คู่มือนี้อธิบายวิธีรองรับการอัปเดตในแอปในแอปโดยใช้ Kotlin หรือ Java เรามีคำแนะนำแยกต่างหากสำหรับกรณีที่การติดตั้งใช้งานใช้โค้ดแบบเนทีฟ (C/C++) และกรณีที่การติดตั้งใช้งานใช้ Unity หรือ Unreal Engine
ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์
ไลบรารีการอัปเดตในแอป Play เป็นส่วนหนึ่งของไลบรารี Google Play Core รวมทรัพยากร Dependency ของ Gradle ต่อไปนี้เพื่อผสานรวมไลบรารีการอัปเดตในแอปของ Play
ดึงดูด
// In your app's build.gradle file: ... dependencies { // This dependency is downloaded from the Google's Maven repository. // So, make sure you also include that repository in your project's build.gradle file. implementation 'com.google.android.play:app-update:2.1.0' // For Kotlin users also add the Kotlin extensions library for Play In-App Update: implementation 'com.google.android.play:app-update-ktx:2.1.0' ... }
Kotlin
// In your app's build.gradle.kts file: ... dependencies { // This dependency is downloaded from the Google's Maven repository. // So, make sure you also include that repository in your project's build.gradle file. implementation("com.google.android.play:app-update:2.1.0") // For Kotlin users also import the Kotlin extensions library for Play In-App Update: implementation("com.google.android.play:app-update-ktx:2.1.0") ... }
ตรวจสอบความพร้อมใช้งานของการอัปเดต
ก่อนขออัปเดต ให้ตรวจสอบว่ามีอัปเดตที่พร้อมใช้งานสำหรับแอปหรือไม่
ใช้ AppUpdateManager เพื่อตรวจสอบอัปเดต โดยทำดังนี้
Kotlin
val appUpdateManager = AppUpdateManagerFactory.create(context)
// Returns an intent object that you use to check for an update.
val appUpdateInfoTask = appUpdateManager.appUpdateInfo
// Checks that the platform will allow the specified type of update.
appUpdateInfoTask.addOnSuccessListener { appUpdateInfo ->
if (appUpdateInfo.updateAvailability() == UpdateAvailability.UPDATE_AVAILABLE
// This example applies an immediate update. To apply a flexible update
// instead, pass in AppUpdateType.FLEXIBLE
&& appUpdateInfo.isUpdateTypeAllowed(AppUpdateType.IMMEDIATE)
) {
// Request the update.
}
}
Java
AppUpdateManager appUpdateManager = AppUpdateManagerFactory.create(context);
// Returns an intent object that you use to check for an update.
Task<AppUpdateInfo> appUpdateInfoTask = appUpdateManager.getAppUpdateInfo();
// Checks that the platform will allow the specified type of update.
appUpdateInfoTask.addOnSuccessListener(appUpdateInfo -> {
if (appUpdateInfo.updateAvailability() == UpdateAvailability.UPDATE_AVAILABLE
// This example applies an immediate update. To apply a flexible update
// instead, pass in AppUpdateType.FLEXIBLE
&& appUpdateInfo.isUpdateTypeAllowed(AppUpdateType.IMMEDIATE)) {
// Request the update.
}
});
อินสแตนซ์ AppUpdateInfo ที่แสดงผลจะมีสถานะความพร้อมใช้งานของการอัปเดต อินสแตนซ์ยังมีข้อมูลต่อไปนี้ด้วย ทั้งนี้ขึ้นอยู่กับสถานะของการอัปเดต
- หากมีการอัปเดตและได้รับอนุญาตให้อัปเดต อินสแตนซ์จะมี Intent ในการเริ่มอัปเดตด้วย
- หากการอัปเดตในแอปอยู่ระหว่างดำเนินการ อินสแตนซ์จะรายงานสถานะของการอัปเดตที่อยู่ระหว่างดำเนินการด้วย
ตรวจสอบความล้าสมัยของการอัปเดต
นอกจากการตรวจสอบว่ามีการอัปเดตพร้อมใช้งานหรือไม่ คุณอาจต้องตรวจสอบด้วยว่าเวลาผ่านไปนานเท่าใดแล้วนับตั้งแต่ที่ผู้ใช้ได้รับการแจ้งเตือนการอัปเดตผ่าน Play Store ครั้งล่าสุด ซึ่งจะช่วยให้คุณตัดสินใจได้ว่าควรเริ่มการอัปเดตแบบยืดหยุ่นหรือการอัปเดตทันที ตัวอย่างเช่น คุณอาจรอ 2-3 วันก่อนที่จะแจ้งให้ผู้ใช้ทราบด้วยการอัปเดตแบบยืดหยุ่น และรออีก 2-3 วันหลังจากนั้นก่อนที่จะกำหนดให้ต้องอัปเดตทันที
ใช้ clientVersionStalenessDays() เพื่อตรวจสอบจำนวนวันนับตั้งแต่ที่การอัปเดตพร้อมใช้งานใน Play Store ดังนี้
Kotlin
val appUpdateManager = AppUpdateManagerFactory.create(context) // Returns an intent object that you use to check for an update. val appUpdateInfoTask = appUpdateManager.appUpdateInfo // Checks whether the platform allows the specified type of update, // and current version staleness. appUpdateInfoTask.addOnSuccessListener { appUpdateInfo -> if (appUpdateInfo.updateAvailability() == UpdateAvailability.UPDATE_AVAILABLE && (appUpdateInfo.clientVersionStalenessDays() ?: -1) >= DAYS_FOR_FLEXIBLE_UPDATE && appUpdateInfo.isUpdateTypeAllowed(AppUpdateType.FLEXIBLE)) { // Request the update. } }
Java
AppUpdateManager appUpdateManager = AppUpdateManagerFactory.create(context); // Returns an intent object that you use to check for an update. Task<AppUpdateInfo> appUpdateInfoTask = appUpdateManager.getAppUpdateInfo(); // Checks whether the platform allows the specified type of update, // and current version staleness. appUpdateInfoTask.addOnSuccessListener(appUpdateInfo -> { if (appUpdateInfo.updateAvailability() == UpdateAvailability.UPDATE_AVAILABLE && appUpdateInfo.clientVersionStalenessDays() != null && appUpdateInfo.clientVersionStalenessDays() >= DAYS_FOR_FLEXIBLE_UPDATE && appUpdateInfo.isUpdateTypeAllowed(AppUpdateType.FLEXIBLE)) { // Request the update. } });
ตรวจสอบลำดับความสำคัญของการอัปเดต
Google Play Developer API ช่วยให้คุณกำหนดลำดับความสำคัญของการอัปเดตแต่ละรายการได้ ซึ่งจะช่วยให้แอปตัดสินใจได้ว่าจะแนะนำการอัปเดตให้ผู้ใช้มากน้อยเพียงใด ตัวอย่างเช่น ลองพิจารณากลยุทธ์ต่อไปนี้สำหรับการตั้งค่าลำดับความสำคัญของการอัปเดต
- การปรับปรุง UI เล็กน้อย: การอัปเดตที่มีลำดับความสำคัญต่ำ ไม่ต้องขอการอัปเดตแบบยืดหยุ่นหรือการอัปเดตทันที อัปเดตเฉพาะเมื่อผู้ใช้ไม่ได้โต้ตอบกับแอป
- การปรับปรุงประสิทธิภาพ: การอัปเดตลำดับความสำคัญปานกลาง ขอการอัปเดตแบบยืดหยุ่น
- การอัปเดตความปลอดภัยที่สำคัญ: การอัปเดตที่มีลำดับความสำคัญสูง โปรดขอการอัปเดตทันที
Google Play จะใช้ค่าจำนวนเต็มระหว่าง 0 ถึง 5 เพื่อกำหนดลำดับความสำคัญ โดย 0 เป็นค่าเริ่มต้นและ 5 เป็นลำดับความสำคัญสูงสุด หากต้องการตั้งค่าลำดับความสำคัญสำหรับการอัปเดต ให้ใช้ช่อง inAppUpdatePriority ในส่วน Edits.tracks.releases ใน Google Play Developer API เวอร์ชันที่เพิ่มใหม่ทั้งหมดในรุ่นจะถือว่ามีลำดับความสำคัญเท่ากับรุ่น คุณจะตั้งค่าลำดับความสำคัญได้เมื่อเปิดตัวรุ่นใหม่เท่านั้น และจะเปลี่ยนในภายหลังไม่ได้
กำหนดลำดับความสำคัญโดยใช้ Google Play Developer API ตามที่อธิบายไว้ในเอกสารประกอบของ Play Developer API คุณควรระบุลำดับความสำคัญของการอัปเดตแอปในทรัพยากร Edit.tracks ที่ส่งผ่านเมธอด Edit.tracks: update ตัวอย่างต่อไปนี้แสดงการเผยแพร่แอปที่มีรหัสเวอร์ชัน 88 และ inAppUpdatePriority 5
{
"releases": [{
"versionCodes": ["88"],
"inAppUpdatePriority": 5,
"status": "completed"
}]
}
ในโค้ดของแอป คุณสามารถตรวจสอบระดับความสำคัญของการอัปเดตหนึ่งๆ ได้โดยใช้ updatePriority() ลำดับความสำคัญที่แสดงผลจะพิจารณา inAppUpdatePriority สำหรับรหัสเวอร์ชันแอปทั้งหมดระหว่างเวอร์ชันที่ติดตั้งกับเวอร์ชันล่าสุดที่พร้อมใช้งาน โดยไม่คำนึงถึงแทร็กการเผยแพร่ ตัวอย่างเช่น ลองพิจารณาสถานการณ์สมมติต่อไปนี้
- คุณเผยแพร่เวอร์ชัน 1 ไปยังแทร็กเวอร์ชันที่ใช้งานจริงโดยไม่มีลำดับความสำคัญ
- คุณเผยแพร่เวอร์ชัน 2 ไปยังแทร็กทดสอบภายในที่มีลำดับความสำคัญเป็น 5
- คุณเผยแพร่เวอร์ชัน 3 ไปยังแทร็กเวอร์ชันที่ใช้งานจริงโดยไม่มีลำดับความสำคัญ
เมื่อผู้ใช้เวอร์ชันที่ใช้งานจริงอัปเดตจากเวอร์ชัน 1 เป็นเวอร์ชัน 3 ผู้ใช้จะได้รับลำดับความสำคัญ 5 แม้ว่าจะมีการเผยแพร่เวอร์ชัน 2 ในแทร็กอื่นก็ตาม
Kotlin
val appUpdateManager = AppUpdateManagerFactory.create(context) // Returns an intent object that you use to check for an update. val appUpdateInfoTask = appUpdateManager.appUpdateInfo // Checks whether the platform allows the specified type of update, // and checks the update priority. appUpdateInfoTask.addOnSuccessListener { appUpdateInfo -> if (appUpdateInfo.updateAvailability() == UpdateAvailability.UPDATE_AVAILABLE && appUpdateInfo.updatePriority() >= 4 /* high priority */ && appUpdateInfo.isUpdateTypeAllowed(AppUpdateType.IMMEDIATE)) { // Request an immediate update. } }
Java
AppUpdateManager appUpdateManager = AppUpdateManagerFactory.create(context); // Returns an intent object that you use to check for an update. Task<AppUpdateInfo> appUpdateInfoTask = appUpdateManager.getAppUpdateInfo(); // Checks whether the platform allows the specified type of update, // and checks the update priority. appUpdateInfoTask.addOnSuccessListener(appUpdateInfo -> { if (appUpdateInfo.updateAvailability() == UpdateAvailability.UPDATE_AVAILABLE && appUpdateInfo.updatePriority() >= 4 /* high priority */ && appUpdateInfo.isUpdateTypeAllowed(AppUpdateType.IMMEDIATE)) { // Request an immediate update. } });
เริ่มอัปเดต
หลังจากยืนยันว่ามีการอัปเดตพร้อมใช้งานแล้ว คุณจะขออัปเดตได้โดยใช้ AppUpdateManager.startUpdateFlowForResult() ดังนี้
Kotlin
appUpdateManager.startUpdateFlowForResult(
// Pass the intent that is returned by 'getAppUpdateInfo()'.
appUpdateInfo,
// An activity result launcher registered using registerForActivityResult.
activityResultLauncher,
// Or pass 'AppUpdateType.FLEXIBLE' to newBuilder() for
// flexible updates.
AppUpdateOptions.newBuilder(AppUpdateType.IMMEDIATE).build())
Java
appUpdateManager.startUpdateFlowForResult(
// Pass the intent that is returned by 'getAppUpdateInfo()'.
appUpdateInfo,
// An activity result launcher registered using registerForActivityResult.
activityResultLauncher,
// Or pass 'AppUpdateType.FLEXIBLE' to newBuilder() for
// flexible updates.
AppUpdateOptions.newBuilder(AppUpdateType.IMMEDIATE).build());
อินสแตนซ์ AppUpdateInfo แต่ละรายการใช้เพื่อเริ่มการอัปเดตได้เพียงครั้งเดียวเท่านั้น หากต้องการลองอัปเดตอีกครั้งในกรณีที่ดำเนินการไม่สำเร็จ ให้ขอ AppUpdateInfo ใหม่และตรวจสอบอีกครั้งว่าการอัปเดตพร้อมใช้งานและได้รับอนุญาต
คุณสามารถลงทะเบียนตัวเปิดผลลัพธ์ของกิจกรรมโดยใช้สัญญา ActivityResultContracts.StartIntentSenderForResult ในตัว ดูส่วนการรับ Callback สำหรับสถานะการอัปเดต
ขั้นตอนถัดไปจะขึ้นอยู่กับว่าคุณกำลังขอการอัปเดตแบบยืดหยุ่นหรือการอัปเดตทันที
กำหนดค่าการอัปเดตด้วย AppUpdateOptions
AppUpdateOptions มีช่อง AllowAssetPackDeletion ที่กำหนดว่าการอัปเดตได้รับอนุญาตให้ล้างAsset Packหรือไม่ในกรณีที่พื้นที่เก็บข้อมูลของอุปกรณ์มีจำกัด ระบบจะตั้งค่าช่องนี้เป็น false โดยค่าเริ่มต้น แต่คุณสามารถใช้เมธอด setAllowAssetPackDeletion() เพื่อตั้งค่าเป็น true แทนได้ ดังนี้
Kotlin
appUpdateManager.startUpdateFlowForResult(
// Pass the intent that is returned by 'getAppUpdateInfo()'.
appUpdateInfo,
// An activity result launcher registered using registerForActivityResult.
activityResultLauncher,
// Or pass 'AppUpdateType.FLEXIBLE' to newBuilder() for
// flexible updates.
AppUpdateOptions.newBuilder(AppUpdateType.IMMEDIATE)
.setAllowAssetPackDeletion(true)
.build())
Java
appUpdateManager.startUpdateFlowForResult(
// Pass the intent that is returned by 'getAppUpdateInfo()'.
appUpdateInfo,
// An activity result launcher registered using registerForActivityResult.
activityResultLauncher,
// Or pass 'AppUpdateType.FLEXIBLE' to newBuilder() for
// flexible updates.
AppUpdateOptions.newBuilder(AppUpdateType.IMMEDIATE)
.setAllowAssetPackDeletion(true)
.build());
รับการติดต่อกลับเพื่ออัปเดตสถานะ
หลังจากเริ่มการอัปเดต Callback ของ Launcher ผลลัพธ์กิจกรรมที่ลงทะเบียนไว้จะได้รับผลลัพธ์ของกล่องโต้ตอบการยืนยันดังนี้
Kotlin
registerForActivityResult(StartIntentSenderForResult()) { result: ActivityResult ->
// handle callback
if (result.resultCode != RESULT_OK) {
log("Update flow failed! Result code: " + result.resultCode);
// If the update is canceled or fails,
// you can request to start the update again.
}
}
Java
registerForActivityResult(
new ActivityResultContracts.StartIntentSenderForResult(),
new ActivityResultCallback<ActivityResult>() {
@Override
public void onActivityResult(ActivityResult result) {
// handle callback
if (result.getResultCode() != RESULT_OK) {
log("Update flow failed! Result code: " + result.getResultCode());
// If the update is canceled or fails,
// you can request to start the update again.
}
}
});
คุณอาจได้รับค่าหลายค่าจาก Callback onActivityResult() ดังนี้
RESULT_OK: ผู้ใช้ยอมรับการอัปเดตแล้ว สำหรับการอัปเดตทันที คุณอาจไม่ได้รับ Callback นี้เนื่องจากการอัปเดตควรเสร็จสิ้นแล้วเมื่อมีการส่งคืนการควบคุมไปยังแอปของคุณRESULT_CANCELED: ผู้ใช้ปฏิเสธหรือยกเลิกการอัปเดตActivityResult.RESULT_IN_APP_UPDATE_FAILED: ข้อผิดพลาดอื่นๆ ที่ทำให้ผู้ใช้ให้ความยินยอมไม่ได้หรือทำให้การอัปเดตดำเนินการต่อไม่ได้
จัดการการอัปเดตแบบยืดหยุ่น
เมื่อคุณเริ่มการอัปเดตแบบยืดหยุ่น กล่องโต้ตอบจะปรากฏขึ้นก่อนเพื่อให้ผู้ใช้ขอความยินยอม หากผู้ใช้ให้ความยินยอมของผู้ใช้ การดาวน์โหลดจะเริ่มขึ้นในเบื้องหลัง และผู้ใช้จะโต้ตอบกับอัปเดตแอปของคุณต่อไปได้ ส่วนนี้จะอธิบายวิธีตรวจสอบและดำเนินการอัปเดตในแอปแบบยืดหยุ่นให้เสร็จสมบูรณ์
ตรวจสอบสถานะการอัปเดตแบบยืดหยุ่น
หลังจากเริ่มดาวน์โหลดการอัปเดตแบบยืดหยุ่นแล้ว แอปของคุณจะต้องตรวจสอบสถานะการอัปเดตเพื่อให้ทราบว่าสามารถติดตั้งการอัปเดตได้เมื่อใด และเพื่อแสดงความคืบหน้าใน UI ของแอป
คุณตรวจสอบสถานะของการอัปเดตที่อยู่ระหว่างดำเนินการได้โดยลงทะเบียน Listener สำหรับการอัปเดตสถานะการติดตั้ง นอกจากนี้ คุณยังแสดงแถบความคืบหน้าใน UI ของแอปเพื่อแจ้งให้ผู้ใช้ทราบถึงความคืบหน้าของการดาวน์โหลดได้ด้วย
Kotlin
// Create a listener to track request state updates.
val listener = InstallStateUpdatedListener { state ->
// (Optional) Provide a download progress bar.
if (state.installStatus() == InstallStatus.DOWNLOADING) {
val bytesDownloaded = state.bytesDownloaded()
val totalBytesToDownload = state.totalBytesToDownload()
// Show update progress bar.
}
// Log state or install the update.
}
// Before starting an update, register a listener for updates.
appUpdateManager.registerListener(listener)
// Start an update.
// When status updates are no longer needed, unregister the listener.
appUpdateManager.unregisterListener(listener)
Java
// Create a listener to track request state updates.
InstallStateUpdatedListener listener = state -> {
// (Optional) Provide a download progress bar.
if (state.installStatus() == InstallStatus.DOWNLOADING) {
long bytesDownloaded = state.bytesDownloaded();
long totalBytesToDownload = state.totalBytesToDownload();
// Implement progress bar.
}
// Log state or install the update.
};
// Before starting an update, register a listener for updates.
appUpdateManager.registerListener(listener);
// Start an update.
// When status updates are no longer needed, unregister the listener.
appUpdateManager.unregisterListener(listener);
ติดตั้งการอัปเดตแบบยืดหยุ่น
เมื่อตรวจพบสถานะ InstallStatus.DOWNLOADED คุณต้องรีสตาร์ทแอปเพื่อติดตั้งการอัปเดต
Google Play จะไม่ทริกเกอร์การรีสตาร์ทแอปโดยอัตโนมัติสำหรับการอัปเดตแบบยืดหยุ่น ซึ่งต่างจากการอัปเดตทันที เนื่องจากในระหว่างการอัปเดตแบบยืดหยุ่น ผู้ใช้คาดหวังว่าจะโต้ตอบกับแอปต่อไปได้จนกว่าจะตัดสินใจว่าต้องการติดตั้งอัปเดต
เราขอแนะนำให้คุณแสดงการแจ้งเตือน (หรือการบ่งชี้ UI อื่นๆ) เพื่อแจ้งให้ผู้ใช้ทราบว่าการอัปเดตพร้อมติดตั้งแล้ว และขอการยืนยันก่อนรีสตาร์ทแอป
ตัวอย่างต่อไปนี้แสดงการใช้ Material Design snackbar ที่ขอการยืนยันจากผู้ใช้เพื่อรีสตาร์ทแอป
Kotlin
val listener = InstallStateUpdatedListener { state ->
if (state.installStatus() == InstallStatus.DOWNLOADED) {
// After the update is downloaded, show a notification
// and request user confirmation to restart the app.
popupSnackbarForCompleteUpdate()
}
...
}
// Displays the snackbar notification and call to action.
fun popupSnackbarForCompleteUpdate() {
Snackbar.make(
findViewById(R.id.activity_main_layout),
"An update has just been downloaded.",
Snackbar.LENGTH_INDEFINITE
).apply {
setAction("RESTART") { appUpdateManager.completeUpdate() }
setActionTextColor(resources.getColor(R.color.snackbar_action_text_color))
show()
}
}
Java
InstallStateUpdatedListener listener = state -> {
if (state.installStatus() == InstallStatus.DOWNLOADED) {
// After the update is downloaded, show a notification
// and request user confirmation to restart the app.
popupSnackbarForCompleteUpdate();
}
...
};
// Displays the snackbar notification and call to action.
private void popupSnackbarForCompleteUpdate() {
Snackbar snackbar =
Snackbar.make(
findViewById(R.id.activity_main_layout),
"An update has just been downloaded.",
Snackbar.LENGTH_INDEFINITE);
snackbar.setAction("RESTART", view -> appUpdateManager.completeUpdate());
snackbar.setActionTextColor(
getResources().getColor(R.color.snackbar_action_text_color));
snackbar.show();
}
เมื่อคุณเรียกใช้ appUpdateManager.completeUpdate() ในเบื้องหน้า แพลตฟอร์มจะแสดง UI แบบเต็มหน้าจอที่รีสตาร์ทแอปในเบื้องหลัง
หลังจากแพลตฟอร์มติดตั้งการอัปเดตแล้ว แอปจะรีสตาร์ทเข้าสู่กิจกรรมหลัก
หากคุณเรียกใช้ completeUpdate() เมื่อแอปทำงานอยู่เบื้องหลังแทน
ระบบจะติดตั้งการอัปเดตโดยไม่มีการแจ้งเตือนและไม่บดบัง UI ของอุปกรณ์
เมื่อใดก็ตามที่ผู้ใช้นำแอปของคุณมาไว้ที่เบื้องหน้า ให้ตรวจสอบว่าแอปมีการอัปเดตที่รอการติดตั้งอยู่หรือไม่ หากแอปของคุณมีการอัปเดตในสถานะ DOWNLOADED ให้แจ้งให้ผู้ใช้ติดตั้งการอัปเดต ไม่เช่นนั้น ข้อมูลอัปเดตจะยังคงใช้พื้นที่เก็บข้อมูลของอุปกรณ์ของผู้ใช้ต่อไป
Kotlin
// Checks that the update is not stalled during 'onResume()'.
// However, you should execute this check at all app entry points.
override fun onResume() {
super.onResume()
appUpdateManager
.appUpdateInfo
.addOnSuccessListener { appUpdateInfo ->
...
// If the update is downloaded but not installed,
// notify the user to complete the update.
if (appUpdateInfo.installStatus() == InstallStatus.DOWNLOADED) {
popupSnackbarForCompleteUpdate()
}
}
}
Java
// Checks that the update is not stalled during 'onResume()'.
// However, you should execute this check at all app entry points.
@Override
protected void onResume() {
super.onResume();
appUpdateManager
.getAppUpdateInfo()
.addOnSuccessListener(appUpdateInfo -> {
...
// If the update is downloaded but not installed,
// notify the user to complete the update.
if (appUpdateInfo.installStatus() == InstallStatus.DOWNLOADED) {
popupSnackbarForCompleteUpdate();
}
});
}
จัดการการอัปเดตทันที
เมื่อคุณเริ่มการอัปเดตทันทีและผู้ใช้ยินยอมให้เริ่มการอัปเดต Google Play จะแสดงความคืบหน้าของการอัปเดตที่ด้านบนของ UI ของแอปตลอดระยะเวลาการอัปเดต หากผู้ใช้ปิดหรือสิ้นสุดการทำงานของแอปในระหว่างการอัปเดต การอัปเดตควรดาวน์โหลดและติดตั้งในเบื้องหลังต่อไปโดยไม่ต้องมีการยืนยันจากผู้ใช้เพิ่มเติม
อย่างไรก็ตาม เมื่อแอปกลับมาทำงานอยู่เบื้องหน้า คุณควรตรวจสอบว่าการอัปเดตไม่ได้หยุดชะงักในสถานะ UpdateAvailability.DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS หากการอัปเดตหยุดชะงักในสถานะนี้ ให้ดำเนินการอัปเดตต่อโดยทำดังนี้
Kotlin
// Checks that the update is not stalled during 'onResume()'.
// However, you should execute this check at all entry points into the app.
override fun onResume() {
super.onResume()
appUpdateManager
.appUpdateInfo
.addOnSuccessListener { appUpdateInfo ->
...
if (appUpdateInfo.updateAvailability()
== UpdateAvailability.DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS
) {
// If an in-app update is already running, resume the update.
appUpdateManager.startUpdateFlowForResult(
appUpdateInfo,
activityResultLauncher,
AppUpdateOptions.newBuilder(AppUpdateType.IMMEDIATE).build())
}
}
}
Java
// Checks that the update is not stalled during 'onResume()'.
// However, you should execute this check at all entry points into the app.
@Override
protected void onResume() {
super.onResume();
appUpdateManager
.getAppUpdateInfo()
.addOnSuccessListener(
appUpdateInfo -> {
...
if (appUpdateInfo.updateAvailability()
== UpdateAvailability.DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS) {
// If an in-app update is already running, resume the update.
appUpdateManager.startUpdateFlowForResult(
appUpdateInfo,
activityResultLauncher,
AppUpdateOptions.newBuilder(AppUpdateType.IMMEDIATE).build());
}
});
}
ขั้นตอนการอัปเดตจะแสดงผลลัพธ์ตามที่อธิบายไว้ในเอกสารอ้างอิงสำหรับ startUpdateFlowForResult() โดยเฉพาะอย่างยิ่ง แอปของคุณควรจัดการกรณีที่ผู้ใช้ปฏิเสธการอัปเดตหรือยกเลิกการดาวน์โหลดได้ เมื่อผู้ใช้ดำเนินการอย่างใดอย่างหนึ่งเหล่านี้ UI ของ Google Play จะปิดลง แอปของคุณควรพิจารณาวิธีที่ดีที่สุดในการดำเนินการต่อ
หากเป็นไปได้ ให้ผู้ใช้ดำเนินการต่อโดยไม่ต้องอัปเดตและแจ้งเตือนอีกครั้งในภายหลัง หากแอปทำงานไม่ได้หากไม่มีการอัปเดต ให้พิจารณาแสดงข้อความที่ให้ข้อมูลก่อนเริ่มขั้นตอนการอัปเดตอีกครั้งหรือแจ้งให้ผู้ใช้ปิดแอป วิธีนี้จะช่วยให้ผู้ใช้เข้าใจว่าสามารถเปิดแอปอีกครั้งได้เมื่อพร้อมติดตั้งการอัปเดตที่จำเป็น
ขั้นตอนถัดไป
ทดสอบการอัปเดตในแอปของแอปเพื่อยืนยันว่าการผสานรวมทำงานอย่างถูกต้อง