הגדרה ואתחול של WorkManager בהתאמה אישית

כברירת מחדל, 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().