कस्टम WorkManager कॉन्फ़िगरेशन और प्रोसेस शुरू करना

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

मांग पर इनिशियलाइज़ेशन

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

डिफ़ॉल्ट इनिशलाइज़र को हटाना

अपना कॉन्फ़िगरेशन देने के लिए, आपको पहले डिफ़ॉल्ट इनिशलाइज़र को हटाना होगा. ऐसा करने के लिए, मर्ज करने के नियम tools:node="remove" का इस्तेमाल करके, AndroidManifest.xml को अपडेट करें.

WorkManager 2.6 के बाद से, WorkManager में ऐप्लिकेशन स्टार्टअप का इस्तेमाल किया जाता है. कस्टम इनिशलाइज़र उपलब्ध कराने के लिए, आपको androidx.startup नोड को हटाना होगा.

अगर आपके ऐप्लिकेशन में ऐप्लिकेशन स्टार्टअप का इस्तेमाल नहीं किया जाता है, तो इसे पूरी तरह से हटाया जा सकता है.

 <!-- If you want to disable android.startup completely. -->
 <provider
    android:name="androidx.startup.InitializationProvider"
    android:authorities="${applicationId}.androidx-startup"
    tools:node="remove">
 </provider>

अगर ऐसा नहीं है, तो सिर्फ़ WorkManagerInitializer नोड को हटाएं.

 <provider
    android:name="androidx.startup.InitializationProvider"
    android:authorities="${applicationId}.androidx-startup"
    android:exported="false"
    tools:node="merge">
    <!-- If you are using androidx.startup to initialize other components -->
    <meta-data
        android:name="androidx.work.WorkManagerInitializer"
        android:value="androidx.startup"
        tools:node="remove" />
 </provider>

WorkManager के 2.6 से पुराने वर्शन का इस्तेमाल करते समय, workmanager-init को हटाएं:

<provider
    android:name="androidx.work.impl.WorkManagerInitializer"
    android:authorities="${applicationId}.workmanager-init"
    tools:node="remove" />

अपने मेनिफ़ेस्ट में मर्ज करने के नियमों का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, एक से ज़्यादा मेनिफ़ेस्ट फ़ाइलों को मर्ज करने से जुड़ा दस्तावेज़ देखें.

Configuration.Provider को लागू करना

अपनी Application क्लास से Configuration.Provider इंटरफ़ेस लागू करें. साथ ही, Configuration.Provider.getWorkManagerConfiguration को लागू करने का अपना तरीका उपलब्ध कराएं. जब आपको WorkManager का इस्तेमाल करना हो, तो WorkManager.getInstance(Context) तरीके को कॉल करना न भूलें. WorkManager, आपके ऐप्लिकेशन के कस्टम getWorkManagerConfiguration तरीके को कॉल करता है, ताकि उसके Configuration का पता लगाया जा सके. आपको WorkManager.initialize पर खुद कॉल करने की ज़रूरत नहीं है.

यहां कस्टम getWorkManagerConfiguration() को लागू करने का एक उदाहरण दिया गया है:

Kotlin

class MyApplication() : Application(), Configuration.Provider {
     override fun getWorkManagerConfiguration() =
           Configuration.Builder()
                .setMinimumLoggingLevel(android.util.Log.INFO)
                .build()
}

Java

class MyApplication extends Application implements Configuration.Provider {
    @Override
    public Configuration getWorkManagerConfiguration() {
        return new Configuration.Builder()
                .setMinimumLoggingLevel(android.util.Log.INFO)
                .build();
    }
}

WorkManager 2.1.0 से पहले, कस्टम तरीके से शुरू करना

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

डिफ़ॉल्ट तौर पर शुरू करना

WorkManager, कस्टम ContentProvider का इस्तेमाल करके खुद को शुरू करता है. ऐसा तब होता है, जब आपका ऐप्लिकेशन शुरू होता है. यह कोड, इंटरनल क्लास androidx.work.impl.WorkManagerInitializer में मौजूद होता है और डिफ़ॉल्ट Configuration का इस्तेमाल करता है. डिफ़ॉल्ट इनिशलाइज़र का इस्तेमाल अपने-आप होता है. हालांकि, ऐसा तब नहीं होता, जब आपने इसे बंद किया हो. डिफ़ॉल्ट इनिशलाइज़र, ज़्यादातर ऐप्लिकेशन के लिए सही होता है.

पसंद के मुताबिक शुरू करना

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

डिफ़ॉल्ट इनिशलाइज़र को हटाने के बाद, WorkManager को मैन्युअल तरीके से शुरू किया जा सकता है:

Kotlin

// provide custom configuration
val myConfig = Configuration.Builder()
    .setMinimumLoggingLevel(android.util.Log.INFO)
    .build()

// initialize WorkManager
WorkManager.initialize(this, myConfig)

Java

// provide custom configuration
Configuration myConfig = new Configuration.Builder()
    .setMinimumLoggingLevel(android.util.Log.INFO)
    .build();

//initialize WorkManager
WorkManager.initialize(this, myConfig);

पक्का करें कि WorkManager सिंगलटन को शुरू करने की प्रोसेस, Application.onCreate() या ContentProvider.onCreate() में से किसी एक में चल रही हो.

उपलब्ध कस्टमाइज़ेशन की पूरी सूची देखने के लिए, Configuration.Builder() रेफ़रंस दस्तावेज़ देखें.