Cocoapods.md

Author: Fatme Havaluova

CocoaPods.md

@@ -0,0 +1,83 @@
+# Using CocoaPods
+
+When you develop for iOS, you can quickly add third party libraries to your NativeScript projects via [CocoaPods](https://cocoapods.org/), a dependency manager for Swift and Objective-C Cocoa projects.
+
+## Table of Contents
+ * [Install CocoaPods](#install-cocoapods)
+ * [Create CLI Project](#create-cli-project)
+ * [Create NativeScript plugin with Podfile](#create-nativescript-plugin-with-podfile)
+ * [Build the Project](#build-the-project)
+
+## Install CocoaPods
+ You need to install CocoaPods. If you haven't yet, you can do so by:
+```
+$ sudo gem install cocoapods
+```
+> **NOTE:** All operations and code in this article are verified against CocoaPods 0.38.2.
+
+You can check your current version using:
+```
+$ pod --version
+```
+
+To update CocoaPods just install the gem again with:
+```
+sudo gem install cocoapods
+```
+
+## Create CLI Project
+To start, create a project, add the iOS platform.
+```bash
+$ tns create MYCocoaPods
+$ cd MYCocoaPods
+$ tns platform add ios
+```
+
+## Create NativeScript plugin with Podfile
+
+For more information see [NativeScript plugins](#PLUGINS.md)
+
+```
+cd ..
+mkdir my-plugin
+cd my-plugin
+touch package.json
+```
+
+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) and move it to 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. {N} CLI will build the newly created workspace and produce correct .ipa.
+