CTS 自動テストを設定する

CTS 自動テストを実行する前に、物理環境を準備し、ワークステーションのセットアップとテスト対象デバイスの構成を行います。

物理環境のセットアップ

一部の CTS テストでは、DUT の付近にセットアップされた外部デバイスを使用する必要があります。物理環境をセットアップする手順は次のとおりです。

（省略可）DUT が Bluetooth LE をサポートしている場合、Bluetooth LE スキャンテスト用に少なくとも 3 台の Bluetooth LE ビーコンを DUT の 5 m 以内に設置します。以下の点にもご注意ください。
- ビーコンは設定も特定の出力も不要です。
- iBeacon や Eddystone、BLE ビーコンをシミュレートするデバイスなど、どんな種類のものでも構いません。
シーン（壁や天井など）の前方に、DUT の最小焦点距離と同程度離してスマートフォンを置きます。以下の点にもご注意ください。
- シーンは照明を十分に明るくして、テスト対象のセンサーが CONTROL_AE_TARGET_FPS_RANGE で指定された最大設定目標 FPS（1 秒あたりのフレーム数）に到達し、それを維持できるようにします。
- このセットアップは、getCameraIdList で取得したカメラセンサーのすべてに適用されます。リストアップされたデバイスを順にテストし、個別に性能を測定するためです。
- DUT が USB ウェブカメラなどの外部カメラをサポートしている場合は、CTS の実行時に外部カメラを接続します。そうしないと、CTS テストは失敗します。
（省略可）DUT がグローバルポジショニングシステム（GPS）などの全球測位衛星システム（GNSS）をサポートしている場合は、DUT に、受信と位置計算に適した信号レベルの GNSS 信号を与える必要があります。以下の点にもご注意ください。
- GPS は ICD-GPS-200C に準拠している必要があります。
- GNSS の信号は、衛星シミュレータや屋外信号の中継器など、どんな種類のものでも構いません。
- DUT は、衛星から十分な GNSS 信号を直接受信できるように窓に近い場所に置いて構いません。
注意: GPS テストでは、インターネット接続の設定で supl.google.com ポート 7276 への接続をブロックしないでください。このポートは、ローカルデバイスでの位置計算をテストするための GPS 支援データをダウンロードするのに使用されます。
Wi-Fi ネットワークが IPv4 と IPv6 に対応していて、IPv4 と IPv6 の DNS を使用するインターネットに接続され、IP マルチキャストをサポートしており、DUT を隔離されたクライアントとして扱うことができることを確認します。

注: 隔離されたクライアントとは、DUT がそのサブネットワーク上のブロードキャストメッセージまたはマルチネットワークメッセージを認識できない構成のことです。隔離されたクライアントをセットアップするには、Wi-Fi アクセスポイント（AP）の設定を使用するか、他のデバイスが接続されていない隔離されたサブネットワークで DUT を動作させます。

IPv6 テストが成功するために必要なネットワーク（ネイティブ IPv6 ネットワーク、IPv6 携帯通信会社ネットワーク、または VPN）にアクセスできない場合は、Wi-Fi AP と IPv6 トンネルを使用します。
DUT の UP、BROADCAST、MULTICAST のフラグを Wi-Fi インターフェースに設定します。
Wi-Fi インターフェースには IPv4 アドレスと IPv6 アドレスを割り当てます。 Wi-Fi インターフェースのプロパティを確認するには、adb shell ifconfig を実行します。
（省略可）DUT が Wi-Fi STA または STA の同時実行をサポートしている場合は、Wi-Fi ネットワークを少なくとも 2 つ設定します。これらの Wi-Fi ネットワークの帯域幅とその SSID は異なっている必要があります。または、SSID が同じ場合は BSSID が異なっている必要があります。
（省略可）DUT が Wi-Fi ラウンドトリップ時間（RTT）をサポートしている場合は、Wi-Fi RTT 対応のデバイスをセットアップします。
1. Wi-Fi RTT 対応デバイスを DUT から 12 メートル以内に置きます。
2. Wi-Fi RTT 対応デバイスの電源を入れます。
Wi-Fi RTT 対応の推奨デバイスは 2 種類あります。Google Wifi、および Compulab の fitlet2 アクセスポイントです（5 GHz 帯、帯域幅 40 MHz に設定）。

デスクトップマシンのセットアップ

CTS 自動テストを実行する前に、デスクトップマシンがハードウェアとオペレーティングシステムの要件を満たしていること、および適切なソフトウェアがインストールされていることを確認します。詳しくは以下の各セクションをご覧ください。

ハードウェア要件を確認する

CTS デスクトップマシンは、以下のハードウェア要件を満たす必要があります。

64 ビット x86 システム
256 GB 以上のディスク空き容量（CTS テストケースの増加と Tradefed で確保される Java ヒープ領域の増加に対応するために必要）
32 GB 以上の RAM

オペレーティングシステムの要件を確認する

開発マシンは、GNU C ライブラリ（glibc）2.17 以降を実装した 64 ビットの Linux ディストリビューションを搭載している必要があります。

デスクトップソフトウェアをインストールする

CTS 用の適切なデスクトップソフトウェアをインストールするには:

FFmpeg パッケージのバージョン 5.1.3 以降をインストールします。
最新バージョンの Android Debug Bridge（adb）と Android Asset Packaging Tool（AAPT2）をインストールし、これらのツールの場所をマシンのシステムパスに追加します。
1. SDK Manager に関するドキュメントの冒頭に記載されている手順に沿って、sdkmanager コマンドラインツールをインストールします。コマンドラインツールをダウンロードするためのリンクは、Android Studio ダウンロードページ下部にある「コマンドラインツールのみ」セクションにあります。
2. 新しくインストールした sdkmanager の場所を追加するためにシステムパスを更新します。
3. sdkmanager を使用して、最新の platform-tools パッケージと build-tools パッケージをインストールします。これらのパッケージには adb と AAPT2 が含まれています。パッケージのインストール方法については、パッケージをインストールするをご覧ください。
4. 新しくインストールした adb ツールと AAPT2 ツールの場所を追加するためにパスを更新します。
5. adb と AAPT2 がパスにあることを確認します。
注: 別の方法として、CTS デスクトップマシンで Android Studio を使用している場合は、Android SDK Platform-Tools と Android SDK Build-Tools オプションを確認して、Android プラットフォームと SDK ビルドツールをインストールすることもできます。
適切なバージョンの Java 開発キット（JDK）をインストールします。
- Android 11 以降の場合は、JDK 11 をインストールします。
- Android 10 以前の場合は、CTS を設定する（AOSP 10 以前）をご覧ください。
（省略可）Android 13 以降の場合は、virtualenv をインストールします。virtualenv ツールは、マルチデバイステストに必要です。
Python がインストールされていることを確認するため、python3 を入力します。Python のバージョンと日付が表示されれば、Python は正しくインストールされています。
デバイスの Android バージョンとデバイスでサポートされているすべてのアプリケーションバイナリインターフェース（ABI）に一致する CTS パッケージを互換性テストスイートのダウンロードからダウンロードして開きます。
最新バージョンの CTS メディアファイルをダウンロードして開きます。このメディアファイルには、Big Buck Bunny の動画クリップが含まれています。その著作権は Blender Foundation にあり、クリエイティブ・コモンズ表示 3.0 ライセンスのもとで提供されています。
（省略可）CTS を初めて実行するときに、Mainline に関連するいくつかの CTS ファイルが動的にダウンロードされます。ネットワークの速度によっては、このダウンロードにより CTS の実行時間が 10 分以上長くなります。

CTS の実行時間が長くならないようにするには、Mainline に関連する CTS ファイルを先にダウンロードしてから CTS バージョンを実行します。Mainline に関連する CTS ファイルをダウンロードする方法については、Mainline に関連する CTS ファイルのダウンロードをご覧ください。

DUT の準備

デスクトップマシンのセットアップが終わったら、DUT のセットアップと構成を行う必要があります。

DUT をセットアップする

DUT をセットアップするには:

DUT で、コードネーム、タグ、ビルド番号から互換性があるとわかるユーザービルド（Android 4.0 以降）をベースとしたシステムイメージが実行されていること、および user ビルドバリアントが使用されていることを確認します。ビルドバリアントについて詳しくは、ターゲットを選択するをご覧ください。
DUT が Android 13 以降を搭載している場合は、ビルドの ro.product.first_api_level が、そのデバイス発売時の API レベルに設定されていることを確認します。この値を設定するには、device.mk ファイルに次の変更を加えます。
```
PRODUCT_SHIPPING_API_LEVEL := 21
```
CTS の要件には、デバイスの最初の出荷時に搭載したビルドによって異なるものがあります。たとえば、最初の出荷時に以前のビルドを搭載したデバイスは、その後のビルドを搭載したデバイスに適用されるシステム要件から除外される場合があります。有効な API レベルの値については、コードネーム、タグ、ビルド番号をご覧ください。 ro.product.first_api_level について詳しくは、ベンダー API レベルをご覧ください。

Android 10 以前の場合は、CTS を設定する（AOSP 10 以前）をご覧ください。
デバイスで APEX パッケージの管理がサポートされている場合:
1. デバイスの Android バージョンとハードウェアアーキテクチャに該当する APEX shim パッケージをダウンロードします。shim パッケージの表の左側 2 列に、ダウンロードするパッケージへのリンクが記載されています。
2. ダウンロードしたパッケージを /system/apex にコピーします。
3. ファイルの名前を com.android.apex.cts.shim.apex に変更します。
デバイスで APEX パッケージの管理がサポートされていない場合:
1. デバイスの Android バージョンとハードウェアアーキテクチャに該当する APEX shim パッケージをダウンロードします。shim パッケージの表の右側 2 列に、ダウンロードするパッケージへのリンクが記載されています。
2. CtsShim.apk を /system/app/ にコピーします。
3. CtsShim.apk の名前を CtsShimPrebuilt.apk に変更します。
4. CtsShimPriv.apk を /system/priv-app/ にコピーします。
5. CtsShimPriv.apk の名前を CtsShimPrivPrebuilt.apk に変更します。
デバイスにセキュアエレメントが複数ある場合:
1. google-cardlet.cap をダウンロードします。
2. ダウンロードしたファイルを /data/uicc/cardlets/ にコピーします。
デバイスにセキュアエレメントが複数ある場合は、サンプルアプレットを、DUT の組み込みセキュアエレメント（eSE）または DUT で使用する SIM カードにインストールします。詳しくは、セキュアエレメントの CTS テストをご覧ください。
デバイスにディスプレイが搭載されていない場合は、ディスプレイを接続します。
デバイスにメモリカードスロットがある場合は、空の SD カードを挿入します。 CTS に確実に合格できるように、SDHC または SDXC の容量で、UHS バス対応であるか、スピードクラス 10 以上の SD カードを使用してください。

警告: デバイスに挿入されている SD カードのデータが CTS により変更または消去される場合があります。
デバイスに SIM カードスロットがある場合は、アクティベーション済みの SIM カードをスロットに挿入します。デバイスが SMS に対応している場合、各 SIM カードに固有の番号フィールドが設定されている必要があります。Android 12 以降を搭載したデバイスの場合、すべての SIM カードが短縮番号（ADN）の保存に対応している必要があります。通信専用ファイル（DF_Telecom）を使用する GSM カードと USIM カードはこの要件を満たしています。

警告: デバイスに挿入されている SIM カードのデータが CTS により変更または消去される場合があります。
デバイスの SIM が、UICC の準備で指定されている要件を満たす、CTS キャリアの権限を持っていることを確認します。

DUT を構成する

次の手順に沿って、CTS で使用する DUT を構成します。

DUT での手順:

デバイスを出荷時設定にリセットします。

警告: このリセットにより、デバイスからすべてのユーザーデータが消去されます。
デバイスの言語を英語（米国）に設定します。
デバイスがデフォルトのフォントのカスタマイズをサポートしている場合は、デフォルトの Sans Serif フォントファミリーを Roboto に設定します。
デバイスに GPS または Wi-Fi / モバイルネットワークの機能がある場合は、位置情報の設定をオンにします。
IPv6 対応で、DUT を隔離されたクライアントとして扱うことができ、インターネットに接続している Wi-Fi ネットワークに接続します。隔離されたクライアントについて詳しくは、物理環境のセットアップをご覧ください。
ロックパターンまたはパスワードが設定されていないことを確認します。
USB デバッグを有効にします。
1. [設定] > [デバイス情報] に移動して [ビルド番号] を 7 回タップします。システム設定のカテゴリ内に [開発者向けオプション] が表示されます。
2. [USB デバッグ] をタップします。
Android 10 以前のデバイスで USB デバッグを有効にするには、CTS を設定する（AOSP 10 以前）をご覧ください。
時刻を 12 時間形式に変更します。
[開発者向けオプション] > [スリープモードにしない] を有効にします。
USB アプリの確認を無効にします。
1. [開発者向けオプション] に移動します。
2. [USB 経由のアプリを確認] をタップします。
Android 13 以降の場合は、疑似モデムを有効にします。
1. [開発者向けオプション] に移動します。
2. [疑似モデムの許可] をタップします。
この設定は、特定のテレフォニーテストで必須です。

デスクトップマシンでの手順:

ブラウザを開き、起動画面や設定画面を閉じます。
USB ケーブルを使用して DUT をデスクトップマシンに接続します。
このパソコンからのデバッグを許可する RSA キーを受け入れるかどうかを尋ねるメッセージが表示された場合は、[USB デバッグを許可] をクリックします。
ユーザーがアクセス可能なアフォーダンス（非表示でない）設定を使用して Roboto2 を Sans Serif フォントとして設定します。
CTS メディアファイルを DUT にコピーします。
1. メディアファイルをダウンロード、展開したパスに移動（cd）します。
2. 次のように、ファイルの権限を変更します。
```
chmod u+x copy_media.sh
```
3. ファイルをコピーします。
  - 解像度が 720x480 以下のクリップをコピーするには、次のコマンドを実行します。
```
./copy_media.sh 720x480
```
  - 最高の解像度がわからない場合は、次のコマンドですべてのファイルをコピーします。
```
./copy_media.sh all
```
  - 複数の DUT がある場合は、特定のデバイスのシリアルオプション（-s）を最後に追加します。たとえば、720x480 以下をシリアル 1234567 のデバイスにコピーするには、次のコマンドを実行します。
```
./copy_media.sh 720x480 -s 1234567
```

Mainline に関連する CTS ファイルのダウンロード

Mainline に関連する CTS ファイルをダウンロードするには:

次のコマンドを実行して、デバイスの Android API レベルを取得します。
```
adb shell getprop ro.build.version.sdk
```
download_mcts.sh スクリプトの手順に沿って、Mainline CTS ファイルをダウンロードします。

ネットワークの速度によっては、ダウンロードに 10 分以上かかることがあります。

Shim パッケージ

次の表は、デバイスのバージョンとアーキテクチャごとに利用可能なパッケージの一覧です。

デバイスのバージョン	パッケージ（APEX がサポートされている場合）		パッケージ（APEX がサポートされていない場合）
	ARM	x86	ARM	x86
Android 15	`15-arm-release`	`android15-x86-release`	`android15-arm-CtsShim.apk` `android15-arm-CtsShimPriv.apk`	`android15-x86-CtsShim.apk` `android15-x86-CtsShimPriv.apk`
Android 14	`android14-arm-release`	`android14-x86-release`	`android14-arm-CtsShim.apk` `android14-arm-CtsShimPriv.apk`	`android14-x86-CtsShim.apk` `android14-x86-CtsShimPriv.apk`
Android 13	`android13-arm-release`	`android13-x86-release`	`android13-arm-CtsShim.apk` `android13-arm-CtsShimPriv.apk`	`android13-x86-CtsShim.apk` `android13-x86-CtsShimPriv.apk`
Android 12	`android12-arm-release`	`android12-x86-release`	`android12-arm-CtsShim.apk` `android12-arm-CtsShimPriv.apk`	`android12-x86-CtsShim.apk` `android12-x86-CtsShimPriv.apk`
Android 11	`android11-arm-release`	`android11-x86-release`	`android11-arm-CtsShim.apk` `android11-arm-CtsShimPriv.apk`	`android11-x86-CtsShim.apk` `android11-x86-CtsShimPriv.apk`
Android 10	`android10-release`		`android10-arm-CtsShim.apk` `android10-arm-CtsShimPriv.apk`	`android10-x86-CtsShim.apk` `android10-x86-CtsShimPriv.apk`
Android 9、O、O-MR1	なし	なし	`arm-CtsShim.apk` `arm-CtsShimPriv.apk`	`x86-CtsShim.apk` `x86-CtsShimPriv.apk`

次のステップ

このドキュメントを読み終わったら、CTS 自動テストを実行するをご覧ください。