Ö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
Ç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
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
veAndroid.mk
ayarlarını uygulayın.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" />
Testinizi
@SmallTest
,@MediumTest
veya@LargeTest
Test modülünü m ile oluşturun.Ör.:
m FrameworksCoreTests
Testleri çalıştırın:
En basit çözüm, Atest'i aşağıdaki gibi kullanmaktır:
atest FrameworksCoreTests
Daha karmaşık testler için Trade Federation test donanımını kullanın:
m tradefed-all tradefed.sh run template/local_min --template:map test=FrameworksCoreTests
Tradefed kullanmıyorsanız testleri manuel olarak yükleyin ve çalıştırın:
- Oluşturulan APK'yı yükleyin:
adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk
Testleri çeşitli seçeneklerle çalıştırın:
APK'daki tüm testler
adb shell am instrument -w com.android.frameworks.coretests\ /android.support.test.runner.AndroidJUnitRunner
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
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
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:
- metrikler tam sayı veya kayan nokta olabilir
- sayısal olmayan tüm değerler silinecek
- test apk'niz, işlevsel test veya metrik testi olabilir. ikisinin birlikte kullanılması şu anda desteklenmemektedir