כברירת מחדל, WorkManager מגדיר את עצמו באופן אוטומטי כשהאפליקציה מופעלת, באמצעות אפשרויות סבירות שמתאימות לרוב האפליקציות. אם אתם צריכים יותר שליטה על האופן שבו WorkManager מנהל ומתזמן את העבודה, אתם יכולים להתאים אישית את ההגדרות של WorkManager על ידי הפעלה שלו בעצמכם.
אתחול על פי דרישה
הפעלה על פי דרישה מאפשרת ליצור את WorkManager רק כשצריך את הרכיב הזה, במקום בכל פעם שהאפליקציה מופעלת. כך WorkManager לא יפריע לתהליך ההפעלה הקריטי, וביצועי ההפעלה של האפליקציה ישתפרו. כדי להשתמש בהפעלה על פי דרישה:
הסרת המאתחל שמוגדר כברירת מחדל
כדי לספק הגדרות משלכם, קודם צריך להסיר את מאתחל ברירת המחדל. כדי לעשות את זה, מעדכנים את AndroidManifest.xml באמצעות כלל המיזוג tools:node="remove".
החל מגרסה 2.6 של WorkManager, נעשה שימוש ב-App Startup באופן פנימי בתוך 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, חשוב להפעיל את ה-method WorkManager.getInstance(Context). WorkManager קורא ל-method המותאם אישית 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 שמוגדר כברירת מחדל. המערכת משתמשת באופן אוטומטי במאתחל שמוגדר כברירת מחדל, אלא אם משביתים אותו באופן מפורש. מאתחל ברירת המחדל מתאים לרוב האפליקציות.
אתחול בהתאמה אישית
אם אתם רוצים לשלוט בתהליך האתחול, אתם צריכים להשבית את ברירת המחדל של המאתחל, ואז להגדיר תצורה מותאמת אישית משלכם.
אחרי שמסירים את מפעיל ברירת המחדל, אפשר להפעיל את 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 singleton פועלת ב-Application.onCreate() או ב-ContentProvider.onCreate().
לרשימה המלאה של ההתאמות האישיות הזמינות, עיינו במאמרי העזרה של Configuration.Builder().