nativescript-set-version


This tool allows you to easily update the version of a Nativescript application.
It will update the following files if found:

- ./package.json
- ./app/App_Resources/Android/src/main/AndroidManifest.xml
- ./app/App_Resources/Android/app/app.gradle
- ./app/App_Resources/iOS/Info.plist

Version number format

In order to use this package, your project version must comply with the format described on semver.org.

Setup and Usage

There are two ways to install nativescript-set-version: globally and locally.

$3

This is the recommended way to install nativescript-set-version.

npm:

``bash
npm install nativescript-set-version --save-dev
`

yarn:

`bash
yarn add nativescript-set-version --dev
`

You can then use this command in your project directory to run nativescript-set-version:

npm:

`bash
$ npm run setVersion
-- or --
$ npm run set-version
`

yarn:

`bash
$ yarn setVersion
-- or --
$ yarn set-version
`

$3

This installation method allows you to use nativescript-set-version in any project.

npm:

`bash
npm install -g nativescript-set-version
`

yarn:

`bash
yarn global add nativescript-set-version
`

You can then use this command in your project directory to run nativescript-set-version:

`bash
setVersion
-- or --
set-version
`

Behaviour

When invoked, nativescript-set-version will make the following changes to your project files:

$3

The version attribute in package.json will be updated with the specified version.

$3

It will update the version name and the version code in both app.gradle and AndroidManifest.xml.

#### About AndroidManifest.xml

Version information should not be in the AndroidManifest.xml since this information is overridden by app.gradle.

See https://developer.android.com/studio/publish/versioning for further informations.

For that reason nativescript-set-version will only write in the AndroidManifest.xml if android:versionCode and/or android:versionName are already in the file.

$3

It will update the CFBundleShortVersionString and the CFBundleVersion in Info.plist.

$3

The Android version code represents your version number as an integer. This
package uses the following format to generate this integer:

`

`

For instance, the first time you call set-version 3.1.4, it will produce the version code 301041.

If you call the command with the same version a second time, it will increment the build number, to produce 301042.

This also applies if, for instance, you call set-version 3.1.4-rc.1, and then set-version 3.1.4-rc.2.

As for the CFBundleVersion on iOS, it will produce a string in the format ....

Example:

`bash
$ yarn set-version 1.0.0-rc.1


Output

...

Will set android version code to 100001

...

Will set CFBundleVersion to 1.0.0.1

$ yarn set-version 1.0.0-rc.2

Output

...

Will set android version code to 100002

...

Will set CFBundleVersion to 1.0.0.2

$ yarn set-version 1.0.0

Output

...

Will set android version code to 100003

...

Will set CFBundleVersion to 1.0.0.3

`

License

This software uses the MIT license.

Contributing

You must use the following style guide:

- Airbnb JavaScript Style Guide

This project contains a linting config, you should setup eslint into your IDE with .eslintrc.js`.