App submission requirements for Windows Phone

August 19, 2014

Applies to Windows Phone

The following requirements are validated during the submission process. The process involves the checking of the metadata and the validating of the packages that you upload.

The assembly and data files must be packaged as an XAP file package or as an AppX file package. Visual Studio generates the necessary package and manifest files.

Requirement

Requirement Text

4.1.1 - List of Package Requirements

XAP Packages

The XAP package must contain the following:

  • A valid Windows Phone app manifest file, named WMAppManifest.xml. For more information, see App manifest file for Windows Phone 8.

  • The Title attribute in the App element in the WMAppManifest.xml file must contain the app title. The Title attribute must not be empty. The Application title entered in Step 2 of the submission process to Store and the title displayed on the phone must be the same.

  • A valid .NET app manifest file, named AppManifest.xaml. This requirement only applies for apps that do not have the RuntimeType attribute set to Modern Native in the app manifest file. For more information about the RuntimeType attribute and the app manifest file, see App manifest file for Windows Phone 8.

  • The assembly files as specified in the AppManifest.xaml file.

  • For Windows Phone 8 

    Support for at least one supported screen resolution. For more information, see Multi-resolution apps for Windows Phone 8.

The maximum size of the XAP package file is 1 GB.

AppX packages and bundles

  1. The AppX package must pass the tests included in the Windows App Certification Kit (WACK).

  2. The published display name in the package must match the publisher display name in the Dev Center. The publisher display name in the package must not be localized when the app is localized.

  3. Only one <Application> entry can be declared in a package manifest under <Package><Applications>.

  4. Only one app package can be included in a bundle. For more information about bundles, see App packaging.

  5. Additional requirements for AppX packages are listed in App packages and deployment.

The maximum allowed size of an AppX package or bundle is 4 GB.

Requirement

Requirement Text

4.2.1

You must develop your app using the documented APIs that are supported on the Windows Phone app platform for the OS version that your app is targeting. For more information, see the Windows Phone API reference.

For more information about app compatibility for all Windows Phone OS versions, see Windows Phone versions.

4.2.2

For Windows Phone OS 7.1 

Apps that target Windows Phone OS 7.1 must not invoke native code APIs by using PInvoke or COM interoperability.

For Windows Phone 8 

Apps that target Windows Phone 8 must not invoke native code APIs other than the APIs listed at Win32 and COM API for Windows Phone 8.

For Windows Phone 8.1 

Apps that target Windows Phone 8.1 must not invoke native code APIs other than the APIs listed at Win32 and COM for Windows Store apps.

4.2.3

The app must be compiled using retail configuration instead of debug. The app must not contain debugging symbols or output.

4.2.4

The app must not redistribute the Windows Phone assemblies. However, you can re-distribute panorama, pivot, and map assemblies.

Every app is targeted to publish to at least one specific geographic market and language. You can target multiple markets and submit your app in multiple languages. The language detection process includes the evaluation of the metadata that is used to describe the app and the UI text that is used within the app.

See Culture and language support for Windows Phone for a full list of supported languages in Windows Phone.

Requirement

Requirement Text

Test Steps

4.4 - Language validation

An app must be localized in at least one of the supported display languages for Windows Phone. For a full list of supported display languages, see Culture and language support for Windows Phone.

For Windows Phone OS 7.1 

A Windows Phone app will fail this requirement if a Neutral Language is not set. For more information on how to localize your app and how to set a Neutral Language, see How to build a localized app for Windows Phone 8.

For Windows Phone 8 and Windows Phone 8.1 

A Windows Phone app will fail this requirement if a Default Language is not set.

Requirement

Requirement Text

Test Steps

4.6 - App Screenshots

For each app, you must provide at least one or up to a maximum of eight screenshots for each supported screen resolution. Users see these screenshots in the details page of the catalog before they make a purchase.

  • Screenshots must only contain app graphics, and must not include any emulator chrome, frame rate counters or debug information.

  • Each screenshot must match the supported resolution size. For more information about supporting different screen resolutions, see Guidelines for supporting multiple screen sizes.

  • Screenshots must not be transparent PNG files.

  • You must not submit screenshots that are photos of the app while it runs on a phone or on the emulator. Use the built-in emulator screenshot tool to take the screenshots for your app instead.

For more information about how to use the built-in emulator screenshot tool, see How to create screenshots for the Store for Windows Phone 8.

  1. Locate the app screenshot files.

  2. Verify that each screenshot shows a direct capture of the phone screen or emulator when the app was running.

  3. Verify that each screenshot does not contain emulator chrome.

  4. Verify that each screenshot matches its supported resolution size, and is a non-transparent PNG file.

Requirement

Requirement Text

Test Steps

4.7.1 - Applicable app images

The following app images must be representative of the app:

  • Default Tile images, found in the package. For more information about Tiles, see Tiles, badges, and notifications.

  • App list image, found in the package.

  • Windows Phone Store app image, submitted on Dev Center.

  1. View the App list.

  2. Verify that the App list image is representative of the app.

  3. From the App list, tap and hold the App list image and select pin to start.

  4. Verify that the default Tile image on the Start screen is representative of the app.

  5. If applicable, resize the default Tile and verify that the Tile image is representative of the app.

4.7.2 - Required app images in the package

The following app images must be included in your app's package when you submit it to the Windows Phone Store:

For Windows Phone OS 7.1 

App list image: a 62 x 62 pixel PNG image.

Default Tile image: a PNG image for the medium Tile size.

For Windows Phone 8 

App list image: a 99 x 99 pixel PNG image.

Default Tile image: a PNG or JPEG image for the medium and small Tile sizes. The image dimensions depend on the Tile template you’ve chosen for your default Tile. For more information, see Tiles for Windows Phone 8.

For Windows Phone 8.1 

For Windows Phone Silverlight 8.1 apps that use MPN as the push notification mechanism, see Tiles for Windows Phone 8.

For Windows Phone Silverlight 8.1 apps that use WNS as the push notification mechanism, see Tile and tile notification overview.

For Windows Runtime apps, see Tile and tile notification overview.

  1. Locate the App list image.

  2. Verify that the image meets the required criteria.

  3. Locate the app Tile image or images.

  4. Verify that the image or images meet the required criteria.

4.7.3 - Required Windows Phone Store submission images

The following app images must be submitted during the submission process for the Windows Phone Store:

Windows Phone Store app image

  • A 300 x 300 pixel, non-transparent PNG image.

  1. Locate the image files that you plan to submit with your app.

  2. Verify that all applicable images are included in the submission, are the right dimensions and are in non-transparent PNG format.

Show:
© 2014 Microsoft