एंड्रॉइड एसडीके: बैटरी मैनेजर को नियंत्रित करना

एंड्रॉइड पृष्ठभूमि सेवाओं को आक्रामक तरीके से ख़त्म करने के लिए कुख्यात है। चीनी ओईएम (जैसे Xiaomi, Huawei) के पास कस्टम पावर मैनेजर भी हैं जो मानक एंड्रॉइड पृष्ठभूमि निष्पादन सीमाओं को पूरी तरह से तोड़ देते हैं।

यह पृष्ठ बताता है कि क्यों एंड्रॉइड आपके ऐप को बंद कर देता है और कैसे ट्रैसलेट की विशिष्ट एंड्रॉइड कॉन्फ़िगरेशन वास्तविक दुनिया में इसे हल करती है।

वैकल्पिक निर्भरता: उच्च सटीकता वाला जीएमएस स्थान

ट्रैसलेट का एंड्रॉइड एसडीके Google Play Services Location - FusedLocationProviderClient का उपयोग कर सकता है (बेहतर सटीकता और बैटरी), हार्डवेयर गतिविधि पहचान (चलना/ड्राइविंग/स्थिर), और हार्डवेयर जियोफेंसिंग। एसडीके को हल्का और Google-रहित उपकरणों पर उपयोग योग्य बनाए रखने के लिए, यह निर्भरता बंडल नहीं है। आप इसे केवल तभी जोड़ें यदि आप उच्च-सटीकता पथ चाहते हैं:

// android/app/build.gradle.kts
dependencies {
    implementation("com.google.android.gms:play-services-location:21.3.0")
}

वैकल्पिक निर्भरता: प्ले इंटीग्रिटी (डिवाइस सत्यापन)

यदि आप ट्रैसलेट की डिवाइस सत्यापन सुविधा (AttestationConfig) का उपयोग करते हैं, तो Android साइड Google Play इंटीग्रिटी के माध्यम से अपना क्रिप्टोग्राफ़िक टोकन उत्पन्न करता है। ठीक वैसा play-services-location, यह निर्भरता बंडल नहीं है - आप इसे तभी जोड़ते हैं जब आप सत्यापन सक्षम करें:

// android/app/build.gradle.kts
dependencies {
    implementation("com.google.android.play:integrity:1.6.0")
}

अनुमतियाँ एवं प्रकट सेटअप

जब आप अपना ऐप संकलित करते हैं तो ट्रैसलेट स्वचालित रूप से आपके AndroidManifest.xml में आवश्यक अनुमतियाँ इंजेक्ट कर देता है। डिफ़ॉल्ट रूप से, यह अनुरोध करता है:

• ACCESS_COARSE_LOCATION और ACCESS_FINE_LOCATION (ट्रैकिंग के लिए आवश्यक)
• ACCESS_BACKGROUND_LOCATION (ऐप बंद होने पर ट्रैकिंग के लिए आवश्यक)
• FOREGROUND_SERVICE और FOREGROUND_SERVICE_LOCATION (निरंतर पृष्ठभूमि निष्पादन के लिए आवश्यक)
• ACTIVITY_RECOGNITION (स्मार्ट मोशन-डिटेक्शन इंजन के लिए आवश्यक)
• POST_NOTIFICATIONS (Android 13+ फ़ोरग्राउंड सेवा UI के लिए आवश्यक)
• SCHEDULE_EXACT_ALARM (सटीक आवधिक मोड ट्रैकिंग के लिए आवश्यक)

अप्रयुक्त अनुमतियाँ हटाना (प्रकट विलय)

यदि आपके ऐप को किसी विशिष्ट सुविधा की आवश्यकता नहीं है (उदाहरण के लिए, आपके क्लाइंट को गति पहचान की आवश्यकता नहीं है, या आप आवधिक मोड का उपयोग नहीं करते हैं), तो आप अपने ऐप-स्तर AndroidManifest.xml (android/app/src/main/AndroidManifest.xml) में एंड्रॉइड के मेनिफेस्ट विलय tools:node="remove" निर्देश का उपयोग करके अनुमति को बलपूर्वक हटा सकते हैं।

ट्रैसलेट का मूल कोड checkSelfPermission() से पूरी तरह सुरक्षित है। अनुपलब्ध अनुमतियाँ शानदार फ़ॉलबैक को ट्रिगर करेंगी, क्रैश नहीं।

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:tools="http://schemas.android.com/tools">
 
    <!-- Geofence-only / periodic-only app: no continuous foreground tracking -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" tools:node="remove" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" tools:node="remove" />
 
</manifest>

उदाहरण: मोशन और पृष्ठभूमि अनुमतियाँ हटाना

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:tools="http://schemas.android.com/tools">
 
    <!-- Client doesn't want Activity/Motion tracking -->
    <uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" tools:node="remove" />
    
    <!-- Client only wants foreground tracking -->
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" tools:node="remove" />
 
    <!-- Remove Exact Alarms -->
    <uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" tools:node="remove" />
    
</manifest>

स्वचालित प्रोगार्ड/आर8 नियम

ट्रैसलेट बैकग्राउंड कोटलिन सेवाओं, रस्ट कोर के लिए जेएनए बाइंडिंग और रिफ्लेक्टिव पिजन चैनलों का भारी उपयोग करता है। यदि ये अस्पष्ट हैं या गलत तरीके से सिकुड़े हुए हैं, तो जब आपका ऐप रिलीज़ के लिए संकलित किया जाएगा तो पृष्ठभूमि ट्रैकिंग चुपचाप विफल हो जाएगी।

आपको ट्रैसलेट के लिए प्रोगार्ड को मैन्युअल रूप से कॉन्फ़िगर करने की आवश्यकता नहीं है।

tracelet_android प्लगइन स्वचालित रूप से एम्बेडेड consumer-rules.pro के साथ शिप होता है। जब आप अपने फ़्लटर ऐप को रिलीज़ मोड में बनाते हैं, तो एंड्रॉइड का R8 श्रिंकर स्वचालित रूप से इन नियमों को निकालता है और यह सुनिश्चित करता है कि सभी आवश्यक कक्षाएं (जैसे HeadlessTaskService, BootReceiver, और रस्ट uniffi बाइंडिंग) सिकुड़ती रहें।

परिदृश्य 1: डिलीवरी ड्राइवर (निरंतर ट्रैकिंग)

अवधारणाओं की खोज: डोज़ मोड, फ़ोरग्राउंड सेवाएँ, वेकलॉक

समस्या

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

ट्रैसलेट इसे कैसे हल करता है: फ़ोरग्राउंड सेवा

एक फ़ोरग्राउंड सेवा एंड्रॉइड को बताती है: “अरे, मैं अभी कुछ अविश्वसनीय रूप से महत्वपूर्ण काम कर रहा हूं, और उपयोगकर्ता इसके बारे में पूरी तरह से अवगत है। मुझे मत मारो।”

android: tl.AndroidConfig(
  foregroundService: tl.ForegroundServiceConfig(
    enabled: true,
    channelName: 'Delivery Tracking',
    notificationText: 'Tracking your route to the customer',
    notificationOngoing: true, // User cannot swipe it away
    showNotificationOnPauseOnly: false, // Auto-hides when app is open
    actions: ['Pause', 'Complete'], // Adds interactive buttons to the notification
  ),
)

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

अधिसूचना उपस्थिति को अनुकूलित करना

लगातार अधिसूचना को अपने ऐप की ब्रांडिंग से मेल खाने के लिए, आप आइकन और रंगों को कस्टमाइज़ कर सकते हैं:

android: tl.AndroidConfig(
  foregroundService: tl.ForegroundServiceConfig(
    enabled: true,
    notificationTitle: 'Delivery Mode',
    notificationText: 'Tracking your route...',
    notificationColor: '#0F9D58', // Your brand hex color
    notificationSmallIcon: 'ic_tracelet_icon', // The icon name
    notificationLargeIcon: 'ic_large_logo',
  ),
)

महत्वपूर्ण चिह्न नियम:

1. फ़ाइल स्थान: छवि फ़ाइल को आपके एंड्रॉइड प्रोजेक्ट के ड्रॉएबल फ़ोल्डर (android/app/src/main/res/drawable/ic_tracelet_icon.png) में रखा जाना चाहिए।
2. छोटे आइकन की बाधाएं: एंड्रॉइड के लिए आवश्यक है कि notificationSmallIcon पूरी तरह से सपाट, पारदर्शी और केवल सफेद हो। यदि आप रंगीन लोगो का उपयोग करते हैं, तो एंड्रॉइड इसे केवल एक ठोस ग्रे या सफेद वर्ग के रूप में प्रस्तुत करेगा।
3. रंग संपत्ति: notificationColor संपत्ति आपके ब्रांड से मेल खाने के लिए आपके छोटे आइकन की पृष्ठभूमि को रंग देगी।

ट्रैकिंग करते समय अधिसूचना को ताज़ा करना (updateNotification())

ट्रैकिंग शुरू होने के बाद में अधिसूचना बदलने की आवश्यकता है - उदाहरण के लिए। शीर्षक को “रास्ते में” से “आ रहा हूँ” में अपडेट करें, टेक्स्ट को स्वैप करें, या यात्रा के बीच में एक्शन बटन बदलें? एक नए ForegroundServiceConfig के साथ setConfig() को कॉल करने से मान बने रहते हैं, लेकिन केवल अधिसूचना परिवर्तन उस अधिसूचना को नहीं करता है जो एंड्रॉइड पहले से ही दिखा रहा है - नई सामग्री केवल एक असंबंधित सेवा पुनरारंभ या अग्रभूमि संक्रमण के बाद ही दिखाई देगी।

चूँकि v3.6.8, Tracelet.updateNotification() लाइव अधिसूचना को उसी स्थान पर ताज़ा करता है, ट्रैकिंग पाइपलाइन को पुनरारंभ किए बिना:

// 1. Apply the new notification content.
await Tracelet.setConfig(
  const tl.Config(
    android: tl.AndroidConfig(
      foregroundService: tl.ForegroundServiceConfig(
        notificationTitle: 'Arriving',
        notificationText: 'Your driver is 2 minutes away',
      ),
    ),
  ),
);
 
// 2. Repost the active notification with the new content.
await Tracelet.updateNotification();

परिदृश्य 2: मौसम ऐप (आवधिक ट्रैकिंग)

अवधारणाओं की खोज: कार्य प्रबंधक बनाम सटीक अलार्म

समस्या

आपके उपयोगकर्ता ने आपका स्थानीय मौसम ऐप डाउनलोड किया है। आप हर 4 घंटे में एक बार पृष्ठभूमि में जागना चाहते हैं, उनका स्थान प्राप्त करना चाहते हैं, और स्थानीय पूर्वानुमान डाउनलोड करना चाहते हैं।

आप स्थायी फ़ोरग्राउंड सेवा अधिसूचना नहीं चाहते हैं। उपयोगकर्ता को अपने दराज में स्थायी “मौसम ट्रैकिंग” अधिसूचना देखना पसंद नहीं आएगा।

ट्रेसलेट इसे कैसे हल करता है: आवधिक मोड

निरंतर सेवा के बजाय, ट्रैसलेट थोड़े समय के लिए जागने, ठीक होने और फिर से सो जाने के लिए एंड्रॉइड के जॉब शेड्यूलर का उपयोग कर सकता है।

android: tl.AndroidConfig(
  periodicUseForegroundService: false, 
  periodicUseExactAlarms: true, // Uses AlarmManager instead of WorkManager
)

दो अनुसूचक

1. कार्यप्रबंधक (देर से अनुवाद नहीं) डिफ़ॉल्ट। यह बहुत बैटरी फ्रेंडली है. हालाँकि, एंड्रॉइड यह तय करता है कि उसे कब चलाना है। यदि आप इसे हर 15 मिनट में चलाने के लिए कहते हैं, तो एंड्रॉइड 45 मिनट तक प्रतीक्षा कर सकता है और जब उपयोगकर्ता इंस्टाग्राम (जिसे “बैचिंग” कहा जाता है) की जांच करने के लिए अपने फोन को अनलॉक करता है, तब इसे चलाया जा सकता है। यह अत्यधिक अचूक है.

2. अलार्म मैनेजर (ट्रांस0 लेट) यदि आपको किसी विशिष्ट समय पर डिवाइस को जगाना ही है, तो इसका उपयोग करें। इसके लिए आपको अपने android/app/src/main/AndroidManifest.xml में SCHEDULE_EXACT_ALARM अनुमति की घोषणा करनी होगी:

   <uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" />

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

परिदृश्य 3: ओईएम आक्रामकता

अवधारणाओं की खोज: सेटिंग्स स्वास्थ्य एपीआई

समस्या

आपने सब कुछ ठीक किया. आपके पास एक फ़ोरग्राउंड सेवा है. लेकिन यूजर के पास Xiaomi फोन है। MIUI में एक मालिकाना “बैटरी सेवर” है जो 5 मिनट के स्क्रीन-ऑफ समय के बाद फ़ोरग्राउंड सेवाओं को भी बंद कर देता है।

ट्रैसलेट इसे कैसे हल करता है: ऑटो-शमन और संकेत

जहां संभव हो वहां ट्रैसलेट स्वचालित रूप से आंतरिक शमन लागू करता है, लेकिन कभी-कभी उपयोगकर्ता को भौतिक रूप से OEM के मालिकाना सेटिंग्स मेनू में आपके ऐप को श्वेतसूची में डालना पड़ता है।

final health = await tl.Tracelet.getSettingsHealth();
if (health['isAggressiveOem'] == true) {
  // Automatically opens the manufacturer-specific settings screen 
  // (e.g. Xiaomi Autostart, Huawei App Launch, Samsung Sleeping Apps)
  await tl.Tracelet.showPowerManager();
}

अपने फ़्लटर यूआई में इसे कैसे कार्यान्वित करें इसके विस्तृत उदाहरण के लिए, डायग्नोस्टिक टूल्स एंड पावर मैनेजमेंट पृष्ठ देखें।