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

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

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

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

टेबल 1. आपके ऐप्लिकेशन पर हाइबरनेशन के असर
टारगेट SDK टूल का वर्शन डिवाइस की विशेषताएं हाइबरनेशन इफ़ेक्ट
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 और उसके बाद वाले वर्शन पर, ये सुविधाएं भी मिलती हैं इन्हें यूज़र इंटरैक्शन माना जाता है:

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

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

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

गैर-उदाहरण

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

सिस्टम को हाइबरनेट मोड में जाने से रोकने के लिए छूट

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मैन्युअल रूप से हाइबरनेशन व्यवहार शुरू करें

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

  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