این راهنما نحوه ادغام پیام‌واره‌های نصب درون‌برنامه را در برنامه شما بااستفاده از Kotlin یا Java شرح می‌دهد.
راه‌اندازی محیط توسعه نرم‌افزار
«کتابخانه پیام‌واره‌های نصب درون‌برنامه Play» بخشی از کتابخانه‌های هسته Google Play است. برای استفاده از کتابخانه، وابستگی Gradle زیر را اضافه کنید:
// In your app's build.gradle.kts file:
...
dependencies {
implementation("com.google.android.play:crossdeviceprompt:0.0.1")
...
}
نمایش پیام‌واره نصب در چند دستگاه
بهترین لحظه را در جریان برنامه‌تان تعیین کنید تا از کاربر بخواهید برنامه‌تان را در دستگاه دیگری نصب کند (برای مثال، وقتی ویدیویی را از تلفن به تلویزیون ارسال می‌کند). وقتی برنامه‌تان به یکی از این نقاط رسید، مراحل زیر را انجام دهید:
CrossDevicePromptInstallationRequestایجاد کنید.- از
CrossDevicePromptManagerبرای ایجاد تکلیف درخواست استفاده کنید که درخواست را به‌عنوان پارامتر می‌پذیرد. - از شیء
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)
}
برای درستی‌سنجی پیاده‌سازی، به آزمایش کردن پیام‌واره‌های نصب درون‌برنامه مراجعه کنید.