了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

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

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

Sen başlamadan önce

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

Başka bir Firebase ürünü kullanmıyorsanız, yalnızca bir proje oluşturmanız ve uygulamanızı kaydetmeniz gerekir. 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 bir sürümünü test kullanıcılarına dağıtmaya hazır olduğunuzda, normal sürecinizi kullanarak APK'nızı oluşturun. APK'yı hata ayıklama anahtarınız 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 kullanarak yükleyin:

  1. Firebase CLI'nin en son sürümünü yükleyin veya güncelleyin (işletim sisteminize özgü CLI için bağımsız ikili dosyayı indirmenizi öneririz). Oturum açtığınızdan ve projelerinize erişebildiğinizden emin olun.
  2. Firebase konsolunun Uygulama Dağıtımı sayfasında , dağıtmak istediğiniz uygulamayı seçin ve 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:

    uygulama dağıtımı:dağıtma 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

    Firebase CLI ile CI ortamınızın kimliğini 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ış bir e-posta adresi listesi olarak belirtebilirsiniz:

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

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

    --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önet ). Gruplar kullanılarak belirtilir grup takma adları , Firebase konsolunda arayabilirsiniz.

    Grupları virgülle ayrılmış bir liste olarak belirleyebilirsiniz:

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

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

    --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

    Firebase CLI, sürüm yüklemesinden sonra aşağıdaki bağlantıların çıktısını verir. Bu bağlantılar, ikili dosyaları yönetmenize ve test edicilerin ve diğer geliştiricilerin doğru sürüme sahip olmalarını sağlamanıza yardımcı olur:

    • firebase_console_uri - Tek bir sürümü görüntüleyen Firebase konsolu bağlantısı. Bu bağlantıyı kuruluşunuzdaki diğer geliştiricilerle paylaşabilirsiniz.
    • testing_uri - Test edicilerin sürüm notlarını görüntülemesine ve uygulamayı cihazlarına yüklemesine olanak tanıyan, test kullanıcısı deneyimindeki (Android yerel uygulaması) yayın bağlantısı. Test kullanıcısının bağlantıyı kullanabilmesi için sürüme erişmesi gerekir.
    • binary_download_uri - Uygulama ikili dosyasını (APK veya AAB dosyası) doğrudan indiren ve yükleyen imzalı bir bağlantı. Bağlantı bir saat sonra sona erer.

    Sürümleri dağıtmanın yanı sıra, yeni test kullanıcılarını davet etmek veya mevcut test kullanıcılarını Firebase projenizden kaldırmak için appdistribution:testers:add ve appdistribution:testers:remove da 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 bir süre önce kaldırılan test kullanıcılarının, belirli bir süre için sürümlerinize erişmeye devam edebileceğ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. Test kullanıcılarını --file /path/to/testers.txt kullanarak da belirleyebilirsiniz.

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

Uygulamayı test etmeye davet edilmemiş olan test kullanıcıları, başlamak için e-posta davetleri alır ve mevcut test kullanıcıları, yeni bir yapının 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 kullanıcısı kurulum kılavuzunu okuyun). Her test kullanıcısının durumunu (daveti kabul edip etmediklerini ve uygulamayı indirip indirmediklerini) Firebase konsolunda izleyebilirsiniz.

Test kullanıcılarının, uygulamayı süresi dolmadan önce test etme davetini kabul etmeleri için 30 günleri vardır. Davetiyenin süresinin dolmasına 5 gün kaldığında, Firebase konsolunda bir sürümde test kullanıcısının yanında bir süre sonu 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