NativeScriptアプリケーションをアップグレードするには、NativeScript CLI Tooling、iOSおよびAndroidランタイム、クロスプラットフォームモジュールのいくつかをアップグレードする必要があります。 以下の手順で、これを行う方法を確認します。また、各リリースの重大な変更点をお読みください。
次のコマンドは、NativeScript CLIとも呼ばれるNativeScriptツールをアップグレードする方法を示しています。 最初にtns(またはnativescript)コマンドをアップグレードする必要があるため、 コマンドプロンプトまたはbash/terminalプロンプトに移動して、次のように入力します。
これにより、必要なファイルが自動的にダウンロードされ、コンピューターがNativeScriptコマンドラインの最新バージョンに更新されます。 tns --versionと入力して、新しいバージョンがインストールされていることを確認できます。
既存のNativeScriptプロジェクトを6.0に移行するには、次を実行するだけです。
このコマンドは、6.0プロジェクトを最新の要件に調整するために必要なパッケージのすべての必要な更新とプロジェクトの変更を実行します。
node-sass
typescript
less
nativescript-dev-sass
nativescript-dev-typescript
nativescript-dev-less
nativescript-camera
nativescript-geolocation
nativescript-imagepicker
nativescript-social-share
nativescript-ui-chart
nativescript-ui-dataform
nativescript-ui-gauge
nativescript-ui-listview
nativescript-ui-sidedrawer
nativescript-ui-calendar
nativescript-ui-autocomplete
nativescript-datetimepicker
kinvey-nativescript-sdk
nativescript-plugin-firebase
nativescript-vue
nativescript-permissions
nativescript-cardview
コアの依存関係に問題が見つかったらすぐに、それぞれのGitHubリポジトリで問題を開いてください。 不明な場合は、nativescript/nativescriptリポジトリで開くことができます。 問題が外部プラグインの一部に関連している場合は、プラグインのリポジトリで新しいissueを作成して作成者に連絡してください。
プロジェクトのルートフォルダでupdateコマンドを実行して、最新バージョンのiOS/Androidランタイムとクロスプラットフォームモジュールでアップグレードする必要があります。
tns update
最新の開発リリースを取得するには、nextを引数として渡します。
tns update next
コマンドに渡すことで特定のバージョンに切り替えることもできます。
tns update 2.3.0
./node_modules/.bin/update-ns-webpack --deps --configs
tns-core-modules
、nativescript-dev-webpack
、およびランタイム(tns-android
およびtns-ios
)を更新しています。
このコマンドは、この記事の次の3つのコマンド(tns platform add、npm i tns-core-modulesおよびnpm i nativescript-dev-webpack --save-dev)を組み合わせています。
Androidおよび/またはiOSランタイムの最新バージョンを取得するには、これらの手順に従ってください。 プロジェクトがあるルートレベルのフォルダーに移動し、Androidプロジェクトで作業している場合は、次のように入力します。
および/または(MacでiOSバージョンを使用している場合):
クロスプラットフォームモジュールは、tns-core-modulesという名前のnpmパッケージとして利用できます。
これらをプロジェクトで使用するには、たとえば、パッケージを明示的にインストールする必要があります(上記の手順でまだメインアプリのプロジェクトフォルダーにいる場合):
これにより、tns-core-modulesパッケージがnode_modulesフォルダーにインストールされ、プロジェクトのpackage.jsonへの依存関係として追加されます。
tns-core-modulesパッケージを見つける別の場所はNativeScript Releasesです。
ここでは、すべてのリリースで利用可能なtns-core-modules-*.tgzパッケージのコレクションを見つけることができます。
以下を実行して、選択したリリースをダウンロードしてインストールできます。
npm install <path to tns-core-modules-*.tgz> --save
。
Webpackプラグインは、nativescript-dev-webpackという名前のnpmパッケージとして利用できます。 プロジェクトでプラグインを使用するには、パッケージをdevDependencyとして明示的にインストールする必要があります。 プラグインの初期インストールでは、関連するすべての開発依存関係がインストールされ、デフォルトのwebpack.config.jsファイルが作成されます。 webpack.config.jsファイルが既に存在する場合、nativescript-dev-webpackのインストールによって上書きされません。
Webpackプラグインの既存のバージョンをアップグレードする場合、関連する開発依存関係もそれに応じて更新する必要があることを考慮する必要があります。 プロセスを容易にするために、プラグインは<project-folder>/node_modules/.binフォルダーにあるupdate-ns-webpackと呼ばれる 自動化されたスクリプトを提供します。 スクリプトには2つのフラグがあります。
--deps -
このフラグは、関連するすべての開発依存関係を更新します。--configs -
このフラグはデフォルトのwebpack.config.jsファイルを更新します。npm i nativescript-dev-webpack@latest --save-dev ./node_modules/.bin/update-ns-webpack --deps --configs
Angularプラグインは、nativescript-angularという名前のnpmパッケージとして利用できます。 プラグインのバージョンと関連する依存関係を更新するには、パッケージを明示的にインストールし、それに応じて関連するAngular依存関係を更新する必要があります。 更新プロセスを容易にするために、プラグインには<project-folder>/node_modules/.binフォルダーにある自動スクリプトupdate-app-ng-depsが付属しています。
npm i nativescript-angular@latest --save ./node_modules/.bin/update-app-ng-deps npm i