Bu kılavuzda, isteğe bağlı Firebase App Distribution Android SDK'sını kullanarak uygulama içi geri bildirimin nasıl etkinleştirileceği açıklanmaktadır. Böylece test kullanıcılarınız, ekran görüntüleri de dahil olmak üzere geri bildirimlerini doğrudan uygulamadan gönderebilir.
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 bölümünde Etkinleştir'i tıklayın.
2. adım: Uygulamanıza App Distribution ekleyin
App Distribution Android SDK'sı iki kitaplıktan oluşur:
firebase-appdistribution-api: Tüm derleme varyantlarına dahil edebileceğiniz yalnızca API kitaplığı.firebase-appdistribution: Tam SDK uygulaması (isteğe bağlı).
Yalnızca API kitaplığı, kodunuzun SDK'ya çağrı yapmasına olanak tanır. Tam SDK uygulaması mevcut değilse çağrıların hiçbir etkisi olmaz.
App Distribution Android SDK'sına olan bağımlılığı, modülünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle
<project>/<app-module>/build.gradle.ktsveya<project>/<app-module>/build.gradle) tanımlayın.Tam SDK uygulamalarının kendi kendine güncelleme işlevini Google Play derlemelerinize dahil etmemek için App Distribution üzerinden dağıtacağınız derleme türleri veya ürün varyantları dahil olmak üzere derleme varyantlarını tanımlayın.
App Distribution Android SDK'sına olan bağımlılığı, modülünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle
app/build.gradle) tanımlayın. Tam SDK uygulamasını yalnızca özel olarak yayın öncesi test için tasarlanmış varyantlara ekleyin:Kotlin+KTX
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta14") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta14") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14") }
3. Adım: Uygulama içi geri bildirimi yapılandırın
Test kullanıcılarınızdan geri bildirim toplamak için test kullanıcılarının geri bildirim başlatmasını sağlamak üzere aşağıdaki tetikleyicilerden birini kullanın:
Yerleşik bildirim tetikleyici: App Distribution Android SDK'sı, test kullanıcısının uygulamanın herhangi bir yerinden dokunabileceği devam eden bir bildirim gösterebilir. Daha hızlı başlamak istiyorsanız ve test kullanıcılarınızın geri bildirim sağlama şeklini özelleştirmeniz gerekmiyorsa bu tetikleyiciyi kullanın.
Özel tetikleyici: Uygulamanızda bir düğmeye veya menü öğesine dokunma ya da cihazı sallama gibi kendi tetikleyici mekanizmanızı sağlayabilirsiniz.
Bu tetikleyicilerden birini kullandığınızda ve test kullanıcısı geri bildirim gönderdiğinde Android SDK'sı 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 yapar. Test özellikleri etkin değilse Android SDK'sı, test kullanıcısından Google Hesabı ile App Distribution'te oturum açmasını ister.
Test kullanıcısının geri bildirim yazıp göndermesine olanak tanıyan tam ekran bir etkinlik başlatır.
1. seçenek: Bildirim tetikleyici
Test kullanıcısının cihazında, geri bildirim başlatmak için dokunabilecekleri kalıcı veya devam eden bir bildirim göstermek için showFeedbackNotification() simgesini kullanın.
Bildirimi yapılandırırken, geri bildirim göndermeden önce test kullanıcısına gösterilecek bir metin ve bildirim için kesinti düzeyi (bildirim kanalının önemine karşılık gelir) sağlamanız gerekir. Test kullanıcılarınıza geri bildirim verilerinin toplanması ve işlenmesi hakkında bildirimde bulunmak istiyorsanız bu bildirimi yapmak için metni kullanabilirsiniz.
showFeedbackNotification()'ü kullandığınızda ve uygulama arka plana gittiğinde bildirim gizlenir. Bildirimi açıkça gizlemek istiyorsanız cancelFeedbackNotification() simgesini kullanın. showFeedbackNotification()'yi ana etkinliğinizin onCreate() bölümüne yerleştirmenizi öneririz.
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
Tercih ettiğiniz bir mekanizmayı kullanarak geri bildirim başlatmak için startFeedback() yöntemini kullanın. Örneğin, geri bildirimi tetiklemek için uygulamanızın işlem menüsüne "Geri bildirim gönder" menü öğesi ekleyebilir veya test kullanıcılarınızın cihazlarını sallamasına ya da ekran görüntüsü almasına izin verebilirsiniz.
Geri bildirimi tetiklediğinizde, geri bildirim göndermeden önce test kullanıcısına gösterilecek bir metin sağlayın. Test kullanıcılarınıza geri bildirim verilerinin toplanması ve işlenmesi hakkında bildirim göndermek istiyorsanız bu metni kullanabilirsiniz.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
4. Adım: Uygulamanızı oluşturun ve test edin
Yerel test
Uygulamayı dağıtmak zorunda kalmadan uygulamanızı test etmek için aşağıdaki adımları uygulayın:
Yerel cihazınızda geliştirici modunu etkinleştirin:
adb shell setprop debug.firebase.appdistro.devmode true
Uygulamanızı, App Distributionkitaplıklarının tamamını içeren bir yayın öncesi varyant olarak oluşturun ve 3. Adım: Uygulama içi geri bildirimi yapılandırın bölümünde uygulanan mekanizmayı kullanarak geri bildirimi tetikleyebildiğinizi test edin. Geliştirici modundayken geri bildirim 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önderip gönderemediğini test etmek için uygulamanızı App Distribution kitaplıklarının tamamını içeren bir yayın öncesi varyant olarak oluşturun ve uygulamanızı aşağıdaki adımları uygulayarak test edin:
App Distribution'e yeni bir uygulama sürümü yükleyin.
Uygulama sürümünü, erişme izniniz olan bir hesaba dağıtın.
Uygulamayı App Distribution'nin web sitesi veya Android test kullanıcısı uygulaması üzerinden indirin.
3. Adım: Uygulama içi geri bildirimi yapılandırın bölümünde uygulanan mekanizmayı kullanarak geri bildirimi tetikleyin.
Uygulama sürümünü dağıttığınız hesapla oturum açtığınızdan emin olun ve geri bildirim gönderin.
Geri bildiriminizi, Firebase konsolundaki yeni sürümün kartında görüntüleyebilirsiniz.
Test kullanıcılarının uygulamada geri bildirim başlatamaması gibi sık karşılaşılan sorunları nasıl çözeceğinizi öğrenmek için SDK ile test özelliklerini etkinleştirme başlıklı makaleyi inceleyin.
5. Adım: Test kullanıcısı geri bildirimlerini yönetin
Test kullanıcılarınızın geri bildirim göndermesini etkinleştirdikten sonra, geri bildirimleri incelemek ve bunlarla ilgili işlem yapmak için aşağıdaki araçları kullanabilirsiniz:
Geri bildirimleri Firebase konsolunda görüntüleme ve silme
Firebase konsolunda belirli bir sürümün altındaki Test kullanıcısı geri bildirimleri sekmesini açarak ekran görüntüleri de dahil olmak üzere kullanıcı geri bildirimlerini inceleyebilir ve silebilirsiniz. Kullanıcı geri bildirimleri, geri bildirimin geçerli olduğu sürümü onaylayabilmeniz için sürüme göre düzenlenir.
Kullanıcı geri bildirimini inceledikten sonra Geri bildirimi sil düğmesini tıklayarak geri bildirimi silebilirsiniz. Silinen geri bildirimler sürümünüzden kaldırılır.
Yeni geri bildirimler için e-posta uyarıları alma
Yeni test kullanıcısı geri bildirimleri hakkında proaktif olarak bilgi edinmek için bir test kullanıcısı geri bildirim gönderdiğinde e-posta uyarıları alabilirsiniz. E-posta uyarısı, test kullanıcınızın sağladığı yazılı geri bildirimi ve gönderdiği ekran görüntülerinin bağlantısını içerir.
Bu varsayılan mekanizma üzerinden App Distribution e-posta uyarıları almak için firebase.projects.update izninizin olması gerekir. Aşağıdaki roller bu gerekli izni varsayılan olarak içerir: Firebase Yöneticisi veya projedeki Sahip ya da Düzenleyici.
Varsayılan olarak, e-posta uyarıları almak için gerekli izinlere sahip olan tüm proje üyeleri yeni bir geri bildirim raporu gönderildiğinde e-posta alır. Proje üyeleri bu uyarıları tek tek devre dışı bırakabilir.
E-posta uyarılarını devre dışı bırakmak için Firebase uyarıları alma başlıklı makaleyi inceleyin.
Üçüncü taraf araçlarına yeni geri bildirim gönderme
Cloud Functions for Firebase'u kullanarak ekibinizin tercih ettiği bildirim kanalına App Distribution uyarıları da gönderebilirsiniz. Örneğin, yeni uygulama içi geri bildirim için uyarı etkinliği yakalayan ve uyarı bilgilerini Discord, Slack veya Jira gibi bir üçüncü taraf hizmetine gönderen bir işlev yazabilirsiniz.
Cloud Functions for Firebase'ü kullanarak gelişmiş uyarı özelliklerini ayarlamak için aşağıdaki adımları uygulayın:
Aşağıdaki görevleri içeren Cloud Functions for Firebase'u oluşturun:
Node.js ve npm'yi indirin.
Firebase CLI'yi yükleyip oturum açın.
Firebase KSA'sını kullanarak Cloud Functions for Firebase'ü başlatın.
App Distribution'den uygulama içi geri bildirim uyarısı etkinliğini yakalayan ve etkinlik yükü işleyen (örneğin, uyarı bilgilerini Discord'da bir mesajda yayınlayan) bir işlev yazıp dağıtın.
Jira'ya nasıl yeni geri bildirim göndereceğinizi gösteren örnek bir işlevi görmek için bu örneği inceleyin.
Yakalayabileceğiniz tüm uyarı etkinlikleri hakkında bilgi edinmek için App Distribution uyarıları ile ilgili referans dokümanlarına bakın.