إعداد وتهيئة WorkManager

يضبط WorkManager نفسه تلقائيًا عند بدء تشغيل تطبيقك، باستخدام خيارات معقولة مناسبة لمعظم التطبيقات. إذا كنت بحاجة إلى مزيد من التحكّم في كيفية إدارة WorkManager للعمل وجدولته، يمكنك تخصيص إعدادات WorkManager من خلال إعداده بنفسك.

الإعداد عند الطلب

تتيح لك عملية الإعداد عند الطلب إنشاء WorkManager فقط عند الحاجة إلى هذا المكوّن، بدلاً من إنشائه في كل مرة يتم فيها تشغيل التطبيق. يؤدي ذلك إلى نقل WorkManager من مسار بدء التشغيل المهم، مما يحسّن أداء بدء تشغيل التطبيق. لاستخدام الإعداد الأولي عند الطلب:

إزالة أداة الإعداد التلقائية

لتقديم الإعدادات الخاصة بك، يجب أولاً إزالة الإعدادات التلقائية لأداة الإعداد. لإجراء ذلك، عليك تعديل AndroidManifest.xml باستخدام قاعدة الدمج tools:node="remove".

منذ الإصدار 2.6 من WorkManager، يتم استخدام بدء تشغيل التطبيق داخليًا ضمن WorkManager. لتوفير دالة تهيئة مخصّصة، عليك إزالة العقدة androidx.startup.

إذا كنت لا تستخدم مكتبة App 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();
    }
}

الإعداد المخصّص قبل الإصدار 2.1.0 من WorkManager

بالنسبة إلى إصدارات WorkManager السابقة للإصدار 2.1.0، يتوفّر خياران للإعداد. في معظم الحالات، يكفي استخدام الإعداد التلقائي. وللتحكّم بشكل أكثر دقة في WorkManager، يمكنك تحديد الإعدادات الخاصة بك.

التهيئة التلقائية

يستخدم WorkManager واجهة ContentProvider مخصّصة لتهيئة نفسه عند بدء تشغيل تطبيقك. يتوفّر هذا الرمز في الفئة الداخلية androidx.work.impl.WorkManagerInitializer ويستخدم الإعداد التلقائي Configuration. يتم استخدام أداة الإعداد التلقائية تلقائيًا ما لم توقفها صراحةً. يُعدّ المُهيئ التلقائي مناسبًا لمعظم التطبيقات.

الإعداد المخصّص

إذا أردت التحكّم في عملية الإعداد، عليك إيقاف أداة الإعداد التلقائية، ثم تحديد الإعدادات المخصّصة.

بعد إزالة أداة الإعداد التلقائية، يمكنك إعداد 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().