CB-1679 Getting started with Windows Store apps, CB-1675 'alert' stack glitch
Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/7fc38436 Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/7fc38436 Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/7fc38436 Branch: refs/heads/master Commit: 7fc3843623ac115cabace332f2a70d90c6f4adfc Parents: 032bbb2 Author: Matthew Baxter-Reynolds (@mbrit) <mb...@mbrit.com> Authored: Tue Oct 23 08:07:37 2012 +0100 Committer: Matthew Baxter-Reynolds (@mbrit) <mb...@mbrit.com> Committed: Tue Oct 23 08:07:37 2012 +0100 ---------------------------------------------------------------------- docs/en/edge/guide/getting-started/index.md | 1 + .../edge/guide/getting-started/windows-8/index.md | 104 +++++++++++++++ .../guide/getting-started/windows-8/wsalert.png | Bin 0 -> 44166 bytes .../getting-started/windows-8/wschangemanifest.png | Bin 0 -> 112224 bytes .../getting-started/windows-8/wsnewproject.png | Bin 0 -> 189370 bytes 5 files changed, 105 insertions(+), 0 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/7fc38436/docs/en/edge/guide/getting-started/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/index.md b/docs/en/edge/guide/getting-started/index.md index 66b0b97..a4f8748 100644 --- a/docs/en/edge/guide/getting-started/index.md +++ b/docs/en/edge/guide/getting-started/index.md @@ -26,5 +26,6 @@ Getting Started Guides - Getting Started with Symbian - Getting Started with WebOS - Getting Started with Windows Phone +- Getting Started with Windows 8 - Getting Started with Bada - Getting Started with Tizen http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/7fc38436/docs/en/edge/guide/getting-started/windows-8/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/windows-8/index.md b/docs/en/edge/guide/getting-started/windows-8/index.md new file mode 100644 index 0000000..598f5e0 --- /dev/null +++ b/docs/en/edge/guide/getting-started/windows-8/index.md @@ -0,0 +1,104 @@ +--- +license: Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +--- + +Getting Started with Windows 8 +================================== + +This guide describes how to set up your development environment for Cordova and run a sample application. Note that Cordova used to be called PhoneGap, so some of the sites still use the old PhoneGap name. + +During development of Windows 8 and Windows RT, Microsoft deprecated the name "Metro-style apps". On MSDN, this type of app is now called a "Windows Store" app. That's the name that we'll use in this guide. Also in this guide whenever we refer to Windows 8, you should take that to mean both Windows 8 and Windows RT. + +1. Requirements +--------------- + +- Windows 8 + +- Visual Studio 2012 Professional or better, or Visual Studio 2012 Express for Windows 8 + +Follow the instructions [here](http://www.windowsstore.com/) to submit your apps Windows Store. + +2. Install SDK + Cordova +---------------------------- + +- Setup your preferred variant of Visual Studio 2012. All of the paid versions of the product (Professional, etc) let you build Windows Store apps. To build Windows Store apps using the [Express editions](http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products), you will need **Express for Windows 8**. +- Download the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the subfolder **lib\windows-8**. + +3. Setup New Project +-------------------- + +You can already build Windows 8 apps using the "HTML/JavaScript track" available in Windows Store apps. The purpose of Cordova in Windows Store apps is to expose the same APIs used on all the other Cordova platforms. + +- Open Visual Studio 2012 and choose **New Project**. +- Select **Installed - Template - Other Languages - JavaScript - Windows Store** from the tree, and then **Blank App** from the projects list. Enter whatever project name you like. We're using **CordovaWin8Foo** in this guide. + +  + +- Microsoft continues to use **default.html** as the default page for use in websites, whereas most "open web" developers use **index.html**. (Plus it's likely that in the other platform variants of your project you are using **index.html** as the name of your default page.) To fix this, in Solution Explorer rename the **default.html** file to **index.html**. Then double-click the **package.appxmanifest** file and change the **Start page** value to **index.html**. + +  + +- To include **cordova.js** in your project, right-click on the **js** folder in Solution Explorer and select **Add - New Item**. Locate the **corvoda.js** file in the **lib\windows-8** folder that we called out previously. + +- Edit the code for **index.html**. Add a reference to **cordova.js**. You can do this manually, or by dragging the file from Solution Explorer. + +### Adding the reference... + <!-- WinJS references --> + <link href="//Microsoft.WinJS.1.0/css/ui-dark.css" rel="stylesheet" /> + <script src="//Microsoft.WinJS.1.0/js/base.js"></script> + <script src="//Microsoft.WinJS.1.0/js/ui.js"></script> + + <!-- Cordova --> + <script src="/js/cordova.js"></script> + + <!-- CordovaWin8Foo references --> + <link href="/css/default.css" rel="stylesheet" /> + <script src="/js/default.js"></script> + +- Next we want to add some code that will demonstrate that Cordova is working. + +### Adding a 'deviceready' handler... + <body> + <p>Content goes here</p> + + <script type="text/javascript"> + + console.log("Subscribing..."); + document.addEventListener("deviceready", function () { + + navigator.notification.alert("The device is ready!"); + + }); + + </script> + + </body> + + +5. Test the Project +------------------------------- + +- Run the project from Visual Studio. You'll see the message box appear. + +  + +Done! +----- + +That's it! You're now ready to build Windows Store apps with Cordova. + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/7fc38436/template/docs/default/img/guide/getting-started/windows-8/wsalert.png ---------------------------------------------------------------------- diff --git a/template/docs/default/img/guide/getting-started/windows-8/wsalert.png b/template/docs/default/img/guide/getting-started/windows-8/wsalert.png new file mode 100755 index 0000000..9680e53 Binary files /dev/null and b/template/docs/default/img/guide/getting-started/windows-8/wsalert.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/7fc38436/template/docs/default/img/guide/getting-started/windows-8/wschangemanifest.png ---------------------------------------------------------------------- diff --git a/template/docs/default/img/guide/getting-started/windows-8/wschangemanifest.png b/template/docs/default/img/guide/getting-started/windows-8/wschangemanifest.png new file mode 100755 index 0000000..1dd67da Binary files /dev/null and b/template/docs/default/img/guide/getting-started/windows-8/wschangemanifest.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/7fc38436/template/docs/default/img/guide/getting-started/windows-8/wsnewproject.png ---------------------------------------------------------------------- diff --git a/template/docs/default/img/guide/getting-started/windows-8/wsnewproject.png b/template/docs/default/img/guide/getting-started/windows-8/wsnewproject.png new file mode 100755 index 0000000..8e1df69 Binary files /dev/null and b/template/docs/default/img/guide/getting-started/windows-8/wsnewproject.png differ
