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

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

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

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

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

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

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

  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)
}

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