//]: # (header-start)

👉    Stay tuned for more info as plans are being made to save the Titanium project and move it under the control of a independent group of developers.

⚠️ CAUTION: PRE-PRODUCTION BETA ⚠️
(breaking changes may be introduced before 1.0.0 release)

alloy+ plugin: underscore

• Overview
  • Why should I use this plugin?
  • What is Alloy+?
• Dependencies
  • Install Alloy+ Core only
  • Install Alloy+ Bundle 📦
• Installing this plugin
• Usage
  • Examples
• Other Alloy+ Plugins
• Need Help?
• License
• Legal

Overview

Why should I use this plugin?

Alloy+ plugin underscore is a plugin for fixing invalid usages of underscore.js within Alloy source code. This paves the way to be able to use newer versions of underscore.js or lodash.

What is Alloy+?

Alloy+ is an entire framework built around Appcelerator Mobile and their Alloy product. The idea for this framework was built upon the concepts of MobileHero Adamantium and a desire to customize and extend Appcelerator Alloy for developers. How much faster or stronger all depends on YOU, the developer.

There will be an assortment of alloy+ plugins (available as npm modules) that you can install in your project to help you take your existing development tools furthur than possible today. You can choose which modules are executed in your config.json file (which is part of your Alloy project). You can also easily create your own plugins by simply creating a npm module that follows a simple convention.

Dependencies

All modules should be installed in the root directory of your Appcelerator mobile project (the directory containing tiapp.xml).

Alloy+ plugins are executed by Alloy+ Core. You can install that by itself or bundled with several Alloy+ plugins.

Install Alloy+ Core only

npm install --save @aplus/core

Install Alloy+ Bundle 📦

npm install --save @aplus/bundle

Installing this plugin

Install in the root directory of your Appcelerator mobile project (the directory containing tiapp.xml).

npm install --save @aplus/underscore

Usage

To use this installed plugin in your app, merge the following to your app's config.json file:

	{
		"tasks": [ "@aplus/underscore" ]
	}

In default mode, the task will run in the precompile stage of the Alloy build process so that any changes done by this plugin can get picked up before copying files over to the build folder.

Examples

Fix underscore.js issues in the Platform-specific resource folder
    "precompile": [ "@aplus/underscore" ]

Other Alloy+ Plugins

Coming Soon! :mega:

• npm: Execute npm during the Alloy build process
• babel: Run babel transformations on your code during the build process
• es6: Use ES6/ES2015 code in your apps via babel transformations!
• node: Make require statements in your app support nodejs packages installed via npm
• underscore: Fix some issues with the usage of underscore in Alloy and allow upgrading to lodash

You can also search for more plugins developed by the community.

Need Help?

Please submit an issue on GitHub and provide information about your setup.

License

This project is licensed under the terms of the MIT license. This means you have full access to the source code and can modify it to fit your own needs. See the license.md file.

Legal

Superhero Studios Incorporated and this project are in no way affiliated with any of the following companies:

• Appcelerator, Inc
• Axway Inc
• Apple Inc
• Google Inc

Alloy is developed by Appcelerator and the community and is Copyright (c) 2012 by Appcelerator, Inc. All Rights Reserved. Alloy is made available under the Apache Public License, version 2. See their LICENSE file for more information.