As of March 2019, this repo is no longer maintained by Microsoft. If you're interested in continuing this project, please feel free to fork it. As of March 2019, we will no longer monitor or respond to open issues. Thanks for your support!
The Tools for Apache Cordova – "TACO" for short – provide a set of command line utilities that make hybrid app development easier, friendlier, and faster.
For developers new to Cordova, TACO makes it crazy-easy to setup your dev environment so you can begin coding immediately. The install-reqs utility downloads, installs and configures all the build tools you need for each mobile platform. Once you’ve started coding, TACO makes life a little sweeter by providing a gentle nudge toward the most likely “next steps” and best practices. If you’re looking for a safety blanket, TACO has one of those, too. “TACO Kits” provide a set of validated open source components (e.g. platforms, build tools and plugins) so you don’t have to wade through the morass of download stats, star ratings and open issues to know which components are both stable and compatible with your app. Since building for iOS platform requires a Mac, TACO also provides a utility to connect to a remotebuild server, so that you can build iOS projects from your Windows machine.
Faster setup. Friendlier command line. Validated quality at run-time. TACO is your friend.
Using TACO, start building awesome Apache Cordova apps really quickly by following these steps:
1. Install the tools:
Make sure you have Node.js installed. Note: Latest version of NodeJS has issues with iOS build
Run the following command to install the latest version of TACO:
npm install -g taco-cli
Note: On OSX and Linux, you may need to prefix this command with sudo
2. Create a new app:
taco create myAwesomeApp
3. Navigate to the directory of your new project:
cd myAwesomeApp
4. Add the Android platform:
taco platform add android
5. (Optional) Check for any missing Android dependencies:
taco install-reqs android
6. Build for Android:
taco build android
7. Run the app on the Android emulator:
taco emulate android
After a few moments, your app will be running inside the Android emulator in all its awesomeness. The steps to build for Windows and iOS are very similar, but this should help you get started.
Remember, when in doubt, just type:
taco help
- Have a question that's not a feature request or bug report? Discuss on Stack Overflow
- Read our Blog
- Have a feature request or find a bug? Submit an issue
- Contribute to TACO source
In order to build the TACO packages, ensure that you have Git and Node.js installed.
Clone a copy of the repo:
git clone https://github.com/Microsoft/TACO.git
Change to TACO directory:
cd TACO
Install dev dependencies
npm install
TACO uses gulp based build system. To build TACO packages, simply run following command from root folder
gulp
Above command will build and install TACO packages. It will also create a globally-installed symbolic link ("npm link") to TACO packages
Once TACO has been built and linked properly, you can use TACO packages from globally-installed symbolic link
- To run taco-cli run
taco
- Similarly to run remotebuild run
remotebuild
Please run following to make sure all tests are passing
gulp run-tests
To check test coverage, please run following command
gulp coverage
TACO uses tslint rules specified in tslint.json. Run following command to make sure code is tslint clean
gulp tslint
TACO is licensed under the MIT Open Source license.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.