Merge 1.3.0 in master

.gitignore

@@ -27,6 +27,7 @@ results
 scratch/
 .idea/
 .settings/
+.vscode/
 test-reports.xml
 
 npm-debug.log

CHANGELOG.md

@@ -1,6 +1,29 @@
 NativeScript CLI Changelog
 ================
 
+1.3.0 (2015, September 16)
+==
+
+### New
+* [Implemented #390](https://github.com/NativeScript/nativescript-cli/issues/390): Support tns_modules from npm.
+* [Implemented #686](https://github.com/NativeScript/nativescript-cli/issues/686): Support building of XCode workspaces.
+* [Implemented #687](https://github.com/NativeScript/nativescript-cli/issues/687): Android build with Gradle.
+* [Implemented #729](https://github.com/NativeScript/nativescript-cli/issues/729): CocoaPods support from plugins.
+* [Implemented #785](https://github.com/NativeScript/nativescript-cli/issues/785): Add platform on each platform related command.
+* [Implemented #875](https://github.com/NativeScript/nativescript-cli/issues/875): Init command configure tns-core-modules version.
+
+### Fixed
+* [Fixed #662](https://github.com/NativeScript/nativescript-cli/issues/662): Failed `tns platform add android` command leaves the project in inconsistent state.
+* [Fixed #730](https://github.com/NativeScript/nativescript-cli/issues/730): `tns livesync android` throws stdout maxBuffer exceeded.
+* [Fixed #772](https://github.com/NativeScript/nativescript-cli/issues/772): `tns platform update ios` command does not update metadata generator.
+* [Fixed #793](https://github.com/NativeScript/nativescript-cli/issues/793): The NativeScript CLI writes errors on stdout.
+* [Fixed #797](https://github.com/NativeScript/nativescript-cli/issues/797): Plugin add does not merge plugins's Info.plist file.
+* [Fixed #811](https://github.com/NativeScript/nativescript-cli/issues/811): `tns livesync <Platform> --watch` reports an error when platform specific file is changed.
+* [Fixed #826](https://github.com/NativeScript/nativescript-cli/issues/826): Failed `tns prepare <Platform>` command leaves the project in inconsistent state.
+* [Fixed #829](https://github.com/NativeScript/nativescript-cli/issues/829): Fail to build the project when `nativescript-telerik-ui` plugin is added before the platform.
+* [Fixed #866](https://github.com/NativeScript/nativescript-cli/issues/866): The NativeScript CLI is not able to detect java on Ubuntu.
+* [Fixed #896](https://github.com/NativeScript/nativescript-cli/issues/896): `tns run <Platform>` after `tns livesync <Platform>` starts the last synced app on the device.
+
 1.2.4 (2015, August 24)
 ==
 

CocoaPods.md

@@ -0,0 +1,89 @@
+# Using CocoaPods
+
+When you develop for iOS, you can quickly add third-party libraries to your NativeScript projects via the [CocoaPods](https://cocoapods.org/) dependency manager.
+
+To work with such libraries, you need to wrap them as a custom NativeScript plugin and add them to your project.
+
+ * [Install CocoaPods](#install-cocoapods)
+ * [Create CLI Project](#create-cli-project)
+ * [Wrap the Library as NativeScript Plugin](#wrap-the-library-as-nativescript-plugin)
+ * [Build the Project](#build-the-project)
+
+## Install CocoaPods
+You need to install CocoaPods. If you haven't yet, you can do so by running:
+
+```
+$ sudo gem install cocoapods
+```
+> **NOTE:** All operations and code in this article are verified against CocoaPods 0.38.2.
+
+To check your current version, run the following command.
+
+```
+$ pod --version
+```
+
+To update CocoaPods, just run the installation command again.
+
+```
+sudo gem install cocoapods
+```
+
+## Create CLI Project
+To start, create a project and add the iOS platform.
+
+```bash
+$ tns create MYCocoaPods
+$ cd MYCocoaPods
+$ tns platform add ios
+```
+
+## Wrap the Library as NativeScript Plugin
+
+For more information about working with NativeScript plugins, click [here](PLUGINS.md).
+
+```
+cd ..
+mkdir my-plugin
+cd my-plugin
+```
+
+Create a package.json file with the following content:
+
+```
+{
+  "name": "myplugin",
+  "version": "0.0.1",
+  "nativescript": {
+    "platforms": {
+      "ios": "1.3.0"
+    }
+  }
+}
+```
+
+Create a [Podfile](https://guides.cocoapods.org/syntax/podfile.html) which describes the dependency to the library that you want to use. Move it to the `platforms/ios` folder.
+
+```
+my-plugin/
+├── package.json
+└── platforms/
+    └── ios/
+        └── Podfile
+```
+
+Next, install the plugin:
+
+```
+tns plugin add ../my-plugin
+```
+
+## Build the project
+
+```
+tns build ios
+```
+
+This modifies the `MYCocoaPods.xcodeproj` and creates a workspace with the same name.
+
+> **IMPORTANT:** You will no longer be able to run the `xcodeproj` alone. NativeScript CLI will build the newly created workspace and produce the correct .ipa.