Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Gcloud CLI ile test edin

Bu kılavuz, gcloud CLI kullanılarak XCTest veya Game Loop testinin nasıl çalıştırılacağını açıklar.

1. Adım : Yerel Google Cloud SDK ortamınızı yapılandırın

  1. Google Cloud SDK'yı indirin .
  2. Bu, gcloud CLI aracını içerir.

  3. Kurulumunuzun güncel olduğundan ve gcloud firebase komutunu içerdiğinden emin olun:
          gcloud components update
  4. Google hesabınızı kullanarak gcloud KSA'ya giriş yapın:
          gcloud auth login
  5. Firebase projenizi gcloud'da ayarlayın; burada PROJECT_ID , Firebase projenizin kimliğidir:
         gcloud config set project PROJECT_ID

2. Adım : Testinizi çalıştırın

XCTest çalıştırın

  1. Aşağıdaki komutu çalıştırarak testinizin .zip dosyasını yükleyin (uygulamanızı henüz paketlemediyseniz, bkz . XCTest'inizi Paketleme ):

    cd FOLDER_WITH_TEST_OUTPUT/Build/Products ; \
    zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun
  2. Test boyutlarınızı seçin.

    Test Lab, çeşitli iOS sürümlerinde, cihazlarda, ekran yönlerinde ve yerel ayarlarda testler yapmanızı sağlar. Bu konfigürasyonlar, testin test boyutları olarak bilinir. Her boyuta ilişkin seçenekleri görmek için (örneğin, cihazın iOS sürümü için desteklenen Xcode sürümleri), aşağıdaki komutta dimension yerine models , versions veya locales :

    gcloud firebase test ios dimension list

    Tek seçeneği portrait ve landscape olduğundan ekran yönü biraz daha basittir.

    Test boyutları listesine bakın ve testinizi üzerinde çalıştırmak istediğiniz birkaç kombinasyon seçin. Günlük çalıştırabileceğiniz maksimum kombinasyon sayısını görmek için Fiyatlandırma Planlarını ziyaret edin.

  3. Bir dizi test boyutu seçtikten sonra, Test Lab'in testlerinizi firebase test ios run komutunu kullanarak firebase test ios run . Üzerinde test etmek istediğiniz her test boyutu kombinasyonu için ayrı bir --device bayrağı ekleyin:

    gcloud firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --device model=MODEL_ID_2,version=VERSION_ID_2,locale=LOCALE_2,orientation=ORIENTATION_2 \
     etc...

    Testin oluşturulduğu Xcode sürümü ile Test Lab tarafından kullanılan varsayılan Xcode sürümü arasındaki uyumsuzluk nedeniyle testinizin başarısız olması mümkündür. --xcode-version için desteklenen bir Xcode sürümü belirtmek için --xcode-version bayrağını kullanın:

    gcloud firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --xcode-version=11.3

Özel Yetkileri Test Edin

Açık bir Uygulama Kimliği gerektiren yetkilendirmeleri test etmek için --test-special-entitlements bayrağını ayarlayarak bunu yapabilirsiniz. Test Lab, özel yetkileri desteklemek için uygulamayı yeni bir paket tanımlayıcıyla yeniden imzalar; bu nedenle lütfen zip dosyanızda uygulamanın paket kimliğine doğrudan referanslar içeren kaynak bulunmadığından emin olun.

Push bildirimleri

Push bildirim isteklerini yetkilendirmek için kullanıcılar, Anahtar Kimliği - C7FD9DJAA8 ve Takım Kimliği - 9CKCGNNUQN ile birlikte özel imzalama anahtarını kullanarak JSON web tokenleri oluşturabilir . Oluşturulan belirteçler bir saat geçerli olacak ve her 60 dakikada bir yenilenmesi gerekecek. APN'lere Token Tabanlı Bağlantı Kurma hakkında daha fazla bilgi edinin .

Oyun Döngüsü testi çalıştırın

gcloud beta firebase test ios run komutunu gcloud beta firebase test ios run ve çalıştırmayı yapılandırmak için aşağıdaki işaretleri kullanın:

Oyun Döngüsü testleri için bayraklar
--type

Gerekli : Çalıştırmak istediğiniz iOS testinin türünü belirtir. xctest (varsayılan) veya game-loop test türlerini girebilirsiniz.

--app

Gerekli : Uygulamanızın IPA dosyasına giden mutlak yol (GCS veya dosya sistemi). Bu bayrak yalnızca Game Loop testleri çalıştırılırken geçerlidir.

--scenario-numbers

Uygulamanızda çalıştırmak istediğiniz döngüler (senaryolar olarak da bilinir). Bir döngü, bir liste veya döngüler veya bir dizi döngü girebilirsiniz. Varsayılan döngü 1'dir.

Örneğin, --scenario-numbers=1-3,5 , 1, 2, 3 ve 5 döngülerini çalıştırır.

--device-model

Testinizi üzerinde çalıştırmak istediğiniz fiziksel cihaz (hangi cihazları kullanabileceğinizi öğrenin).

--timeout

Testinizin çalışmasını istediğiniz maksimum süre. Süreyi saniye cinsinden temsil etmek için bir tamsayı veya süreyi daha uzun bir zaman birimi olarak göstermek için bir tamsayı ve numaralandırma girebilirsiniz.

Örneğin:

  • --timeout=200 , testinizi 200 saniyeye kadar çalıştığında sona erdirmeye zorlar.
  • --timeout=1h , testinizi bir saate kadar çalıştığında sona erdirmeye zorlar.

Örneğin, aşağıdaki komut bir iPhone 8 Plus'ta 1, 4, 6, 7 ve 8 döngülerini yürüten bir Oyun Döngüsü testi çalıştırır:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

Gcloud CLI hakkında daha fazla bilgi için referans belgelerine bakın .

4. Adım (İsteğe Bağlı) : Oluşturacağınız gelecekteki testleri otomatikleştirin

Test Lab ile gcloud komutlarını komut dosyası oluşturma

Aksi takdirde gcloud komut satırını kullanarak çalıştıracağınız mobil uygulama test komutlarını otomatikleştirmek için kabuk komut dosyalarını veya toplu iş dosyalarını kullanabilirsiniz. Bu örnek bash betiği, iki dakikalık bir zaman aşımına sahip bir XCTest çalıştırır ve test çalıştırmasının başarıyla tamamlanıp tamamlanmadığını bildirir:

if gcloud firebase test ios run --test MyTest.zip --timeout 2m
then
    echo "Test matrix successfully finished"
else
    echo "Test matrix exited abnormally with non-zero exit code: " $?
fi

Komut dosyası çıkış kodları

Test Lab, komut dosyalarını veya toplu iş dosyalarını kullanarak çalıştırdığınız testlerin sonuçlarını daha iyi anlamak için kullanabileceğiniz birkaç çıkış kodu sağlar.

Çıkış kodu Notlar
0 Tüm test yürütmeleri geçti.
1 Genel bir arıza meydana geldi. Olası nedenler şunları içerir: var olmayan bir dosya adı veya bir HTTP / ağ hatası.
2 Bilinmeyen komutlar veya bağımsız değişkenler sağlandığı için testten çıkıldı.
10 Bir test yürütmesi içindeki bir veya daha fazla test senaryosu (test edilen sınıflar veya sınıf yöntemleri) geçmedi.
15 Firebase Test Lab, beklenmeyen bir hata nedeniyle test matrisinin başarılı olup olmadığını belirleyemedi.
19 Test matrisi kullanıcı tarafından iptal edildi.
20 Bir test altyapısı hatası oluştu.

5. Adım : Test sonuçlarını inceleyin

Test başladığında, Test Sonuçları sayfasına bir bağlantı alırsınız. Seçtiğiniz farklı konfigürasyonların sayısına ve testleriniz için ayarlanan test zaman aşımı süresine bağlı olarak testlerin çalıştırılması birkaç dakika sürebilir. Testleriniz çalıştıktan sonra test sonuçlarını gözden geçirebilirsiniz. Test sonuçlarınızı nasıl yorumlayacağınız hakkında daha fazla bilgi edinmek için Firebase Test Lab Sonuçlarını Analiz Etme bölümüne bakın.

Sonraki adım

Genel olarak sunulan veya beta sürümde olan test seçeneklerini keşfetmek için Google Cloud SDK belgelerini okuyun.