Windows Store app test cases

[ This article is for Windows 8.x and Windows Phone 8.x developers writing Windows Runtime apps. If you’re developing for Windows 10, see the latest documentation ]

Here's a set of test cases that you can use to test your app before you submit it to the Windows Store. Use these cases along with the guidance in Debugging and testing either to supplement your existing test process or to develop a new one.

Note  These test cases support app functionality that meets the latest Windows and Windows Phone Store Policies. Make sure to align any of your own test cases to those requirements whenever possible.

 

Use the links in the panel to the right to jump to the feature area that's relevant to your app. Identify the test cases that best apply to your app based on how it uses specific features, and then use the provided examples and resources to develop your own test routines.

A quick note on additional UX design testing

A complete functional review to check for critical bugs is an important step in completing the development of your app; you can't close the book on all user-experience (UX) concerns during the design phase. You have to implement some elements of your app design before you can see how they contribute to the user experience.

For examples of what to test for, see App UX test cases, a companion to the UX design checklist.

Store certification

Test case	Details
Your app meets Windows Store app certification requirements.	Review the Windows and Windows Phone Store Policies and see if your app meets all applicable criteria prior to its final submission to the Windows Store.
Your app passes self-testing using the Windows App Certification Kit .	First, download the Windows App Certification Kit for the appropriate platform version (Windows 8 or Windows RT). Next, test your app using the kit as described in Using the Windows App Certification Kit.
Your app starts within five seconds.	Your app can display a splash image while loading at Start, but the first app screen should still render within five seconds to support a responsive user experience. Example test Start your app. Verify that the first screen is rendered within the five seconds after start.

 

Functionality and core scenarios

Test case	Details
Your app fully implements all advertised features and functionality.	Example test Start your app. Test all primary features and functionality. Observed behavior should match expectations initially set for your users.
Your app supports primary orientation scenarios.	The behavior of your app should be consistent when responding to orientation changes. Your app should not display a blank screen, blank tiles, or empty white rectangles. Your app should maintain context. For example, your app should be in same state as it was in when the screen was locked and device orientation was changed. If the user was watching a video when the orientation changed, playback should continue after the change. Example test Start your app in landscape orientation. Lock the screen. Change the orientation of the device. Unlock the screen. Repeat for portrait orientation. For more info, see Guidelines for layouts.
Your app uses the correct navigation UI element to move from any page back to the app homepage.	The primary method of navigation back to the app home page should be accomplished using the provided app bar button. Example test Start your app Go to any second-level page. Navigate back to the app home page using the Home button on the app bar. For more info, see Navigation patterns.

 

User input

Test case	Details
Your app does not hide user input controls when the on-screen keyboard is in use, or as a result of changes to page dimensions after switching between portrait and landscape orientation.	User input, such as buttons or other text boxes, should not be obscured by the on-screen keyboard or as a result of orientation changes. Example test Start your app. Place a focus within a text box. Observe the placement of UI elements with the on-screen keyboard active. Observe the placement of UI elements when your app transitions between portrait and landscape orientation with and without the on-screen keyboard. Where applicable, repeat the previous steps for other app pages. For more info, see Guidelines for layouts.
Your app is fully functional using all supported input types.	The user experience should be consistent in quality across primary control methods supported by Windows 8. Example test Start your app. Test app features with touch. Test app features with mouse and keyboard. Test content containers (for example, lists and grids) to see if the mouse wheel allows content scrolling. Test for basic keystroke navigation. Responding to user interaction (JavaScript and HTML or C#/VB/C++ and XAML)
Your app disables a user-input element until the last interaction with that element has been processed.	After the user interacts with a UI element (for example, a button), that element should be disabled if the operation that it initiates requires completion before another call is made (for instance, a sign-in to a remote service). Example test Start your app. Observe the app's response to actions like tapping or clicking a button several times in succession. Depending on the complexity of the operation that the UI element represents, these conditions can result in your app crashing. Responding to user interaction (JavaScript and HTML or C#/VB/C++ and XAML)
Your app implements the provided app bars correctly.	If commands on the app bar are vital to the screen or further navigation, they should appear on the canvas. Example test Start your app. Verify that both the top and bottom app bars are transient. Observe whether swiping up or down from the bottom or top of a touch display, right-clicks on the canvas, or selects items for which there are associated actions in the app bar results in the app bar appearing. Ensure that the app bars are not blank. Verify that taps or clicks made anywhere on the canvas dismiss the app bars. Repeat these tests for each app page. Note   Your app should not display the app bar programmatically.   Note   Your app should not display app bar if there is nothing to show in it.   For more info, see Guidelines and checklist for app bars (JavaScript and HTML or C#/VB/C++ and XAML)

 

Connectivity

Test case	Details
Your app behaves normally in environments where network connectivity isn't reliable.	Your app provides a relevant connectivity error message to the user when a connection is lost or reestablished. Example test Confirm that the device has a working connection. Start your app. While your app is running, close the network connection. Continue using your app. Make sure to test functionality that requires connectivity. Note   One option for scenarios where connections aren't available is for your app to operate in an offline mode without alerting the user.
Your app behaves normally in airplane mode.	Example test Turn airplane mode on. Start your app. Perform an action that will cause a connection attempt. Test when on-connected on first run of the app and on subsequent app sessions.

 

Content interaction

Test case	Details
Your app uses appropriate list-box interactions.	Items in a list-box element should change text color, but should not be active if there are no actions currently associated with the selection. Example test Start your app. Find a list of objects that the user can tap to transition to a different page. Select one of the objects on a page by tapping. Select one of the objects on a page by swiping down or using right-click.
Your app does not trigger an action while a scrolling control is in use.	Ensure that items within a grid or scroll viewer are not triggered accidentally by events on their container controls. Example test Start your app. Go to a page that uses a grid layout. Pan the grid in quick swipes on the area over a child control. If the grid reacts by scrolling, the child control should not be triggered. Repeat the previous steps on any app page that displays content with a scroll bar. For more info, see Guidelines for panning.
Your app does not trigger an action if the user moves across a scrolling control grid populated with thumbnails.	When using touch to swipe left and right (to browse through thumbnails presented on a grid), the content moves left or right without activating a thumbnail. Example test Place a finger on one of the thumbnails on a grid and drag the content sideways to swipe. After the swipe, lift the finger. Observe to see if the thumbnail is activated. Repeat the previous steps any app page that displays a grid populated with thumbnails. For more info, see Guidelines for panning.
Your app supports hover feedback (a mouse scenario).	When the mouse cursor is placed over an item in a list or grid, the item shows a highlight. Example test Start your app. Hover over various content items with the mouse cursor. Repeat the previous step on any app page that displays content with a scroll bar.
Your app items are not selected automatically.	Go through all pages in your app and verify that each item, especially the first item on a page, is not selected by default when the page loads or when page contents are refreshed by clicking the Refresh button on the app bar. Example test Start your app Go through each page and observe app behavior.

 

Performance and stability

Test case	Details
Your app successfully resumes from a suspended state.	The app should resume from the suspended state successfully. Your app must not crash on resume, and user must be able to continue using your app. We recommend that your app resume at the same page it was on before the app was suspended, and with its UI in a similar state. For example, text entered by a user before app suspension is still present after the app resumes. Example test Start your app. Take steps to get your app into a state in which data is being presented. Suspend the app (for example, press the power button on the device). Wait a few seconds for the device to go into a low power state. Press the power button to turn the device back on. Bring up your app and confirm that its state was persisted. Note   If your run the app from Microsoft Visual Studio, app suspend and app termination can be achieved via buttons on the app bar. The suspend the application command from Visual Studio can also be used with any Windows 8 app by attaching to the process from Visual Studio via the Debug->Attach to process menu command.   For more info, see Guidelines for app suspend and resume.
Your app demonstrates smooth and fluid page transitions.	Verify that animations and transitions are smooth and fluid. This includes things like page animations or object animations. The overall quality of this experience is most important in highly visible areas like the app home page and any other page where a user is most likely spend a lot of time using the app. For more info, see Animating your UI with the Animation Library and Stand out with styling and animation in your Windows Store app.
Your app provides clear and concise process feedback to the user.	Your app must appear responsive at all times. If content is slow to load, the app should indicate to the user that the action is in progress by displaying progress notifications via UI elements. Example test Start your app Carry out operations or request content that meet the conditions required to trigger any progress indicators (for example, a progress bar) that you have implemented to inform the user. Note   Some pages may rely on online content that takes time to load. The best practice is to navigate quickly to the page, then display a progress control as the content loads.
Your app does not crash.	Record in detail any crashes you encounter during app testing and resolve them before you submit the app to the Windows Store. Example test Carefully document steps so that a crash can be reproduced later. Track a count of distinct crashes as your testing process continues. (For example, the app crashed three times during start-up and five times while the user was buying an item.) Develop processes for debugging these crashes, using your records.
Your app manages memory consumption effectively.	If memory usage continues to increase as your app is being used, and doesn't show indications of a decrease, there is a chance that there is a memory leak. Example test Start your app. Start Task Manager to observe app memory usage. Complete one or more usage scenarios to verify memory consumption (for example, go to and back from several app pages).
Your app uses an appropriate amount of CPU resources while idle.	When idle your app shouldn't consume an inappropriate amount of CPU resources. You can use Task Manager (preferably tm.exe to taskmgr.exe) to test CPU usage. Example test Start your app and allow it time to load the content. Go to a few different pages and let the app settle down. Verify that your app does not consume an unexpectedly high amount of CPU resources while idle. (For example, start Task Manager and observe your app's resource usage.) Note   Ideally, when an app is idle, it consumes 0% of CPU resources.
Your app uses appropriate methods of data caching.	Your app should use app data caching appropriately to avoid delays in loading content or excessive use of a network connection.

 

Games

Test case	Details
Your game app can save the current game state if the app is suspended.	Game-state info should persist through app suspension. This includes info like the screen state, the score, level progress, and number of lives. Example test Start your game and start playing. Play the game for a while and observe the current game state (such as score, screen state, items, and level progress.) Suspend the game and return to it. (To do this, press the power button on the device and wait 10 seconds, and then press the power button again to wake the device. Start the game. Observe whether game state has been restored. For more info, see Application lifecycle.
Your game makes global settings available through the Settings charm.	Games often have interactive controls for global settings on the canvas and this is acceptable as long as the same commands are also in the Settings charm. Example test Start your game. Use the Settings charm to display settings. Confirm that global app settings are provided. For more info, see Guidelines for app settings.
Your game app's audio effects and music don't play while the app is in the background.	The game's sound effects and media aren't playing while the game is in the background. Example test Start your game Switch to an app that doesn't use sound or music and leave the game in the background. Verify that the game's audio cannot be heard. Return to the game and verify that the sound effects and music resume. For more info, see Playing and previewing audio and video.
Your game app allows music from an app in the background to play in place of the game music.	You can play the game and listen to music from an app in the background. The GameEffects sounds are heard, but the GameMedia sounds are not. Example test Start playing music in an app that's capable of playing music while in the background. Start a game with GameEffects and GameMedia sounds. Note   Reinforce this behavior by adding the correct msAudioCategory tag to your audio element.   For more info, see Playing and previewing audio and video.

 

Contracts and extensions

Test case	Details
Your app uses the Share contract correctly.	If your app is a Share source, the content that it shares should be both meaningful and relevant. If your app is a Share target, the content preview should be rich and accurate. Example test Start your app. Verify that your app supports sharing as a source. If your app is a Share source, attempt to share content from your app. If app is a Share target, Start another app and share content to your app. For more info, see App contracts and extensions.
Your app uses the Search contract correctly.	If your app offers search, it should provide accurate search results that closely match results expected by the user for the initial query. If necessary, your app should provide additional methods of result filtering. If no results are returned, the Search panel should display a clear and concise message. Example test Verify that your app supports searching content within the app. Access the Search charm. (On the keyboard, press Windows Logo key + Q) Type a search query that's context relevant to what your app provides (for example, if you're testing a news app, type in a news topic). Select your app on the search panel. Confirm that your app opens and displays search results. Verify that search results are displayed and that: You can view and browse results. You can open specific results. You app indicates why a result matches the query. You can navigate back to the previous page after looking at the details for a result. Your app provides additional search behavior recommendations. Verify that white space in query strings is handled properly by entering a query string that begins with white space. For more info, see App contracts and extensions.
Contracts and extensions	Your app should provide contract functionality such as Search and Share only where appropriate. Example test Review your app's AppxManifest file to determine which contracts or extensions are implemented. Do this in Visual Studio by using the Store->Edit App Manifest command. Next, refer to App contracts and extensions when creating basic test scenarios for verifying the quality of each experience. Note   Avoid declaring contracts and extensions that enable functionality that your app doesn't actually implement.   For more info, see App contracts and extensions.
Your app uses the Settings charm correctly.	Your app should provide the capability to adjust settings specific to the app using the Settings charm. Example test Start your app. Verify that Settings flyout disappears when the user touches anywhere on the screen outside of the surface. Verify that your app reflects changes to a setting immediately. Verify that a new setting value is applied as soon as the user stops interacting with a particular setting control. Verify that the Settings flyout doesn't include a button to commit changes. Verify that recommended Settings flyouts are in use. A Settings flyout should be narrow (346 pixels) or wide (646 pixels), and should have a header that includes a back button, the name of the entry point that opened the flyout, and the app icon. Note   Handle the beforeshow and afterhide events to do control initialization and state serialization.   For more info, see Guidelines for app settings.
Your app provides users with control over the behavior of web-based file transfers created using the background transfer feature.	Confirm that control of a background transfer operation and indication of its progress are being relayed to the user. Example test Start your app Confirm that the user is provided with controls required to construct and initiate background transfers. Confirm that a transfer begins when the control to begin a transfer is used. Confirm that there is a UI element that displays transfer progress info. Confirm that there is a way to cancel a transfer that's in progress. Confirm that the a transfer is canceled when the user indicates that it should be. Confirm that canceled transfers no longer appear in any UI elements used to track in-progress transfers.
Your app uses push notifications correctly to keep the user informed.	Your app should use push notifications where appropriate. A push notification demonstrates itself to user via a toast notification or a tile change (in text, a number, or a picture) in the Windows 8 Start experience. Example test Start your app. Begin app activities that are known to elicit push notifications. Verify that notifications can be tapped or clicked for additional info. Review notifications for meaning and usefulness. Verify that notifications dismiss themselves after a period of time, if they're not interacted with. Verify that your app supports notifications for both small and wide tiles (where a wide tile is supported). For more info, see Push notifications.
Your app provides a way to manage scheduled notifications.	Example test Start your app. Look for a way to check any future scheduled notifications. Look for a way to delete future scheduled notifications. Note   This test applies only to apps that use Scheduled Notifications. (for example, alarms or reminders).   For more info, see Scheduled Notifications.

 

Language and localization

Test case	Details
Your app displays accurate info for all regional setting requirements.	Regional info displayed by your app should align to the regional formatting selected by the current user. Example test Change the device region and language settings to a configuration supported by the app. Restart the device. Start your app. View as many UI elements as possible. Repeat for each supported region and language configuration.
Your app provides error messages that are contextual, user friendly, and not generic.	Error messages should very clearly define what the error was and what next steps are required. Make sure that your app does not display empty pages. In situations where content is not available to display on a page, provide appropriate error or help text to the user. Example test Start your app. Conduct usage exercises that result in an error message. Review the content of each message. Note   Error messages must not contain any code details or stack traces.
Your app provides accurate platform and app descriptors where applicable.	Any references to the platform should correctly reference Windows 8, and the app should reference itself accurately. Example test Start your app. Access the Settings charm. Read any disclaimers, EULAs, or About text. Check links to external websites that contain app info.
Your app is fully localized to all languages it claims to support.	Verify that all strings have changed (are localized) and no hard-coded strings are present in the app. Confirm that all strings are completely visible and are not truncated. Example test Change the region and language settings on the test device to a supported configuration for the app (for example, countries/regions where the app will be available). Restart the device. Start your app. View as many UI elements as possible. Check links to external websites, which may contain legal info that has not been localized.
Your app UI uses appropriate font types and sizes.	To make your app readable and appear consistent with broader Windows 8 design principles, confirm the use of the following font types and sizes: Use Segoe UI (the primary Windows typeface) for UI elements such as buttons and date pickers. Use Calibri for text that the user both reads and writes, such as email and chat. Use Cambria for larger blocks of text, such as for a magazine or RSS reader. For more info, see Guidelines for fonts.

 

Audio and video

Test case	Details
Your app continues music playback while in the background.	If you develop a music app, it should enable users to listen to music while they work in other apps on the device. Example test Start playing music in your app. Transition your app to the background. Start an app that doesn't use sound or music, leaving the app you're testing in the background. Observe background playback capabilities. For more info, see Playing and previewing audio and video.
Your app correctly adjusts music playback volume for the duration of a voice call.	If your music app is capable of playback while in the background, it should decrease playback volume, or pause music playback, for the duration of a voice call started in another app. Example test Start music playback in your app. Transition your app to the background. Start any VoIP-enabled app. Initiate or receive a voice call. Observe audio levels of the music playback. Note   Reinforce this behavior by adding the correct msAudioCategory tag to your audio element.   For more info, see Playing and previewing audio and video.
Your Voice over IP (VoIP)-enabled app maintains normal volume levels for the duration of a voice call.	This test case example is specific to the playback volume of a voice call when an app in the background is playing music. While the app in the background needs to lower the music playback volume, your Voice over IP (VoIP)-enabled app keeps audio levels normal during voice calls. Example test Start any music app and start playing music. Transition the music app to the background. Start your app. Start a voice call and observe volume levels. Note   Reinforce this behavior by adding the correct msAudioCategory tag to your audio element.   For more info, see Playing and previewing audio and video.
Your app enables the user to adjust audio playback volume using the volume control.	Your app should provide audio controls that allow the user to affect playback progress and volume levels. However, if the app doesn't support this functionality, the buttons should be disabled. Example test Start your app. Begin audio playback. Adjust the volume control. Use next and previous track controls. For more info, see Playing and previewing audio and video.