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, geri bildirimleri (ekran görüntüleri dahil) doğrudan uygulamanın içinden gönderebilir.
Sen başlamadan önce
Henüz yapmadıysanız Android projenize Firebase'i ekleyin .
1. Adım: Uygulama Dağıtımı Test Cihazı API'sini etkinleştirin
Google Cloud konsolunu açın ve Firebase projenizi seçin.
Firebase Uygulama Test Cihazları API'si 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 derleme çeşitlerine ekleyebileceğ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.
Modülünüzde (uygulama düzeyi) Gradle dosyasında Uygulama Dağıtımı Android SDK'sının bağımlılığını bildirin (genellikle
<project>/<app-module>/build.gradle.ktsveya<project>/<app-module>/build.gradle).SDK uygulamasının kendi kendini güncelleme işlevinin tamamını Google Play derlemelerinize dahil etmekten kaçınmak için, Uygulama Dağıtımı aracılığıyla dağıtacağınız derleme türleri veya ürün tatları da dahil olmak üzere derleme çeşitlerini tanımlayın.
Modülünüzdeki (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 yayın öncesi testler için özel olarak tasarlanan varyantlara ekleyin:Kotlin+KTX
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta12") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta12") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta12") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta12") }
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 : Uygulama Dağıtımı Android SDK'sı, 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 uzmanlarınızın geri bildirim sağlama şeklini özelleştirmenize gerek yoksa bu tetikleyiciyi kullanın.
Özel tetikleyici : Uygulamanızdaki bir düğmeye veya menü öğesine dokunmak veya cihazı sallamak gibi kendi tetikleme mekanizmanızı sağlayabilirsiniz.
Bu tetikleyicilerden herhangi birini kullandığınızda ve test cihazı geri bildirim gönderdiğinde, Android SDK aşağıdaki eylemleri 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 gerçekleştirir. Test özellikleri etkinleştirilmemişse Android SDK, test cihazından Google hesabıyla Uygulama Dağıtımı'nda oturum açmasını ister.
Testi yapan kişinin geri bildirimlerini yazmasına ve göndermesine olanak tanıyan tam ekran bir etkinlik başlatır.
1. Seçenek: Bildirim tetikleyicisi
Geri bildirimi başlatmak için dokunabilecekleri, test cihazının cihazında kalıcı veya devam eden bir bildirim görüntülemek için showFeedbackNotification() işlevini kullanın. Bildirimi yapılandırdığınızda, geri bildirim göndermeden önce testçiye 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çilerinize geri bildirim verilerinin toplanması ve işlenmesi hakkında bildirimde bulunmak istiyorsanız, bu tür bir bildirimde bulunmak için metni kullanabilirsiniz.
showFeedbackNotification() işlevini kullandığınızda ve uygulama arka plana gittiğinde bildirim gizlenir. Bildirimi açıkça gizlemek istiyorsanız cancelFeedbackNotification() kullanın. showFeedbackNotification() öğesini ana etkinliğinizin onCreate() öğesine 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 bildirimi 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ı sallamasına veya ekran görüntüsü almasına izin vermek isteyebilirsiniz. Geri bildirimi tetiklediğinizde, testçiye geri bildirim göndermeden önce gösterilecek bir metin sağlayın. Testçilerinize geri bildirim verilerinin toplanması ve işlenmesi konusunda bir bildirimde bulunmak istiyorsanız bu metni kullanarak böyle bir bildirimde bulunabilirsiniz.
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 testler
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ı, Uygulama Dağıtımı kitaplı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ırma bölümünde uygulanan mekanizmayı kullanarak geri bildirimi tetikleyip tetikleyemeyeceğ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ı, Uygulama Dağıtımı kitaplıklarının tamamını içeren bir yayın öncesi varyant 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 uygulaması aracılığıyla indirin.
3. Adım: Uygulama içi geri bildirimi yapılandırma 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 kartında görüntüleyin.
Test kullanıcılarının uygulamada geri bildirim başlatamaması gibi yaygın sorunların nasıl çözüleceğini öğrenmek için bkz . SDK ile test özelliklerini etkinleştirme .
5. Adım: Test kullanıcılarının geri bildirimlerini yönetin
Test kullanıcılarınızın geri bildirim göndermesine izin verdikten sonra, bu geri bildirimi incelemek ve buna göre harekete geçmek için aşağıdaki araçları kullanabilirsiniz:
Firebase konsolunda geri bildirimi görüntüleyin ve silin
Firebase konsolunda belirli bir sürümün 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 sürüme göre düzenlenir, böylece geri bildirimin geçerli olduğu sürümü onaylayabilirsiniz.
Kullanıcı geri bildirimlerini inceledikten sonra Geri bildirimi sil düğmesini tıklayarak bu geri bildirimi silebilirsiniz. Silinen geri bildirim sürümünüzden kaldırılır.
Yeni geri bildirimler için e-posta uyarıları alın
Yeni test kullanıcısı geri bildirimleri hakkında proaktif bir şekilde bilgi edinmek için, bir test kullanıcısı geri bildirim gönderdiğinde e-posta uyarıları alabilirsiniz. E-posta uyarısı, test uzmanı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ını almak için firebase.projects.update iznine sahip olmanız gerekir. Aşağıdaki roller varsayılan olarak bu gerekli izni 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 alacaktır. Proje üyeleri bireysel olarak bu uyarılardan vazgeçebilir.
E-posta uyarılarını devre dışı bırakmak için bkz . Firebase uyarılarını alma .
Üçüncü taraf araçlara yeni geri bildirim gönderin
Ayrıca Firebase için Cloud Functions'ı kullanarak Uygulama Dağıtımı uyarılarını ekibinizin tercih ettiği bildirim kanalına gönderebilirsiniz. Örneğin, yeni uygulama içi geri bildirim için bir uyarı olayını yakalayan ve uyarı bilgilerini Discord, Slack veya Jira gibi bir üçüncü taraf hizmete gönderen bir işlev yazabilirsiniz.
Firebase için Cloud Functions'ı 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 yükleyin ve oturum açın.
Firebase CLI'yi kullanarak Firebase için Cloud Functions'ı başlatın.
App Distribution'dan uygulama içi geri bildirim uyarısı olayını yakalayan ve etkinlik yükünü işleyen (örneğin, uyarı bilgilerini Discord'daki 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şlevi görmek için bu örneğe bakın.
Yakalayabileceğiniz tüm uyarı etkinlikleri hakkında bilgi edinmek için Uygulama Dağıtımı uyarılarına ilişkin referans belgelere bakın.