CTS Doğrulayıcı çok cihazlı testlerini çalıştırma

Bu sayfada, Android 16 ve sonraki sürümler için CTS Verifier (CTS-V) çok cihazlı testlerini kullanmayla ilgili talimatlar yer almaktadır.

Barındırıcı tarafında çok cihazlı testler oluşturma

Bu bölümde, çok cihazlı testlerin nasıl ayarlanacağı açıklanmaktadır.

  1. Masaüstü bilgisayarınızın CTS için işletim sistemi gereksinimlerini karşıladığından emin olun.
  2. adb, AAPT2 ve Python'un masaüstünüze doğru şekilde yüklendiğinden emin olmak için Masaüstü yazılımını yükleme başlıklı makalenin 2. ve 5. adımlarını uygulayın.

  3. Her biri CTS-V kurulumu yapılmış iki eşleşen test cihazı (DUT) hazırlayın.

    • DUT oluşturma hakkında bilgi edinmek için DUT'u kurma başlıklı makaleyi inceleyin.
    • CTS-V'yi ayarlama talimatları için Kurulum bölümüne bakın.

  4. NFC dışında bir modülü test ediyorsanız Standart iki cihazlı testleri ayarlama başlıklı makaleyi inceleyin.

  5. CDM modülünü test ediyorsanız standart iki cihazlı kurulumun yanı sıra CDM testlerini ayarlama başlıklı makaleyi de inceleyin.

Standart iki cihazlı testler oluşturma

Varsayılan iki cihazlı kurulum için:

  1. Eşleşen iki Android DUT'u yaklaşık 20 cm mesafeye yerleştirin.

  2. Temiz bir ortam sağlamak için her iki cihazı da bir koruma kutusuna yerleştirin.

  3. (isteğe bağlı) Kablosuz ağda hata ayıklama için bir OTA sniffer ayarlayın.

NFC testlerini ayarlama

NFC testlerinde bir DUT ve PN532 NFC çipi kullanılır.

NFC testlerini ayarlamak için:

  1. PN532 NFC çipi satın alın. Hepsi Bir Arada PN532'yi öneririz.

  2. DUT'ta Ayarlar uygulamasına gidin.

  3. NFC'yi etkinleştirin.

  4. NFC çipini yerleştirin:

    • Telefonlarda DUT'un NFC okuyucusunu şekil 1'de gösterildiği gibi konumlandırın:

      NFC çipi konumlandırma

      Şekil 1. NFC çipi konumlandırması.

    • Diğer cihaz türlerinde çipi cihazın NFC anteninin yanına yerleştirin.

  5. PN532 NFC çipini USB kablosuyla test iş istasyonunuza bağlayın.

CDM testleri oluşturma

test_permissions_sync() test senaryosu, testin yürütüldüğü cihazların derleme türüne bağlı olarak farklı bir davranışa sahiptir. Hem hata ayıklama yapılabilir (userdebug veya eng) hem de hata ayıklama yapılamayan (user) sürümlerin OEM'ler tarafından test edilmesi ve her iki sürümün de testlerden geçmesi önemlidir.

Muafiyet

İzin senkronizasyonu API'si uygulaması için CDD ekinde, API'nin yalnızca güvenli bir kanal üzerinden cihazlar arasında veri aktarabilmesi gerektiği belirtilir. Güvenli kanal uygulaması CDD uygunluk koşulu olmadığından bu test, hata ayıklama yapılamayan (kullanıcı) derlemelerde atlanabilir ancak yalnızca CDM izin senkronizasyonu özelliğini desteklemeyi devre dışı bırakmak istiyorsanız atlanabilir.

Testler, hata ayıklama yapılabilir derlemelerde istisnasız olarak geçmelidir.

Hata ayıklama yapılamayan derlemelerde test için ön koşullar

Önceki muafiyet hükümleri uyarınca muaf değilseniz aşağıdaki ön koşulların karşılandığından emin olun.

Güvenli kanal, donanımın güvenilirliğini doğrulamak için AVF'yi (AttestationVerificationFramework) kullanır. Her iki taraf tarafından oluşturulan doğrulamalar, sistemlerinde yetkisiz bir değişiklik yapılmadığından emin olmak için kendileriyle ilgili çeşitli bilgiler içerir. AVF, doğrulama işlemi sırasında aşağıdaki durumları kontrol eder:

  • Cihazın internete erişimi olmalıdır.
  • Cihaz doğrulanmış önyükleme kullanıyor ve derleme, geliştirici anahtarı yerine sürüm anahtarıyla imzalanmış olmalıdır
  • Cihazın bootloader'ı kilitli. Ayrıntılı talimatlar için açılış yükleyiciyi kilitleme başlıklı makaleyi inceleyin.
  • İşletim sistemi, anahtar başlatma ve anahtar tedarikçi yama seviyeleri 12 ay içinde olmalıdır. Bir yıldan eski bir derleme kullanmayın

  • Cihaz tasdiki, tedarikçi firma tarafından onaylanan kök sertifikalardan biri tarafından desteklenir. Güvenilir kök sertifikalarınızı vendor_required_attestation_certificates.xml kaynak yer paylaşımında belirtin.

Barındıran taraflı çok cihazlı testler çalıştırma (AOSP 16 veya sonraki sürümler)

CTS Verifier 16, ana makine tarafında çok cihazlı testler için destek sunar. Bu testler, cihazdaki manuel test işlemi yerine ana makinede otomatik komut dosyaları kullanılarak çalıştırılabilir. Her test tamamlandıktan sonra sonuçlar otomatik olarak DUT'a yüklenir ve CTS Doğrulayıcı uygulamasında gösterilir.

Bu bölümde, ana makine tarafında çok cihazlı testlerin nasıl çalıştırılacağı açıklanmaktadır.

Çok cihazlı testler çalıştırma

Çok cihazlı test çalıştırmak için:

  1. Test iş istasyonunuzda, CTS-V zip paketinin açıldığı dizinden cts-v-host konsolunu başlatın:

    ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed

  2. DUT'taki CTS Doğrulayıcı uygulamasından Barındırıcı Tarafı Testleri'ni tıklayın. Şekil 2'de, CTS Doğrulayıcı uygulamasındaki ana makine taraflı testler gösterilmektedir:

    CTS Doğrulayıcı uygulamasında barındıran taraflı çok cihazlı testler

    Şekil 2. CTS Doğrulayıcı uygulamasında barındıran taraflı çok cihazlı testler.

    Test ana makine tarafında çok cihazlı test modüllerinin listesi gösterilir.

  3. Çalıştırmak istediğiniz test modülünün adını belirleyin. Örneğin, CompanionDeviceManager modülü CtsCompanionDeviceManagerMultiDeviceTestCases olarak listelenir.

  4. cts-v-host konsolunda aşağıdaki komutu çalıştırın: Not: CTS Doğrulayıcı uygulamasında ana makine tarafında bir modüle dokunursanız ayrı test Bunun yerine, modül ana makinede çalıştırıldıktan sonra kullanıcı arayüzü test durumu sonuçlarıyla otomatik olarak doldurulur.

  5. xTS konsolunda aşağıdaki komutu çalıştırın:

    run cts-v-host -m test_module_name

    Örneğin:

    run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases

    xTS konsolu testleri çalıştırmayı tamamladıktan sonra sonuçlar CTS Doğrulayıcı uygulamasında gösterilir. Yeşil olarak işaretlenen testler başarılıdır. Kırmızıyla işaretlenen testler başarısız oldu. Şekil 3'te, CtsCompanionDeviceManager testlerine ait örnek sonuçlar gösterilmektedir:

    CTS Doğrulayıcı uygulamasında barındıran taraflı çok cihazlı test sonuçları

    Şekil 3. Barındıran taraflı çok cihazlı test sonuçları CTS Doğrulayıcı uygulamasında.

Çok cihazlı testlerle ilgili sorunları giderme

Bu bölümde, olası sorunlarla ilgili sorun giderme yardımı sağlanır.

NFC testleri sırasında GetFirmwareVersion için yanıt yok sorununu düzeltme

Çok cihazlı testleri çalıştırırken verify_firmware_version RuntimeError: No response for GetFirmwareVersion mesajını alırsanız testler PN532 NFC kartına erişemez.

Bu sorunu düzeltmek için ana makinenizdeki PN532 NFC kartının kullandığı seri yolunu (ör. dev/ttyUSB1) tanımlayın, ardından konsolda --module-arg bağımsız değişkenini kullanarak manuel olarak belirtin:

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

NFC testleri sırasında "İşlem tamamlanamadı" hata mesajını düzeltme

Tüm NFC test durumları için Transaction failed, check device logs for more information. mesajını alıyorsanız bunun nedeni DUT'un NFC çipinin PN532'yi algılayamaması olabilir.

Ana makineye bağlı birden fazla cihazınız varsa ve bunların bazılarında PN532 yerleştirilmemişse yanlış DUT seçilmiş olabilir. Daha fazla bilgi için NFC testlerini ayarlama başlıklı makaleyi inceleyin.

Bu sorunu düzeltmek için aşağıdakilerden birini yapın:

  • -s işaretini kullanarak ana makine tarafındaki test komutunuzda doğru DUT seri numarasını ayarlayın.

  • DUT dışındaki tüm cihazların ana makineyle bağlantısını kaldırın.

CDM test durumu test_permissions_sync yoksayılır

Test, hata ayıklama yapılamayan cihazlarda çalıştırılıyorsa istisnadan muaf olup olmadığınızı kontrol edin. Aksi takdirde, her iki cihazın da ön koşulları karşıladığından emin olun.