שילוב של הצעות להתקנה מתוך האפליקציה

במדריך הזה מוסבר איך לשלב באפליקציה הנחיות להתקנה בתוך האפליקציה באמצעות Kotlin או Java.

הגדרת סביבת הפיתוח

הספרייה של הנחיות להתקנה מתוך האפליקציה ב-Play היא חלק מספריות Google Play Core. כדי להשתמש בספרייה, צריך לכלול את התלות הבאה ב-Gradle:

// In your app's build.gradle.kts file:
...
dependencies {
    implementation("com.google.android.play:crossdeviceprompt:0.0.1")
    ...
}

הצגת ההנחיה להתקנה במכשירים שונים

קובעים מהו הרגע הכי טוב בתהליך השימוש באפליקציה להצגת בקשה למשתמש להתקין את האפליקציה במכשיר אחר (לדוגמה, כשהוא מפעיל Cast של סרטון מהטלפון לטלוויזיה). כשהאפליקציה מגיעה לאחת מהנקודות האלה, מבצעים את השלבים הבאים:

  1. יצירת CrossDevicePromptInstallationRequest.
  2. משתמשים ב-CrossDevicePromptManager כדי ליצור משימת בקשה שמקבלת את הבקשה כפרמטר.
  3. משתמשים באובייקט CrossDevicePromptInfo שמתקבל עם launchPromptFlow() כדי להציג את ההודעה למשתמש.

אם מתרחשת שגיאה במהלך קבלת CrossDevicePromptInfo או הצגת ההנחיה, מתרחשת חריגה.

val crossDevicePromptManager = CrossDevicePromptManagerFactory.create(activity)
val request = CrossDevicePromptInstallationRequest.create()

try {
    val info = crossDevicePromptManager.requestInstallationPromptFlow(request).await()
    crossDevicePromptManager.launchPromptFlow(activity, info).await()
} catch (e: CrossDevicePromptException) {
    Log.e(TAG, "Cross-device prompt failed with error: ${e.errorCode}", e)
}

כדי לאמת את ההטמעה, אפשר לעיין במאמר בנושא בדיקת הנחיות להתקנת אפליקציות בתוך האפליקציה.