Add Getting Started Guides from phonegap.com/start
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/36be3a55 Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/36be3a55 Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/36be3a55 Branch: refs/heads/master Commit: 36be3a5576a6fe7ff04bf2fabce256396fc768c5 Parents: 53fef6b Author: Yohei Shimomae <yohei.shimo...@nitobi.com> Authored: Wed Jan 18 18:07:11 2012 -0800 Committer: Fil Maj <filip....@nitobi.com> Committed: Fri Jan 27 16:38:38 2012 -0800 ---------------------------------------------------------------------- .../guide/getting-started/android/img/javaSrc.jpg | Bin 0 -> 72706 bytes .../guide/getting-started/android/img/manifest.jpg | Bin 0 -> 247181 bytes .../android/img/new_android_project.jpeg | Bin 0 -> 62485 bytes .../en/edge/guide/getting-started/android/index.md | 111 +++++++++++++++ .../edge/guide/getting-started/blackberry/index.md | 63 ++++++++ docs/en/edge/guide/getting-started/index.md | 9 ++ .../getting-started/ios/img/HelloWorldiPhone4.png | Bin 0 -> 101624 bytes .../getting-started/ios/img/XCode4-templates.png | Bin 0 -> 207971 bytes .../edge/guide/getting-started/ios/img/project.jpg | Bin 0 -> 39552 bytes .../ios/img/xcode4-name_your_app.png | Bin 0 -> 186383 bytes docs/en/edge/guide/getting-started/ios/index.md | 75 ++++++++++ .../en/edge/guide/getting-started/symbian/index.md | 58 ++++++++ docs/en/edge/guide/getting-started/webos/index.md | 58 ++++++++ .../windows-phone/img/wp7projectstructure.PNG | Bin 0 -> 22436 bytes .../getting-started/windows-phone/img/wpd.png | Bin 0 -> 1964 bytes .../windows-phone/img/wpfirstrun.PNG | Bin 0 -> 114030 bytes .../windows-phone/img/wpnewproj.PNG | Bin 0 -> 87470 bytes .../getting-started/windows-phone/img/wprun.png | Bin 0 -> 63091 bytes .../guide/getting-started/windows-phone/index.md | 76 ++++++++++ 19 files changed, 450 insertions(+), 0 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/android/img/javaSrc.jpg ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/android/img/javaSrc.jpg b/docs/en/edge/guide/getting-started/android/img/javaSrc.jpg new file mode 100644 index 0000000..4e1bebf Binary files /dev/null and b/docs/en/edge/guide/getting-started/android/img/javaSrc.jpg differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/android/img/manifest.jpg ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/android/img/manifest.jpg b/docs/en/edge/guide/getting-started/android/img/manifest.jpg new file mode 100644 index 0000000..1e25330 Binary files /dev/null and b/docs/en/edge/guide/getting-started/android/img/manifest.jpg differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/android/img/new_android_project.jpeg ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/android/img/new_android_project.jpeg b/docs/en/edge/guide/getting-started/android/img/new_android_project.jpeg new file mode 100644 index 0000000..20bc29d Binary files /dev/null and b/docs/en/edge/guide/getting-started/android/img/new_android_project.jpeg differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/android/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/android/index.md b/docs/en/edge/guide/getting-started/android/index.md new file mode 100644 index 0000000..317ced5 --- /dev/null +++ b/docs/en/edge/guide/getting-started/android/index.md @@ -0,0 +1,111 @@ +Getting Started with Android +============================ + + +Video Tutorials: +---------------- + +- [PhoneGap and Android Quick Start Video Using Ecliplse](http://www.youtube.com/v/MzcIcyBYJMA?autoplay=1) + + +1. Requirements +--------------- + +- Eclipse 3.4+ + +There is also a [Terminal](http://wiki.phonegap.com/w/page/30864168/phonegap-android-terminal-quickstart) of this tutorial that doesn't use Eclipse. + + +2. Install SDK + PhoneGap +---------------------------- + +- Download and install [Eclipse Classic](http://www.eclipse.org/downloads/) +- Download and install [Android SDK](http://developer.android.com/sdk/index.html) +- Download and install [ADT Plugin](http://developer.android.com/sdk/eclipse-adt.html#installing) +- Donwload the latest copy of [PhoneGap](http://phonegap.com/download) and extract its contents. We will be working with the Android directory. + + 3. Setup New Project +----------------------- + +- Launch Eclipse, then under the menu select **New > Android Project** + +  +- In the root directory of the project, create two new directories: + - **/libs** + - **guides/images/www** +- Copy **phonegap.js** from your PhoneGap download earlier to **guides/images/www** +- Copy **phonegap.jar** from your PhoneGap download earlier to **/libs** +- Copy **xml** folder from your PhoneGap download earlier to **/res** +- Make a few adjustments too the project's main Java file found in the **src** folder in Eclipse: (view image below) + - Change the class's extend from **Activity** to **DroidGap** + - Replace the **setContentView()** line with **super.loadUrl("file:///android_asset/www/index.html");** + - Add **import com.phonegap.*;** + - Remove **import android.app.Activity;** + +  +- You might experience an error here, where Eclipse can't find phonegap-1.0.0.jar. In this case, right click on the /libs folder and go to Build Paths/ > Configure Build Paths. Then, in the Libraries tab, add phonegap-1.0.0.jar to the Project. If Eclipse is being temperamental, you might need to refresh (F5) the project once again. +- Right click on AndroidManifest.xml and select **Open With > Text Editor** +- Paste the following permissions under versionName: (view image below) + + <supports-screens android:largeScreens="true" android:normalScreens="true" android:smallScreens="true" android:resizeable="true" android:anyDensity="true" /> + <uses-permission android:name="android.permission.CAMERA" /> + <uses-permission android:name="android.permission.VIBRATE" /> + <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> + <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> + <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" /> + <uses-permission android:name="android.permission.READ_PHONE_STATE" /> + <uses-permission android:name="android.permission.INTERNET" /> + <uses-permission android:name="android.permission.RECEIVE_SMS" /> + <uses-permission android:name="android.permission.RECORD_AUDIO" /> + <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> + <uses-permission android:name="android.permission.READ_CONTACTS" /> + <uses-permission android:name="android.permission.WRITE_CONTACTS" /> + <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> + <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.GET_ACCOUNTS" /> + <uses-permission android:name="android.permission.BROADCAST_STICKY" /> + +- Add `android:configChanges="orientation|keyboardHidden"` to the activity tag in AndroidManifest. (view image below) +- Add a second activity under you appliction tag in AndroidManifest. (view image below) + + <activity android:name="com.phonegap.DroidGap" android:label="@string/app_name" android:configChanges="orientation|keyboardHidden"> <intent-filter> </intent-filter> </activity> + +  + +4. Hello World +-------------- + +Now create and open a new file named **index.html** in the **guides/images/www** directory. Paste the following code: + + <!DOCTYPE HTML> + <html> + <head> + <title>PhoneGap</title> + <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> + </head> + <body> + <h1>Hello World</h1> + </body> + </html> + + *phonegap.js might need to be replaced with phonegap.<VERSION NUMER>.js + + +5A. Deploy to Simulator +----------------------- + +- Right click the project and go to **Run As** and click **Android Application** +- Eclipse will ask you to select an appropriate AVD. If there isn't one, then you'll need to create it. + + +5B. Deploy to Device +-------------------- + +- Make sure USB debugging is enabled on your device and plug it into your system. (Settings > Applications > Development) +- Right click the project and go to **Run As** and click **Android Application** + + +Done! +----- + +You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/30862722/phonegap-android-eclipse-quickstart). + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/blackberry/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/blackberry/index.md b/docs/en/edge/guide/getting-started/blackberry/index.md new file mode 100644 index 0000000..dd7a67b --- /dev/null +++ b/docs/en/edge/guide/getting-started/blackberry/index.md @@ -0,0 +1,63 @@ +Getting Started with Blackberry +============================ + + +Video Tutorials: +---------------- + +- [PhoneGap and BlackBerry Widgets uick Start Video](http://www.youtube.com/v/eF0h0K0OLwI?autoplay=1) + + + +1. Requirements +--------------- + +- Windows XP (32-bit) or Windows 7 (32-bit and 64-bit) or Mac OSX 10.6.4+ + +For 4.x devices check out [this guide](http://wiki.phonegap.com/w/page/25653281/Getting%20Started%20with%20PhoneGap-BlackBerry%20with%20the%20Latest%20Environment). + + +2. Install SDK + PhoneGap +------------------------- + +- (Windows Only) Download and install [SUN JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html#jdk) (32-Bit Version). Add it to your PATH variable. +- (Windows Only) Download and extract [Apache Ant](http://ant.apache.org/bindownload.cgi). Add it to your PATH variable. +- Download [BlackBerry WebWorks Smartphone SDK](ttps://bdsc.webapps.blackberry.com/html5/download/sdk) for BlackBerry development and/or [BlackBerry WebWorks Tablet OS SDK](https://bdsc.webapps.blackberry.com/html5/download/sdk) for Playbook development. Keep note of the directories you install these SDKs. +- Donwload the latest copy of [PhoneGap](http://phonegap.com/download) and extract its contents. We will be working with the Android directory. + + +3. Setup New Project +-------------------- + +- Open up a command prompt/terminal and navigate to where you extracted PhoneGap. CD into the PhoneGapBlackBerry directory. +- Create a PhoneGap BlackBerry and PlayBook project. Type 'ant create -Dproject.path='followed by the location you wish to create your project into the command prompt/terminal. +- Change to the newly created directory located at `C:\Dev\bbw\sample`. +- Open up the project.properties file with your favourite editor and change the lines `BlackBerry.bbwp.dir=` and `PlayBook.bbwp.dir=` to equal the respective install locations of the SDKs you downloaded earlier. + + +4. Hello World +-------------- + +Build the PhoneGap sample project by typing `ant target build` in your command prompt/terminal while you are in your project's directory. Replace the target with either blackberry or playbook. Note this is the sample PhoneGap project and not a basic hello world application. You can go edit the index.html file located in the www directory of your project to make it say Hello World if you wish. + + +5A. Deploy to Simulator (Windows Only) +-------------------------------------- + +- While in your project directory, in command prompt/terminal type `ant target load-simulator`. Replace the target with either blackberry or playbook. +- Press the BlackBerry button on the simulator, go to downloads and you should see your app loaded there. + + +5B. Deploy to Device (Windows and Mac) +-------------------------------------- + +- You have to have your signing keys from RIM by filling out this [form](https://www.blackberry.com/SignedKeys/). +- While in your project directory, in command prompt/terminal type `ant target load-device`. Replace the target with either blackberry or playbook. +- Press the BlackBerry button on the simulator, go to downloads and you should see your app loaded there. + + +Done! +----- + +You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/31930982/Getting-Started-with-PhoneGap-BlackBerry-WebWorks). + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/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 new file mode 100644 index 0000000..54621ef --- /dev/null +++ b/docs/en/edge/guide/getting-started/index.md @@ -0,0 +1,9 @@ +Getting Started with PhoneGap +============================= + +- Android +- Blackberry +- iOS +- Symbian +- WebOS +- Windows Phone \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/ios/img/HelloWorldiPhone4.png ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/ios/img/HelloWorldiPhone4.png b/docs/en/edge/guide/getting-started/ios/img/HelloWorldiPhone4.png new file mode 100644 index 0000000..25c22d8 Binary files /dev/null and b/docs/en/edge/guide/getting-started/ios/img/HelloWorldiPhone4.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/ios/img/XCode4-templates.png ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/ios/img/XCode4-templates.png b/docs/en/edge/guide/getting-started/ios/img/XCode4-templates.png new file mode 100644 index 0000000..33b0fa9 Binary files /dev/null and b/docs/en/edge/guide/getting-started/ios/img/XCode4-templates.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/ios/img/project.jpg ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/ios/img/project.jpg b/docs/en/edge/guide/getting-started/ios/img/project.jpg new file mode 100644 index 0000000..3fe062e Binary files /dev/null and b/docs/en/edge/guide/getting-started/ios/img/project.jpg differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/ios/img/xcode4-name_your_app.png ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/ios/img/xcode4-name_your_app.png b/docs/en/edge/guide/getting-started/ios/img/xcode4-name_your_app.png new file mode 100644 index 0000000..4d5bad3 Binary files /dev/null and b/docs/en/edge/guide/getting-started/ios/img/xcode4-name_your_app.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/ios/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/ios/index.md b/docs/en/edge/guide/getting-started/ios/index.md new file mode 100644 index 0000000..21198b3 --- /dev/null +++ b/docs/en/edge/guide/getting-started/ios/index.md @@ -0,0 +1,75 @@ +Getting Started with iOS +======================== + + +Video Tutorials: +---------------- + +- [PhoneGap Installer - Xcode 4 Template](http://www.youtube.com/v/R9zktJUN7AI?autoplay=1) + + +1. Requirements +--------------- +- Intel-based computer with Mac OS X Snow Leopard (10.6) +- Necessary for Installing on Device: + - An Apple iOS device (iPhone, iPad, iPod Touch) + - iOS developer certification + + +2. Install SDK + PhoneGap +------------------------- + +- Download and install Xcode from [Apple Developer Portal](http://developer.apple.com) (Membership required)</p> +- Donwload the latest copy of [PhoneGap](http://phonegap.com/download) and extract its contents. We will be working with the Android directory. + + +3. Setup New Project +-------------------- + +- Launch Xcode, then under the File menu select **New** and then **New Project...** +- Select **PhoneGap-based Application** from the list of templates + +  +- Select the **Next** button, Fill in the "Product Name" & "Company Identifier" for your app + +  + +- Choose a directory to store your app +- You should see your project in Xcode 4 now. Press the **Run** button in the top left corner. Your build should succeed and launch in the simulator +- You should see a error in your simulator informing you index.html was not found +- To fix this, we need to copy the **www** directory into the project. Right click on the project in the left navigation window and click show in finder +- In Finder, you should see the **www** directory beside your project +- Next step is **IMPORTANT**! Drag the **www** folder into Xcode 4. You can't just drag the www folder into your app's folder. It needs to be dragged into Xcode 4!! In my case I would drag it and drop it on HiWorld shown below. + +  +- After you drag, you should see a prompt with a few options. Make sure to select **Create folder references for any added folders**. Click Finish + + +4. Hello World +-------------- + +Open the folder named **www** and type `<h1>Hello World</h1>` after the `<body>` tag in **index.html**. You can also add any associated Javascript and CSS files there as well. + + +5A. Deploy to Simulator +----------------------- + +- Make sure to change the Active SDK in the top left menu to **Simulator+version#**. +- Hit **Run** in your project window header. + + +5B. Deploy to Device +-------------------- + +- Open [AppName]-Info.plist and change **BundleIdentifier** to the identifier provided by Apple. If you have a developer license, you can access and run the Assistant at [here](http://developer.apple.com/iphone/manage/overview/index.action) and register your App. +- Make sure to change the Active SDK in the top left menu to **Device+version#**. +- Hit **Run** in your project window header. + +  + + +Done! +----- + +You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/39991939/Getting-Started-with-PhoneGap-iOS-using-Xcode-4-%28Template-Version%29). + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/symbian/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/symbian/index.md b/docs/en/edge/guide/getting-started/symbian/index.md new file mode 100644 index 0000000..448c1f7 --- /dev/null +++ b/docs/en/edge/guide/getting-started/symbian/index.md @@ -0,0 +1,58 @@ +Getting Started with Symbian +============================ + + +Video Tutorials: +---------------- + +- [PhoneGap Installer - Xcode 4 Template](http://www.youtube.com/v/R9zktJUN7AI?autoplay=1) + + +1. Requirements +--------------- + +- Windows, OS X, or Linux + +There are also [QT for Symbian](http://wiki.phonegap.com/w/page/16494811/PhoneGap-Symbian-%28Qt%29) and [Symbian with Sony Ericsson](http://wiki.phonegap.com/w/page/16494782/Getting-Started-with-PhoneGap-Symbian-(WRT-on-Sony-Ericsson)) guides. + + +2. Install SDK + PhoneGap +------------------------- + +- Download and install [cygwin](http://www.cygwin.com/setup.exe) (Windows only). Make sure you select "make" as it is not included by default +- Donwload the latest copy of [PhoneGap](http://phonegap.com/download) and extract its contents. We will be working with the Android directory. + + +3. Setup New Project +-------------------- + +- In cygwin, navigate to where you extracted PhoneGap and go into the Symbian directory</li> + + +4. Hello World +-------------- + +- Open up index.html located in phonegap/symbian/framework/www with your favourite editor. +- In the `body` tag, remove the line `"Build your phonegap app here! Dude!"` and add the line `<h1>Hello World</h1>` +- In cygwin/terminal, type make. This will produce phonegap-symbian.wrt/app.wgz. + + +5A. Deploy to Simulator +----------------------- + +- For Mac or Linux you should install [Aptana Studio](http://www.aptana.org/products/studio2/download) and [Nokia WRT Plug-in for Aptana Studio](http://www.forum.nokia.com/info/sw.nokia.com/id/00d62bd8-4214-4c86-b608-5f11b94dad54/Nokia_WRT_Plug_in_for_Aptana_Studio.html). This has a browser-based javascript emulator +- For Windows you can download the [S60 SDK](http://www.forum.nokia.com/info/sw.nokia.com/id/ec866fab-4b76-49f6-b5a5-af0631419e9c/S60_All_in_One_SDKs.html) which includes the S60 Emulator +- Load the phonegap-symbian.wrt/app.wgz file into the emulator. + + +5B. Deploy to Device +-------------------- + +- Load the phonegap-symbian.wrt/app.wgz file into the device using bluetooth or email. + + +Done! +----- + +You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/16494780/Getting-Started-with-Phonegap-Nokia-WRT). + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/webos/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/webos/index.md b/docs/en/edge/guide/getting-started/webos/index.md new file mode 100644 index 0000000..059763c --- /dev/null +++ b/docs/en/edge/guide/getting-started/webos/index.md @@ -0,0 +1,58 @@ +Getting Started with WebOS +========================== + + +Video Tutorials: +---------------- + +- [PhoneGapPhoneGap and HP Palm webOS quick start video](http://www.youtube.com/v/XEnAUbDRZfw?autoplay=1) +- [How to convert iPhone app to a Palm](http://www.youtube.com/v/wWoJfQw79XI?autoplay=1) + + +1. Requirements +--------------- + +- Windows, OS X, or Linux + + +2. Install SDK + PhoneGap +---------------------------- + +- Download and install [Virtual Box](http://www.virtualbox.org/) +- Download and install [WebOS SDK](http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1788&Itemid=321/) +- Download and install [cygwin SDK](http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1788&Itemid=321) (Windows only). Make sure you select "make" as it is not included by default +- Donwload the latest copy of [PhoneGap](http://phonegap.com/download) and extract its contents. We will be working with the Android directory. + + + +3. Setup New Project +-------------------- + +- Open up terminal/cygwin and navigate to where you extracted your PhoneGap Download. Go into the webOS directory. + + +4. Hello World +-------------- + +In phonegap/webOS/framework/www, open up index.html with your favourite editor. After the body tag add `<h1>Hello World</h1>` + + +5A. Deploy to Simulator +----------------------- + +- Open up your Palm Emulator from your applications folder/start menu. +- Type `make` in your terminal/cygwin while in the webOS directory. + + +5B. Deploy to Device +-------------------- + +- Make sure your device is in [Developer Mode and plug it in.](http://developer.palm.com/index.php?option=com_content&view=article&id=1552&Itemid=59#dev_mode) +- Type `make` in your terminal/cygwin while in the webOS directory. + + +Done! +----- + +You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/16494781/Getting-Started-with-PhoneGap-webOS). + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/windows-phone/img/wp7projectstructure.PNG ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/windows-phone/img/wp7projectstructure.PNG b/docs/en/edge/guide/getting-started/windows-phone/img/wp7projectstructure.PNG new file mode 100644 index 0000000..0c7d42d Binary files /dev/null and b/docs/en/edge/guide/getting-started/windows-phone/img/wp7projectstructure.PNG differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/windows-phone/img/wpd.png ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/windows-phone/img/wpd.png b/docs/en/edge/guide/getting-started/windows-phone/img/wpd.png new file mode 100644 index 0000000..0a0b2db Binary files /dev/null and b/docs/en/edge/guide/getting-started/windows-phone/img/wpd.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/windows-phone/img/wpfirstrun.PNG ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/windows-phone/img/wpfirstrun.PNG b/docs/en/edge/guide/getting-started/windows-phone/img/wpfirstrun.PNG new file mode 100644 index 0000000..8a82ec6 Binary files /dev/null and b/docs/en/edge/guide/getting-started/windows-phone/img/wpfirstrun.PNG differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/windows-phone/img/wpnewproj.PNG ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/windows-phone/img/wpnewproj.PNG b/docs/en/edge/guide/getting-started/windows-phone/img/wpnewproj.PNG new file mode 100644 index 0000000..ed2f143 Binary files /dev/null and b/docs/en/edge/guide/getting-started/windows-phone/img/wpnewproj.PNG differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/windows-phone/img/wprun.png ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/windows-phone/img/wprun.png b/docs/en/edge/guide/getting-started/windows-phone/img/wprun.png new file mode 100644 index 0000000..ce67de9 Binary files /dev/null and b/docs/en/edge/guide/getting-started/windows-phone/img/wprun.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/36be3a55/docs/en/edge/guide/getting-started/windows-phone/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/getting-started/windows-phone/index.md b/docs/en/edge/guide/getting-started/windows-phone/index.md new file mode 100644 index 0000000..8f381d2 --- /dev/null +++ b/docs/en/edge/guide/getting-started/windows-phone/index.md @@ -0,0 +1,76 @@ +Getting Started with Windows Phone +================================== + + +Video Tutorials: +---------------- + +- [PhoneGap and Windows Phone quick setup video](http://www.youtube.com/v/wO9xdRcNHIM?autoplay=1) +- [PhoneGap and Windows Phone deep dive](http://www.youtube.com/v/BJFX1GRUXj8?autoplay=1) + + +1. Requirements +--------------- + +- Windows 7 or Windows Vista with SP2 + +Note: Running in VM has issues, if you are on a Mac, you will need to setup a bootcamp partition with Windows 7 or Vista + +Necessary for Installing on Device and Submitting to Market Place: + +- Become an [App Hub member](http://create.msdn.com/en-US/home/membership). + + +2. Install SDK + PhoneGap +---------------------------- + +- Download and install [Windows Phone SDK](http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=27570/) +- Donwload the latest copy of [PhoneGap](http://phonegap.com/download) and extract its contents. We will be working with the Android directory. + + +3. Setup New Project +-------------------- + +- Open Visual Studio Express for Windows Phone and choose **New Project**. +- Select **PhoneGapStarter**. +- Give your project a name, and select OK. + +  + + +4. Review the project structure +------------------------------- + +- The 'www' folder contains your PhoneGap html/js/css and any other resources included in your app. +- Any content that you add here needs to be a part of the Visual Studio project, and it must be set as content. + +  + + +5. Build and Deploy to Emulator +------------------------------- + +- Make sure to have **Windows Phone Emulator** selected in the top drop-down menu. +- Hit the green **play button** beside the Windows Phone Emulator drop-down menu to start debugging or press F5. + +  +  + + +6. Build your project for the device +------------------------------------ + +In order to test your application on a device, the device must be registered. Click [here](http://msdn.microsoft.com/en-us/library/gg588378(v=VS.92).aspx) to read documentation on deploying and testing on your Windows Phone. + +- Make sure your phone is connected, and the screen is unlocked +- In Visual Studio, select 'Windows Phone Device' from the top drop-down menu. +- Hit the green **play button** beside the drop-down menu to start debugging or press F5. + +  + + +Done! +----- + +You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/48672055/Getting%20Started%20with%20PhoneGap%20Windows%20Phone%207). +
