cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ste...@apache.org
Subject [4/9] docs commit: CB-8823 Ensure Windows Platform Guide is actual
Date Wed, 22 Apr 2015 19:09:50 GMT
CB-8823 Ensure Windows Platform Guide is actual

* Removed separate intallation instructions for Windows 8.0 only support
* Added information how to list available deploy targets


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/39dfc3f4
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/39dfc3f4
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/39dfc3f4

Branch: refs/heads/master
Commit: 39dfc3f429764b329a6eb5a67dcc5a4839db1cd5
Parents: a9a64cd
Author: sgrebnov <v-segreb@microsoft.com>
Authored: Mon Apr 13 10:00:13 2015 -0700
Committer: sgrebnov <v-segreb@microsoft.com>
Committed: Sat Apr 18 21:19:24 2015 -0700

----------------------------------------------------------------------
 docs/en/edge/guide/platforms/win8/index.md | 90 +++++++++++--------------
 1 file changed, 39 insertions(+), 51 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39dfc3f4/docs/en/edge/guide/platforms/win8/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/win8/index.md b/docs/en/edge/guide/platforms/win8/index.md
index 52ff85a..7de05b5 100644
--- a/docs/en/edge/guide/platforms/win8/index.md
+++ b/docs/en/edge/guide/platforms/win8/index.md
@@ -34,7 +34,7 @@ Windows 8 Cordova projects.
 Window Phone 8 (wp8) stays as a separate platform,
 see Windows Phone 8 Platform Guide for details.
 
-Cordova WebViews running on Windows rely on Internet Explorer 10 (Windows 8)
+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
 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
@@ -44,35 +44,24 @@ on how to support IE along with comparable WebKit browsers.
 
 ## Requirements and Support
 
-You need one of the following OS/SDK combinations, either from an
-installation disk or an _ISO_ disk image file.
+To develop apps for Windows platform you need:
 
-To develop apps for Windows 8.0 only:
+- A Windows 8.1, 32 or 64-bit machine (_Home_, _Pro_, or _Enterprise_ editions) with minimum
4 GB of RAM.
 
-- Windows 8.0 or 8.1, 32 or 64-bit _Home_, _Pro_, or _Enterprise_
-  editions, along with
-  [Visual Studio 2012 Express](http://www.visualstudio.com/downloads).
+- 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).
 
-To develop apps for all platforms (Windows 8.0, Windows 8.1 and Windows Phone 8.1):
-
-- Windows 8.1, 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
-  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).
 
 Apps compiled under Windows 8.1 do _not_ run under Windows 8.0. Apps
 compiled under Windows 8.0 are forward-compatible with 8.1.
 
-  <!-- 64-bit necessary? Pro necessary? ELSE still recommended for parallel WP dev -->
-
 Follow the instructions at
 [windowsstore.com](http://www.windowsstore.com/)
 to submit the app to Windows Store.
 
-  <!-- true? -->
-
 To develop Cordova apps for Windows, you may use a PC running
 Windows, but you may also develop on a Mac, either by running a
 virtual machine environment or by using Boot Camp to dual-boot a
@@ -84,22 +73,29 @@ Windows development environment on a Mac:
 - [Parallels Desktop](http://msdn.microsoft.com/en-US/library/windows/apps/jj945424),
   
 - [Boot Camp](http://msdn.microsoft.com/en-US/library/windows/apps/jj945423).
-  
+
+## Install the SDK
+
+Install the _Ultimate_, _Premium_, or _Professional_ 2013 editions of
+[Visual Studio](http://www.visualstudio.com/downloads/download-visual-studio-vs#d-express-windows-8).
+
+![](img/guide/platforms/win8/win8_installSDK.png)
+
 ## Using Cordova Shell Tools
 
 If you want to use Cordova's Windows-centered shell tools in
 conjunction with the SDK, you have two basic options:
 
 - Access them locally from project code generated by the CLI. They are
-  available in the `platforms/windows/cordova` directory after you add
+  available in the `platforms/windows/` directory after you add
   the `windows` platform as described below.
 
 - Download them from a separate distribution at
-  [cordova.apache.org](http://cordova.apache.org).  The Cordova
-  distribution contains separate archives for each platform.  Be sure
-  to expand the appropriate archive, `cordova-windows\windows` in
+  [cordova.apache.org](https://www.apache.org/dist/cordova/platforms/).
+  The Cordova  distribution contains separate archives for each platform.
+  Be sure to expand the appropriate archive, `cordova-windows` in
   this case, within an empty directory.  The relevant batch utilities
-  are available in the top-level `bin` directory. (Consult the
+  are available in `package/bin` directory. (Consult the
   __README__ file if necessary for more detailed directions.)
 
 These shell tools allow you to create, build, and run Windows apps.
@@ -107,29 +103,21 @@ For information on the additional command-line interface that enables
 plugin features across all platforms, see Using Plugman to Manage
 Plugins.
 
-## Install the SDK
-
-Install the _Ultimate_, _Premium_, or _Professional_ 2013 editions of
-[Visual Studio](http://www.visualstudio.com/downloads).
-
-![](img/guide/platforms/win8/win8_installSDK.png)
-
 ## Create a New Project
 
 At this point, to create a new project you can choose between the
 cross-platform CLI tool described in The Command-Line Interface, or
-the set of Windows-specific shell tools. From within a source-code
-directory, this CLI approach generates an app named _HelloWorld_
+the set of Windows-specific shell tools. 
+The CLI approach below generates an app named _HelloWorld_
 within a new `hello` project directory:
 
         > cordova create hello com.example.hello HelloWorld
         > cd hello
         > cordova platform add windows
-        > cordova build
 
 Here's the corresponding lower-level shell-tool approach:
 
-        C:\path\to\cordova-win\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+        C:\path\to\cordova-windows\package\bin\create.bat C:\path\to\new\hello com.example.hello
HelloWorld
 
 ## Build the Project
 
@@ -138,22 +126,14 @@ top-level `www` directory contains the source files. Run either of
 these within the project directory to rebuild the app:
 
         > cordova build
-        > cordova build windows   # do not rebuild other platforms
-
-Once you generate the project, the default app's source is available in the
-`projects\windows\www` subdirectory. Subsequent commands are available in
-the `cordova` subdirectory at the same level.
+        > cordova build windows              # do not rebuild other platforms
+        > cordova build windows   --debug    # generates debugging information
+        > cordova build windows   --release  # signs the apps for release
 
-The `build` command cleans project files and rebuilds the app.  The first
-example generates debugging information, and the second signs the apps
-for release:
+Here's the corresponding lower-level shell-tool approach:
 
         C:\path\to\project\cordova\build.bat --debug        
         C:\path\to\project\cordova\build.bat --release
-
-The `clean` command helps flush out directories in preparation for the
-next `build`:
-
         C:\path\to\project\cordova\clean.bat
 
 ## Configure target Windows version
@@ -169,15 +149,23 @@ and Windows Phone 8.1 packages.
 
 ## Deploy the app
 
+To deploy Windows package:
+
+        > cordova run windows -- --win  # explicitly specify Windows as deployment target
+        > cordova run windows # `run` uses Windows package by default
+
 To deploy Windows Phone package:
 
         > cordova run windows -- --phone  # deploy app to Windows Phone 8.1 emulator
         > cordova run windows --device -- --phone  # deploy app to connected device
 
-To deploy Windows package:
+You can use __cordova run windows --list__ to see all available targets and 
+__cordova run windows --target=target_name -- --phone__ to run application on a 
+specific device or emulator 
+(for example, `cordova run windows --target="Emulator 8.1 720P 4.7 inch" -- --phone`).
 
-        > cordova run windows -- --win  # explicitly specify Windows as deployment target
-        > cordova run windows # `run` uses Windows package by default
+You can also use __cordova run --help__ to see additional build and run
+options.
 
 ## Open the Project in the SDK and Deploy the App
 


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


Mime
View raw message