Tích hợp lời nhắc cài đặt trong ứng dụng

Hướng dẫn này mô tả cách tích hợp lời nhắc cài đặt trong ứng dụng vào ứng dụng của bạn bằng cách sử dụng Kotlin hoặc Java.

Thiết lập môi trường phát triển

Thư viện lời nhắc cài đặt trong ứng dụng của Play là một phần của Thư viện Google Play Core. Để sử dụng thư viện này, hãy thêm phần phụ thuộc Gradle sau:

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

Hiện lời nhắc cài đặt trên nhiều thiết bị

Xác định thời điểm thích hợp nhất trong luồng ứng dụng để nhắc người dùng cài đặt ứng dụng của bạn trên một thiết bị khác (ví dụ: khi họ truyền video từ điện thoại sang TV). Khi ứng dụng của bạn chạy đến một trong những thời điểm này, hãy thực hiện các bước sau:

  1. Tạo CrossDevicePromptInstallationRequest.
  2. Sử dụng CrossDevicePromptManager để tạo một tác vụ yêu cầu chấp nhận yêu cầu làm tham số.
  3. Sử dụng đối tượng CrossDevicePromptInfo thu được với launchPromptFlow() để hiện lời nhắc cho người dùng.

Nếu xảy ra lỗi khi lấy CrossDevicePromptInfo hoặc hiện lời nhắc, thì một ngoại lệ sẽ được gửi.

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

Để xác minh quá trình triển khai, hãy xem bài viết Kiểm thử lời nhắc cài đặt trong ứng dụng.