cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From purplecabb...@apache.org
Subject [4/4] docs commit: CB-1679 Getting started with Windows Store apps, CB-1675 'alert' stack glitch
Date Wed, 24 Oct 2012 19:47:06 GMT
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) <mbrit@mbrit.com>
Authored: Tue Oct 23 08:07:37 2012 +0100
Committer: Matthew Baxter-Reynolds (@mbrit) <mbrit@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.
+
+    ![](img/guide/getting-started/windows-8/wsnewproject.PNG)
+
+- 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**. 
+
+	![](img/guide/getting-started/windows-8/wschangemanifest.PNG)
+
+- 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.
+
+	![](img/guide/getting-started/windows-8/wsalert.PNG)
+
+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


Mime
View raw message