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

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

हाइबरनेशन के असर

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

टेबल 1. हाइबरनेशन मोड में जाने पर आपके ऐप्लिकेशन पर क्या असर पड़ता है

टारगेट एसडीके वर्शन	डिवाइस की विशेषताएं	हाइबरनेशन मोड के असर
Android 12 या इसके बाद का वर्शन	Android 12 या इसके बाद के वर्शन पर काम करता हो	आपके ऐप्लिकेशन के लिए, रनटाइम की अनुमतियां रीसेट कर दी जाती हैं. इस कार्रवाई का असर वैसा ही होता है जैसा कि उपयोगकर्ता ने सिस्टम सेटिंग में जाकर, अनुमति देखी हो और आपके ऐप्लिकेशन के ऐक्सेस लेवल को अस्वीकार करें पर सेट कर दिया हो. आपका ऐप्लिकेशन, बैकग्राउंड में जॉब या सूचनाएं नहीं चला सकता. आपके ऐप्लिकेशन को पुश नोटिफ़िकेशन नहीं मिल सकते. इनमें, Firebase क्लाउड से मैसेज की मदद से भेजे गए ज़रूरी मैसेज भी शामिल हैं. ऐप्लिकेशन की कैश मेमोरी में मौजूद सभी फ़ाइलें हटा दी जाती हैं.
Android 11	Android 11 पर काम करता हो	आपके ऐप्लिकेशन के लिए, रनटाइम की अनुमतियां रीसेट कर दी जाती हैं.
Android 11	Android 6.0 (एपीआई लेवल 23) से लेकर Android 10 (एपीआई लेवल 29) तक के वर्शन पर काम करता हो. साथ ही, इसमें Google Play services मौजूद हो	आपके ऐप्लिकेशन के लिए, रनटाइम की अनुमतियां रीसेट कर दी जाती हैं. यह बदलाव दिसंबर 2021 से लागू होगा. इस ब्लॉग पोस्ट में, अनुमतियां अपने-आप रीसेट होने की सुविधा को अरबों डिवाइसों पर उपलब्ध कराने के बारे में ज़्यादा जानें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  ध्यान दें: अगर उपयोगकर्ता सूचना को खारिज कर देता है और सूचना के साथ किसी भी तरह से इंटरैक्ट नहीं करता है, तो इसे ऐप्लिकेशन के इस्तेमाल के तौर पर नहीं गिना जाता है.

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

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

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

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

ऐसे उदाहरण जो इस कैटगरी में नहीं आते

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

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

सिस्टम को हाइबरनेशन मोड में जाने से रोकने की सुविधा

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

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

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

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

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

डिवाइस से जुड़ी नीति नियंत्रक

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

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

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

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

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

हाइबरनेशन मोड से जुड़ी छूट

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

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

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

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

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

यह देखने के लिए कि उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए, हाइबरनेशन की सुविधा को पहले ही बंद कर दिया है या नहीं, 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 > इस्तेमाल न किए गए ऐप्लिकेशन के लिए अनुमतियां	ऐप्लिकेशन इस्तेमाल न होने पर अनुमतियां हटाएं

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

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

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

Kotlin

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 का इस्तेमाल करके इंटेंट बनाएं

हाइबरनेशन मोड को मैन्युअल तरीके से चालू करना

ध्यान दें: अगर आपको Android 11 पर चलने वाले डिवाइस पर अपने ऐप्लिकेशन की जांच करनी है, तो इस सेक्शन में दिए गए कई चरणों को छोड़ा जा सकता है. इन चरणों पर "सिर्फ़ Android 12 और इसके बाद के वर्शन के लिए" लेबल लगा होता है.

सिस्टम आपके ऐप्लिकेशन को हाइबरनेशन मोड में डाल देता है. इसके बाद, ऐप्लिकेशन कैसे काम करता है, यह देखने के लिए यह तरीका अपनाएं:

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