Google Cloud KSA ile test etme

Bu kılavuzda, gcloud CLI kullanarak XCTest veya oyun döngüsü testinin nasıl çalıştırılacağı açıklanmaktadır.

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

1. Google Cloud SDK'yı indirin.

gcloud CLI aracı da buna dahildir.

2. Yüklemenizin güncel olduğundan ve gcloud firebase komutunu içerdiğinden emin olun:

         gcloud components update

3. Google Hesabınızı kullanarak gcloud CLI'ya giriş yapın:

         gcloud auth login

4. gcloud'da Firebase projenizi ayarlayın. PROJECT_ID, Firebase projenizin kimliğidir:

        gcloud config set project PROJECT_ID

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

XCTest çalıştırma

1. Aşağıdaki komutu çalıştırarak testinizin .zip dosyasını yükleyin (uygulamanızı henüz paketlemediyseniz XCTest'inizi paketleme bölümüne bakın):

   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ümleri, cihazlar, ekran yönleri ve yerel ayarlarda test çalıştırmanıza olanak tanır. Bu yapılandırmalar, testin test boyutları olarak bilinir. Her bir boyutun seçeneklerini (ör. cihazın iOS sürümü için desteklenen Xcode sürümleri) görmek istiyorsanız aşağıdaki komutta dimension yerine models, versions veya locales yazın:

   gcloud firebase test ios dimension list

   Ekran yönlendirme, yalnızca portrait ve landscape seçenekleri olduğu için biraz daha basittir.

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

3. Bir test boyutları grubu seçtikten sonra Test Lab aracının firebase test ios run komutunu kullanarak testlerinizi çalıştırmasını sağlayabilirsiniz. Test etmek istediğiniz her test boyutu kombinasyonu için ayrı bir --device işareti 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 testiniz başarısız olabilir. Testiniz için desteklenen bir Xcode sürümü belirtmek istiyorsanız --xcode-version işaretini 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=15

   Firebase konsolunda test matrislerinizi tanımlamanıza ve bulmanıza yardımcı olması için aşağıdaki örnekte yer alan --client-details matrixLabel="<label>" işaretini kullanarak test matrisinizi isteğe bağlı olarak etiketleyebilirsiniz:

   gcloud beta firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --client-details matrixLabel="my label"

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

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

Örneğin, aşağıdaki komut bir iPhone 8 Plus'ta 1, 4, 6, 7 ve 8 numaralı döngüleri çalıştıran bir Oyun Döngüsü testi yürütü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.

3. adım (isteğe bağlı): Oluşturacağınız gelecekteki testleri otomatikleştirin

Test Lab ile gcloud komutları için komut dosyası oluşturma

Normalde 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 komut dosyası, iki dakikalık zaman aşımıyla 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ı veya toplu iş dosyaları kullanarak çalıştırdığınız testlerin sonuçlarını daha iyi anlamak için kullanabileceğiniz çeşitli çıkış kodları sağlar.

4. adım: Test sonuçlarını inceleyin

Test başladığında Test Sonuçları sayfasının bağlantısını alırsınız. Seçtiğiniz farklı yapılandırmaları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ırıldıktan sonra test sonuçlarını inceleyebilirsiniz. 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 kullanıma sunulan veya beta sürümündeki test seçeneklerini incelemek için Google Cloud SDK belgelerini okuyun.