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

Bu sayfada, Android 16 ve sonraki sürümlerde CTS Verifier (CTS-V) çoklu cihaz testlerinin kullanımıyla ilgili talimatlar yer almaktadır.

Ana makine tarafında çok cihazlı testler ayarlama

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

  1. Masaüstü makinenizin CTS için işletim sistemi gereksinimlerini karşıladığından emin olun.
  2. adb, AAPT2 ve Python'ın 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 kurulu olan, teste tabi iki eşleşen cihaz (DUT) hazırlayın.

    • DUT kurulumu hakkında bilgi edinmek için DUT'u kurma başlıklı makaleyi inceleyin.
    • CTS-V'yi ayarlama talimatları için Kurulum başlıklı makaleyi inceleyin.

  4. NFC dışındaki bir modülü test ediyorsanız Standart iki cihazlı testler ayarlama bölümündeki adımları uygulayın.

  5. CDM modülünü test ediyorsanız standart iki cihazlı kurulumun yanı sıra CDM testlerini ayarlama bölümündeki talimatları uygulayın.

Standart iki cihazlı testler ayarlama

Varsayılan iki cihaz kurulumu için:

  1. Birbiriyle eşleşen iki Android DUT'u yaklaşık 20 cm arayla yerleştirin.

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

  3. (İsteğe bağlı) Kablosuz hata ayıklama için OTA sniffer'ı ayarlayın.

NFC testlerini ayarlama

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

NFC testlerini ayarlamak için:

  1. PN532 NFC çipi satın alın. All-In-One PN532'yi öneririz.

  2. DUT'ta Ayarlar uygulamasına gidin.

  3. NFC'yi etkinleştirin.

  4. NFC çipini konumlandırın:

    • Telefonlar için DUT'un NFC okuyucusunu Şekil 1'de gösterildiği gibi konumlandırın:

      NFC çipinin konumu

      1. şekil. NFC çipinin konumu

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

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

CDM testleri oluşturma

test_permissions_sync() test durumu, testin yürütüldüğü cihazların derleme türüne bağlı olarak farklı davranışlar gösterir. Hata ayıklanabilir (userdebug veya eng) ve hata ayıklanamayan (user) derlemelerin her ikisinin de OEM'ler tarafından test edilmesi ve her ikisi için de testlerin başarılı olması kritik önem taşır.

Muafiyet

İzin senkronizasyonu API'si uygulaması için CDD maddesi, yalnızca cihazlar arasında güvenli bir kanal üzerinden verilerin başarıyla aktarılabilmesini gerektirir. Güvenli kanal uygulaması bir CDD uygunluk şartı olmadığından bu test, hata ayıklanamayan (kullanıcı) derlemelerde atlanabilir ancak yalnızca CDM izinleri senkronizasyon özelliğini desteklemeyi devre dışı bırakmak istiyorsanız.

Testler, hata ayıklanabilir derlemelerde istisnasız olarak başarılı olmalıdır.

Hata ayıklanamayan derlemelerde test için ön koşullar

Önceki muafiyet maddeleri kapsamında 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ın oluşturduğu onaylar, sistemlerinde yetkisiz 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 internet erişimi olmalıdır.
  • Cihazda Doğrulanmış Önyükleme kullanılıyor ve derleme, geliştirme anahtarıyla değil yayın anahtarıyla imzalanmış olmalıdır.
  • Cihazın bootloader'ı kilitli olmalıdır. Ayrıntılı talimatlar için önyükleyiciyi kilitleme başlıklı makaleyi inceleyin.
  • İşletim sistemi, temel başlatma ve temel satıcı yama düzeyleri 12 ay içinde olmalıdır. Bir yıldan eski bir derleme kullanmayın.

  • Cihaz doğrulama, satıcı tarafından onaylanmış kök sertifikalardan biriyle desteklenir. Güvenilir kök sertifikalarınızı vendor_required_attestation_certificates.xml kaynak yer paylaşımında belirtin.

Ana makine tarafında ç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, cihazda manuel test işlemi yerine ana makinede otomatik komut dosyaları kullanılarak yürütülebilir. Her test tamamlandıktan sonra sonuçlar otomatik olarak DUT'a yüklenir ve CTS Verifier 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 Verifier uygulamasında Host-side Tests'i (Ana Taraf Testleri) tıklayın. Şekil 2'de, CTS Verifier uygulamasındaki ana makine tarafı testleri gösterilmektedir:

    CTS Doğrulayıcı uygulamasında ana makine tarafı çok cihazlı testler

    Şekil 2. CTS Verifier uygulamasında ana makine tarafı çok cihazlı testler.

    Test 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:

    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 Verifier uygulamasında görünür. Yeşil işaretli testler başarılı olmuştur. Kırmızı işaretli testler başarısız oldu. Şekil 3'te, CtsCompanionDeviceManager testlerinin örnek sonuçları gösterilmektedir:

    CTS Doğrulayıcı uygulamasında ana makine tarafı çoklu cihaz test sonuçları

    3.Şekil CTS Doğrulayıcı uygulamasında ana makine tarafı çok cihazlı test sonuçları.

Ç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

Çoklu cihaz testlerini ç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 makinenizde PN532 NFC kartı tarafından kullanılan seri yolunu (ör. dev/ttyUSB1) belirleyin, 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 başarısız oldu" hata mesajını düzeltme

Tüm NFC test senaryolarında Transaction failed, check device logs for more information. mesajını alıyorsanız bunun nedeni muhtemelen DUT'un NFC çipinin PN532'yi algılayamamasıdır.

Ana makineye bağlı birden fazla cihazınız varsa ve bunlardan bazılarının üzerinde PN532 yoksa 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'un seri numarasını ayarlayın.

  • DUT dışındaki tüm cihazların ana bilgisayarla bağlantısını kesin.

CDM test durumu test_permissions_sync yoksayılıyor

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