Repository: cordova-docs Updated Branches: refs/heads/master 18417bae3 -> 3cb404e46
CB-10481 Update the docs according to windows8 deprecation Fixed the Windows platform guide links Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/3cb404e4 Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/3cb404e4 Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/3cb404e4 Branch: refs/heads/master Commit: 3cb404e465d30f75b6b98ee880a135afbb498acf Parents: 18417ba Author: daserge <[email protected]> Authored: Wed Feb 10 21:30:09 2016 +0300 Committer: daserge <[email protected]> Committed: Wed Feb 10 21:30:09 2016 +0300 ---------------------------------------------------------------------- www/docs/en/dev/config_ref/images.md | 18 +++--- www/docs/en/dev/guide/appdev/hooks/index.md | 8 +-- www/docs/en/dev/guide/platforms/index.md | 2 +- www/docs/en/dev/guide/platforms/win8/index.md | 58 ++++++++------------ www/docs/en/dev/guide/platforms/win8/upgrade.md | 11 +++- .../dev/guide/platforms/win8/win10-support.md | 6 +- www/docs/en/dev/guide/support/index.md | 2 +- www/docs/en/dev/plugin_ref/spec.md | 4 +- 8 files changed, 51 insertions(+), 58 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3cb404e4/www/docs/en/dev/config_ref/images.md ---------------------------------------------------------------------- diff --git a/www/docs/en/dev/config_ref/images.md b/www/docs/en/dev/config_ref/images.md index bd5022c..d3f38e0 100644 --- a/www/docs/en/dev/config_ref/images.md +++ b/www/docs/en/dev/config_ref/images.md @@ -110,12 +110,12 @@ Windows Phone8 <icon src="res/wp/Background.png" width="159" height="159" /> </platform> -Windows8 +Windows - <platform name="windows8"> - <icon src="res/windows8/logo.png" width="150" height="150" /> - <icon src="res/windows8/smalllogo.png" width="30" height="30" /> - <icon src="res/windows8/storelogo.png" width="50" height="50" /> + <platform name="windows"> + <icon src="res/windows/logo.png" width="150" height="150" /> + <icon src="res/windows/smalllogo.png" width="30" height="30" /> + <icon src="res/windows/storelogo.png" width="50" height="50" /> </platform> ## Configuring Splash Screens in the CLI @@ -159,15 +159,15 @@ You can name the source image whatever you like. The internal name in the app ar <splash src="res/screen/wp8/SplashScreenImage.jpg" width="768" height="1280"/> </platform> - <platform name="windows8"> + <platform name="windows"> <!-- images are determined by width and height. The following are supported --> - <splash src="res/screen/windows8/splashscreen.png" width="620" height="300"/> + <splash src="res/screen/windows/splashscreen.png" width="620" height="300"/> </platform> <platform name="blackberry10"> <!-- Add a rim:splash element for each resolution and locale you wish --> <!-- http://developer.blackberry.com/html5/documentation/rim_splash_element.html --> - <rim:splash src="res/screen/windows8/splashscreen.png"/> + <rim:splash src="res/screen/blackberry10/splashscreen.png"/> </platform> @@ -180,7 +180,7 @@ As of now (Cordova 3.5.0 July 2014) the following platforms support splash scree android ios wp8 - windows8 + windows blackberry10 # Splashscreen Plugin http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3cb404e4/www/docs/en/dev/guide/appdev/hooks/index.md ---------------------------------------------------------------------- diff --git a/www/docs/en/dev/guide/appdev/hooks/index.md b/www/docs/en/dev/guide/appdev/hooks/index.md index 4396adb..4c8d453 100644 --- a/www/docs/en/dev/guide/appdev/hooks/index.md +++ b/www/docs/en/dev/guide/appdev/hooks/index.md @@ -101,10 +101,10 @@ Hooks can be defined in project's `config.xml` using `<hook>` elements, for exam ... </platform> - <platform name="windows8"> - <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.bat" /> - <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.js" /> - <hook type="before_plugin_install" src="scripts/windows8/appWin8BeforePluginInstall.js" /> + <platform name="windows"> + <hook type="before_build" src="scripts/windows/appWinBeforeBuild.bat" /> + <hook type="before_build" src="scripts/windows/appWinBeforeBuild.js" /> + <hook type="before_plugin_install" src="scripts/windows/appWinBeforePluginInstall.js" /> ... </platform> http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3cb404e4/www/docs/en/dev/guide/platforms/index.md ---------------------------------------------------------------------- diff --git a/www/docs/en/dev/guide/platforms/index.md b/www/docs/en/dev/guide/platforms/index.md index e88a6fe..9ccc7c2 100644 --- a/www/docs/en/dev/guide/platforms/index.md +++ b/www/docs/en/dev/guide/platforms/index.md @@ -82,4 +82,4 @@ a lower-level alternative to the `cordova` command-line utility. * [Windows Platform Guide](win8/index.html) * [Windows Plugins](win8/plugin.html) * [Windows Packaging](win8/packaging.html) -* [Upgrading Windows 8](win8/upgrade.html) +* [Upgrading Windows](win8/upgrade.html) http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3cb404e4/www/docs/en/dev/guide/platforms/win8/index.md ---------------------------------------------------------------------- diff --git a/www/docs/en/dev/guide/platforms/win8/index.md b/www/docs/en/dev/guide/platforms/win8/index.md index 214869f..911317e 100644 --- a/www/docs/en/dev/guide/platforms/win8/index.md +++ b/www/docs/en/dev/guide/platforms/win8/index.md @@ -23,7 +23,7 @@ title: Windows Platform Guide # Windows Platform Guide This guide shows how to set up your SDK development environment to build -and deploy Cordova apps for Windows 8, Windows 8.1, Windows Phone 8.1, and +and deploy Cordova apps for Windows 8.1, Windows Phone 8.1, and Windows 10 Universal App Platform. It shows how to use either shell tools to generate and build apps, or the cross-platform Cordova CLI discussed in [The Command-Line Interface](../../cli/index.html). (See the [Overview](../../overview/index.html) for a comparison of these @@ -31,14 +31,14 @@ development options.) This section also shows how to modify Cordova apps within Visual Studio. Regardless of which approach you take, you need to install the Visual Studio SDK, as described below. -See [Upgrading Windows 8](upgrade.html) for information on how to upgrade existing -Windows 8 Cordova projects. +See [Upgrading Windows](upgrade.html) for information on how to upgrade existing +Windows Cordova projects. Window Phone 8 (wp8) stays as a separate platform, see [Windows Phone 8 Platform Guide](../wp8/index.html) for details. -Cordova WebViews running on Windows rely on Internet Explorer 10 (Windows 8.0) -and Internet Explorer 11 (Windows 8.1 and Windows Phone 8.1) as +Cordova WebViews running on Windows rely on Internet Explorer 11 +(Windows 8.1 and Windows Phone 8.1) as their rendering engine, so as a practical matter you can use IE's powerful debugger to test any web content that doesn't invoke Cordova APIs. The Windows Phone Developer Blog provides @@ -49,40 +49,26 @@ on how to support IE along with comparable WebKit browsers. To develop apps for Windows platform you need: -- A Windows 8.1, 32 or 64-bit machine (_Home_, _Pro_, or _Enterprise_ editions) with minimum 4 GB of RAM. - -- Windows 8.0, 8.1 or 10, 32 or 64-bit _Home_, _Pro_, or _Enterprise_ - editions, along with - [Visual Studio 2012 Express](http://www.visualstudio.com/downloads) - or Visual Studio 2013. Visual Studio 2015 is not able to build Windows 8.0 apps. - -To develop apps for Windows 8.0 and 8.1 (including Windows Phone 8.1): - -- Windows 8.1 or Windows 10, 32 or 64-bit _Home_, _Pro_, or _Enterprise_ editions, - along with - [Visual Studio 2013 Express](http://www.visualstudio.com/downloads) - or higher. An evaluation version of Windows 8.1 Enterprise is +- A Windows 8.1, 32 or 64-bit machine (_Home_, _Pro_, or _Enterprise_ editions) + with minimum 4 GB of RAM along with [Visual Studio 2015](http://www.visualstudio.com/downloads) + or Visual Studio 2013. An evaluation version of Windows 8.1 Enterprise is available from the - [Microsoft Developer Network](http://msdn.microsoft.com/en-US/evalcenter/jj554510). + [Microsoft Developer Network](https://technet.microsoft.com/evalcenter/hh699156.aspx). - For the Windows Phone emulators, Windows 8.1 (x64) Professional edition or higher, and a processor that supports <a href='https://msdn.microsoft.com/en-us/library/windows/apps/ff626524(v=vs.105).aspx#hyperv'>Client Hyper-V and Second Level Address Translation (SLAT)</a>. -An evaluation version of Windows 8.1 Enterprise is available from the -[Microsoft Developer Network](http://msdn.microsoft.com/en-US/evalcenter/jj554510). - -- [Visual Studio 2013 for Windows](http://www.visualstudio.com/downloads/download-visual-studio-vs#d-express-windows-8) (Express or higher). To develop apps for Windows 10: -- Windows 8.1 or Windows 10 Technical Preview 2, 32- or 64-bit, along with - [Visual Studio 2015 RC](http://www.visualstudio.com/preview) or higher. +- Windows 8.1 or Windows 10, 32- or 64-bit, along with + [Visual Studio 2015](http://www.visualstudio.com/downloads) or higher. App compatibility is determined by the OS that the app targeted. Apps are forwardly-compatible -but not backwardly-compatible, so an app targeting Windows 8.1 cannot run on 8.0, but -an app built for 8.0 can run on 8.1. +but not backwardly-compatible, so an app targeting Windows 10 cannot run on 8.1, but +an app built for 8.1 can run on 10. Follow the instructions at -[windowsstore.com](http://www.windowsstore.com/) +[developer.windows.com](https://developer.windows.com/) to submit the app to Windows Store. To develop Cordova apps for Windows, you may use a PC running @@ -147,7 +133,7 @@ Here's the corresponding lower-level shell-tool approach: C:\path\to\cordova-windows\package\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld -This project targets Windows 8.1 as the default target OS. You can choose to target 8.0 or 10.0 (see "Configure target Windows version" below) for all builds, or you target specific a particular version during each build. +This project targets Windows 8.1 as the default target OS. You can choose to target 10.0 (see "Configure target Windows version" below) for all builds, or you target specific a particular version during each build. ## Build the Project @@ -172,14 +158,14 @@ next `build`: ## Configure target Windows version -By default `build` command produces two packages: Windows 8.0 and Windows Phone 8.1. -To upgrade Windows package to version 8.1 the following configuration setting must be +By default `build` command produces two packages: Windows 8.1 and Windows Phone 8.1. +To upgrade Windows package to version 10 the following configuration setting must be added to configuration file (`config.xml`). - <preference name="windows-target-version" value="8.1" /> + <preference name="windows-target-version" value="10.0" /> -Once you add this setting `build` command will start producing Windows 8.1 -and Windows Phone 8.1 packages. +Once you add this setting `build` command will start producing Windows 10 packages. For more information about Windows 10, look at +the [Cordova for Windows 10](win10-support.html) documentation. ### The --appx parameter @@ -197,7 +183,7 @@ Windows 10 supports a new "Remote" mode for Cordova apps (and HTML apps in gener apps much more freedom with respect to use of DOM manipulation and common web patterns such as the use of inline script, but does so by reducing the set of capabilities your app may use when submitted to the public Windows Store. For more information about Windows 10 and Remote Mode, look at -the [Cordova for Windows 10](win10-support.md.html) documentation. +the [Cordova for Windows 10](win10-support.html) documentation. When using Remote Mode, developers are encouraged to apply a Content Security Policy (CSP) to their application to prevent script injection attacks. @@ -244,7 +230,7 @@ deploy the app: With __Local Machine__ selected, press the green arrow to install the app on the same machine running Visual Studio. Once you do so, the app -appears in Windows 8's app listings: +appears in Windows' app listings:  http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3cb404e4/www/docs/en/dev/guide/platforms/win8/upgrade.md ---------------------------------------------------------------------- diff --git a/www/docs/en/dev/guide/platforms/win8/upgrade.md b/www/docs/en/dev/guide/platforms/win8/upgrade.md index 06dd39a..a189c04 100644 --- a/www/docs/en/dev/guide/platforms/win8/upgrade.md +++ b/www/docs/en/dev/guide/platforms/win8/upgrade.md @@ -17,9 +17,18 @@ license: > specific language governing permissions and limitations under the License. -title: Upgrading Windows 8 +title: Upgrading Windows --- +# Upgrading Windows + +Run `cordova platform update windows`. + +For projects not created with the cordova CLI, run: + + bin\update <project_path> + + # Upgrading Windows 8 This guide shows how to modify Windows 8 projects to upgrade from older versions of Cordova. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3cb404e4/www/docs/en/dev/guide/platforms/win8/win10-support.md ---------------------------------------------------------------------- diff --git a/www/docs/en/dev/guide/platforms/win8/win10-support.md b/www/docs/en/dev/guide/platforms/win8/win10-support.md index ee04287..abb5b1b 100644 --- a/www/docs/en/dev/guide/platforms/win8/win10-support.md +++ b/www/docs/en/dev/guide/platforms/win8/win10-support.md @@ -37,7 +37,7 @@ be built. They will require Windows 10 at a minimum. ### Understanding Remote Mode vs. Local Mode ### Remote Mode is a new feature of the HTML Applications for Windows platform in Windows 10. In -Windows 8 and 8.1, HTML Applications worked in what is called "Local Mode" in Windows 10. In +Windows 8.1, HTML Applications worked in what is called "Local Mode" in Windows 10. In Local Mode, HTML Applications have full access to the native Windows API surface and capabilities. In order to prevent script injection attacks which could result in leaking personally-identifiable information due to malicious code, Local Mode disallows inline script, @@ -82,8 +82,6 @@ app package to target. - `10.0`, `UAP`: Builds for Windows 10 Universal App Platform - `8.1`: Builds for Windows 8.1 or Windows Phone 8.1 -- `8.0`: Build for Windows 8.0. Not valid for Windows Phone (use the **wp8** Cordova -platform instead) **Scenarios** @@ -103,7 +101,7 @@ elements with remote URIs. **Valid Values** -- `ms-appx://` (Default for Windows 8.0, 8.1): The start page runs in the local context +- `ms-appx://` (Default for Windows 8.1): The start page runs in the local context - `ms-appx-web://` (Default for Windows 10): The start page runs in the remote context #### {SDK}-MinVersion, {SDK}-MaxVersionTested #### http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3cb404e4/www/docs/en/dev/guide/support/index.md ---------------------------------------------------------------------- diff --git a/www/docs/en/dev/guide/support/index.md b/www/docs/en/dev/guide/support/index.md index 24dc32b..a6285c4 100644 --- a/www/docs/en/dev/guide/support/index.md +++ b/www/docs/en/dev/guide/support/index.md @@ -40,7 +40,7 @@ CLI's shorthand names. <th>ios</th> <th>Ubuntu</th> <th>wp8<br/>(Windows Phone 8)</th> - <th>windows<br/>(8.0, 8.1, 10,<br/>Phone 8.1)</th> + <th>windows<br/>(8.1, 10,<br/>Phone 8.1)</th> </tr> </thead> http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3cb404e4/www/docs/en/dev/plugin_ref/spec.md ---------------------------------------------------------------------- diff --git a/www/docs/en/dev/plugin_ref/spec.md b/www/docs/en/dev/plugin_ref/spec.md index c9e2591..a61a480 100644 --- a/www/docs/en/dev/plugin_ref/spec.md +++ b/www/docs/en/dev/plugin_ref/spec.md @@ -102,7 +102,7 @@ Here's a list of the default engines that the `<engine>` tag supports: * `cordova-ios` * `cordova-blackberry10` * `cordova-wp8` -* `cordova-windows8` +* `cordova-windows` * `android-sdk` // returns the highest Android api level installed * `apple-xcode` // returns the xcode version * `apple-ios` // returns the highest iOS version installed @@ -348,7 +348,7 @@ chosen, are listed: * blackberry10 * ios * wp8 -* windows8 +* windows ## _source-file_ Element --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
