Windows アプリ認定キットWindows App Certification Kit

アプリ Windows Certified を取得するか、または 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 10 用 Windows ソフトウェア開発キット (Windows SDK) に含まれる Windows アプリ認定キットをインストールする必要があります。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. Windows デスクトップ ブリッジ アプリ テストを使用すると、作成したアプリを 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. この場合、キットで "インストール トレース ファイルの処理" タスクの実行に問題が発生しているように表示され、UI で前に進めなくなります。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、またはデバイス ファミリ デスクトップまたは OneCore を対象としない UWA アプリの最終的なレポートに、"検証時に一部のテストが実行されませんでした。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. Microsoft 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

Windows SDK バージョン 10.0.15063 を使用したデスクトップ ブリッジ アプリに対してアプリケーション マニフェストのリソース テストを行った場合に、イメージが予測サイズに適合しないことを示すエラーが発生しても、イメージと予測サイズの差異が 1 ピクセルのみであればそのエラーを無視してください。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% の小さいタイルは 89 x 89 px に切り上げた場合、88.75 x 88.75 px になります。サイズの制限である 88 x 88 px を超えます。A small tile at 125% would be 88.75x88.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

  1. [スタート] メニューから、 [アプリ][Windows キット] の順に進み、 [Windows アプリ認定キット] をクリックします。From the Start menu, search Apps, find Windows Kits, and click Windows App Cert Kit.

  2. [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.

    テストするアプリを直接参照するか、UI で一覧からアプリを選ぶことができます。You may browse directly to the app you're testing, or choose the app from a list in the UI. Windows アプリ認定キットを初めて実行すると、UI にはコンピューターにインストールされているすべての 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. 以降の実行では、UI には検証済みの最新の 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.

  3. テストするアプリを入力するか選択したら [次へ] をクリックします。After you have input or selected the app that you want to test, click Next.

  4. 次の画面からは、テストするアプリの種類に合ったテスト ワークフローが表示されます。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 7 で Windows 10 アプリをテストする場合、静的テストのみがワークフローに適用されます。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.

  5. テストが終わった後のプロンプトで、テスト レポートを保存するフォルダーのパスを入力します。At the prompt after the test, enter the path to the folder where you want to save the test report.

    Windows アプリ認定キットによって XML 形式のレポートと共に HTML が作成され、このフォルダーに保存されます。The Windows App Certification Kit creates an HTML along with an XML report and saves it in this folder.

  6. レポート ファイルを開いて、テストの結果を確認します。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. 方法については、「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.

  1. コマンド ウィンドウで、Windows アプリ認定キットを含むディレクトリに移動します。In the command window, navigate to the directory that contains the Windows App Certification Kit.

    既定のパスは C:\Program Files\Windows Kits\10\App Certification Kit\ です。Note The default path is C:\Program Files\Windows Kits\10\App Certification Kit\.

  2. 次のコマンドをこの順序で入力し、テスト コンピューターにすでにインストールされているアプリをテストします。Enter the following commands in this order to test an app that is already installed on your test computer:

    appcert.exe reset

    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 reset

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

  3. テストが完了したら、[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 ポリシーを満たしているかどうかを判断するには、アプリを低電力コンピューター (たとえば画面の解像度が 1366x768 またはそれ以上で、ソリッド ステート ハード ドライブではなく回転式ハード ドライブを搭載した Intel Atom プロセッサ ベースのコンピューター) 上でテストすることをお勧めします。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 1366x768 (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.