Windows App Certification Kit

To get your app Windows Certified or prepare it for publication to the Microsoft Store, you should validate and test it locally first. This topic shows you how to install and run the Windows App Certification Kit to ensure your app is safe and efficient.

Prerequisites

Prerequisites for testing a Universal Windows app:

• You must install and run WindowsВ 10.
• You must install the Windows App Certification Kit, which is included in the Windows Software Development Kit (SDK) for WindowsВ 10.
• You must enable your device for development.
• You must deploy the Windows app that you want to test to your computer.

In-place upgrades: Installing a more recent Windows App Certification Kit will replace any previously installed version of the kit.

What’s new

Tests for Windows Desktop Bridge Apps are now supported in the kit. Windows Desktop Bridge app tests can give your app the best chance of being published on Microsoft Store or get certified.

The kit can now be integrated into an automated testing where no interactive user session is available.

The App Prelaunch Validation test is no longer supported.

Known issues

The following is a list of known issues with the Windows App Certification Kit:

During testing, if an installer terminates but leaves active processes or windows running, the app certification kit may detect that there is still work to be done by the installer. In this case, the kit appears stuck running the «Process Install Trace Files» task and it’s not possible to move forward with the UI.

Resolution: After your installer is complete, manually close any active processes or windows spawned by the installer.

For ARM UWA, or any UWA app that doesn’t target the device family desktop or OneCore, a message may appear in the final report that states «Not all tests were run during validation. This may impact your Store submission.». This message does not apply in cases where the user didn’t manually deselect tests.

Resolution: n/a

For Desktop Bridge Apps using Windows SDK Version 10.0.15063 please ignore any failures in Application Manifest Resources test that flag your image not confirming to the expected dimensions if those dimensions are only off by one pixel. The test is supposed to have a +/-1 pixel tolerance. E.g. A small tile at 125% would be 88.75×88.75px if rounded up to 89x89px this would fail the size restrictions of 88x88px.

Resolution: n/a

Validate your Windows app using the Windows App Certification Kit interactively

From the Start menu, search Apps, find Windows Kits, and click Windows App Cert Kit.

From the Windows App Certification Kit, select the category of validation you would like to perform. For example: If you are validating a Windows app, select Validate a Windows app.

You may browse directly to the app you’re testing, or choose the app from a list in the UI. When the Windows App Certification Kit is run for the first time, the UI lists all the Windows apps that you have installed on your computer. For any subsequent runs, the UI will display the most recent Windows apps that you have validated. If the app that you want to test is not listed, you can click on My app isn’t listed to get a comprehensive list of all apps installed on your system.

After you have input or selected the app that you want to test, click Next.

From the next screen, you will see the test workflow that aligns to the app type you are testing. If a test is grayed out in the list, the test is not applicable to your environment. For example, if you are testing a Windows 10 app on Windows 7, only static tests will apply to the workflow. Note that the Microsoft Store may apply all tests from this workflow. Select the tests you want to run and click Next.

The Windows App Certification Kit begins validating the app.

At the prompt after the test, enter the path to the folder where you want to save the test report.

The Windows App Certification Kit creates an HTML along with an XML report and saves it in this folder.

Open the report file and review the results of the test.

If you’re using Visual Studio, you can run the Windows App Certification Kit when you create your app package. See Packaging UWP apps to learn how.

Validate your Windows app using the Windows App Certification Kit from a command line

The Windows App Certification Kit must be run within the context of an active user session.

In the command window, navigate to the directory that contains the Windows App Certification Kit.

NoteВ В The default path is C:\Program Files\Windows Kits\10\App Certification Kit\.

Enter the following commands in this order to test an app that is already installed on your test computer:

appcert.exe test -packagefullname [package full name] -reportoutputpath [report file name]

Or you can use the following commands if the app is not installed. The Windows App Certification Kit will open the package and apply the appropriate test workflow:

appcert.exe test -appxpackagepath [package path] -reportoutputpath [report file name]

After the test completes, open the report file named [report file name] and review the test results.

NoteВ В The Windows App Certification Kit can be run from a service, but the service must initiate the kit process within an active user session and cannot be run in Session0.

NoteВ В For more info about the Windows App Certification Kit command line, enter the command appcert.exe /?

Testing with a low-power computer

The performance test thresholds of the Windows App Certification Kit are based on the performance of a low-power computer.

The characteristics of the computer on which the test is performed can influence the test results. To determine if your app’s performance meets the Microsoft Store Policies, we recommend that you test your app on a low-power computer, such as an Intel Atom processor-based computer with a screen resolution of 1366×768 (or higher) and a rotational hard drive (as opposed to a solid-state hard drive).

As low-power computers evolve, their performance characteristics might change over time. Refer to the most current Microsoft Store Policies and test your app with the most current version of the Windows App Certification Kit to make sure that your app complies with the latest performance requirements.

Комплект сертификации приложений для Windows Windows App Certification Kit

Чтобы сертифицировать приложение для Windows или подготовить его к публикации в Microsoft Store, необходимо сначала проверить и протестировать его локально. To get your app Windows Certified or prepare it for publication to the Microsoft Store, you should validate and test it locally first. В этой статье показано, как установить и запустить комплект сертификации приложений для Windows, чтобы убедиться в том, что приложение является безопасным и эффективным. This topic shows you how to install and run the Windows App Certification Kit to ensure your app is safe and efficient.

Предварительные условия Prerequisites

Необходимые условия для тестирования универсального приложения для Windows: Prerequisites for testing a Universal Windows app:

• Необходимо установить и запустить Windows 10. You must install and run Windows 10.
• Необходимо установить комплект сертификации приложений для Windows. Он включен в пакет средств разработки программного обеспечения для Windows 10. You must install the Windows App Certification Kit, which is included in the Windows Software Development Kit (SDK) for Windows 10.
• Необходимо подготовить устройство к разработке. You must enable your device for development.
• Необходимо развернуть на компьютере приложение для Windows, которое вы хотите протестировать. You must deploy the Windows app that you want to test to your computer.

Обновление на месте: установка более современной версии комплекта сертификации приложений для Windows будет заменять все установленные ранее версии комплекта. In-place upgrades: Installing a more recent Windows App Certification Kit will replace any previously installed version of the kit.

Новые возможности What’s new

Комплект теперь поддерживает тесты для приложений моста для классических приложений Windows. Tests for Windows Desktop Bridge Apps are now supported in the kit. Эти тесты позволяют опубликовать приложение в Microsoft Store или пройти сертификацию. Windows Desktop Bridge app tests can give your app the best chance of being published on Microsoft Store or get certified.

Теперь комплект можно интегрировать в автоматические процедуры тестирования, если интерактивные пользовательские сеансы недоступны. The kit can now be integrated into an automated testing where no interactive user session is available.

Проверка приложений перед запуском больше не поддерживается. The App Prelaunch Validation test is no longer supported.

Известные проблемы Known issues

Ниже приведен список известных проблем с комплектом сертификации приложений для Windows. The following is a list of known issues with the Windows App Certification Kit:

Во время тестирования, если установщик завершит работу, но оставит активные процессы или открытые окна, то комплект сертификации приложений может обнаружить, что установщик должен еще выполнить некоторые действия. During testing, if an installer terminates but leaves active processes or windows running, the app certification kit may detect that there is still work to be done by the installer. В этом случае комплект зависнет на задаче «Файлы трассировки установки процесса», и работу пользовательского интерфейса невозможно будет продолжить. In this case, the kit appears stuck running the «Process Install Trace Files» task and it’s not possible to move forward with the UI.

Решение. После завершения работы установщика вручную закройте все активные процессы или открытые установщиком окна. Resolution: After your installer is complete, manually close any active processes or windows spawned by the installer.

Для ARM UWA или любого приложения UWA, не ориентированного на семейство устройств для компьютеров или OneCore, в финальном отчете может появиться сообщение с текстом «Во время проверки выполнены не все тесты. For ARM UWA, or any UWA app that doesn’t target the device family desktop or OneCore, a message may appear in the final report that states «Not all tests were run during validation. Это может повлиять на отправку в Store.». This may impact your Store submission.». Это сообщение не применяется в случаях, когда пользователь вручную не отменил выбор тестов. This message does not apply in cases where the user didn’t manually deselect tests.

Решение. Недоступно Resolution: n/a

Для приложений моста для классических приложений, использующих пакет SDK для Windows версии 10.0.15063, следует игнорировать сбои в тесте ресурсов манифеста приложения, указывающие на то, что образ не соответствует ожидаемым размерам, если отклонение составляет один пиксель. For Desktop Bridge Apps using Windows SDK Version 10.0.15063 please ignore any failures in Application Manifest Resources test that flag your image not confirming to the expected dimensions if those dimensions are only off by one pixel. Допуск теста — +/-1 пиксель. The test is supposed to have a +/-1 pixel tolerance. Пример: E.g. размер мелкой плитки с масштабом 125 % составляет 88,75 x 88,75 пикселей. Если это значение округлить до 89 x 89, будут превышены ограничения размера (88 х 88 пикселей). A small tile at 125% would be 88.75×88.75px if rounded up to 89x89px this would fail the size restrictions of 88x88px.

Решение. Недоступно Resolution: n/a

Проверка приложения для Windows с помощью комплекта сертификации приложений для Windows в интерактивном режиме Validate your Windows app using the Windows App Certification Kit interactively

В меню Пуск выберите Приложения, найдите Комплекты Windows и щелкните Комплект сертификации приложений для Windows. From the Start menu, search Apps, find Windows Kits, and click Windows App Cert Kit.

В комплекте сертификации приложений для Windows выберите категорию проверки, которую необходимо выполнить. From the Windows App Certification Kit, select the category of validation you would like to perform. Например: Для проверки приложения для Windows щелкните Validate a Windows app (Проверить приложение для Windows). For example: If you are validating a Windows app, select Validate a Windows app.

Вы можете перейти непосредственно к тестируемому приложению или выбрать приложение из списка в пользовательском интерфейсе. You may browse directly to the app you’re testing, or choose the app from a list in the UI. При первом запуске комплекта сертификации приложений для Windows в пользовательском интерфейсе будут перечислены все приложения для Windows, установленные на компьютере. When the Windows App Certification Kit is run for the first time, the UI lists all the Windows apps that you have installed on your computer. При последующих запусках в пользовательском интерфейсе будут отображаться последние проверенные приложения для Windows. For any subsequent runs, the UI will display the most recent Windows apps that you have validated. Если в этом списке отсутствует приложение, которое необходимо протестировать, щелкните Моего приложения нет в списке, чтобы отобразить полный список приложений, установленных в вашей системе. If the app that you want to test is not listed, you can click on My app isn’t listed to get a comprehensive list of all apps installed on your system.

После выбора приложения, которое нужно протестировать, нажмите кнопку Далее. After you have input or selected the app that you want to test, click Next.

На следующем экране вы увидите рабочий процесс тестирования, который соответствует типу тестируемого приложения. From the next screen, you will see the test workflow that aligns to the app type you are testing. Если тест выделен серым, он не применим к вашей среде. If a test is grayed out in the list, the test is not applicable to your environment. Например, если вы тестируете приложение для Windows 10 в Windows 7, будут доступны только статические тесты. For example, if you are testing a Windows 10 app on Windows 7, only static tests will apply to the workflow. Обратите внимание, что Microsoft Store может применять все тесты этого рабочего процесса. Note that the Microsoft Store may apply all tests from this workflow. Выберите тесты, которые будут выполнены, и нажмите кнопку Далее. Select the tests you want to run and click Next.

Комплект сертификации приложений для Windows начнет проверку приложения. The Windows App Certification Kit begins validating the app.

В ответ на запрос по окончании тестирования введите путь к папке, в которую следует сохранить отчет о тестировании. At the prompt after the test, enter the path to the folder where you want to save the test report.

Комплект сертификации приложений для Windows создаст HTML-файл вместе с отчетом в формате XML и сохранит его в этой папке. The Windows App Certification Kit creates an HTML along with an XML report and saves it in this folder.

Откройте файл отчета и просмотрите результаты теста. Open the report file and review the results of the test.

Если вы используете Visual Studio, вы можете запустить комплект сертификации приложений для Windows при создании пакета приложения. If you’re using Visual Studio, you can run the Windows App Certification Kit when you create your app package. Подробнее об этом см. в разделе Packaging UWP apps (Создание пакетов приложений UWP). See Packaging UWP apps to learn how.

Проверка приложения для Windows с помощью комплекта сертификации приложений для Windows из командной строки Validate your Windows app using the Windows App Certification Kit from a command line

Комплект сертификации приложений для Windows должен выполняться в контексте активного сеанса пользователя. The Windows App Certification Kit must be run within the context of an active user session.

В командном окне перейдите в каталог, содержащий комплект сертификации приложений для Windows. In the command window, navigate to the directory that contains the Windows App Certification Kit.

Примечание. Путь по умолчанию — C:\Program File\sWindows Kits\10\App Certification Kit\. Note The default path is C:\Program Files\Windows Kits\10\App Certification Kit\.

Введите следующие команды в указанном порядке для тестирования приложения, которое уже установлено на компьютере тестирования: Enter the following commands in this order to test an app that is already installed on your test computer:

appcert.exe test -packagefullname [package full name] -reportoutputpath [report file name]

Или можно использовать следующие команды, если приложение не установлено. Or you can use the following commands if the app is not installed. Комплект сертификации приложений для Windows откроет пакет и применит соответствующий рабочий процесс проверки: The Windows App Certification Kit will open the package and apply the appropriate test workflow:

appcert.exe test -appxpackagepath [package path] -reportoutputpath [report file name]

По окончании тестирования откройте файл отчета с именем [report file name] и проверьте результаты теста. After the test completes, open the report file named [report file name] and review the test results.

Примечание. Комплект сертификации приложений для Windows может выполняться из службы, но служба должна запустить процесс комплекта в активном сеансе пользователя и не может выполняться в сеансе Session0. Note The Windows App Certification Kit can be run from a service, but the service must initiate the kit process within an active user session and cannot be run in Session0.

Примечание Чтобы получить дополнительные сведения о командной строке комплекта сертификации приложений для Windows, введите команду appcert.exe /? Note For more info about the Windows App Certification Kit command line, enter the command appcert.exe /?

Тестирование на маломощном компьютере Testing with a low-power computer

Пороговые значения теста производительности комплекта сертификации приложений для Windows основаны на производительности маломощного компьютера. The performance test thresholds of the Windows App Certification Kit are based on the performance of a low-power computer.

Характеристики компьютера, на котором выполняется тестирование, могут повлиять на результаты теста. The characteristics of the computer on which the test is performed can influence the test results. Чтобы определить, соответствует ли производительность вашего приложения политикам Microsoft Store, мы рекомендуем проводить тестирование на маломощном компьютере, например, с процессором Intel Atom, разрешением экрана 1366×768 (или выше) и механическим (а не твердотельным) жестким диском. To determine if your app’s performance meets the Microsoft Store Policies, we recommend that you test your app on a low-power computer, such as an Intel Atom processor-based computer with a screen resolution of 1366×768 (or higher) and a rotational hard drive (as opposed to a solid-state hard drive).

Так как маломощные компьютеры совершенствуются, со временем их рабочие характеристики могут меняться. As low-power computers evolve, their performance characteristics might change over time. Выберите самую новую версию политик Microsoft Store и протестируйте свое приложение с использованием самой новой версии комплекта сертификации приложений для Windows, чтобы обеспечить соответствие вашего приложения последним требованиям к производительности. Refer to the most current Microsoft Store Policies and test your app with the most current version of the Windows App Certification Kit to make sure that your app complies with the latest performance requirements.