מדריך זה מתאר כיצד להפעיל משוב בתוך האפליקציה באמצעות Firebase App Distribution Android SDK האופציונלי, כך שהבודקים שלך יוכלו לשלוח משוב (כולל צילומי מסך) ישירות באפליקציה.
לפני שאתה מתחיל
אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Android שלך .
שלב 1: הפעל את API Test Distribution App
פתח את מסוף Google Cloud ובחר בפרויקט Firebase שלך.
מתחת ל-Firebase App Testers API, לחץ על הפעל .
שלב 2: הוסף הפצת אפליקציות לאפליקציה שלך
ה-SDK של Android Distribution של אפליקציות מורכב משתי ספריות:
-
firebase-appdistribution-api
: ספריית ה-API בלבד, שתוכל לכלול בכל גרסאות הבנייה . -
firebase-appdistribution
: היישום המלא של SDK (אופציונלי).
ספריית ה-API בלבד מאפשרת לקוד שלך לבצע קריאות ל-SDK. לקריאות אין השפעה אם היישום המלא של ה-SDK אינו קיים.
הכריז על התלות של ה-App Distribution Android SDK בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל
<project>/<app-module>/build.gradle.kts
או<project>/<app-module>/build.gradle
).כדי להימנע מהכללת פונקציונליות העדכון העצמי של היישום המלא של ה-SDK ב-builds שלך ב-Google Play, זהה את גרסאות ה-build, כולל סוגי build או טעמי מוצר שתפיץ באמצעות הפצת אפליקציות.
הכריז על התלות של ה-App Distribution Android SDK בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל
app/build.gradle
). הוסף את ההטמעה המלאה של ה-SDK רק לגרסאות המיועדות אך ורק לבדיקות טרום-הפצה: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: הגדר משוב בתוך האפליקציה
כדי לאסוף משוב מהבודקים שלך, השתמש באחד מהטריגרים הבאים כדי לאפשר לבודקים ליזום משוב:
טריגר הודעות מובנה : ה-App Distribution Android SDK יכול להציג הודעה מתמשכת שהבודק יכול להקיש מכל מקום באפליקציה. השתמש בטריגר זה אם אתה רוצה להתחיל מהר יותר ואינך צריך להתאים אישית את האופן שבו הבודקים שלך מספקים משוב.
טריגר מותאם אישית : אתה יכול לספק מנגנון טריגר משלך, כמו הקשה על כפתור או פריט תפריט באפליקציה שלך או ניעור המכשיר.
כאשר אתה משתמש באחד מהטריגרים הללו והבודק שולח משוב, ה-SDK של Android מבצע את הפעולות הבאות:
מצלם צילום מסך של הפעילות הנוכחית של האפליקציה.
מפעיל בדיקות כדי לוודא שהבודק איפשר את תכונות הבדיקה של ה-SDK. אם תכונות הבדיקה אינן מופעלות, ה-SDK של Android יבקש מהבודק להיכנס ל-App Distribution עם חשבון Google שלו.
מתחיל פעילות במסך מלא המאפשרת לבוחן לכתוב ולשלוח את המשוב שלו.
אפשרות 1: הפעלת הודעות
השתמש ב- showFeedbackNotification()
כדי להציג הודעה מתמשכת או מתמשכת במכשיר של הבוחן שעליה הוא יכול להקיש כדי ליזום משוב. כאשר אתה מגדיר את ההתראה, עליך לספק טקסט כלשהו שיוצג לבוחן לפני שהוא שולח משוב, ורמת הפרעה להתראה (המתאימה לחשיבות ערוץ ההתראות). אם אתה רוצה לספק הודעה לבוחנים שלך על איסוף ועיבוד נתוני המשוב שלהם, אתה יכול להשתמש בטקסט כדי לספק הודעה כזו.
כאשר אתה משתמש showFeedbackNotification()
וכאשר האפליקציה עוברת לרקע, ההודעה מוסתרת. אם אתה רוצה להסתיר את ההודעה במפורש, השתמש cancelFeedbackNotification()
. אנו ממליצים לשים את showFeedbackNotification()
ב- onCreate()
של הפעילות הראשית שלך.
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: טריגר מותאם אישית
השתמש בשיטת startFeedback()
כדי ליזום משוב באמצעות מנגנון לבחירתך. לדוגמה, כדי להפעיל משוב, ייתכן שתרצה להוסיף פריט תפריט "שלח משוב" לתפריט הפעולה של האפליקציה שלך, או לאפשר לבודקים שלך לנער את המכשיר שלהם או לצלם צילום מסך . כאשר אתה מפעיל משוב, ספק טקסט שיוצג לבוחן לפני שהוא שולח משוב. אם ברצונך לספק הודעה לבוחנים שלך על איסוף ועיבוד נתוני המשוב שלהם, תוכל להשתמש בטקסט זה כדי לספק הודעה כזו.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
שלב 4: בנה ובדוק את היישום שלך
בדיקה מקומית
כדי לבדוק את היישום שלך מבלי שתצטרך להפיץ את האפליקציה תחילה, בצע את השלבים הבאים:
הפעל את מצב הפיתוח במכשיר המקומי שלך:
adb shell setprop debug.firebase.appdistro.devmode true
בנה את האפליקציה שלך כגרסה מוקדמת שכוללת את ספריות הפצת האפליקציות המלאות, ובדוק שאתה יכול להפעיל משוב באמצעות המנגנון שיושם בשלב 3: הגדר משוב בתוך האפליקציה . משוב לא נשלח במצב מפתח.
לאחר הבדיקה, תוכל להשבית את מצב הפיתוח במכשיר שלך:
adb shell setprop debug.firebase.appdistro.devmode false
בדיקות מקצה לקצה
כדי לבדוק שהאפליקציה שלך יכולה לשלוח משוב, בנה את האפליקציה שלך כגרסה מוקדמת שכוללת את ספריות הפצת האפליקציות המלאות, ובדוק את היישום שלך בעקבות השלבים הבאים:
העלה מהדורת אפליקציה חדשה להפצת אפליקציות.
הפץ את מהדורת האפליקציה לחשבון שיש לך הרשאה לגשת אליו.
הורד את האפליקציה דרך אפליקציית ה-Web או Android Tester של App Distribution.
הפעל משוב באמצעות המנגנון שיושם בשלב 3: הגדר משוב בתוך האפליקציה .
ודא שאתה מחובר עם אותו חשבון שאליו הפצת את מהדורת האפליקציה, ושלח משוב.
הצג את המשוב שלך בכרטיס המהדורה החדשה במסוף Firebase .
כדי ללמוד כיצד לפתור בעיות נפוצות, כמו בודקים שאינם יכולים להתחיל משוב באפליקציה, ראה הפעלת תכונות בדיקה עם ה-SDK .
שלב 5: נהל משוב בודקים
לאחר שתאפשר לבודקים שלך לשלוח משוב, תוכל להשתמש בכלים הבאים כדי לבדוק את המשוב הזה ולפעול לפיו:
הצג ומחק משוב במסוף Firebase
אתה יכול לסקור ולמחוק משוב משתמשים, כולל צילומי מסך, על ידי פתיחת כרטיסיית המשוב של הבוחנים תחת מהדורה ספציפית במסוף Firebase. משוב המשתמש מאורגן לפי מהדורה כך שתוכל לאשר את הגרסה עליה חל המשוב.
לאחר סקירת משוב משתמשים, תוכל למחוק משוב זה על ידי לחיצה על כפתור מחק משוב . המשוב שנמחק יוסר מהגרסה שלך.
קבל התראות באימייל על משוב חדש
כדי ללמוד באופן יזום על משוב בודקים חדשים, תוכל לקבל התראות בדוא"ל כאשר בודק שולח משוב. התראת האימייל כוללת את המשוב הכתוב שהבודק שלך סיפק וקישור לכל צילומי מסך שהוא שלח.
כדי לקבל התראות באימייל של הפצת אפליקציות באמצעות מנגנון ברירת מחדל זה, עליך לקבל את הרשאת firebase.projects.update
. התפקידים הבאים כוללים הרשאה נדרשת זו כברירת מחדל: Firebase Admin או בעל פרויקט או עורך .
כברירת מחדל, כל חבר בפרויקט שיש לו את ההרשאות הנדרשות לקבלת התראות בדוא"ל יקבל אימייל עם הגשת דוח משוב חדש. חברי הפרויקט יכולים לבטל את הסכמתם להתראות אלו בנפרד.
כדי להשבית התראות דוא"ל, ראה קבלת התראות Firebase .
שלח משוב חדש לכלים של צד שלישי
תוכל גם לשלוח התראות הפצת אפליקציות לערוץ ההתראות המועדף על הצוות שלך באמצעות Cloud Functions for Firebase. לדוגמה, אתה יכול לכתוב פונקציה שמצלמת אירוע התראה עבור משוב חדש בתוך האפליקציה ומפרסמת את מידע ההתראה לשירות של צד שלישי כמו Discord, Slack או Jira.
כדי להגדיר יכולות התראה מתקדמות באמצעות Cloud Functions for Firebase, בצע את השלבים הבאים:
הגדר את פונקציות הענן עבור Firebase , הכוללות את המשימות הבאות:
הורד את Node.js ו-npm.
התקן והיכנס ל-Firebase CLI.
אתחול פונקציות ענן עבור Firebase באמצעות Firebase CLI.
כתוב ופריסה של פונקציה הלוכדת אירוע התראת משוב בתוך האפליקציה מ-App Distribution ומטפלת בעומס האירוע (לדוגמה, פרסום מידע ההתראה בהודעה ב-Discord).
כדי לראות פונקציה לדוגמה שמראה לך כיצד לשלוח משוב חדש לג'ירה, עיין בדוגמה זו .
כדי ללמוד על כל אירועי ההתראה שתוכלו לצלם, עיין בתיעוד העזר להתראות הפצת אפליקציות .