プロファイル命名規約による自動デバイス検出

テストで使用する仮想デバイス/実デバイスを プロファイル命名規約 によって決定することができます。

注意

この機能はローカルマシンで利用できます。リモートサーバーでは利用できません。

プロファイル命名規約 を使用すれば testConfig.jsonにプロファイルを定義してcapabilitiesを構成する必要はありません。 プロファイル名を指定するだけです。

testConfig.json

...
  "profiles": [
  ]
...

例 (Android)

AVD名をプロファイル名としてtestrunファイルで指定することができます。

testrun.properties

android.profile=Pixel 8(Android 14)

テストを実行するとAVD名がPixel 8(Android 14)である仮想デバイスが検索されて起動します。

Console

78	[00:00:13]	2024/04/14 22:04:36.055	{}	0	-	[info]	+10175	C	()	Connected device found. (Pixel_8_Android_14_:5554, Android 14, emulator-5554)

例 (iOS)

Simulatorのデバイス名をプロファイル名としてtestrunファイルで指定することができます。

testrun.properties

os=ios
ios.profile=iPhone 15(iOS 17.2)

テストを実行するとSimulatorデバイスiPhone 15(iOS 17.2)が検索されて起動します。

Console

125	[00:00:24]	2024/04/14 22:01:47.766	{s10}	0	-	[info]	+2268	C	(launchApp)	Device found. (iPhone 15(iOS 17.2), iOS 17.2, 4F87A640-BC60-46F1-8124-BD01B3862DD1)

プロファイル命名規約

Android

パターン プロファイル名 説明
AVD name Pixel 8 API 34 Android仮想デバイス Pixel 8 API 34
model(os_version) Pixel 8(Android 14) 接続されているデバイス Pixel 8(Android 14)
model(os_version) Pixel 8(14) 接続されているデバイス Pixel 8(Android 14)
os_version Android * 接続されているデバイス
os_version Android 14 接続されているデバイス Android 14
os_version 14 接続されているデバイス Android 14
udid emulator-5554 接続されているエミュレーター udid:emulator-5554
udid 14141JEC20492X 接続されている実デバイス udid:14141JEC20492X

iOS

パターン プロファイル名 説明
deviceName Device 1 iOSデバイス Device 1
os_version 17.2 iOSデバイス (iOS 17.2)
model(os_version) iPhone * iOSデバイス
model iPhone 15 iOSデバイス (iPhone 15)
model(os_version) iPhone 15(17.2) iOSデバイス (iPhone 15, iOS 17.2)
udid D0A63437-19F6-4756-8F27-8B1AA9EC22A4 iOSデバイス (udid:D0A63437-19F6-4756-8F27-8B1AA9EC22A4)

Androidエミュレーター

Android Studioを開いてDevice Managerで virtual タブを確認します。

Device Manager

プロファイル名としてAVD名を使用できます。

テスト開始時に指定されたAVDが起動していない場合は自動で起動します。

iOSシミュレーター

Xcode を起動して Simulators タブを確認します。

Simulators

プロファイル名としてシミュレーターのデバイス名を使用できます。

テスト開始時に指定されたシミュレーターデバイスが起動していない場合は自動で起動します。


Link