การพักใช้งานแอป

หากแอปกำหนดเป้าหมายเป็น Android 11 (API ระดับ 30) ขึ้นไป และผู้ใช้ไม่ได้โต้ตอบกับแอปเป็นเวลา 2-3 เดือน ระบบจะตั้งค่าแอปของคุณเป็นสถานะหยุดทำงานชั่วคราว ระบบจะเพิ่มประสิทธิภาพพื้นที่เก็บข้อมูลแทนประสิทธิภาพ และระบบจะปกป้องข้อมูลผู้ใช้ ลักษณะการทํางานของระบบนี้คล้ายกับสิ่งที่เกิดขึ้นเมื่อผู้ใช้บังคับหยุดแอปของคุณด้วยตนเองจากการตั้งค่าระบบ

ผลของการพักใช้งาน

ดังที่แสดงในตารางที่ 1 ผลของการพักแรมจะขึ้นอยู่กับเวอร์ชัน SDK เป้าหมายของแอป รวมถึงอุปกรณ์ที่แอปทำงานอยู่

ลักษณะการทํางานของระบบเมื่อแอปออกจากโหมดพัก

เมื่อผู้ใช้โต้ตอบกับแอปของคุณในครั้งถัดไป แอปจะออกจากโหมดพักและสามารถสร้างงาน การแจ้งเตือน และการแจ้งเตือนอีกครั้ง

อย่างไรก็ตาม ระบบจะไม่ดำเนินการต่อไปนี้ให้กับแอปของคุณ

1. ให้สิทธิ์รันไทม์ของแอปอีกครั้ง

   ผู้ใช้ต้องให้สิทธิ์เหล่านี้แก่แอปของคุณอีกครั้ง

2. ตั้งเวลางาน การแจ้งเตือน และการแจ้งเตือนที่ตั้งเวลาไว้ก่อนแอปเข้าสู่โหมดพัก

   หากต้องการรองรับเวิร์กโฟลว์นี้ได้ง่ายขึ้น ให้ใช้ WorkManager นอกจากนี้ คุณยังเพิ่มตรรกะการกําหนดเวลาใหม่ใน ACTION_BOOT_COMPLETED ได้ด้วย ซึ่งจะเรียกใช้เมื่อแอปออกจากโหมดพักและหลังจากอุปกรณ์บูตขึ้น

การใช้งานแอป

ส่วนต่อไปนี้แสดงตัวอย่างการใช้งานแอป รวมถึงตัวอย่างการดำเนินการที่ระบบไม่ถือว่าเป็นส่วนหนึ่งของการใช้งานแอป

ตัวอย่างการใช้งานแอป

เมื่อกิจกรรมในแอปกลับมาทํางานอีกครั้ง ระบบจะถือว่าเหตุการณ์นี้เป็นกิจกรรมการโต้ตอบของผู้ใช้ ดังนั้น ระบบจึงเพิ่มระยะเวลาก่อนที่แอปจะเข้าสู่โหมดพัก

ใน Android 11 ขึ้นไป ระบบจะถือว่าพฤติกรรมต่อไปนี้เป็นการโต้ตอบของผู้ใช้ด้วย

• ผู้ใช้โต้ตอบกับวิดเจ็ต

• ผู้ใช้โต้ตอบกับการแจ้งเตือน ยกเว้นการปิดการแจ้งเตือน

โปรดทราบว่าการใช้งานแอปสำหรับการพักแรมไม่ได้กำหนดให้ต้องมีการโต้ตอบของผู้ใช้อย่างชัดเจน ตราบใดที่มีการเรียกใช้คอมโพเนนต์ของแพ็กเกจ ระบบจะยังคงถือว่ามีการใช้งานแอป ตัวอย่างของเนื้อหาประเภทนี้ ได้แก่

• แอปที่มีบริการหรือผู้ให้บริการเนื้อหาที่เชื่อมโยงกับแอปอื่นในอุปกรณ์หรือระบบปฏิบัติการ เช่น ตัวแก้ไขวิธีการป้อนข้อมูล (IME) หรือเครื่องมือจัดการรหัสผ่าน

• ตัวรับสัญญาณการออกอากาศในแพ็กเกจที่รับการออกอากาศที่ชัดเจนจากแพ็กเกจภายนอก

ไม่ใช่ตัวอย่าง

หากแอปแสดงลักษณะการทำงานตามที่อธิบายไว้ในรายการต่อไปนี้เท่านั้น แอปจะเข้าสู่โหมดพักหลังจากผ่านไป 2-3 เดือน

• เรียกใช้งานที่กําหนดเวลาไว้โดยใช้ JobScheduler
• ได้รับการออกอากาศโดยนัย
• ตั้งเวลาการปลุก

การยกเว้นระบบจากการเข้าสู่โหมดสลีป

Android ให้ข้อยกเว้นระดับระบบจากการพักแอปในบาง Use Case หากแอปของคุณอยู่ในหมวดหมู่ใดหมวดหมู่หนึ่งต่อไปนี้ แอปจะได้รับการยกเว้นจากมาตรฐานการใช้งานแอปและจะไม่เข้าสู่โหมดไฮเบอร์เนต

แอปไม่แสดงใน Launcher

แอปที่ไม่มีการ์ดทางลัดที่ใช้งานอยู่ในตัวเปิดแอป

แอปในโปรไฟล์งาน

แอปใดก็ตามที่ผู้ใช้ติดตั้งในโปรไฟล์งาน โปรดทราบว่าหากแอปเดียวกันอยู่ในโปรไฟล์ส่วนตัวด้วย จะมีเพียงแอปในโปรไฟล์งานเท่านั้นที่ได้รับการยกเว้น

เครื่องมือควบคุมนโยบายด้านอุปกรณ์

แอปที่ควบคุมนโยบายของอุปกรณ์ในเครื่องและแอปพลิเคชันระบบในอุปกรณ์

แอปที่มีสิทธิ์ของผู้ให้บริการ

แอปใดก็ตามที่ผู้ให้บริการเครือข่ายมือถือโหลดลงในอุปกรณ์ไว้ล่วงหน้าและเห็นว่าจำเป็นสำหรับภาระหน้าที่ในการให้บริการตามสัญญา เช่น แอปฝากข้อความเสียงหรือแอปบริการลูกค้า

แอปเครื่องมือติดตั้งของบุคคลที่สาม

App Store ของบุคคลที่สามสำหรับการอัปเดตแอปที่ติดตั้งไว้โดยอัตโนมัติเมื่อจำเป็น

การยกเว้นผู้ใช้จากการพักเครื่อง

หากคาดว่า Use Case หลักในแอปจะได้รับผลกระทบจากการพักเครื่อง คุณสามารถขอการยกเว้นจากการพักเครื่องของแอปจากผู้ใช้ได้ ข้อยกเว้นนี้มีประโยชน์ในสถานการณ์ที่ผู้ใช้คาดหวังให้แอปของคุณทํางานในเบื้องหลังเป็นหลัก แม้ว่าผู้ใช้จะไม่โต้ตอบกับแอปก็ตาม เช่น เมื่อแอปทําสิ่งต่อไปนี้

• ดูแลความปลอดภัยของครอบครัวด้วยการรายงานตำแหน่งของสมาชิกในครอบครัวเป็นระยะๆ
• ซิงค์ข้อมูลระหว่างอุปกรณ์กับเซิร์ฟเวอร์ของแอป
• สื่อสารกับอุปกรณ์อัจฉริยะ เช่น ทีวี
• จับคู่กับอุปกรณ์เสริม เช่น นาฬิกา

หากต้องการขอรับการยกเว้น ให้ทำตามขั้นตอนในส่วนต่อไปนี้

ตรวจสอบว่าผู้ใช้ปิดใช้โหมดพักสำหรับแอปของคุณแล้วหรือยัง

หากต้องการตรวจสอบว่าผู้ใช้ปิดใช้โหมดพักสำหรับแอปของคุณแล้วหรือยัง ให้ใช้ getUnusedAppRestrictionsStatus() API

ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้ API นี้ในแอปได้ที่ตัวอย่างโค้ด API ในหน้านี้

ขอให้ผู้ใช้ปิดใช้โหมดพักสำหรับแอปของคุณ

หากผู้ใช้ยังไม่ได้ปิดใช้โหมดพักสำหรับแอปของคุณ คุณสามารถส่งคำขอไปยังผู้ใช้ได้ โดยทำตามขั้นตอนต่อไปนี้

1. แสดง UI ที่อธิบายให้ผู้ใช้ทราบถึงเหตุผลที่ต้องปิดใช้โหมดพักสำหรับแอป

2. เรียกใช้ createManageUnusedAppRestrictionsIntent() API ตามที่แสดงในตัวอย่างโค้ด API API นี้จะสร้าง Intent ที่โหลดหน้าจอข้อมูลแอปในการตั้งค่า จากที่นี่ ผู้ใช้จะปิดโหมดพักสำหรับแอปของคุณได้

   คุณต้องเรียกใช้ startActivityForResult() ไม่ใช่ startActivity() เมื่อส่ง Intent นี้

   ดังที่แสดงในตารางที่ 2 ตำแหน่งและชื่อของตัวเลือกจะขึ้นอยู่กับลักษณะของอุปกรณ์ที่ติดตั้งแอป

   ตารางที่ 2 ตัวเลือกที่ปิดใช้การพักใช้งานสำหรับแอป

   ลักษณะของอุปกรณ์	หน้าที่ตัวเลือกปรากฏขึ้น	ชื่อตัวเลือกที่จะปิด
   ใช้ Android 13 ขึ้นไป	ข้อมูลแอป	หยุดกิจกรรมบนแอปชั่วคราวหากไม่ได้ใช้
   ใช้งาน Android 12	ข้อมูลแอป	นำสิทธิ์ออกและเพิ่มพื้นที่ว่าง
   ใช้งาน Android 11 ได้	ข้อมูลแอป > สิทธิ์	นำสิทธิ์ออกหากไม่ได้ใช้งานแอป
   ใช้ Android 6.0 ถึง Android 10 และขับเคลื่อนโดยบริการ Google Play	แอป Play > เมนู > Play Protect > สิทธิ์สําหรับแอปที่ไม่ได้ใช้	นำสิทธิ์ออกหากไม่ได้ใช้งานแอป

ตัวอย่างโค้ด API

ตัวอย่างโค้ดนี้แสดงวิธีตรวจสอบว่าเปิดใช้โหมดพักสำหรับแอปหรือไม่ และวิธีที่เหมาะสมในการขอให้ผู้ใช้ปิดใช้โหมดพักสำหรับแอป

val future: ListenableFuture<Int> =
    PackageManagerCompat.getUnusedAppRestrictionsStatus(context)
future.addListener({ onResult(future.get()) }, ContextCompat.getMainExecutor(context))

fun onResult(appRestrictionsStatus: Int) {
  when (appRestrictionsStatus) {
    // Couldn't fetch status. Check logs for details.
    ERROR -> { }

    // Restrictions don't apply to your app on this device.
    FEATURE_NOT_AVAILABLE -> { }

    // The user has disabled restrictions for your app.
    DISABLED -> { }

    // If the user doesn't start your app for a few months, the system will
    // place restrictions on it. See the API_* constants for details.
    API_30_BACKPORT, API_30, API_31 -> handleRestrictions(appRestrictionsStatus)
  }
}

fun handleRestrictions(appRestrictionsStatus: Int) {
  // If your app works primarily in the background, you can ask the user
  // to disable these restrictions. Check if you have already asked the
  // user to disable these restrictions. If not, you can show a message to
  // the user explaining why permission auto-reset or app hibernation should be
  // disabled. Then, redirect the user to the page in system settings where they
  // can disable the feature.
  val intent = IntentCompat.createManageUnusedAppRestrictionsIntent(context, packageName)

  // You must use startActivityForResult(), not startActivity(), even if
  // you don't use the result code returned in onActivityResult().
  startActivityForResult(intent, REQUEST_CODE)
}

API ของแพลตฟอร์มเดิม

นอกจากนี้ ระบบปฏิบัติการยังมี API สำหรับการโต้ตอบกับฟีเจอร์การพักเครื่องด้วย อย่างไรก็ตาม API นี้ใช้ได้กับอุปกรณ์ที่ใช้ Android 11 ขึ้นไปเท่านั้น API จะไม่จัดการฟีเจอร์การพักแรมที่ย้ายข้อมูลไปยัง Android เวอร์ชันเก่า ดังนั้น เราจึงไม่แนะนำให้ใช้ API

หากจําเป็นต้องใช้ API ต่อไปชั่วคราวเพื่อวัตถุประสงค์ด้านความเข้ากันได้ รายการต่อไปนี้แสดงวิธีใช้

• วิธีตรวจสอบว่าระบบปิดใช้โหมดพักสำหรับแอปหรือไม่ isAutoRevokeWhitelisted()
• หากต้องการส่งผู้ใช้ไปยังหน้าการตั้งค่าโหมดไฮเบอร์เนต ให้สร้าง Intent โดยใช้ ACTION_APPLICATION_DETAILS_SETTINGS

เรียกใช้ลักษณะการเข้าสู่โหมดพักเครื่องด้วยตนเอง

หากต้องการทดสอบลักษณะการทำงานของแอปหลังจากที่ระบบทำให้แอปอยู่ในสถานะ "ไฮเบอร์เนต" ให้ทำตามขั้นตอนต่อไปนี้

1. (Android 12 ขึ้นไปเท่านั้น) เปิดใช้ลักษณะการทำงานในโหมดไฮเบอร์เนตในอุปกรณ์ โดยทำดังนี้

   adb shell device_config put app_hibernation app_hibernation_enabled true
   

2. ตั้งค่าระยะเวลาเริ่มต้นที่ระบบจะรอเพื่อเข้าสู่โหมดไฮเบอร์เนต วิธีนี้จะช่วยให้คุณกู้คืนข้อมูลได้หลังจากการทดสอบ

   threshold=$(adb shell device_config get permissions \
     auto_revoke_unused_threshold_millis2)
   

3. ลดระยะเวลาที่ระบบรอ ในตัวอย่างต่อไปนี้ ระบบได้รับการแก้ไขเพื่อให้แอปเข้าสู่โหมดพักเครื่องเพียง 1 วินาทีหลังจากที่คุณหยุดโต้ตอบกับแอป

   adb shell device_config put permissions \
     auto_revoke_unused_threshold_millis2 1000
   

4. รอให้อุปกรณ์ทดสอบออกอากาศเวลาบูตจนเสร็จสิ้นโดยเรียกใช้คำสั่งต่อไปนี้

   adb shell am wait-for-broadcast-idle
   

   เมื่อการออกอากาศสิ้นสุดลง คำสั่งนี้จะแสดงข้อความต่อไปนี้ All broadcast queues are idle!

5. เรียกใช้กระบวนการพักใช้งานแอปด้วยตนเองโดยทำดังนี้

   adb shell cmd jobscheduler run -u 0 -f \
     com.google.android.permissioncontroller 2
   

6. (Android 12 ขึ้นไปเท่านั้น) ยืนยันว่าแอปอยู่ในโหมดไฮเบอร์เนตโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

   • สังเกตว่าตอนนี้อุปกรณ์ทดสอบแสดงการแจ้งเตือนที่ระบุว่าแอปที่ไม่ได้ใช้งานอยู่อยู่ในโหมดพัก

   • เรียกใช้คำสั่งต่อไปนี้

     adb shell cmd app_hibernation get-state PACKAGE-NAME
     

7. คืนค่าระยะเวลาเริ่มต้นที่ระบบจะรอก่อนที่จะทำให้แอปเข้าสู่โหมดพักเครื่อง

   adb shell device_config put permissions \
     auto_revoke_unused_threshold_millis2 $threshold