Bu dokümanda, birden fazla cihaz oluşturmayla ilgili adım adım talimatlar yer almaktadır ve bilindiğinde mevcut sınırlamaları belirtir.
Örnek
CTS kablosuz duyarlı çoklu cihaz modülü sağlanır. Bir kişiden mesaj gönderir kablosuz ağ üzerinden cihazı alır ve diğer cihazın iletiyi aldığını doğrular.
Modülün kaynağı: paketler/modüller/Wifi/tests/hostsidetests/multidevices/test/aware/.
Örneğe faydalı olduğunu düşündüğümüz kadar açıklama ekledik.
1. Adım: Modül klasörünü oluşturun
Paketteki birden fazla cihaz modülünüz için bir klasör oluşturmanız önerilir ve açıklıktan ibarettir. Örneğin: cts/hostsidetests/multidevices/. Bunu, birden çok cihaza ait tüm modüllerin en az Bu da örneklerin keşfedilmesini kolaylaştıracaktır.
Bu modüldeki tüm dosyalar kendi modül klasörlerinin altına yerleştirilmelidir. Örneğin,
örnek: wifi_aware.
2. Adım: Testi oluşturun
Test mantığınızı burada uygularsınız. Büyük ölçüde projenin yardımcı oluyorum.
Mobly test kaynağını oluşturun. Örneğin: wifi_aware_test.py adresine gidin.
3. Adım: Derleme dosyasını oluşturun: Android.bp
Şunun gibi bir Android.bp dosyası ekleyin: Paketler/modüller/Wifi/tests/hostsidetests/multidevices/test/Android.bp Şuna benzer bir python_test_host modülü tanımlayın:
python_test_host {
name: "CtsWifiAwareTestCases",
main: "wifi_aware_test.py",
srcs: ["wifi_aware_test.py"],
test_suites: [
"cts",
"general-tests",
],
test_options: {
unit_test: false,
},
data: [
// Package the snippet with the mobly test
":wifi_aware_snippet",
],
}
Veri alanıyla test için snippet'leri belirtin. Bu veri alanı ATest tarafından veya ATest tarafından bulunup teste eklenebilir Sürekli yürütme.
Mobly Gruplandırılmış Snippet'ler Android'de şu adresten kullanılabilir: external/mobly-bundled-snippets/ (harici/mobly-bundled-snippets) sayfasından yararlanabilirsiniz.
İsteğe bağlı: Özel snippet'ler oluşturma
Birden çok cihaza yönelik bazı modüller özel Mobly snippet'leri gerektirebilir. Örnek test kablosuz duyarlı snippet içerir. packages/modules/Wifi/tests/hostsidetests/multidevices/com.google.snippet.wifi/aware/WifiAwareSnippet.java, Mobly Snippet Lib ile geliştirilmiştir ve Android'de şurada mevcuttur: external/mobly-snippet-lib/.
Snippet, Android.bp'de şunun gibi android_test kuralıyla tanımlanmalıdır: standart araçlar:
android_test {
name: "wifi_aware_snippet",
sdk_version: "current",
srcs: [
"CallbackUtils.java",
"WifiAwareSnippet.java",
],
manifest: "AndroidManifest.xml",
static_libs: [
"androidx.test.runner",
"guava",
"mobly-snippet-lib",
],
}
4. Adım: Modül yapılandırmasını oluşturun: AndroidTest.xml
Şunun gibi bir AndroidTest.xml dosyası ekleyin: packages/modules/Wifi/tests/hostsidetests/multidevices/test/aware/AndroidTest.xml. Bu test yapılandırmasında test için iki cihaz belirtmeniz gerekir. şuna benzer:
<configuration description="Config for CTS Wifi Aware test cases">
<option name="test-suite-tag" value="cts" />
<option name="config-descriptor:metadata" key="component" value="wifi" />
<option name="config-descriptor:metadata" key="parameter" value="not_instant_app" />
<option name="config-descriptor:metadata" key="parameter" value="not_multi_abi" />
<option name="config-descriptor:metadata" key="parameter" value="not_secondary_user" />
<device name="device1">
<!-- For coverage to work, the APK should not be uninstalled until after coverage is pulled.
So it's a lot easier to install APKs outside the python code.
-->
<target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
<option name="test-file-name" value="wifi_aware_snippet.apk" />
</target_preparer>
<target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
<option name="run-command" value="input keyevent KEYCODE_WAKEUP" />
<option name="run-command" value="wm dismiss-keyguard" />
</target_preparer>
<target_preparer class="com.android.tradefed.targetprep.PythonVirtualenvPreparer">
<!-- Any python dependencies can be specified and will be installed with pip -->
<option name="dep-module" value="mobly" />
</target_preparer>
</device>
<device name="device2">
<target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
<option name="test-file-name" value="wifi_aware_snippet.apk" />
</target_preparer>
<target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
<option name="run-command" value="input keyevent KEYCODE_WAKEUP" />
<option name="run-command" value="wm dismiss-keyguard" />
</target_preparer>
</device>
<test class="com.android.tradefed.testtype.mobly.MoblyBinaryHostTest">
<!-- The mobly-par-file-name should match the module name -->
<option name="mobly-par-file-name" value="CtsWifiAwareTestCases" />
<!-- Timeout limit in milliseconds for all test cases of the python binary -->
<option name="mobly-test-timeout" value="60000" />
</test>
</configuration>
Şu noktalara dikkat edin:
- Bu örnek testin Mobly'ye bağımlılığı var. Herhangi bir bağımlılık belirtilebilir
PythonVirtualenvPrepareriçin kullanılacak ve pip ile yüklenecek. MoblyBinaryHostTestiçinmobly-par-file-nameözelliği modülle eşleşmelidir gerekir.- Test için bir
mobly-test-timeoutbelirtin. Milisaniye cinsinden tam python ikili program yürütmesi için geçerlidir (tüm test durumları birlikte). Bu, bazı sorunlar yaşanması halinde test durumlarının sonsuza kadar askıya alınmasını önlemek için gereklidir. - Her
deviceetiketi, her bir cihaz (The Mobly) için ayrı bir kurulum içerebilir config, bu öğeleri XML'de belirtilen sırayla alır.
Snippet apk ile ilgili yükleme:
- İlk POC, üzerinden snippet apk'leri yükleyecek şekilde güncellendi. Kapsam ekibi ile görüştüğümüzden dolayı target_preparer: kapsam ölçümleri çok erken silinmez, bunlar Harness tarafından kaldırılır test kodu yerine Python ikili dosyaları yerine pek çok yolu vardır.
5. Adım: Testi yerel olarak çalıştırın: atest
Şu anda birden fazla cihazda yapılan testler yalnızca fiziksel cihazlarda yapılmaktadır.
test cihazlarınızın doğru durumda olduğunu doğrulayın. adb
devices komutu, bağlı cihazlarınızın listesini bildirir. Listede
cihazlar, test için tasarlanmamış cihazları -s kullanarak belirtin
tıklayın.
Kablosuz bağlantı testleri için cihazlarda kablosuz bağlantının etkinleştirildiğinden emin olun (fabrika ayarlarına sıfırladıktan sonra).
Testi yerel olarak aşağıdaki şekilde çalıştırabilirsiniz:
$ atest CtsWifiAwareTestCases
Testteki özet başlığında kullanılan cihaz sayısını göreceksiniz
bir çıkış değeri (ör. Test executed with 2 device(s)) yazın.
Sorun giderme
Test, yerel olarak çalıştırıldığında aşağıdaki nedenlerle başarısız olursa:
Virtualenv hatası
java.io.IOException: Cannot run program
"virtualenv": error=2, No such file or directory
Lütfen virtualenv yolunun PATH yolunda olduğundan emin olun. "~/.local/bin" ekleniyor PATH hedefine
bu sorunu çözmek için.
Virtualenv yüklü değilse, şu adresi ziyaret edin: https://virtualenv.pypa.io/en/En/Son/installation.html
En az 2 denetleyici nesnesi alınması bekleniyordu, 1 tane alındı
Test modülleri birden fazla veya tek cihazlı olabilir. kullanabilirsiniz. Birden fazla cihaz modülü olmayan bir çoklu cihaz modülünü çalıştırmaya çalışırsanız cihazlarda şu hatayı görürsünüz:
Expected to get at least 2 controller objects, got 1
Modülü birden çok cihaz modunda yürütmek sorunu çözer.
CTS için: Bunu tetiklemek için parçalamayı kullanabilirsiniz (Örneğin: --shard-count 2)
veya run cts-multidevces.