Bu kılavuz, isteğe bağlı Firebase App Distribution Android SDK kullanılarak uygulama içi geri bildirimin nasıl etkinleştirileceğini açıklar; böylece test kullanıcılarınız doğrudan uygulamada geri bildirim (ekran görüntüleri dahil) gönderebilir.
Sen 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 Console'u açın ve Firebase projenizi seçin.
Firebase App Testers API altında, Etkinleştir'i tıklayın.
2. Adım: Uygulamanıza Uygulama Dağıtımı ekleyin
Uygulama Dağıtımı Android SDK'sı iki kitaplıktan oluşur:
-
firebase-appdistribution-api: Tüm yapı türevlerine 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ı yoksa çağrıların hiçbir etkisi olmaz.
Modül (uygulama düzeyinde) Gradle dosyanızda (genellikle
<project>/<app-module>/build.gradle.ktsveya<project>/<app-module>/build.gradleUygulama Dağıtımı Android SDK'sının bağımlılığını bildirin ).Tam SDK uygulamasının kendi kendini güncelleme işlevini Google Play derlemelerinize dahil etmekten kaçınmak için, Uygulama Dağıtımı aracılığıyla dağıtacağınız yapı türleri veya ürün çeşitleri dahil olmak üzere yapı varyantlarını belirleyin.
Modül (uygulama düzeyi) Gradle dosyanızda (genellikle
app/build.gradle) Uygulama Dağıtımı Android SDK'sının bağımlılığını bildirin. Tam SDK uygulamasını yalnızca özel olarak yayın öncesi test için tasarlanan değişkenlere ekleyin:Kotlin+KTX
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta10") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta10") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta10") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta10") }
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, test cihazının uygulamanın herhangi bir yerinden dokunabileceği sürekli bir bildirim görüntüleyebilir. 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 tetik : Uygulamanızdaki bir düğmeye veya menü öğesine dokunmak veya cihazı sallamak gibi kendi tetik mekanizmanızı sağlayabilirsiniz.
Bu tetikleyicilerden herhangi 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ü yakalar.
Test cihazının SDK'nın test özelliklerini etkinleştirdiğinden emin olmak için kontroller yapar. Test özellikleri etkinleştirilmemişse Android SDK, test cihazından Google hesabıyla App Distribution'da oturum açmasını ister.
Test uzmanının geri bildirim yazmasını ve göndermesini sağlayan tam ekran bir etkinlik başlatır.
1. Seçenek: Bildirim tetikleyici
Test cihazının cihazında geri bildirim başlatmak için dokunabilecekleri kalıcı veya devam eden bir bildirim görüntülemek için showFeedbackNotification() öğesini kullanın. Bildirimi yapılandırdığınızda, test cihazına geri bildirim göndermeden önce görüntülenecek bir metin ve bildirim için bir kesinti düzeyi (bildirim kanalının önemine karşılık gelen) sağlamanız gerekir. Test kullanıcılarınıza geri bildirim verilerinin toplanması ve işlenmesi hakkında bildirimde bulunmak istiyorsanız, böyle bir bildirimde bulunmak için metni kullanabilirsiniz.
showFeedbackNotification() işlevini kullandığınızda ve uygulama arka plana geçtiğinde bildirim gizlenir. Bildirimi açıkça gizlemek istiyorsanız, cancelFeedbackNotification() kullanın. Ana etkinliğinizin onCreate() işlevine showFeedbackNotification() koymanızı ö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
Seçtiğ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 bir "Geri bildirim gönder" menü öğesi eklemek veya test kullanıcılarınızın cihazlarını sallamalarına veya ekran görüntüsü almalarına izin vermek isteyebilirsiniz. Geri bildirimi tetiklediğinizde, testi yapan kişiye geri bildirim göndermeden önce gösterilecek bazı metinler sağlayın. Test kullanıcılarınıza geri bildirim verilerinin toplanması ve işlenmesi hakkında bir bildirim sağlamak istiyorsanız, bu metni böyle bir bildirimde bulunmak için 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
Uygulamanızı önce uygulamayı dağıtmak zorunda kalmadan test etmek için şu adımları izleyin:
Yerel cihazınızda geliştirme modunu etkinleştirin:
adb shell setprop debug.firebase.appdistro.devmode true
Uygulamanızı, tam Uygulama Dağıtım kitaplıklarını içeren bir yayın öncesi değişken 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ştirme modundayken geri bildirim gönderilmez.
Test ettikten sonra cihazınızda geliştirme 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ı tam Uygulama Dağıtımı kitaplıklarını içeren bir yayın öncesi değişken olarak oluşturun ve aşağıdaki adımları izleyerek uygulamanızı test edin:
App Distribution'a 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'ın web veya Android test cihazı uygulaması aracılığıyla indirin.
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üleyin.
Test kullanıcılarının uygulamada geri bildirim başlatamaması gibi yaygın sorunları nasıl çözeceğinizi öğrenmek için SDK ile test özelliklerini etkinleştirme bölümüne bakın.
5. Adım: Test kullanıcısı geri bildirimini yönetin
Test kullanıcılarınızın geri bildirim göndermesini etkinleştirdikten sonra, bu geri bildirimi incelemek ve buna göre işlem yapmak için aşağıdaki araçları kullanabilirsiniz:
Firebase konsolunda geri bildirimi görüntüleyin ve silin
Firebase konsolundaki belirli bir sürüm altındaki Test Kullanıcısı geri bildirimi sekmesini açarak, ekran görüntüleri de dahil olmak üzere kullanıcı geri bildirimlerini inceleyebilir ve silebilirsiniz. Kullanıcı geri bildirimi, geri bildirimin geçerli olduğu sürümü onaylayabilmeniz için sürüme göre düzenlenir.
Kullanıcı geri bildirimlerini inceledikten sonra, Geri bildirimi sil düğmesine tıklayarak bu geri bildirimi silebilirsiniz. Silinen geri bildirim, sürümünüzden kaldırılır.
Yeni geri bildirim için e-posta uyarıları alın
Yeni test kullanıcısı geri bildirimi 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 cihazınızın sağladığı yazılı geri bildirimi ve gönderdikleri ekran görüntülerinin bağlantısını içerir.
Bu varsayılan mekanizma aracılığıyla Uygulama Dağıtımı e-posta uyarıları almak için firebase.projects.update iznine sahip olmanız gerekir. Aşağıdaki roller, bu gerekli izni varsayılan olarak içerir: Firebase Yöneticisi veya proje Sahibi veya Düzenleyici .
Varsayılan olarak, e-posta uyarıları almak için gerekli izinlere sahip olan her proje üyesi, yeni bir geri bildirim raporu gönderildiğinde bir e-posta alır. Proje üyeleri bireysel olarak bu uyarıları devre dışı bırakabilir.
E-posta uyarılarını devre dışı bırakmak için bkz . Firebase uyarıları alma .
Üçüncü taraf araçlara yeni geri bildirim gönderin
Ayrıca Cloud Functions for Firebase'i kullanarak ekibinizin tercih ettiği bildirim kanalına Uygulama Dağıtımı uyarıları gönderebilirsiniz. Örneğin, yeni uygulama içi geri bildirim için bir uyarı olayı yakalayan ve uyarı bilgilerini Discord, Slack veya Jira gibi üçüncü taraf bir hizmete gönderen bir işlev yazabilirsiniz.
Cloud Functions for Firebase'i kullanarak gelişmiş uyarı özelliklerini ayarlamak için şu adımları izleyin:
Aşağıdaki görevleri içeren Firebase için Cloud Functions'ı kurun :
Node.js ve npm'yi indirin.
Firebase CLI'yi kurun ve oturum açın.
Firebase CLI'yi kullanarak Cloud Functions for Firebase'i başlatın.
App Distribution'dan bir uygulama içi geri bildirim uyarı olayını yakalayan ve olay yükünü işleyen (örneğin, uyarı bilgilerini Discord'da bir mesajda yayınlayan) bir işlev yazın ve dağıtın .
Jira'ya nasıl yeni geri bildirim göndereceğinizi gösteren örnek bir işlev görmek için bu örneğe bakın.
Yakalayabileceğiniz tüm uyarı olayları hakkında bilgi edinmek için Uygulama Dağıtımı uyarıları referans belgelerine bakın.