Creates a new project for NativeScript plugin development. The project uses the NativeScript Plugin Seed as a base and contains the following directories:
src- source code of the plugin
publish- shell scripts used to build and pack the plugin source code and publish it in NPM
The command will also propose you to setup demo applications and if you accept them, it will create the following additional directories:
demo- simple NativeScript application used to test and show plugin features
demo-angular- simple Angular application used to test and show plugin features
The project is setup for easy commit in Github, which is why the command will ask you for your Github username. Before starting to code your first plugin, you can visit the NativeScript documentation page for building plugins or the plugin seed repository.
|Create from the default plugin seed||
|Create from a custom plugin seed||
--path- Specifies the directory where you want to create the project, if different from the current directory.
--username- Specifies the Github username, which will be used to build the URLs in the plugin's package.json file.
--pluginName- Used to set the default file and class names in the plugin source.
--includeTypeScriptDemo- Specifies if TypeScript demo should be created. Default value is
demowill be created), in case you do not want to create this demo, pass
--includeAngularDemo- Specifies if Angular demo should be created. Default value is
demo-angularwill be created), in case you do not want to create this demo, pass
--template- Specifies the custom seed archive, which you want to use to create your plugin. If
--templateis not set, the NativeScript CLI creates the plugin from the default NativeScript Plugin Seed.
<Template>can be a URL or a local path to a
.tar.gzfile with the contents of a seed repository. This must be a clone of the NativeScript Plugin Seed and must contain a
srcdirectory with a package.json file and a script at
src/scripts/postclone.js. After the archive is extracted, the postclone script will be executed with the username (
gitHubUsername) and plugin name (
pluginName) parameters given to the
tns plugin createcommand prompts. For more information, visit the default plugin seed repository and examine the source script there. Examples:
Using a local file:
tns plugin create nativescript-testplugin --template ../seeds/seed1.tar.gz
.tar.gzfile from a tag called
v4.0in a Github repository:
tns plugin create nativescript-testplugin --template https://github.com/NativeScript/nativescript-plugin-seed/archive/v.4.0.tar.gz
<Plugin Repository Name>is the name of repository where your plugin will reside. A directory with the same name will be created. For example:
nativescript-awesome-list. If a directory with the name already exists and is not empty, the plugin create command will fail.