Araç testleri

Öncelikle Uygulamanızı test etme başlıklı makaleyi okuyun geliştirici.android.com adresinde bulabilirsiniz. Bu iki kavram arasında bazı farklılıklar araç testlerinin platform testlerinde nasıl kullanıldığına bakalım.

Özet olarak, enstrümantasyon testi, am instrument komutu aracılığıyla başlatılan özel bir test yürütme ortamı sağlar. Bu ortamda, hedeflenen uygulama işlemi yeniden başlatılır ve temel uygulama bağlamıyla başlatılır. Ayrıca, uygulama işlemi sanal makinesinin içinde bir enstrümantasyon iş parçacığı başlatılır. Sizin test kodu bu araç iş parçacığında yürütülmeye başlar ve uygulama bağlamına erişim sağlayan bir Instrumentation örneği test edilen uygulama sürecini değiştirmek için kullanılan API'ler bulunur.

Temel kavramlar

  • bir araç, uygulama paketinde açıkça belirtilmelidir. <instrumentation> etiketi, uygulama paketi manifestinin <manifest> etiketi altında iç içe yerleştirilmiş şekilde gösterilir.
  • Uygulama paketi manifesti teknik olarak birden fazla <instrumentation> etiketi içerebilir ancak genellikle bu şekilde kullanılmaz.
  • her <instrumentation> şunları içermelidir:
    • android:name özelliği: bu, Instrumentation her şey test uygulamasıdır. Bu, genellikle örneğin, kullanılan koşucu, örneğin: android.support.test.runner.AndroidJUnitRunner
    • android:targetPackage özelliği tanımlanmalıdır. Değeri, test edilen uygulama paketi olarak ayarlanmalıdır.

Adımların özeti

  1. Çerçeve hizmetlerine yönelik hermetik testlerin yaygın hedeflerini aşağıda bulabilirsiniz:

    frameworks/base/core/tests/coretests
    frameworks/base/services/tests/servicestests
    

    Bileşeniniz için yepyeni bir araç modülü ekliyorsanız daha fazla bilgi için

  2. Yukarıdaki konumlardan birine test ekleyecekseniz mevcut sözleşmeyi uygulayın. Yeni bir test modülü oluşturuyorsanız lütfen yukarıdaki konumlardan birinde AndroidManifest.xml ve Android.mk ayarlarını uygulayın.

  3. Görüntüleyin çerçeveler/temel/çekirdek/testler/temeltestler/ inceleyebilirsiniz. Bu satırların ek uygulamalar yüklediğini unutmayın:

    <option name="test-file-name" value="FrameworksCoreTests.apk" />
    <option name="test-file-name" value="BstatsTestApp.apk" />
    
  4. Testinizi @SmallTest, @MediumTest veya @LargeTest

  5. Test modülünü m ile oluşturun.Ör.:

    m FrameworksCoreTests
    
  6. Testleri çalıştırın:

    m tradefed-all
    tradefed.sh run template/local_min --template:map test=FrameworksCoreTests
    
  7. Tradefed kullanmıyorsanız testleri manuel olarak yükleyin ve çalıştırın:

    1. Oluşturulan APK'yı yükleyin:
    adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk
    
    1. Testleri çeşitli seçeneklerle çalıştırın:

      1. APK'daki tüm testler

        adb shell am instrument -w com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      2. belirli bir Java paketi altındaki tüm testler

        adb shell am instrument -w -e package android.animation \
          com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      3. belirli bir sınıf altındaki tüm testler

        adb shell am instrument -w -e class \
          android.animation.AnimatorSetEventsTest \
          com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      4. belirli bir test yöntemi

        adb shell am instrument -w -e class \
          android.animation.AnimatorSetEventsTest#testCancel \
          com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        

Testiniz, JUnit API'lerini kullanarak başarılı veya başarısız olduğu konusunda net bir beyan yapabilir. Ayrıca, yakalanmayan istisnalar da işlevsel bir hataya neden olur.

Test kodunuz, performans metrikleri yayınlamak için Instrumentation#sendStatus anahtar/değer çiftlerinin bir listesini gönderin. Aşağıdaki noktaları göz önünde bulundurun:

  1. metrikler tam sayı veya kayan nokta olabilir
  2. sayısal olmayan tüm değerler silinecek
  3. test apk'niz, işlevsel test veya metrik testi olabilir. ikisinin birlikte kullanılması şu anda desteklenmemektedir