Bu kılavuzda, isteğe bağlı Test kullanıcılarınızın geri bildirim gönderebilmesi için Firebase App Distribution Android SDK'sı (ekran görüntüleri dahil) doğrudan uygulamada gösterilecek.
Başlamadan önce
Henüz yapmadıysanız Firebase'i Android projenize ekleyin.
1. Adım: App Distribution Tester API'yi etkinleştirin
Google Cloud konsolunu açın. ve Firebase projenizi seçin.
Firebase App Testers API'nin altında Etkinleştir'i tıklayın.
2. Adım: App Distribution uygulamasını uygulamanıza ekleyin
App Distribution Android SDK'sı iki kitaplıktan oluşur:
firebase-appdistribution-api: Ekleyebileceğiniz yalnızca API kitaplığı tüm derleme varyantlarında.firebase-appdistribution: Tam SDK uygulaması (isteğe bağlı).
Yalnızca API kitaplığı, kodunuzun SDK'ya çağrı yapmasını sağlar. Görüşmelerde Tam SDK uygulaması mevcut değilse herhangi bir etkisi olmaz.
App Distribution Android SDK için bağımlılığı modül (uygulama düzeyinde) Gradle dosyası (genellikle
<project>/<app-module>/build.gradle.ktsveya<project>/<app-module>/build.gradle) tıklayın.SDK uygulamasının kendi kendine güncelleme işlevinin tamamını dahil etmemek için dahil olmak üzere, yaptığınız değişikliklerden kaynaklandığını derleme türleri veya ürün aromalarını kullanarak App Distribution ile dağıtmanız gerekir.
App Distribution Android SDK için bağımlılığı modül (uygulama düzeyinde) Gradle dosyası (genellikle
app/build.gradle). Yalnızca özel olarak tasarlanan varyantlara tam SDK uygulaması yayın öncesi testi:Kotlin+KTX
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta13") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta13") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta13") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta13") }
3. Adım: Uygulama içi geri bildirimi yapılandırın
Test kullanıcılarınızdan geri bildirim toplamak için aşağıdaki tetikleyicilerden birini kullanarak test kullanıcılarının geri bildirim başlatmasını sağlayın:
Yerleşik bildirim tetikleyicisi: App Distribution Android SDK'sı, uygulamada herhangi bir yere dokunabilir. Aşağıdaki durumlarda bu tetikleyiciyi kullanın: daha hızlı kullanmaya başlar ve test kullanıcılarınızın nasıl çalıştığını özelleştirmeniz geri bildirim sağlayın.
Özel tetikleyici: Kendi tetikleyicinizi sağlayabilirsiniz bir düğmeye veya menü öğesine dokunma ya da olanak tanır.
Bu tetikleyicilerden birini kullandığınızda ve test kullanıcısı geri bildirim gönderdiğinde Android SDK aşağıdaki işlemleri gerçekleştirir:
Uygulamanın mevcut etkinliğinin ekran görüntüsünü alır.
Test kullanıcısının, SDK'nın test özelliklerini etkinleştirdiğinden emin olmak için kontroller yürütür. Öğe test özellikleri etkin değilse Android SDK, test kullanıcısından Google hesabıyla App Distribution uygulamasında.
Test kullanıcısının geri bildirim.
1. Seçenek: Bildirim tetikleyici
Kalıcı veyashowFeedbackNotification()
devam ediyor
dokunabileceğini belirten bir bildirim alır.
Bildirimi yapılandırdığınızda,
geri bildirim göndermeden önce test kullanıcısına gösterilmelerini sağlamalı ve
bildirimin kesilmesi (bildirim kanalının önemine karşılık gelir). Şunu istiyorsanız:
kendilerine ait bilgilerin toplanıp işlenmesi hakkında test kullanıcılarınıza bildirim gönderme
bu tür bir bildirimde bulunmak için metni kullanabilirsiniz.
showFeedbackNotification() kullandığınızda ve uygulama
bildirim gizlenir. Belirli bir içeriği
bildirimde bulunmak için cancelFeedbackNotification() öğesini kullanın. Önerilerimiz:
showFeedbackNotification() öğesini ana etkinliğinizin onCreate() bölümüne ekleyin.
Kotlin+KTX
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
Firebase.appDistribution.showFeedbackNotification(
// Text providing notice to your testers about collection and
// processing of their feedback data
R.string.additionalFormText,
// The level of interruption for the notification
InterruptionLevel.HIGH)
}
}
Java
public class MainActivity extends AppCompatActivity {
FirebaseAppDistribution firebaseAppDistribution =
FirebaseAppDistribution.getInstance();
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
firebaseAppDistribution.showFeedbackNotification(
// Text providing notice to your testers about collection and
// processing of their feedback data
R.string.additionalFormText,
// The level of interruption for the notification
InterruptionLevel.HIGH);
}
}
2. seçenek: Özel tetikleyici
Size ait bir mekanizmayı kullanarak geri bildirim başlatmak için startFeedback() yöntemini kullanın
seçim. Örneğin, geri bildirimi tetiklemek için
"Geri bildirim gönder" uygulamanızın işlem menüsüne ekleyin veya test kullanıcılarınızın
cihazlarını sallayın
veya ekran görüntüsü alın.
Geri bildirimi tetiklediğinizde, test kullanıcısına gösterilecek bir metin sağlayın
geri bildirim göndermeden önce. Test kullanıcılarınıza bildirim göndermek isterseniz
geri bildirim verilerinin toplanması ve işlenmesi hakkında bilgi edindiyseniz, bu metni kullanarak
bu tür bir bildirim sağlamalısınız.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
4. Adım: Uygulamanızı oluşturma ve test etme
Yerel test
Uygulamayı dağıtmadan önce uygulamanızı test etmek için şu adımları uygulayın:
Yerel cihazınızda geliştirici modunu etkinleştirin:
adb shell setprop debug.firebase.appdistro.devmode true
Uygulamanızı, tüm App Distribution içeren yayın öncesi varyant olarak derleyin ve mekanizmayı kullanarak geri bildirimi tetikleyip tetikleyemediğinizi uygulanan 3. Adım: Uygulama içi geri bildirimi yapılandırın. Geri bildirim: geliştirici modundayken gönderilmez.
Test ettikten sonra cihazınızda geliştirici modunu devre dışı bırakabilirsiniz:
adb shell setprop debug.firebase.appdistro.devmode false
Uçtan uca test
Uygulamanızın geri bildirim gönderebildiğini test etmek için uygulamanızı yayın öncesi ve App Distribution kitaplığının tamamını içeren varyantı test edin ve şu adımları izleyerek uygulayın:
App Distribution uygulamasına yeni bir uygulama sürümü yükleyin.
Uygulama sürümünü, erişim izniniz olan bir hesaba dağıtın.
Uygulamayı App Distribution kullanıcısının web veya Android test kullanıcısı uygulamasından indirin.
Şurada uygulanan mekanizmayı kullanarak geri bildirimi tetikleyin: 3. Adım: Uygulama içi geri bildirimi yapılandırın.
Dağıtımı yaptığınız hesapta oturum açtığınızdan emin olun uygulama lansmanı ve geri bildirim gönderin.
Geri bildiriminizi yeni sürümün kartında şurada görebilirsiniz: Firebase konsolu.
Test kullanıcılarının geri bildirim başlatamamaları gibi yaygın sorunları nasıl çözeceğinizi öğrenmek için Uygulamada SDK ile test özelliklerini etkinleştirme konusuna bakın.
5. Adım: Test kullanıcılarının geri bildirimlerini yönetin
Test kullanıcılarınızın geri bildirim göndermelerini etkinleştirdikten sonra aşağıdakileri kullanabilirsiniz: kullanabileceğiniz araçlar:
Firebase konsolunda geri bildirimi görüntüleyip silin
Aşağıdakiler de dahil olmak üzere kullanıcı geri bildirimlerini inceleyip silebilirsiniz: Aşağıdaki bağlantıdan belirli bir sürümün altındaki Test kullanıcısı geri bildirimi sekmesini Firebase konsolu. Kullanıcı geri bildirimleri sürüme göre düzenlenir. Böylece geri bildirimin geçerli olduğu sürümdür.
Kullanıcı geri bildirimini inceledikten sonra Geri bildirimi sil düğmesi. Silinen geri bildirim kullanabilirsiniz.
Yeni geri bildirimler için e-posta uyarıları alın
Yeni test kullanıcılarının geri bildirimleri hakkında proaktif olarak bilgi almak için Bir test kullanıcısı geri bildirim gönderdiğinde uyarı verir. E-posta uyarısı, test kullanıcınızın sağladığı geri bildirimi ve gönderdikleri ekran görüntülerinin bağlantısını paylaşın.
Bu varsayılan mekanizma üzerinden App Distribution e-posta uyarısı almak için
firebase.projects.update izni. Aşağıdaki roller bu kapsamdadır:
varsayılan olarak gerekli izin: Firebase Yöneticisi
veya projenin Sahibi veya Düzenleyici'dir.
Varsayılan olarak, gerekli izinleri içeren her proje üyesi, e-posta uyarıları, yeni bir geri bildirim raporu gönderildiğinde e-posta alır. Proje üyeleri bu uyarıları bireysel olarak devre dışı bırakabilir.
E-posta uyarılarını devre dışı bırakmak için Firebase uyarıları alma konusuna bakın.
Üçüncü taraf araçlarına yeni geri bildirim gönderme
Ayrıca, ekibinizin tercih ettiği bildirime App Distribution uyarı da gönderebilirsiniz Cloud Functions for Firebase kullanıyor. Örneğin, Arkadaş Bitkiler projesinin yeni uygulama içi geri bildirim için bir uyarı etkinliği yakalayan ve uyarı bilgilerini Discord, Slack veya Jira gibi üçüncü taraf hizmetlerine gönderebilirsiniz.
Cloud Functions for Firebase kullanarak gelişmiş uyarı özellikleri ayarlamak için şu adımları uygulayın:
Cloud Functions for Firebase özelliğini kurun, ve şu görevleri içerir:
Node.js ve npm'yi indirin.
Firebase KSA'yı yükleyin ve oturum açın.
Firebase KSA'yı kullanarak Cloud Functions for Firebase uygulamasını başlatın.
Aşağıdaki koşulları karşılayan bir işlev yaz ve dağıt: App Distribution cihazından bir uygulama içi geri bildirim uyarı etkinliği yakalar ve (örneğin, uyarı bilgilerini Discord) girin.
Jira'ya yeni geri bildirim göndermeyi gösteren örnek bir işlevi görmek için: bu örneğe bakın.
Yakalayabileceğiniz tüm uyarı etkinlikleri hakkında bilgi edinmek için App Distribution uyarı ile ilgili dokümanlar.