Merge pull request #236 from NativeScript/library-add-help

Library add help

Author: ikoevska

README.md

@@ -198,6 +198,7 @@ Run `tns help` to list all available commands. Run or `tns <Command> --help` to
 * `platform add <Platform>` adds a new target platform to your project.
 * `platform remove <Platform>` removes the selected platform from the target platforms of the project.
 * `platform update <Platform>` updates the NativeScript runtime for the specified platform.
+* `library add <Platform> <Library Path>` adds a locally stored native library to the current project.
 * `prepare <Platform>` copies cross-platform and selected platform-specific content to the subdirectory for the target platform.
 * `build <Platform>` builds the project for the selected target platform.
 * `emulate <Platform>` builds the project for the selected target platform and runs it in the native emulator, if configured. 

resources/help.txt

@@ -15,6 +15,7 @@ General commands:
     platform remove                 Removes the selected platform from the platforms that the project currently targets.
                                     This operation deletes all platform-specific files and subdirectories from your project.
     platform update                 Updates the NativeScript runtime for the specified platform.
+    library add                     Adds a locally stored native library to the current project.
     prepare                         Copies relevant content from the app directory to the subdirectory for the selected target platform. 
                                     This lets you build the project with the SDK for the selected platform and deploy it on device.
     build                           Builds the project for the selected target platform and produces an application package or an
@@ -160,6 +161,53 @@ Platform-specific usage:
 Updates the NativeScript runtime for the specified platform.
 --[/]--
 
+--[library]--
+Usage:
+    $ tns library <Command>
+
+You must run the library command with a related command.
+
+<Command> is a related command that extends the library command. You can run the following related commands:
+    add - Adds a native library to the current project.
+--[/]--
+
+--[library|add]--
+Usage:
+    $ tns library add <Platform> <Path>
+
+Platform-specific usage:
+    $ tns library add android <Library Path>
+    $ tns library add ios <Library Path>
+
+Adds a native library to the current project. Copies the library files to the lib/<platform> folder in your project and configures the platform-specific projects in platforms/<platform> to work with the library. Build operations might perform additional configuration changes on the platform-specific project in platforms/<platform>.
+
+IMPORTANT: When adding frameworks, keep in mind the following behaviors.
+    * When you add an iOS framework, the NativeScript CLI automatically changes your build target to iOS 8.0.
+    * Any functionality exposed by the library will becomes available in the built application package.
+    * The first build operation after you run this command is significantly slower.
+
+<Library Path> is the file path to a locally stored framework.
+    When you want to add an iOS framework, <Library Path> must be the complete file path to the *.framework file that you want to use.
+    When you want to add an Android framework, <Library Path> might be any of the following:
+        * The file path to a directory containing one or more *.jar files.
+        * The file path to a directory containing the project.properties files for an Android library project created with Eclipse.
+        * The complete file path to a *.jar or project.properties file.
+
+Prerequisites:
+Before adding a framework, verify that your project meets the following requirements:
+    * You have added the platform for which you want to add a native library by running $ tns platform add <Platform>
+Before adding an iOS framework, verify that your system and the framework meets the following requirements.
+    * You have installed Mono using Homebrew.
+    * You have Xcode 6 and the iOS 8.0 SDK installed.
+    * The framework is a Cocoa Touch Framework with all build architectures enabled.
+    * If the framework relies on other third-party frameworks, make sure to add these frameworks manually as well.
+Before adding an Android framework, verify that the framework meets the following requirements.
+    * If you want to add an Android library project, the project must be created and developed with Eclipse.
+    * If an Android library project depends on other libraries, make sure that these libraries are accessible locally.
+    * If a *.jar file depends on other libraries, make sure to add the dependent libraries by storing them in the same directory and passing this directory to <Library Path>. Otherwise, make sure to add each dependent library manually as well.
+
+--[/]--
+
 --[prepare]--
 
 Usage: