Using the Windows App Certification Kit

To give your desktop app the best chance of getting certified, validate and test it on your computer before you submit it for certification and listing in the Windows Store. To certify your app, you need to install and run the Windows App Certification Kit. For details on specific tests within the kit, refer to Windows App Certification Kit tests.

For a high level look at the certification process, and where the use of this tool fits in, see Certify your desktop app.

The current release of Windows ACK is available in 14 languages (Czech, English, French, German, Italian, Japanese, Korean, Polish, Portuguese (Brazil), Russian, Simplified Chinese, Spanish, Traditional Chinese, and Turkish).

Prerequisites

Before you install the Windows ACK, you need to install and run the operating system.

1. Install and run the operating system you’re developing apps for.

• If you’re developing apps for Windows 7, you can install and run Windows 7, Windows 8, or Windows 8.1.
• If you’re developing a Windows 8 desktop app or Windows 8 desktop device app, you can install and run Windows 8 or Windows 8.1.
• If you’re developing a Windows 8.1 desktop app or Windows 8 desktop device app, install Windows 8.1.

1. Install the Windows App Certification Kit 3.3, which is included in the Windows Software Development Kit (SDK) for Windows 8.1.

Note: When you install Windows App Certification Kit 3.3 or higher on your PC, you replace any previously installed version of the kit.

Instructions to run Windows App Certification Kit 3.3

Validate your desktop app by using the Windows App Certification Kit 3.3 interactively

1. From the Start menu, search for Windows App Cert Kit.
2. From the Windows App Certification Kit, click the test validation category you want to run. If you’re validating a desktop app, select Validate Desktop app.
3. In the next screen, browse to the setup file of the desktop app you want to validate.
   • Note: You can use the command line steps to include options or an installation switch, if necessary.
4. Indicate the app usage type, and then click Next. The Windows App Certification Kit starts installing the desktop app using the setup files so it can validate the installation.
5. If you’re asked to reboot the system to complete setup, choose No. If your app needs to install several components or external dependencies, carefully select the name for your app. The name you choose here is the name your app is given if it gets listed in the Windows Store. When validation is complete, save the report with the name you gave your app in Step 6. The Windows App Certification Kit creates an XML report file and saves it.
6. Navigate to the folder where you saved the report and open it to view the results of the test. If your test failed and you’re eligible for a waiver, the info you need to submit is listed here. You must submit a detailed description for each possible waiver request.

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

Navigate to the folder where you saved the report and open it to view the results of the test. Failed tests with a possible waiver request are listed here. You must submit a detailed description for each possible waiver request.

From the folder that contains the Windows App Certification Kit, enter these commands in this order:

• appcert.exe reset
• appcert test -apptype desktop -setuppath d:\cdrom\setup.exe -appusage peruser -reportoutputpath [report file name]

where: [report file name] is the fully qualified file name of the XML file that the kit will create to contain the test report.

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

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

The Windows App Certification Kit must be run in the context of an active user session but you can’t launch apps in a non-interactive session. The way the kit handles tokens for running tests with or without administrative privileges depends on this user session context as well. The kit can be run from a service, but the service must be able to spawn the kit process in an active user session.

Use the Windows App Certification Kit to validate your Windows 7 apps

• The Windows App Certification Kit replaced the Windows Software Logo Kit. If you want the Windows 7 logo for your app, use the Windows App Certification Kit for your validation testing and report. The kit can detect which operating system it’s running on and automatically launches for Windows 7 apps. Follow the same process for validating Windows 7 apps.

Submit for certification

• After your app is validated, you’re ready to submit it for certification through the portal submission process.

Reference Documents

Windows App Certification Kit tests

We’ve changed the kit to make the Windows ACK tests easier to use. The kit now has:

• A new simplified user interface
• Improved multi-user test, which no longer requires that you set up a second user account

Процесс сертификации приложения The app certification process

Закончив создание отправки приложения, щелкните Отправить в Store , чтобы перейти на шаг сертификации. When you finish creating your app’s submission and click Submit to the Store , the submission enters the certification step. Как правило, этот процесс завершается в течение нескольких часов, хотя в некоторых случаях может занять до трех рабочих дней. This process usually is completed within a few hours, though in some cases it may take up to three business days. После того как отправка будет продолжена, клиенты смогут просмотреть список приложений для новой отправки или обновить отправку изменений в пакетах до 24 часов. After your submission passes certification, it can take up to 24 hours for customers to see the app’s listing for a new submission, or for an updated submission with changes to packages. Если обновление содержит только сведения о списке хранилищ, процесс публикации будет завершен менее чем за час. If your update only changes Store listing details, the publishing process will be completed in less than an hour. Вы получите извещение о публикации отправки, и состояние приложения на панели мониторинга будет находиться в хранилище . You’ll be notified when your submission is published, and the app’s status in the dashboard will be In the Store .

Предварительная обработка Preprocessing

После успешной отправки пакетов приложения, направленного на сертификацию, пакеты ставятся в очередь на тестирование. After you successfully upload the app’s packages and submit the app for certification, the packages are queued for testing. Если в процессе предварительной обработки будет обнаружена ошибка, появится соответствующее сообщение. We’ll display a message if we detect any errors during preprocessing. Дополнительные сведения о возможных ошибках см. в разделе Устранение ошибок отправки. For more info on possible errors, see Resolve submission errors.

Сертификация Certification

На этом этапе проводится несколько тестов: During this phase, several tests are conducted:

• Тесты безопасности. В ходе первого теста пакеты вашего приложения проверяются на наличие вирусов и вредоносного ПО. Security tests: This first test checks your app’s packages for viruses and malware. Если ваше приложение не проходит этот тест, то вам понадобится проверить систему разработки, запустив актуальное антивирусное ПО, а затем снова собрать пакет приложения в чистой системе. If your app fails this test, you’ll need to check your development system by running the latest antivirus software, then rebuild your app’s package on a clean system.
• Проверка соответствия техническим требованиям. Соответствие техническим требованиям проверяется с помощью комплекта сертификации приложений для Windows. Technical compliance tests: Technical compliance is tested by the Windows App Certification Kit. (Вы всегда должны проверять свое приложение с помощью комплекта сертификации приложений для Windows перед отправкой в Магазин.) (You should always make sure to test your app with the Windows App Certification Kit before you submit it to the Store.)
• Соответствие содержимого требованиям. Продолжительность этого этапа зависит от сложности приложения, от объема его визуального содержимого и количества приложений, отправленных за последнее время. Content compliance: The amount of time this takes varies depending on how complex your app is, how much visual content it has, and how many apps have been submitted recently. Укажите полезную для тест-инженеров информацию на странице Заметки по сертификации. Be sure to provide any info that testers should be aware of in the Notes for certification page.

После завершения процесса сертификации вы получите отчет с сообщением о том, прошло ли ваше приложение сертификацию. After the certification process is complete, you’ll get a certification report telling you whether or not your app passed certification. Если приложение не прошло сертификацию, то в отчете будет показано, какой именно тест не был пройден или требования какой политики оказались невыполненными. If it didn’t pass, the report will indicate which test failed or which policy was not met. После устранения проблемы можно создать новую отправку для вашего приложения для повторного запуска процедуры сертификации. After you fix the problem, you can create a new submission for your app to start the certification process again.

Выпуск Release

Когда приложение проходит сертификацию, оно готово к переходу в процесс публикации . When your app passes certification, it’s ready to move to the Publishing process.

• Если вы указали, что отправка должна быть опубликована как можно скорее (параметр по умолчанию), процесс публикации начнется сразу же. If you’ve indicated that your submission should be published as soon as possible (the default option), the publishing process will begin right away.
• Если вы впервые опубликовали приложение и указали дату выпуска в разделе » Расписание «, приложение станет доступным в соответствии с выбранными датами выпуска . If this is the first time you’ve published the app, and you specified a Release date in the Schedule section, the app will become available according to your Release date selections.
• Если вы использовали Параметры удержания публикации , чтобы указать, что она не должна быть освобождена до определенной даты, мы добавим ее до начала процесса публикации, если не выбран параметр изменить дату выпуска . If you’ve used Publishing hold options to specify that it should not be released until a certain date, we’ll wait until that date to begin the publishing process, unless you select Change release date .
• Если вы использовали Параметры удержания публикации , чтобы указать, что вы хотите опубликовать отправку вручную, процесс публикации не будет запущен, пока не будет выбран параметр Опубликовать сейчас (или выбрать параметр изменить дату выпуска и выбрать конкретную дату). If you’ve used Publishing hold options to specify that you want to publish the submission manually, we won’t start the publishing process until you select Publish now (or select Change release date and pick a specific date).

Публикация Publishing

Пакеты вашего приложения получают цифровую подпись для защиты от незаконного изменения после выпуска. Your app’s packages are digitally signed to protect them against tampering after they have been released. После начала этого этапа вы не сможете отменить отправку или изменить дату выпуска. Once this phase has begun, you can no longer cancel your submission or change its release date.

Для новых приложений и обновлений, которые включают изменения в пакеты приложения, процесс публикации будет выполнен в течение 24 часов. For new apps and updates which include changes to the app’s packages, the publishing process will be completed within 24 hours. Для обновлений, которые изменяют только такие параметры, как хранение сведений о списке, но не изменяют пакеты приложения, процесс публикации займет меньше часа. For updates that only change options such as Store listing details, but don’t change the app’s packages, the publishing process will take less than one hour.

Пока приложение находится на этапе публикации, ссылка показывать сведения в столбце Состояние для отправки приложения позволяет узнать, когда новые пакеты и сведения о хранении будут доступны клиентам в каждой из ПОДДЕРЖИВАЕМЫХ версий ОС. While your app is in the publishing phase, the Show details link in the Status column for your app’s submission lets you know when your new packages and Store listing details are available to customers on each of your supported OS versions. Действия, которые еще не были завершены будут помечены сообщением Ожидание . Steps that have not yet completed will show Pending . Приложение останется на этапе публикации до тех пор, пока процесс не будет завершен. Это означает, что новые пакеты и/или сведения о выводе будут доступны всем потенциальным клиентам вашего приложения. Your app will remain in the publishing phase until the process has completed, meaning that the new packages and/or listing details are available to all of your app’s potential customers.

В Магазине In the Store

После успешного завершения описанных выше этапов, состояние отправки поменяется Публикация на В Store . After successfully going through the steps above, the submission’s status will change from Publishing to In the Store . После этого приложение станет доступно для скачивания в Microsoft Store (если вы не выбрали другое значение параметра Возможность обнаружения). Your submission will then be available in the Microsoft Store for customers to download (unless you have chosen another Discoverability option).

Примечание. Мы также проводим выборочную проверку приложений после их публикации, что позволяет выявлять возможные проблемы и удостоверяться в выполнении Политик Microsoft Store. We also conduct spot checks of apps after they’ve been published so we can identify potential problems and ensure that your app complies with all of the Microsoft Store Policies. Если мы обнаружим какие-либо неполадки, то уведомим вас о них и порекомендуем, как их исправить, а также, если применимо, сообщим о необходимости удаления приложения из Магазина. If we find any problems, you’ll be notified about the issue and how to fix it, if applicable, or if it has been removed from the Store.