Geliştirici Destekli CTS

Bu sayfada, Geliştirici Destekli CTS (CTS-D) için kullanım yönergeleri özetlenmektedir.

Test kapsamı

CTS-D (ör. CTS ve CTS Doğrulayıcı, yalnızca aşağıdakileri zorunlu kılabilir:

  • Geliştirici SDK'sında açıklanan, herkese açık tüm API'ler (developer.android.com) ekleyebilirsiniz.
  • Android Uyumluluğu'nda yer alan tüm gereksinimler ZORUNLUDUR Belirli bir API düzeyi için Tanım Belgesi (CDD).

Kesinlikle ÖNERİLİR, ÖNERİLİR, OLABİLİR gibi zorunlu olmayan şartlar isteğe bağlıdır. CTS ile test edilemez.

Tüm API ve CDD şartları belirli bir API düzeyine bağlı olduğundan tüm CTS CTS, CTS-D ve CTS Doğrulayıcı testlerinin (CTS, CTS-D ve CTS Doğrulayıcı), veya gerekliliklere karşılık gelir. Belirli bir API kullanımdan kaldırılmış veya değiştirilmişse ilgili testin desteği sonlandırılmalı veya güncellenmelidir.

CTS testi oluşturma kuralları

  • Bir test, tutarlı bir şekilde aynı hedef sonucu üretmelidir.
  • Bir test, o cihazı test ederek başarılı mı yoksa başarısız mı olduğunu belirlemelidir bir kez daha kullanabilirsiniz.
  • Test oluşturan kullanıcılar, test sonuçlarını etkileyebilecek tüm faktörleri kaldırmalıdır.
  • Bir cihaz için belirli bir donanım koşulu/ortamı/kurulumu gerekiyorsa bu kurulum, kayıt mesajında net bir şekilde tanımlanması gerekir. Örneğin, kurulum talimatları, CTS'yi ayarlama adlı makaleyi inceleyin.
  • Test, tek seferde 6 saatten fazla çalıştırılmamalıdır. Çalışması gerekirse teklifi değerlendirebilmemiz için lütfen gerekçeyi test teklifinize ekleyin.

Aşağıda, bir uygulamayı test etmeye yönelik örnek test koşulları grubu verilmiştir kısıtlama:

  • Kablosuz ağ kararlı durumda (kablosuz ağa dayalı bir test için).
  • Cihaz test sırasında sabit kalır (teste bağlı olarak sabit kalır).
  • Cihazın fişi, pil seviyesi yüzde X yüksek olan herhangi bir güç kaynağından çıkar.
  • Çalışmakta olan uygulama, ön plan hizmeti veya arka plan hizmeti CTS
  • CTS çalışırken ekran kapatılır.
  • Cihaz isLowRamDevice DEĞİL.
  • Pil tasarrufu / uygulama kısıtlamaları durumu hakkında daha fazla bilgi edinin.

Test uygunluğu

Mevcut CTS tarafından test edilmeyen bir davranışı zorunlu kılan yeni testleri kabul ediyoruz. CTS Doğrulayıcı veya CTS-D testleri. Kapsam dışında bir davranışı kontrol eden tüm testler test kapsamımızın kadarı reddedilecektir.

CTS gönderim süreci

  1. Test teklifi yazma: Uygulama geliştirici, Google Sorun İzleyici, Belirlenen sorunu açıklamak ve kontrol edilmesi için bir test önermek sahip olacaksınız. Teklif, ilişkili CDD gereksinim kimliğini içermelidir. Android ekibi teklifi inceler.
  2. CTS testi geliştirme: Bir teklif onaylandıktan sonra, gönderen kişi bir CTS oluşturur ana (AOSP/ana) daldaki AOSP'de test edin. Android ekibi kodu inceler.
  3. Testi yayınlayın: CL'nizi AOSP/main tarihinde gönderin ve sonra en son androidx-tests-dev dalını tıklayın. Test artık herkesin kullanımına açık.

CTS-D testi yazma yönergeleri

  • Java Code Style Guide'daki (Java Kodu Stil Kılavuzu) tavsiyeleri uygulayın.
  • CTS Geliştirme bölümünde açıklanan tüm adımları uygulayın.
  • Testlerinizi uygun test planına ekleyin:
    • Yeni testlerinizi CTS-D test planına eklemek için include-filters yöntemini kullanın: platform/cts/tools/cts-tradefed/res/config/cts-developer.xml.
    • Yeni testlerinizi ana CTS test planından hariç tutmak için exclude-filters yöntemini kullanın: platform/cts/tools/cts-tradefed/res/config/cts-developer-exclude.xml.
  • build_error.log dokümanındaki tüm errorprone uyarı ve öneriyi işleyin.
  • Değişikliklerinizin temelini head olarak değiştirin. Buna cts-developer.xml ve cts-developer-exclude.xml test planı.
  • Google mühendislik temsilcinizle birlikte çalışarak test durumunuzun mevcut bir CTS modülüne dahil edilebilir. Aksi halde size yeni bir modül oluşturabilirsiniz.
  • Oluşturulan her yeni test modülü için yeni test modülünde bir OWNERS dosyası oluşturun dizin.
    • OWNERS dosyanız, çalıştığınız Google test sahibi:
    • # Bug component: xxx
    • Google test sahibi LDAP
  • AndroidTest.xml alanında aşağıdaki parametreleri belirtin. Referans örnek dosyalar (1, 2) örneğin:
    • Instant_app veya not_instant_app
    • secondary_user veya not_secondary_user
    • all_foldable_states veya no_foldable_states
  • Doğru minSDK'yı belirtmek için <uses-sdk> dokümanlarına göz atın.
  • Yeni test yöntemlerini, dersleri veya modülleri kontrol ederken bunları CTS-D'ye ekleyin planlandığı gibi ana CTS test planından hariç tutmak için yeni testler var.

CTS-D testinizi çalıştırın

CTS-D test planını komut satırından çalıştırın run cts --plan cts-developer kullanılıyor.

Belirli bir test durumu çalıştırmak için run cts --include-filter "test_module_name test_name" işlevini kullanın.

Tam CTS'yi çalıştırma hakkında bilgi için CTS testlerini çalıştırma bölümüne bakın.

Kabul ve ibra

Bir test isteği gönderildikten sonra, dahili bir ekip isteği inceleyerek bir CDD gereksinimini veya belgelenmiş bir API davranışını test eder. Test geçerli bir gereksinimi veya davranışı kontrol ettiğini belirlediğinde, bu test destek kaydını daha ayrıntılı bir şekilde incelenmesi için bir Google mühendisine iletecek. Google mühendis, testin nasıl iyileştirilebileceğiyle ilgili geri bildirimde bulunmak üzere size ulaşacak erken bir aşamada yapılması gerekir.

Görüntüleyin Yayın planı ve şube bilgileri ayrıntılı bir şekilde inceleyebilirsiniz.