From 701ba20c9bd9673a35753547ef1393eae118d189 Mon Sep 17 00:00:00 2001 From: Kristian Dimitrov Date: Wed, 10 Jul 2019 14:04:15 +0300 Subject: [PATCH 1/3] docs: introduce help for migrate command --- docs/man_pages/general/migrate.md | 64 +++++++++++++++++++ docs/man_pages/general/package-manager-get.md | 2 +- docs/man_pages/general/package-manager-set.md | 2 +- docs/man_pages/general/update.md | 2 +- docs/man_pages/general/usage-reporting.md | 2 +- docs/man_pages/index.md | 1 + 6 files changed, 69 insertions(+), 4 deletions(-) create mode 100644 docs/man_pages/general/migrate.md diff --git a/docs/man_pages/general/migrate.md b/docs/man_pages/general/migrate.md new file mode 100644 index 0000000000..949e38725b --- /dev/null +++ b/docs/man_pages/general/migrate.md @@ -0,0 +1,64 @@ +<% if (isJekyll) { %>--- +title: tns migrate +position: 15 +---<% } %> + +# tns migrate + +### Description + +Migrates the app dependencies to a form compatible with NativeScript 6.0. Running this command will not affect the codebase of the application and you might need to do additional changes manually. + +The migrate command will update **"webpack.config.js"**, **"karma.conf.js"**, **"tsconfig.tns.json"**(not for code sharing projects) and **"package-lock.json"**. The original files will be moved to **".migration_backup"** folder. +The following folders will be removed: **"hooks"**, **"platforms"** and **"node_modules"**. The **"hooks"** folder will also be backed up in **".migration_backup"** folder. + +The **"nativescript-dev-sass"** and **"nativescript-dev-typescript"** dependencies will be replaced with **"node-sass"** and **"typescript"** respectively. +The **"nativescript-dev-less"** dependency will be removed, but to enable LESS CSS support the user should follow the steps in this<% if(isConsole) { %> feature request: https://github.com/NativeScript/nativescript-dev-webpack/issues/967.<% } %><% if(isHtml) { %> [feature request](https://github.com/NativeScript/nativescript-dev-webpack/issues/967).<% } %> + +The following dependencies will be updated if needed: +* tns-core-modules +* tns-core-modules-widgets +* tns-platform-declarations +* nativescript-dev-webpack +* nativescript-camera +* nativescript-geolocation +* nativescript-imagepicker +* nativescript-permissions +* 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-cardview +* nativescript-datetimepicker +* kinvey-nativescript-sdk +* nativescript-plugin-firebase +* nativescript-vue +* nativescript-unit-test-runner +* karma-webpack +* karma-jasmine +* karma-mocha +* karma-chai +* karma-qunit +* karma" + + +### Commands + +Usage | Synopsis +------|------- +General | `$ tns migrate` + +<% if(isHtml) { %> + +### Related Commands + +Command | Description +----------|---------- +[update](update.html) | Updates the project with the latest versions of iOS/Android runtimes and cross-platform modules. +[help](help.html) | Lists the available commands or shows information about the selected command. +[doctor](doctor.html) | Checks your system for configuration problems which might prevent the NativeScript CLI from working properly. +<% } %> diff --git a/docs/man_pages/general/package-manager-get.md b/docs/man_pages/general/package-manager-get.md index e1fd3de934..ba516da2a3 100644 --- a/docs/man_pages/general/package-manager-get.md +++ b/docs/man_pages/general/package-manager-get.md @@ -1,6 +1,6 @@ <% if (isJekyll) { %>--- title: tns package-manager get -position: 18 +position: 19 ---<% } %> # tns package-manager get diff --git a/docs/man_pages/general/package-manager-set.md b/docs/man_pages/general/package-manager-set.md index 38bf182674..333ae3c93a 100644 --- a/docs/man_pages/general/package-manager-set.md +++ b/docs/man_pages/general/package-manager-set.md @@ -1,6 +1,6 @@ <% if (isJekyll) { %>--- title: tns package-manager set -position: 17 +position: 18 ---<% } %> # tns package-manager set diff --git a/docs/man_pages/general/update.md b/docs/man_pages/general/update.md index c4849220a5..868686aa40 100644 --- a/docs/man_pages/general/update.md +++ b/docs/man_pages/general/update.md @@ -1,6 +1,6 @@ <% if (isJekyll) { %>--- title: tns update -position: 15 +position: 16 ---<% } %> # tns update diff --git a/docs/man_pages/general/usage-reporting.md b/docs/man_pages/general/usage-reporting.md index 1b11115748..5edf50dca4 100644 --- a/docs/man_pages/general/usage-reporting.md +++ b/docs/man_pages/general/usage-reporting.md @@ -1,6 +1,6 @@ <% if (isJekyll) { %>--- title: tns usage-reporting -position: 16 +position: 17 ---<% } %> # tns usage-reporting diff --git a/docs/man_pages/index.md b/docs/man_pages/index.md index 542395e2ea..0d86ade439 100644 --- a/docs/man_pages/index.md +++ b/docs/man_pages/index.md @@ -21,6 +21,7 @@ Command | Description [doctor](general/doctor.html) | Checks your system for configuration problems which might prevent the NativeScript CLI from working properly. [info](general/info.html) | Displays version information about the NativeScript CLI, core modules, and runtimes. [proxy](general/proxy.html) | Displays proxy settings. +[migrate](general/migrate.html) | Migrates the app dependencies to a form compatible with NativeScript 6.0. [update](general/update.html) | Updates the project with the latest versions of iOS/Android runtimes and cross-platform modules. ## Project Development Commands From 3e95c78083e915301cdee8fbc0d666af5c18992d Mon Sep 17 00:00:00 2001 From: Dimitar Tachev Date: Wed, 10 Jul 2019 15:30:35 +0300 Subject: [PATCH 2/3] chore: remove forgotten " --- docs/man_pages/general/migrate.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/man_pages/general/migrate.md b/docs/man_pages/general/migrate.md index 949e38725b..c326907cae 100644 --- a/docs/man_pages/general/migrate.md +++ b/docs/man_pages/general/migrate.md @@ -43,7 +43,7 @@ The following dependencies will be updated if needed: * karma-mocha * karma-chai * karma-qunit -* karma" +* karma ### Commands From e082e8ada3603b1f5be680eab76e7afd8c554a5c Mon Sep 17 00:00:00 2001 From: Kristian Dimitrov Date: Wed, 10 Jul 2019 15:33:19 +0300 Subject: [PATCH 3/3] chore: remove extra new line in migrate help --- docs/man_pages/general/migrate.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/man_pages/general/migrate.md b/docs/man_pages/general/migrate.md index c326907cae..b33a19f87a 100644 --- a/docs/man_pages/general/migrate.md +++ b/docs/man_pages/general/migrate.md @@ -45,7 +45,6 @@ The following dependencies will be updated if needed: * karma-qunit * karma - ### Commands Usage | Synopsis