Skip to content

Latest commit

 

History

History
39 lines (31 loc) · 3.1 KB

platform-add.md

File metadata and controls

39 lines (31 loc) · 3.1 KB

platform add

Usage Synopsis
Android latest runtime $ tns platform add android [--frameworkPath <File Path>] [--symlink] [--sdk <target sdk>]
Android selected runtime $ tns platform add android[@<Version>] [--frameworkPath <File Path>] [--symlink] [--sdk <target sdk>]
<% if (isMacOS) { %>iOS latest runtime $ tns platform add ios [--frameworkPath <File Path>] [--symlink]
iOS selected runtime $ tns platform add ios[@<Version>] [--frameworkPath <File Path>] [--symlink]<% } %>

Configures the current project to target the selected platform. <% if(isHtml) { %>When you add a target platform, the NativeScript CLI adds a corresponding platform-specific subdirectory under the platforms directory. This platform-specific directory contains the necessary files to let you build your project for the target platform.<% } %>

Options

  • --frameworkPath - Sets the path to a NativeScript runtime for the specified platform that you want to use instead of the default runtime. If --symlink is specified, <File Path> must point to directory in which the runtime is already extracted. If --symlink is not specified, <File Path> must point to a valid npm package.
  • --symlink - Creates a symlink to a NativeScript runtime for the specified platform that you want to use instead of the default runtime. If --frameworkPath is specified, creates a symlink to the specified directory. If --frameworkPath is not specified, creates a symlink to platform runtime installed with your current version of NativeScript.
  • --sdk - Sets the Android target SDK. The value should be a valid Android API Level, for example 17, 19, MNC.

Attributes

  • <File Path> is the complete path to a valid npm package or a directory that contains a NativeScript runtime for the selected platform.
  • <Version> is any available version of the respective platform runtime published in npm. <% if(isHtml) { %>If @<Version> is not specified, the NativeScript CLI installs the latest stable runtime for the selected platform.
    To list all available versions for Android, run $ npm view tns-android versions
    To list only experimental versions for android, run $ npm view tns-android dist-tags
    To list all available versions for iOS, run $ npm view tns-ios versions
    To list only experimental versions for ios, run $ npm view tns-ios dist-tags

Command Limitations

  • You can run $ tns platform add ios only on OS X systems.

Related Commands

Command Description
install Installs all platforms and dependencies described in the package.json file in the current directory.
platform remove Removes the selected platform from the platforms that the project currently targets.
platform update Updates the NativeScript runtime for the specified platform.
platform Lists all platforms that the project currently targets.
prepare Copies common and relevant platform-specific content from the app directory to the subdirectory for the selected target platform in the platforms directory.
<% } %>