ऐप्लिकेशन का हाइबरनेशन मोड

अगर आपका ऐप्लिकेशन, Android 11 (एपीआई लेवल 30) या इसके बाद के वर्शन के लिए है और उपयोगकर्ता कुछ महीनों तक आपके ऐप्लिकेशन से इंटरैक्ट नहीं करता है, तो सिस्टम आपके ऐप्लिकेशन को हाइबरनेशन मोड में डाल देता है. सिस्टम, परफ़ॉर्मेंस के बजाय स्टोरेज स्पेस को ऑप्टिमाइज़ करता है. साथ ही, उपयोगकर्ता के डेटा को सुरक्षित रखता है. सिस्टम का यह व्यवहार, तब होने वाले व्यवहार जैसा ही होता है, जब उपयोगकर्ता सिस्टम सेटिंग से आपके ऐप्लिकेशन को मैन्युअल तरीके से बंद करता है.

हाइबरनेशन मोड में होने पर क्या होता है

टेबल 1 में दिखाया गया है कि हाइबरनेशन मोड में होने पर क्या होता है. यह इस बात पर निर्भर करता है कि आपके ऐप्लिकेशन का टारगेट एसडीके वर्शन कौनसा है. साथ ही, यह इस बात पर भी निर्भर करता है कि आपका ऐप्लिकेशन किस डिवाइस पर चल रहा है:

हाइबरनेशन मोड से बाहर आने पर सिस्टम का व्यवहार

जब उपयोगकर्ता अगली बार आपके ऐप्लिकेशन से इंटरैक्ट करता है, तो आपका ऐप्लिकेशन हाइबरनेशन मोड से बाहर आ जाता है. इसके बाद, यह फिर से काम कर सकता है, सूचनाएं भेज सकता है, और अलर्ट दिखा सकता है.

हालांकि, सिस्टम आपके ऐप्लिकेशन के लिए ये काम नहीं करता:

1. आपके ऐप्लिकेशन की रनटाइम अनुमतियां फिर से देना.

   उपयोगकर्ता को आपके ऐप्लिकेशन के लिए ये अनुमतियां फिर से देनी होंगी.

2. आपके ऐप्लिकेशन के हाइबरनेशन मोड में जाने से पहले शेड्यूल किए गए किसी भी काम, अलर्ट, और सूचनाओं को फिर से शेड्यूल करना.

   इस वर्कफ़्लो को आसानी से लागू करने के लिए, WorkManager का इस्तेमाल करें. इसके अलावा, फिर से शेड्यूल करने की लॉजिक ACTION_BOOT_COMPLETED ब्रॉडकास्ट रिसीवर में जोड़ी जा सकती है. यह तब शुरू होता है, जब आपका ऐप्लिकेशन हाइबरनेशन मोड से बाहर आता है और डिवाइस बूट अप हो जाता है.

ऐप्लिकेशन का उपयोग

यहां दिए गए सेक्शन में, ऐप्लिकेशन के इस्तेमाल के उदाहरण दिए गए हैं. साथ ही, उन कार्रवाइयों के उदाहरण भी दिए गए हैं जिन्हें सिस्टम, ऐप्लिकेशन का इस्तेमाल नहीं मानता.

ऐप्लिकेशन के इस्तेमाल के उदाहरण

जब आपके ऐप्लिकेशन में कोई गतिविधि फिर से शुरू होती है, तो सिस्टम इस इवेंट को उपयोगकर्ता का इंटरैक्शन मानता है. इसलिए, सिस्टम आपके ऐप्लिकेशन के हाइबरनेशन मोड में जाने से पहले लगने वाले समय को बढ़ा देता है.

Android 11 और इसके बाद के वर्शन पर, इन कार्रवाइयों को भी उपयोगकर्ता का इंटरैक्शन माना जाता है:

• उपयोगकर्ता, विजेट से इंटरैक्ट करता है.

• उपयोगकर्ता, किसी सूचना से इंटरैक्ट करता है. हालांकि, सूचना को खारिज करने पर इसे इंटरैक्शन नहीं माना जाता.

यह ध्यान रखना ज़रूरी है कि हाइबरनेशन मोड के लिए, ऐप्लिकेशन के इस्तेमाल के लिए उपयोगकर्ता के इंटरैक्शन की ज़रूरत नहीं होती. जब तक पैकेज का कोई कॉम्पोनेंट शुरू होता है, तब तक इसे ऐप्लिकेशन का इस्तेमाल माना जाता है. इसके कुछ उदाहरण यहां दिए गए हैं:

• ऐसे ऐप्लिकेशन जिनमें कोई सेवा या कॉन्टेंट देने वाली कंपनी, डिवाइस या ओएस पर मौजूद किसी दूसरे ऐप्लिकेशन से जुड़ी होती है. उदाहरण के लिए, इनपुट के तरीके के एडिटर (IME) या पासवर्ड मैनेजर.

• पैकेज में मौजूद ब्रॉडकास्ट रिसीवर को, किसी बाहरी पैकेज से साफ़ तौर पर ब्रॉडकास्ट मिलता है.

उदाहरण नहीं

अगर आपका ऐप्लिकेशन, सिर्फ़ यहां बताई गई कार्रवाइयां करता है, तो कुछ महीनों बाद आपका ऐप्लिकेशन हाइबरनेशन मोड में चला जाता है:

• शेड्यूल किया गया कोई काम करता है.JobScheduler
• कोई इंप्लिसिट ब्रॉडकास्ट पाता है.
• अलार्म शेड्यूल करता है.

सिस्टम की ओर से हाइबरनेशन मोड से छूट

Android, इस्तेमाल के कुछ मामलों में, ऐप्लिकेशन के हाइबरनेशन मोड से सिस्टम-लेवल की छूट देता है. अगर आपका ऐप्लिकेशन, इनमें से किसी भी कैटगरी में आता है, तो उसे ऐप्लिकेशन के इस्तेमाल के मानकों से छूट मिलती है . साथ ही, वह हाइबरनेशन मोड में नहीं जाएगा.

लॉन्चर पर नहीं दिखने वाले ऐप्लिकेशन

ऐसा कोई भी ऐप्लिकेशन जिसका लॉन्चर पर कोई ऐक्टिव शॉर्टकट टाइल नहीं है.

वर्क प्रोफ़ाइल वाले ऐप्लिकेशन

ऐसा कोई भी ऐप्लिकेशन जिसे उपयोगकर्ता, वर्क प्रोफ़ाइल पर इंस्टॉल करता है. ध्यान दें कि अगर वही ऐप्लिकेशन, निजी प्रोफ़ाइल पर भी मौजूद है, तो सिर्फ़ वर्क प्रोफ़ाइल वाले ऐप्लिकेशन को छूट मिलती है.

डिवाइस नीति नियंत्रक

ऐसे ऐप्लिकेशन जो डिवाइसों पर, स्थानीय डिवाइस की नीतियों और सिस्टम ऐप्लिकेशन को कंट्रोल करते हैं.

मोबाइल और इंटरनेट सेवा देने वाली कंपनी के खास ऐप्लिकेशन

ऐसा कोई भी ऐप्लिकेशन जिसे मोबाइल और इंटरनेट सेवा देने वाली कंपनियां, डिवाइसों पर पहले से लोड करती हैं और जिसे वे कॉन्ट्रैक्ट के तहत सेवा देने की ज़रूरी शर्तों के लिए ज़रूरी मानती हैं. उदाहरण के लिए, वॉइसमेल या ग्राहक सेवा वाले ऐप्लिकेशन.

तीसरे पक्ष के इंस्टॉलर ऐप्लिकेशन

तीसरे पक्ष के ऐप्लिकेशन स्टोर, इंस्टॉल किए गए ऐप्लिकेशन को ज़रूरत पड़ने पर अपने-आप अपडेट करते हैं.

उपयोगकर्ता की ओर से हाइबरनेशन मोड से छूट

अगर आपको लगता है कि आपके ऐप्लिकेशन के मुख्य इस्तेमाल के मामले पर हाइबरनेशन मोड का असर पड़ता है, तो उपयोगकर्ता से ऐप्लिकेशन के हाइबरनेशन मोड से छूट का अनुरोध किया जा सकता है. यह छूट उन स्थितियों के लिए काम की है जिनमें उपयोगकर्ता को उम्मीद होती है कि आपका ऐप्लिकेशन मुख्य तौर पर बैकग्राउंड में काम करेगा. भले ही, उपयोगकर्ता आपके ऐप्लिकेशन से इंटरैक्ट न करे. जैसे, जब आपका ऐप्लिकेशन इनमें से कोई काम करता है:

• परिवार के सदस्यों की जगह की जानकारी समय-समय पर रिपोर्ट करके, परिवार की सुरक्षा की सुविधा देना.
• किसी डिवाइस और आपके ऐप्लिकेशन के सर्वर के बीच डेटा सिंक करना.
• स्मार्ट डिवाइसों से कम्यूनिकेट करना, जैसे कि टीवी.
• साथ में इस्तेमाल किए जाने वाले डिवाइसों से पेयर करना, जैसे कि स्मार्टवॉच.

छूट का अनुरोध करने के लिए, यहां दिए गए सेक्शन में बताया गया तरीका अपनाएं.

यह देखना कि उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा पहले से बंद की है या नहीं

यह देखने के लिए कि उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा पहले से बंद की है या नहीं, getUnusedAppRestrictionsStatus() एपीआई का इस्तेमाल करें.

अपने ऐप्लिकेशन में इस एपीआई का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, इस पेज पर एपीआई कोड का उदाहरण देखें.

उपयोगकर्ता से अपने ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा बंद करने के लिए कहना

अगर उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा पहले से बंद नहीं की है, तो उपयोगकर्ता को अनुरोध भेजा जा सकता है. इसके लिए, यह तरीका अपनाएं:

1. ऐसा यूज़र इंटरफ़ेस (यूआई) दिखाएं जिसमें उपयोगकर्ता को यह बताया जाए कि उसे आपके ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा क्यों बंद करनी चाहिए.

2. createManageUnusedAppRestrictionsIntent() एपीआई शुरू करें. जैसा कि एपीआई कोड के उदाहरण में दिखाया गया है. यह एपीआई, एक इंटेंट बनाता है, जो सेटिंग में ऐप्लिकेशन की जानकारी स्क्रीन लोड करता है. यहां से, उपयोगकर्ता आपके ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा बंद कर सकता है.

   यह ज़रूरी है कि इस इंटेंट को भेजते समय, startActivity() के बजाय startActivityForResult() को कॉल किया जाए.

   टेबल 2 में दिखाया गया है कि विकल्प की जगह और नाम, उस डिवाइस की खासियतें पर निर्भर करता है जिस पर आपका ऐप्लिकेशन इंस्टॉल है:

   टेबल 2. वह विकल्प जिससे आपके ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा बंद की जा सकती है

   डिवाइस की खासियतें	वह पेज जहां विकल्प दिखता है	बंद करने के लिए विकल्प का नाम
   Android 13 या इसके बाद के वर्शन पर चलता है	ऐप्लिकेशन की जानकारी	इस्तेमाल न होने पर, ऐप की गतिविधि रोकें
   Android 12 पर चलता है	ऐप्लिकेशन की जानकारी	अनुमतियां हटाएं और स्टोरेज खाली करें
   Android 11 पर चलता है	ऐप्लिकेशन की जानकारी > अनुमतियां	अगर ऐप्लिकेशन इस्तेमाल नहीं किया गया है, तो अनुमतियां हटाएं
   Android 6.0 से लेकर Android 10 तक के वर्शन पर चलता है और Google Play services की मदद से काम करता है	Play ऐप्लिकेशन > मेन्यू > Play Protect > इस्तेमाल न किए जाने वाले ऐप्लिकेशन की अनुमतियां	अगर ऐप्लिकेशन इस्तेमाल नहीं किया गया है, तो अनुमतियां हटाएं

एपीआई कोड का उदाहरण

इस कोड के उदाहरण में, यह देखने का तरीका बताया गया है कि आपके ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा चालू है या नहीं. साथ ही, उपयोगकर्ताओं से अपने ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा बंद करने के लिए कहने का सही तरीका भी बताया गया है.

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

लेगसी प्लैटफ़ॉर्म एपीआई

ऑपरेटिंग सिस्टम में, हाइबरनेशन मोड की सुविधा से इंटरैक्ट करने के लिए एक एपीआई भी शामिल है. हालांकि, यह एपीआई सिर्फ़ Android 11 या इसके बाद के वर्शन पर चलने वाले डिवाइसों पर काम करता है. यह एपीआई, Android के पुराने वर्शन में बैकपोर्ट की गई हाइबरनेशन मोड की सुविधाओं को हैंडल नहीं करता. इसलिए, हमारा सुझाव है कि इस एपीआई का इस्तेमाल न करें.

अगर आपको कंपैटबिलटी के लिए, अस्थायी तौर पर इस एपीआई का इस्तेमाल जारी रखना है, तो यहां दिए गए तरीके से इसका इस्तेमाल करें:

• यह देखने के लिए कि आपके ऐप्लिकेशन के लिए, हाइबरनेशन मोड की सुविधा बंद है या नहीं: isAutoRevokeWhitelisted()
• उपयोगकर्ता को हाइबरनेशन मोड की सेटिंग वाले पेज पर भेजने के लिए: 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. सिस्टम के इंतज़ार करने का समय कम करें. यहां दिए गए उदाहरण में, सिस्टम में बदलाव किया गया है, ताकि ऐप्लिकेशन से इंटरैक्ट करना बंद करने के सिर्फ़ एक सेकंड बाद, आपका ऐप्लिकेशन हाइबरनेशन मोड में चला जाए:

   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