- Platform Support
- The Command-Line Interface
- Platform Guides
- Using Plugman to Manage Plugins
- The config.xml File
- Icons and Splash Screens
- Embedding WebViews
- Plugin Development Guide
- Privacy Guide
- Whitelist Guide
Windows Phone 7 Platform Guide
This guide shows how to set up your SDK development environment to deploy Cordova apps for Windows Phone 7 devices. Apps also run on Windows Phone 8 devices using the same APIs, but version 7 lacks some of IE10's advanced features available on Windows Phone 8. Windows Phone 8 apps do not run on Windows Phone 7 devices.
See the following for more detailed platform-specific information that applies to both versions:
The command-line tools above refer to versions prior to Cordova 3.0. See The Command-Line Interface for information about the current interface.
Use Windows 7 or Windows 8 (Pro) or Windows Vista with SP2. The 64-bit version (x64) of Windows is required for the SDK. The Pro version is recommended for running a device emulator.
Register and pay for a Windows Phone Dev Center account if you want to install an app on a real device or submit it to Market Place.
NOTE: Running the SDK in Virtual Machine may present challenges. Read Windows Phone on a Mac for insights on developing solutions.
Install SDK and Cordova
Download and install the Windows Phone SDK.
Download and extract the latest copy of
Cordova. You need to work in the
contains the Windwos Phone 8 version of Cordova.
CordovaWP7_x_x_x.zip file to the
Studio 2012\Templates\ProjectTemplates\ directory.
Building the Template
NOTE: Skip this step if the
lib\windows-phone directory already
To simplify development, Cordova bundles a script to build Visual Studio templates. These allow you to rapidly generate Cordova apps, and you can modify them if necessary. The steps below show how to generate it.
Run the Batch File to Create and Install the Templates
The root of the repo contains a
Double-clicking this file generates two
CordovaWP8_x_x_x.zip, where 3.3.0 is
the current version number. To use these files easily in Visual
Studio, copy them to the
My Documents\Visual Studio
2012\Templates\ProjectTemplates\ subdirectory. You are then able to
create new Apache Cordova Windows Phone_ apps from Visual Studio's
__File → New Project menu.
If you run the batch file from the command line, you can also call with a parameter to install automatically:
Set up a New Project
Open Visual Studio Express for Windows Phone and choose New Project.
Select CordovaWP7. The version number displays in the template description.
Give the project a name, and select OK.
Review the Project Structure
www directory features
and any other resources the app requires.
Any additional content needs to be a part of the Visual Studio
project, and it must be set as content.
The following sample structure represents a 2.3.0 project, but may vary depending on installed version:
Build the Project for the Device
Before testing your application on a device, the device must be registered. Consult [Microsoft's documentation](http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx) for details on how to deploy and test on Windows Phone 7. These are the basic steps:
Make sure your phone is connected, and the screen is unlocked.
In Visual Studio, select Device from the drop-down menu at the top.
Press the green play button next to the main drop-down menu to start debugging, or else type F5.
At this point, you're done.