يضبط 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().