リリース / アップグレード手順

アップグレード手順

NativeScriptアプリケーションをアップグレードするには、NativeScript CLI Tooling、iOSおよびAndroidランタイム、クロスプラットフォームモジュールのいくつかをアップグレードする必要があります。 以下の手順で、これを行う方法を確認します。また、各リリースの重大な変更点をお読みください。

NativeScriptツールのアップグレード

次のコマンドは、NativeScript CLIとも呼ばれるNativeScriptツールをアップグレードする方法を示しています。 最初にtns(またはnativescript)コマンドをアップグレードする必要があるため、 コマンドプロンプトまたはbash/terminalプロンプトに移動して、次のように入力します。

npm install -g nativescript

これにより、必要なファイルが自動的にダウンロードされ、コンピューターがNativeScriptコマンドラインの最新バージョンに更新されます。 tns --versionと入力して、新しいバージョンがインストールされていることを確認できます。

既存のプロジェクトを{N}6.0に移行する

既存のNativeScriptプロジェクトを6.0に移行するには、次を実行するだけです。

tns migrate

このコマンドは、6.0プロジェクトを最新の要件に調整するために必要なパッケージのすべての必要な更新とプロジェクトの変更を実行します。

ノード: migrateコマンドは、{N}コアパッケージと以下にリストされたプラグインを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ランタイムとクロスプラットフォームモジュールでアップグレードする必要があります。

注釈: updateコマンドはNativeScript CLIのバージョン2.4で導入されました。このコマンドを使用する前に、NativeScript CLIを更新する必要があります。

tns update

最新の開発リリースを取得するには、nextを引数として渡します。

tns update next

コマンドに渡すことで特定のバージョンに切り替えることもできます。

tns update 2.3.0

注釈: nativescript-dev-webpackを更新した後、webpack.config.jsも更新する必要があります。 そのためにupdate-ns-webpack自動化スクリプトを実行することもできます。
./node_modules/.bin/update-ns-webpack --deps --configs
重要: --configsフラグを使用すると、以前の構成は上書きされて失われます。 webpack.config.jsで導入したカスタムコードを保存し、--configsフラグを使用した後にコードを再適用することを検討してください。 注釈: コマンドtns updateは、tns-core-modulesnativescript-dev-webpack、およびランタイム(tns-androidおよびtns-ios)を更新しています。 このコマンドは、この記事の次の3つのコマンド(tns platform addnpm i tns-core-modulesおよびnpm i nativescript-dev-webpack --save-dev)を組み合わせています。

プラットフォームのアップグレード

Androidおよび/またはiOSランタイムの最新バージョンを取得するには、これらの手順に従ってください。 プロジェクトがあるルートレベルのフォルダーに移動し、Androidプロジェクトで作業している場合は、次のように入力します。

tns platform remove android tns platform add android

および/または(MacでiOSバージョンを使用している場合):

tns platform remove ios tns platform add ios

TNSモジュールのアップグレード

クロスプラットフォームモジュールは、tns-core-modulesという名前のnpmパッケージとして利用できます。

これらをプロジェクトで使用するには、たとえば、パッケージを明示的にインストールする必要があります(上記の手順でまだメインアプリのプロジェクトフォルダーにいる場合):

npm install tns-core-modules@latest --save

これにより、tns-core-modulesパッケージがnode_modulesフォルダーにインストールされ、プロジェクトのpackage.jsonへの依存関係として追加されます。

重要: このtns createコマンドは、新しいプロジェクトを作成し、tns-core-modulesパッケージをそのpackage.jsonへの依存関係として追加してインストールします。 そのため、作成する新しいプロジェクトごとにtns-core-modulesパッケージがインストールされ、明示的にインストールする必要はありません。

tns-core-modulesパッケージを見つける別の場所はNativeScript Releasesです。 ここでは、すべてのリリースで利用可能なtns-core-modules-*.tgzパッケージのコレクションを見つけることができます。 以下を実行して、選択したリリースをダウンロードしてインストールできます。 npm install <path to tns-core-modules-*.tgz> --save

Webpackのアップグレード

Webpackプラグインは、nativescript-dev-webpackという名前のnpmパッケージとして利用できます。 プロジェクトでプラグインを使用するには、パッケージをdevDependencyとして明示的にインストールする必要があります。 プラグインの初期インストールでは、関連するすべての開発依存関係がインストールされ、デフォルトのwebpack.config.jsファイルが作成されます。 webpack.config.jsファイルが既に存在する場合、nativescript-dev-webpackのインストールによって上書きされません。

npm i nativescript-dev-webpack --save-dev

Webpackのバージョンと構成の更新

Webpackプラグインの既存のバージョンをアップグレードする場合、関連する開発依存関係もそれに応じて更新する必要があることを考慮する必要があります。 プロセスを容易にするために、プラグインは<project-folder>/node_modules/.binフォルダーにあるupdate-ns-webpackと呼ばれる 自動化されたスクリプトを提供します。 スクリプトには2つのフラグがあります。

npm i nativescript-dev-webpack@latest --save-dev ./node_modules/.bin/update-ns-webpack --deps --configs

重要: --configsフラグを使用すると、以前の構成は上書きされて失われます。 webpack.config.jsで導入したカスタムコードを保存し、--configsフラグを使用した後にコードを再適用することを検討してください。

Angular依存関係のアップグレード

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

入門

コアコンセプト

ユーザーインターフェース

ツール

ハードウェアアクセス

プラグインの開発

リリース

アプリテンプレート

パフォーマンスの最適化

フレームワークモジュール

ガイド

サポートを受ける

トラブルシューティング

Siedkick