2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main ではなく android-latest-release を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。

このページは Cloud Translation API によって翻訳されました。

CTS 検証ツールのマルチデバイステストを実行する

このページには、Android 16 QPR2 以降向けの Better Together CTS 検証ツール（CTS-V）テストの使用手順が記載されています。

ホスト側のマルチデバイステストをセットアップする

このセクションでは、マルチデバイステストをセットアップする方法について説明します。

デスクトップマシンが CTS のオペレーティングシステム要件を満たしていることを確認します。
デスクトップソフトウェアをインストールするの手順 2 と 5 に沿って、adb、AAPT2、Python がデスクトップに正しくインストールされていることを確認します。
- Python のバージョンは 3.11 以降である必要があります。Python のバージョンを確認するには、python3 --version を実行します。バージョンが 3.11 より前の場合は、最新の公式 Python リリースをインストールします。詳しくは、python.org のダウンロードセクションをご覧ください。
- 一部のテストでは、ホストに Python venv モジュールが必要です。Debian システムと Ubuntu システムでは、このモジュールがデフォルトでインストールされていない可能性があります。Python バージョンに venv モジュールがあるかどうかを確認するには、python3 -m venv venv を実行します。このコマンドが失敗すると、エラーメッセージが表示されます。プロンプトに沿って python3.x-venv パッケージをインストールします。
2 台のテスト対象デバイス（DUT）を用意し、それぞれに CTS-V をセットアップします。
- DUT のセットアップ方法については、DUT をセットアップするを参照してください。
- CTS-V のセットアップ方法については、セットアップを参照してください。
テストタイプのセットアップセクションに移動します。
- NFC テストについては、NFC テストをセットアップするを参照してください。
- Wi-Fi AP 接続テストについては、Wi-Fi AP 接続テストをセットアップするをご覧ください。
- CDM モジュールをテストするには、2 台のデバイスによる標準テストをセットアップするに移動してから、CDM テストをセットアップするに移動します。
テストがこのリストにない場合は、2 台のデバイスによる標準テストをセットアップするに進みます。

NFC テストをセットアップする

NFC テストでは、DUT 1 台と PN532 NFC チップ 1 個を使用します。

NFC テストをセットアップするには:

PN532 NFC チップを購入します。All-In-One PN532 をおすすめします。
DUT で設定アプリに移動します。
NFC を有効にする。
NFC チップを配置する。
- スマートフォンの場合、DUT の NFC リーダーを図 1 に示すように配置します。
  
  図 1. NFC チップの位置
- その他のデバイスの場合は、チップをデバイスの NFC アンテナの隣に配置します。
USB ケーブルを使用して、PN532 NFC チップをテスト用ワークステーションに接続します。

省略可: Wi-Fi AP 接続テストを設定する

Wi-Fi アクセスポイント（AP）接続テスト（CtsWifiConnectionTests）では、DUT と AP 間の接続をテストします。これらのテストを実行することを強くおすすめしますが、CTS-V Android 16 16 QPR2 では必須ではありません。

これらのテストには、DUT と OpenWrt Banana Pi R3 AP が必要です。

Wi-Fi AP 接続テストをセットアップするには:

この表に記載されている Banana Pi R3 AP とアクセサリを購入します。

アイテム	数量
Banana Pi BPI-R3 ルーターボード（MediaTek MT7986 チップ設計、Wi-Fi 6、2G DDR RAM、8G eMMC フラッシュ搭載）に類似した BPi-R3 ボード	1
BPi-R3 アルミケース（BPI-R3 Iron ケースと同様）	1
BPi-R3 アルミ製ヒートシンク（冷却ファン）（ファン付き BPI-R3 アルミ製ヒートシンクと同様）	1
ケーブル付きの 2 GHz と 5 GHz のアンテナ（BPI ショップの 5DB アンテナに類似）	8
12 V/2 A DC 電源と同様の電源アダプター	1

購入するには、Banana Pi BPI-R3 ページの Easy to buy セクションをご覧ください。

アクセスポイントを設定します。アクセスポイントのセットアップについては、Banana Pi BPI-R3 AP をセットアップするをご覧ください。
省略可: シールドボックスをお持ちでない場合は、JTP-SR101 シールドボックスをおすすめします。次の情報を使用してこのボックスを購入します。

Dong Guan Zheng Sheng Electronics Technology Co., LTD
Bohui Industrial Park, Panlong Road, Liaobu Town, Dongguan City, Guangdong Province, China
連絡先: Forest Pan
メール: forest.pan@jtpmak.cn
電話（中国）: +86 18676993556

注: シールドボックスを使用すると、外部信号を分離し、DUT と AP を 10 cm 離すことができます。
DUT と AP をホストに接続し、RF シールドボックスに入れます。DUT と AP の間隔は 10 cm 以上にする必要があります。図 2 は、この構成を示しています。

図 2. シールドボックス内の DUT と AP。
SSH を使用して、ホストから AP にアクセスできることを確認します。

2 台のデバイスによる標準テストをセットアップする

デバイス 2 台のデフォルトのセットアップ方法:

2 台の Android のテスト対象デバイス（DUT）を約 20 cm 離して配置します。
クリーンな環境をセットアップするために、デバイスを 2 台ともシールドボックスに入れます。

注: テスト中に問題が発生し、サポートが必要な場合は、シールドボックス内の両方のデバイスでテストが実行されていることを確認してください。
省略可: Wi-Fi デバッグを行う場合は、OTA スニファをセットアップします。

CDM テストをセットアップする

test_permissions_sync() テストケースは、テストが実行されるデバイスのビルドタイプに応じて動作が異なります。デバッグ可能（userdebug または eng）ビルドとデバッグ不可（user）ビルドの両方を OEM がテストし、両方でテストに合格することが重要です。

免除

権限同期 API 実装の CDD 条項では、安全なチャネルを介してデバイス間でデータを正常に転送できることのみが求められています。セキュアチャネルの実装は CDD 準拠の要件ではないため、このテストはデバッグ不可（ユーザー）ビルドではスキップできますが、CDM 権限同期機能のサポートをオプトアウトする場合に限ります。

テストは、デバッグ可能なビルドで例外なく合格する必要があります。

デバッグ不可ビルドでテストするための前提条件

前の免除条項で免除されていない場合は、次の前提条件を満たしていることを確認してください。

セキュアチャネルは AVF（AttestationVerificationFramework）を使用してハードウェアの信頼性を検証します。両当事者によって生成された証明書には、システムで不正な変更が行われていないことを確認するための、当事者自身に関する情報がいくつか含まれています。AVF は、検証プロセス中に次の状態を確認します。

デバイスがインターネットにアクセスできる
デバイスが確認付きブートを使用しており、ビルドが開発キーではなくリリースキーで署名されている
デバイスのブートローダーがロックされている。詳細な手順については、ブートローダーをロックするをご覧ください。
OS、キーブート、キーベンダーのパッチレベルが 12 か月以内である。1 年以上前のビルドは使用しない
デバイスの証明書は、ベンダーが承認したルート証明書のいずれかによってバックアップされています。信頼できるルート証明書を vendor_required_attestation_certificates.xml リソースオーバーレイで指定します。

ホスト側のマルチデバイステストを実行する（AOSP 16 以降）

CTS Verifier 16 ではホスト側でのマルチデバイステストに対応するようになりました。こうしたテストは、デバイス側でテストを手動で操作する代わりに、ホスト側で自動スクリプトを使用して実行できます。各テストが完了するたびに、結果が自動的に DUT にアップロードされ、CTS 検証ツールアプリに表示されます。

このセクションでは、ホスト側でマルチデバイステストを実行する方法について説明します。

マルチデバイステストを実行する

マルチデバイステストを行うには:

テストワークステーションで、CTS-V zip パッケージを解凍したディレクトリから cts-v-host コンソールを起動します。
```
./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
```
DUT の CTS 検証ツールアプリから [Host-side Tests] をクリックします。図 3 は、CTS 検証ツールアプリのホスト側テストを示しています。

図 3. CTS 検証ツールアプリでのホスト側マルチデバイステスト。

テストホスト側のマルチデバイステストモジュールのリストが表示されます。
実行するテストモジュール名を特定します。たとえば、CompanionDeviceManager モジュールは、CtsCompanionDeviceManagerMultiDeviceTestCases としてリストされます。

注: CTS 検証ツールアプリでホスト側のモジュールをタップしても、個々のテストケースのリストは表示されません。テストケースの結果は、ホストでモジュールを実行した後に UI によって自動的に入力されます。
cts-v-host コンソールで、次のコマンドを実行します。
```
run cts-v-host -m test_module_name
```
次に例を示します。
```
run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases
```
注: cts-v-host を -m test_module_name なしで実行した場合は、すべてのテストモジュールの実行が試行され、デバイスやハードウェアの要件の逸脱は無視されます。単一のサブプランとして標準セットアップでテストを実行する場合は、代わりに run cts-v-host-default-devices コマンドを実行してください。
注: 特定の DUT を指定してテストする場合は、「run cts-v-host -m test_module_name -s\ device1_serial -s device2_serial ...」のようにシリアル番号で指定します。
xTS コンソールがテストの実行を終了すると、結果が CTS 検証ツールアプリに表示されます。緑色でマークされたテストは合格です。赤色でマークされたテストは不合格です。図 4 に、CtsCompanionDeviceManager テストの結果の例を示します。

図 4. CTS 検証ツールアプリでのホスト側マルチデバイステストの結果。

注: ホスト側の結果は、全体の CTS-V テストレポートに自動的に追加されます。

省略可: Wi-Fi AP 接続テストを実行する

Wi-Fi AP 接続テストを実行する手順は次のとおりです。

テストベッド構成ファイル（WifiConnectionTestbed.yaml）を編集します。このファイルは、CTS-Verifier が解凍されたディレクトリにあります。
```
./android-cts-verifier/android-cts-v-host/testcases/CtsWifiConnectionTests/x86_64/connection/WifiConnectionTestbed.yaml
```
ローカル SSH 設定に基づいて、hostname フィールドの値を AP の IP アドレスに変更します。IP アドレスを確認するには、AP の IP アドレスを確認するをご覧ください。

次の例は、WifiConnectionTestbed.yaml ファイル内の hostname フィールドの場所を示しています。
```
TestBeds:
- Name: WifiConnectionTestbed
  Controllers:
    # Specify settings for the AP.
    OpenWrtDevice:
    - hostname: AP-IP
      skip_init_reboot: True
```
cts-v-host コンソールで、次のコマンドを実行します。
```
run everything -m CtsWifiConnectionTests
```
注: cts-v-host コンソールの詳細については、マルチデバイステストを実行するをご覧ください。

マルチデバイステストのトラブルシューティング

このセクションでは、起こりうる問題に対するトラブルシューティングを説明します。

NFC テスト中に GetFirmwareVersion に応答がない問題を修正

マルチデバイステストの実行中にメッセージ「verify_firmware_version RuntimeError: No response for GetFirmwareVersion」が表示される場合、PN532 NFC ボードにアクセスできていません。

この問題を解決するには、ホスト上の PN532 ボードが使用するシリアルパス（例: dev/ttyUSB1）を特定し、コンソールで --module-arg 引数を使用して手動で指定してください。

run cts-v-host -m CtsNfcHceMultiDeviceTestCases --module-arg CtsNfcHceMultiDeviceTestCases:pn532_serial_path:/dev/ttyUSB1

NFC テスト中のトランザクション失敗のエラーメッセージを解決する

すべての NFC テストケースでメッセージ「Transaction failed, check device logs for more information.」が表示される場合は、DUT の NFC チップが PN532 を検出できていない可能性があります。

ホストに複数のデバイスを接続していて、PN532 を一部のデバイスにのみ配置している場合は、間違った DUT が選択されている可能性があります。詳しくは、NFC テストをセットアップするを参照してください。

この問題を解決するには、次のいずれかの方法をお試しください。

ホスト側のテストコマンドで、-s フラグを使用して正しい DUT のシリアルを設定する。
DUT 以外のすべてのデバイスについて、ホストとの接続を解除する。

CDM テストケース `test_permissions_sync` が無視される

デバッグできないデバイスでテストを実行している場合は、免除されているかどうかを確認してください。そうでない場合は、両方のデバイスが前提条件を満たしていることを確認します。

CTS 検証ツールのマルチデバイス テストを実行する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

ホスト側のマルチデバイス テストをセットアップする