获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Firebase CLI kullanarak Android uygulamalarını test kullanıcılarına dağıtın

Bu kılavuz, APK'ların Firebase CLI kullanarak test kullanıcılarına nasıl dağıtılacağını açıklar. CLI aracı, bir yapı için test edicileri ve sürüm notlarını belirlemenize olanak tanır ve ardından yapıyı buna göre dağıtır.

Sen başlamadan önce

Henüz yapmadıysanız, Android projenize Firebase'i ekleyin .

Başka bir Firebase ürünü kullanmıyorsanız, bir proje oluşturmanız ve uygulamanızı kaydetmeniz yeterlidir. Ancak gelecekte ek ürünler kullanmaya karar verirseniz, yukarıda bağlantısı verilen sayfadaki tüm adımları tamamladığınızdan emin olun.

1. Adım. Uygulamanızı oluşturun

Uygulamanızın yayın öncesi sürümünü test kullanıcılarına dağıtmaya hazır olduğunuzda, normal işleminizi kullanarak APK'nızı oluşturun. APK'yı hata ayıklama anahtarınızla veya uygulama imzalama anahtarınızla imzalamanız gerekir.

2. Adım. Uygulamanızı test kullanıcılarına dağıtın

Uygulamanızı test kullanıcılarına dağıtmak için uygulamanızın dosyasını Firebase CLI'yi kullanarak yükleyin:

  1. Firebase CLI'nin en son sürümünü yükleyin veya güncelleyin (işletim sisteminize özel CLI için bağımsız ikili dosyayı indirmenizi öneririz). Oturum açtığınızdan ve projelerinize erişebildiğinizi test ettiğinizden emin olun.
  2. Firebase konsolunun Uygulama Dağıtımı sayfasında , dağıtmak istediğiniz uygulamayı seçin, ardından Başlayın 'ı tıklayın.
  3. Uygulamanızı yüklemek ve test kullanıcılarına dağıtmak için appdistribution:distribute komutunu çalıştırın. Dağıtımı yapılandırmak için aşağıdaki parametreleri kullanın:

    appdistribution:dağıtım seçenekleri
    --app

    Gerekli : Uygulamanızın Firebase Uygulama Kimliği. Uygulama Kimliğini Firebase konsolunda, Genel Ayarlar sayfasında bulabilirsiniz .

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    CI ortamınızın kimliğini Firebase CLI ile doğruladığınızda yazdırılan bir yenileme belirteci (daha fazla bilgi için CLI'yi CI sistemleriyle kullanma bölümünü okuyun).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Bu yapı için sürüm notları.

    Sürüm notlarını doğrudan belirtebilirsiniz:

    --release-notes "Text of release notes"

    Veya düz metin dosyasının yolunu belirtin:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Davet etmek istediğiniz test kullanıcılarının e-posta adresleri.

    Test kullanıcılarını virgülle ayrılmış e-posta adresleri listesi olarak belirtebilirsiniz:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    Veya, virgülle ayrılmış bir e-posta adresleri listesi içeren bir düz metin dosyasının yolunu belirtebilirsiniz:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Davet etmek istediğiniz test kullanıcısı grupları (bkz. Test kullanıcılarını yönetme ). Gruplar kullanılarak belirtilir grup takma adları , Firebase konsolunda arayabilirsiniz.

    Grupları virgülle ayrılmış liste olarak belirtebilirsiniz:

    --groups "qa-team, trusted-testers"

    Veya virgülle ayrılmış grup adları listesi içeren düz metin dosyasının yolunu belirtebilirsiniz:

    --groups-file "/path/to/groups.txt"
    --debug

    Ayrıntılı günlük çıktısını yazdırmak için ekleyebileceğiniz bir bayrak.

    Örneğin:

    firebase appdistribution:distribute test.apk  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    Sürümleri dağıtmanın yanı sıra, yeni test kullanıcıları davet etmek veya mevcut test kullanıcılarını Firebase projenizden kaldırmak için appdistribution:testers:add ve appdistribution:testers:remove de kullanabilirsiniz. Firebase projenize bir test kullanıcısı eklendikten sonra, bunları ayrı sürümlere ekleyebilirsiniz. Bir test kullanıcısını kaldırdığınızda, artık projenizdeki sürümlere erişemezler. Kısa süre önce kaldırılan test kullanıcılarının, sürümlerinize erişimini bir süre daha sürdürebileceğini unutmayın.

    Örneğin:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    Test kullanıcısı e-postaları bir boşlukla ayrılmalıdır. Ayrıca --file /path/to/testers.txt kullanarak test kullanıcılarını belirtebilirsiniz.

Derlemenizi dağıttıktan sonra, 150 gün (beş ay) boyunca Firebase konsolunun Uygulama Dağıtımı panosunda kullanılabilir hale gelir. Derlemenin süresinin dolmasına 30 gün kala, hem konsolda hem de test kullanıcınızın test cihazındaki derlemeler listesinde bir sona erme bildirimi görünür.

Uygulamayı test etmeye davet edilmemiş olan test kullanıcıları, başlamak için e-posta davetiyeleri alır ve mevcut test kullanıcıları, yeni bir derlemenin test edilmeye hazır olduğuna dair e-posta bildirimleri alır (test uygulamasının nasıl kurulacağına ilişkin talimatlar için test cihazı kurulum kılavuzunu okuyun). Her bir test kullanıcısının durumunu (davetiyeyi kabul edip etmediklerini ve uygulamayı indirip indirmediklerini) Firebase konsolunda izleyebilirsiniz.

Test kullanıcılarının, uygulamanın süresi dolmadan önce uygulamayı test etme davetini kabul etmesi için 30 günü vardır. Bir davetiyenin süresinin dolmasına 5 gün kala, bir sürümdeki test kullanıcısının yanında Firebase konsolunda bir sona erme bildirimi görünür. Bir davet, test kullanıcısı satırındaki açılır menü kullanılarak yeniden gönderilerek yenilenebilir.

Sonraki adımlar

Android uygulamalarını CI/CD kullanarak QA test kullanıcılarına dağıtmak için en iyi uygulamaları öğrenin.