Cordova for Windows Phone 8 Build Options

The Intel® XDK "Cordova for Windows 8 Phone" build system automatically generates special configuration files in your project source directory to direct the build process. The Cordova build option is based on the open source Apache* Cordova CLI build system. When you use the Cordova build option your application project files are submitted to the Intel XDK build server where a Cordova CLI system is hosted and maintained, there is no need to install the open source Cordova CLI system on your workstation.

NOTE: starting with Intel XDK version 1199, the build configuration files are automatically generated based on input you provide on the Projects tab. A special intelxdk.config.wp8.xml file is automatically generated. The options described below can be used inside an intelxdk.config.additions.xml file to exercise finer grained control over the Projects tab and to control features that are not handled by the Projects tab.

The following build options pertain only to Windows Phone 8 builds. They will not affect builds for other target platforms. You can include these options in your intelxdk.config.additions.xml file when submitting a build, in order to either supplement or replace those options that are automatically generated by the Intel XDK.

For detailed information regarding the structure and contents of the intelxdk.config.additions.xml file, please read Understanding the Intel XDK Cordova Build File Options topic.

Windows Phone 8 Launch Icon Specifications

If no icon files are provided with your project, the build system will provide default icons. You must provide the Square, Small, and Store Logo icon sizes shown in bold in the table below, before submitting your application to the Windows Phone Store. The Wide Logo size is optional. If you do not provide unique icons with your app it is likely that your application will be rejected by Microsoft.

Beginning with Cordova CLI 5, icon images must be provided in PNG format, other image formats will result in build errors.

The height and width numbers in the table (below) are in pixels. The 100% scale image splash screen should be provided by you prior to submitting the application to the app store. See the app icons section of this Choosing your app images article for more information.

Target Width Height Scale
Square Logo 120 120 80% scale image
Square Logo* 150 150 100% scale image
Square Logo 210 210 140% scale image
Square Logo 270 270 180% scale image
Small Logo 24 24 80% scale image
Small Logo* 30 30 100% scale image
Small Logo 42 42 140% scale image
Small Logo 54 54 180% scale image
Store Logo* 50 50 100% scale image
Store Logo 70 70 140% scale image
Store Logo 90 90 180% scale image
Wide Logo 248 120 80% scale image
Wide Logo 310 150 100% scale image
Wide Logo 434 210 140% scale image
Wide Logo 558 270 180% scale image

* These icons must be included for submission to the Windows Phone store. All others are optional.

Windows Phone 8 Splash Screen Image Specifications

Your application will display a splash screen during initialization. This is done to provide a "getting ready" indication while your app and the underlying device API infrastructure initializes. If no splash files are provided with your project, the build system will provide default images. It is highly recommended that you replace the default splash screen images with your own before submitting your application to a store. See the app launch section of this Choosing your app images article for more information.

Beginning with Cordova CLI 5, splash screen images must be provided in PNG format, other image formats will result in build errors.

The height and width numbers in the table (below) are the required pixel sizes for the respective screens, only the size in bold is required. A launch image should be provided for each support device with your application.

Target Width Height Scale
Small* 620 300 100% scale image
Medium 868 420 140% scale image
Large 1116 540 100% scale image

* This splash screen must be included for submission to the Windows Phone store. All others are optional.

Windows Phone 8 Tile Image Specifications

Tile images are icons that appear on the main Start screen when you press the 'Windows' button or traditional home screen. Every app is required to have at least one default image for a Tile image that is used when you 'pin' an app from the App list. You can also have alternative Tiles that contain more valuable display information about the app, like weather, time, statistics, or current stock price. Any information a user might need at a glance. Refer to the app tile size and resolution section of this Tile Sizes and Resolutions article for more information.

Target Flip and Cycle Iconic
Small 159 x 159 110 x 110
Medium 336 x 336 202 x 202
Wide 691 x 336 N/A

Windows Phone 8 Build Preferences

windows-publisher-id
The publisher ID string, assigned by Microsoft, is unique and is the ID linked to your Windows Phone Store developer account when you submit your application to the Windows Store.
<preference name="windows-publisher-id" value="<PUBID>" />
<PUBID> is the publisher id assigned to you by Microsoft. (See the walkthrough to find your information on the Windows Dashboard). This identifies your account in the Windows Phone Store.
windows-publisher-display-name
The publisher display name is the author your applications are listed under in the Windows Store and the Windows Phone Store.
<preference name="windows-publisher-display-name" value="<DISPLAYNAME>" />
<DISPLAYNAME> represents the name under which your applications will be listed in the store. (See the walkthrough to find your information on the Windows Dashboard)
windows8-capability
Apps that need to access user resources like pictures, photos, contacts, etc., must state the appropriate capability in their application. Upon submission to the Windows Store, it is cross-checked to make sure the declared capabilities match the app description.
<preference name="windows8-capability" value="<CAPABILITY>" />
<CAPABILITY> is the permission identifier. The list of valid permissions may vary depending on the version of the operating system that is targeted. See the Windows 8 Capabilities on the MSDN site for valid values.


For more complete information about compiler optimizations, see our Optimization Notice.