From 4b4e633545430bc757f7af0a79bdc105fd6ebcc3 Mon Sep 17 00:00:00 2001 From: Erjan Gavalji Date: Fri, 8 Aug 2014 18:17:22 +0300 Subject: [PATCH 1/6] Copied the help content to the README and applied some formatting. --- README.md | 128 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 127 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a26f4dd930..367064766c 100644 --- a/README.md +++ b/README.md @@ -2,4 +2,130 @@ nativescript-cli ================ [![Build Status](https://travis-ci.org/NativeScript/nativescript-cli.svg?branch=build)](https://travis-ci.org/NativeScript/nativescript-cli) -Command-line interface for building NativeScript projects +Command-line interface for creating and building Telerik NativeScript projects + +#Prerequisites +The installation of the Telerik NativeScript Command-line Interface requires [Node.js](http://nodejs.org/) + +#Installation +To install the nativescript-cli, simply run +`npm install -g nativescript` +[![NPM](https://nodei.co/npm/nativescript.png?downloads=true&stars=true)](https://nodei.co/npm/nativescript/) + +#Usage +`$ tns [command parameters] [--command ]` +or, the longer +`$ nativescript [command parameters] [--command ]` + +General commands: +`help ` shows additional information about the commands in this list. + +| Command | Does | +| ------- | ---- | +|`create` | Creates a new NativeScript project with given project name and application identifier. | +|`platform add` | Creates a new platform specific project. | +|`platform list` | Lists all available and all installed platforms. | +|`platform remove` | Removes the platform specific project. | +|`prepare` | Copies files for specified platform, so that the project is ready to build in platform specific SDK. | +|`build` | Builds the project for the selected target platform and produces an application package. | +|`run`| This is shorthand for prepare and build. | + +##General commands + +| Command | Does | +| ------ | ---- | +| `--help` | Prints help about the command. | +| `--path ` | Specifies the directory that contains the project. If not set, the project is searched for in the current directory and all directories above it. | +| `--version` | Prints the client version.| + +##`help` + +Usage: +`$ tns help []` +Lists the available commands or shows information about the selected command. + is any of the available commands as listed by $ tns help. + +##`create` + +Usage: + `$ tns create [--path ] [--appid ] [--copy-from ]` + +Creates a new NativeScript project. +<App name> is the name of project. It should conform to platform package type limitations. For example classes in Java don't begin with numbers. + +Options: + +| Option | Does | +| ------ | ---- | +| `--path` | Specifies the directory where you want to create the project, if different from the current directory. The directory must be empty. | +| `--appid` | Sets the application identifier for your project. The application identifier must consist of at least three alphanumeric strings, separated by a dot (.). Each string must start with a letter. The application identifier corresponds to the Bundle ID for iOS apps and to the package identifier for Android apps. If not specified, the application identifier is set to com.telerik.<App name>. | +| `--copy-from` | Specifies the directory where your javascript files are located. If not set, the default hello world template is used. | + +##`platform` + +Usage: +`$ tns platform ` + +<Command> is a related command that extends the platform command. You can run the following related commands: + +| Command | Does | +| ------- | ---- | +| `list` | Lists all available and installed platforms. | +| `add` | Enables a project with deployment capabilities for the specified platform | +| `remove` | Removes the deployment capabilities of a project for the specified platform| + +##`platform add` + +Usage: +`$ tns platform add ` + +Platform-specific usage: +`$ tns platform add android` +`$ tns platform add ios` + +Creates a new platform specific project. The current version of the Telerik NativeScript has support for iOS and Android projects. +Android projects can be created on Linux, Windows and Mac machines. iOS projects can only be created on a MAC machine. + +##`platform remove` + +Usage: +`$ tns platform remove ` + +Platform-specific usage: +`$ tns platform remove android` +`$ tns platform remove ios` + +Removes the platform specific project. + +##`prepare` + +Usage: +`$ tns prepare []` + +Platform-specific usage: +`$ tns prepare android` +`$ tns prepare ios` + +Copies files for specified platform, so that the project is ready to build in each SDK. + +##`build` + +Usage: +`$ tns build []` + +Platform-specific usage: +`$ tns build android` +`$ tns build ios` + +Builds the project for specified platform. This generates platform-specific code within the project's platforms subdirectory. + +##`run` + +Usage: +`$ tns run []` + +Platform-specific usage: +`$ tns run android` +`$ tns run ios` + +This is shorthand for prepare and build. From 3d0a7876ccf7ad7431ece0de854d1099df4bb5ee Mon Sep 17 00:00:00 2001 From: Erjan Gavalji Date: Fri, 8 Aug 2014 18:36:55 +0300 Subject: [PATCH 2/6] Fix attached code blocks. Add links to the main table. --- README.md | 78 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 48 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 367064766c..5a2cbd77d7 100644 --- a/README.md +++ b/README.md @@ -17,18 +17,18 @@ To install the nativescript-cli, simply run or, the longer `$ nativescript [command parameters] [--command ]` -General commands: -`help ` shows additional information about the commands in this list. +##Main commands | Command | Does | | ------- | ---- | -|`create` | Creates a new NativeScript project with given project name and application identifier. | -|`platform add` | Creates a new platform specific project. | -|`platform list` | Lists all available and all installed platforms. | -|`platform remove` | Removes the platform specific project. | -|`prepare` | Copies files for specified platform, so that the project is ready to build in platform specific SDK. | -|`build` | Builds the project for the selected target platform and produces an application package. | -|`run`| This is shorthand for prepare and build. | +| [`help `](#helpcommand) | Shows additional information about the commands in this list. | +|[`create`](#createcommand) | Creates a new NativeScript project with given project name and application identifier. | +|[`platform add`](#platformaddcommand) | Creates a new platform specific project. | +|[`platform list`](#platformlistcommand) | Lists all available and all installed platforms. | +|[`platform remove`](#platformremovecommand) | Removes the platform specific project. | +|[`prepare`](#preparecommand) | Copies files for specified platform, so that the project is ready to build in platform specific SDK. | +|[`build`](#buildcommand) | Builds the project for the selected target platform and produces an application package. | +|[`run`](#runcommand)| This is shorthand for prepare and build. | ##General commands @@ -38,22 +38,24 @@ General commands: | `--path ` | Specifies the directory that contains the project. If not set, the project is searched for in the current directory and all directories above it. | | `--version` | Prints the client version.| -##`help` +##`help` + +**Usage** -Usage: `$ tns help []` Lists the available commands or shows information about the selected command. is any of the available commands as listed by $ tns help. -##`create` +##`create` + +**Usage** -Usage: `$ tns create [--path ] [--appid ] [--copy-from ]` Creates a new NativeScript project. <App name> is the name of project. It should conform to platform package type limitations. For example classes in Java don't begin with numbers. -Options: +**Options** | Option | Does | | ------ | ---- | @@ -63,7 +65,8 @@ Options: ##`platform` -Usage: +**Usage** + `$ tns platform ` <Command> is a related command that extends the platform command. You can run the following related commands: @@ -74,58 +77,73 @@ Usage: | `add` | Enables a project with deployment capabilities for the specified platform | | `remove` | Removes the deployment capabilities of a project for the specified platform| -##`platform add` +##`platform add` + +**Usage** -Usage: `$ tns platform add ` -Platform-specific usage: +**Platform-specific usage** + `$ tns platform add android` + `$ tns platform add ios` Creates a new platform specific project. The current version of the Telerik NativeScript has support for iOS and Android projects. Android projects can be created on Linux, Windows and Mac machines. iOS projects can only be created on a MAC machine. -##`platform remove` +##`platform remove` + +**Usage** -Usage: `$ tns platform remove ` -Platform-specific usage: +**Platform-specific usage** + `$ tns platform remove android` + `$ tns platform remove ios` Removes the platform specific project. -##`prepare` +##`prepare` + +**Usage** -Usage: `$ tns prepare []` -Platform-specific usage: +**Platform-specific usage** + `$ tns prepare android` + `$ tns prepare ios` Copies files for specified platform, so that the project is ready to build in each SDK. -##`build` +##`build` + +**Usage** -Usage: `$ tns build []` -Platform-specific usage: +**Platform-specific usage** + `$ tns build android` + `$ tns build ios` Builds the project for specified platform. This generates platform-specific code within the project's platforms subdirectory. -##`run` +##`run` + +**Usage** -Usage: `$ tns run []` -Platform-specific usage: +**Platform-specific usage** + `$ tns run android` + `$ tns run ios` This is shorthand for prepare and build. From b6baf02d95b68050e9c9465b4f86d2a6047797b6 Mon Sep 17 00:00:00 2001 From: Erjan Gavalji Date: Fri, 8 Aug 2014 18:40:55 +0300 Subject: [PATCH 3/6] Remove the nodei reference, out package is not published to npmjs.org yet --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 5a2cbd77d7..9ee3f071af 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,6 @@ The installation of the Telerik NativeScript Command-line Interface requires [No #Installation To install the nativescript-cli, simply run `npm install -g nativescript` -[![NPM](https://nodei.co/npm/nativescript.png?downloads=true&stars=true)](https://nodei.co/npm/nativescript/) #Usage `$ tns [command parameters] [--command ]` From ea84e22e325ee192bcdd1e956dce83ed1d80a89b Mon Sep 17 00:00:00 2001 From: Erjan Gavalji Date: Mon, 11 Aug 2014 10:12:58 +0300 Subject: [PATCH 4/6] A small fox on the platform remove command --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9ee3f071af..baf5c91083 100644 --- a/README.md +++ b/README.md @@ -103,7 +103,7 @@ Android projects can be created on Linux, Windows and Mac machines. iOS projects `$ tns platform remove ios` -Removes the platform specific project. +Removes the deployment capabilities of a project for the specified platform. ##`prepare` From 04715ac0db0bd51215d92bdf9166537f4360518c Mon Sep 17 00:00:00 2001 From: Erjan Gavalji Date: Tue, 12 Aug 2014 01:38:28 -0700 Subject: [PATCH 5/6] Update common submodule --- lib/common | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/common b/lib/common index d4ad1e3b37..210d47e475 160000 --- a/lib/common +++ b/lib/common @@ -1 +1 @@ -Subproject commit d4ad1e3b37334dc80797d1c181aed1e5bd1626ae +Subproject commit 210d47e475b369edd00f51001d6c4269ee60ba62 From 19de491c3713fb6f8d7c832339995fe0a0ac6b39 Mon Sep 17 00:00:00 2001 From: Erjan Gavalji Date: Tue, 12 Aug 2014 01:46:08 -0700 Subject: [PATCH 6/6] Remove the Telerik prefix where NativeScript is mentioned --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index baf5c91083..c398fa39a8 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ nativescript-cli ================ [![Build Status](https://travis-ci.org/NativeScript/nativescript-cli.svg?branch=build)](https://travis-ci.org/NativeScript/nativescript-cli) -Command-line interface for creating and building Telerik NativeScript projects +Command-line interface for creating and building NativeScript projects #Prerequisites The installation of the Telerik NativeScript Command-line Interface requires [Node.js](http://nodejs.org/)