WorkManager

WorkManager API ช่วยให้กำหนดเวลางานแบบอะซิงโครนัสที่เลื่อนได้ ซึ่งต้องเรียกใช้ได้อย่างน่าเชื่อถือได้ง่าย API เหล่านี้ช่วยให้คุณสร้างงานและส่งต่อให้ WorkManager เรียกใช้เมื่อตรงตามข้อจำกัดของงาน
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
30 กรกฎาคม 2025 2.10.3 - - -

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มการอ้างอิงใน WorkManager คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์

เพิ่มการอ้างอิงสำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูลของคุณ

ดึงดูด

dependencies {
    def work_version = "2.10.3"

    // (Java only)
    implementation "androidx.work:work-runtime:$work_version"

    // Kotlin + coroutines
    implementation "androidx.work:work-runtime-ktx:$work_version"

    // optional - RxJava2 support
    implementation "androidx.work:work-rxjava2:$work_version"

    // optional - GCMNetworkManager support
    implementation "androidx.work:work-gcm:$work_version"

    // optional - Test helpers
    androidTestImplementation "androidx.work:work-testing:$work_version"

    // optional - Multiprocess support
    implementation "androidx.work:work-multiprocess:$work_version"
}

Kotlin

dependencies {
    val work_version = "2.10.3"

    // (Java only)
    implementation("androidx.work:work-runtime:$work_version")

    // Kotlin + coroutines
    implementation("androidx.work:work-runtime-ktx:$work_version")

    // optional - RxJava2 support
    implementation("androidx.work:work-rxjava2:$work_version")

    // optional - GCMNetworkManager support
    implementation("androidx.work:work-gcm:$work_version")

    // optional - Test helpers
    androidTestImplementation("androidx.work:work-testing:$work_version")

    // optional - Multiprocess support
    implementation("androidx.work:work-multiprocess:$work_version")
}

ดูข้อมูลเกี่ยวกับการใช้ส่วนขยาย Kotlin ได้ที่เอกสารประกอบเกี่ยวกับ KTX

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพาบิลด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยเราปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากพบปัญหาใหม่หรือมี ไอเดียในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ ในไลบรารีนี้ก่อนสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดย คลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของเครื่องมือติดตามปัญหา

เวอร์ชัน 2.10

เวอร์ชัน 2.10.3

30 กรกฎาคม 2025

androidx.work:work-*:2.10.3 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.3 มีการคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ผู้ปฏิบัติงานซึ่งมีข้อจำกัดด้านเครือข่ายเหมือนกับผู้ปฏิบัติงานก่อนหน้าจะรายงานว่าข้อจำกัดของตนไม่เป็นไปตามข้อกำหนด (b/427115602)

เวอร์ชัน 2.10.2

18 มิถุนายน 2025

androidx.work:work-*:2.10.2 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.2 มีการเปลี่ยนแปลงเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาเมื่อคงสถานะ Worker ด้วยคำขอเครือข่ายและความสามารถเริ่มต้น ซึ่งจะทำให้ระบบเพิ่มความสามารถที่นำออกไปแล้วกลับเข้ามาใหม่ ส่งผลให้ Worker ที่มีข้อจำกัดด้านเครือข่ายทำงานผิดปกติ (b/409716532)
  • แก้ไขข้อบกพร่องที่ทำให้ผู้ปฏิบัติงานที่มีข้อจำกัดด้านเครือข่ายไม่สามารถดำเนินการได้ทันทีเนื่องจากไม่เป็นไปตามข้อจำกัด แม้ว่าเครือข่ายและความสามารถจะพร้อมใช้งานก็ตาม (b/423403088)

เวอร์ชัน 2.10.1

23 เมษายน 2025

androidx.work:work-*:2.10.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.1 มีการคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ลดความเป็นไปได้ที่จะเกิดข้อผิดพลาด TooManyRequestsException จากการลงทะเบียน WorkManager ของ NetworkCallback ที่ใช้สำหรับการติดตามข้อจำกัด (b/231499040, b309d5)

เวอร์ชัน 2.10.0

30 ตุลาคม 2024

androidx.work:work-*:2.10.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.0 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.9.1

  • เพิ่มแท็กการติดตามไปยังงานจาก WorkManager ซึ่งทำให้ "adb shell dumpsys jobscheduler" เข้าใจได้ง่ายขึ้นมาก เนื่องจากจะมีชื่อของ Worker ที่กำลังดำเนินการอยู่ นอกจากนี้ เรายังเพิ่มส่วนการติดตามรอบๆ พื้นที่สำคัญของ WorkManager
  • เพิ่ม Configuration.workerCoroutineContext เพื่อควบคุม Dispatcher ที่มีการเรียกใช้ CoroutineWorker
  • นักพัฒนาแอปสามารถระบุ NetworkRequest เป็นข้อจำกัดสำหรับ Worker ผ่านเมธอด Constraints.setRequiredNetworkRequest ได้ ซึ่งจะช่วยให้ควบคุมได้อย่างละเอียดยิ่งขึ้นว่าจะให้ผู้ปฏิบัติงานนี้ทำงานในเครือข่ายใด
  • WorkManager 2.10.0 ได้รับการคอมไพล์ด้วย SDK 35 และมีการเปลี่ยนแปลงต่างๆ เพื่อให้ใช้งานร่วมกับ SDK 35 ได้

เวอร์ชัน 2.10.0-rc01

24 ตุลาคม 2024

androidx.work:work-*:2.10.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.0-rc01 มีการคอมมิตเหล่านี้

เวอร์ชัน 2.10.0-beta01

2 ตุลาคม 2024

androidx.work:work-*:2.10.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.0-beta01 มีการคอมมิตเหล่านี้

เวอร์ชัน 2.10.0-alpha04

18 กันยายน 2024

androidx.work:work-*:2.10.0-alpha04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha04 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มเหตุผลในการหยุด STOP_REASON_FOREGROUND_SERVICE_TIMEOUT เมื่อหยุด Worker ที่ทำงานอยู่เบื้องหน้าเนื่องจากหมดเวลาการดำเนินการตามประเภทของบริการที่ทำงานอยู่เบื้องหน้า (Ibd0af)

เวอร์ชัน 2.10.0-alpha03

4 กันยายน 2024

androidx.work:work-*:2.10.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha03 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มแท็กการติดตามไปยังงานจาก WorkManager ซึ่งทำให้ "adb shell dumpsys jobscheduler" เข้าใจได้ง่ายขึ้นมาก เนื่องจากจะมีชื่อของ Worker ที่กำลังดำเนินการอยู่ นอกจากนี้ เรายังเพิ่มส่วนการติดตามรอบๆ พื้นที่สำคัญของ WorkManager

การเปลี่ยนแปลง API

  • ตอนนี้ WorkManager 2.10.0 ได้รับการคอมไพล์ด้วย SDK 35 แล้ว
  • แก้ไขการหมดเวลาของ Worker ที่ทำงานอยู่เบื้องหน้าประเภท "บริการระยะสั้น" และ "การซิงค์ข้อมูล" ซึ่งทำให้เกิด ANR เมื่อ WorkManager ไม่ได้เรียกใช้ stopSelf() การแก้ไขนี้ใช้ได้เฉพาะกับอุปกรณ์ที่มี API 34 และ 35 ซึ่งมีการเปิดตัวประเภทบริการที่ทำงานอยู่เบื้องหน้า (ca06b2, b/364508145)
  • WorkerParameters API ใหม่ที่ช่วยให้เปลี่ยนกระบวนการระยะไกลที่ Worker ผูกกับเมื่อใช้ WorkerFactory ได้ (Ibdc8a, Ie8a90, I7373f)

แก้ไขข้อบกพร่อง

  • แก้ไขข้อขัดข้องที่เกิดจากWorkManagerการพยายามรีสตาร์ท Worker ที่ทำงานเป็นเวลานาน (เช่น Worker ที่ทำงานอยู่เบื้องหน้า) เมื่อประเภทงานที่ทำงานอยู่เบื้องหน้ามีสิทธิ์ที่ต้องมีใน Android 14 ซึ่งถูกเพิกถอน (b/333957914)
  • นำการระบุสิทธิ์เข้าถึง API ของแพลตฟอร์มใหม่ด้วยตนเองออก เนื่องจากระบบจะดำเนินการนี้โดยอัตโนมัติผ่านการสร้างโมเดล API เมื่อใช้ R8 กับ AGP 7.3 ขึ้นไป (เช่น R8 เวอร์ชัน 3.3) และสำหรับการสร้างทั้งหมดเมื่อใช้ AGP 8.1 ขึ้นไป (เช่น D8 เวอร์ชัน 8.1) เราขอแนะนำให้ลูกค้าที่ไม่ได้ใช้ AGP อัปเดตเป็น D8 เวอร์ชัน 8.1 ขึ้นไป ดูบทความนี้สำหรับรายละเอียดเพิ่มเติม (Ia60e0, b/345472586)

เวอร์ชัน 2.10.0-alpha02

17 เมษายน 2024

androidx.work:work-*:2.10.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha02 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มความสามารถในการปล่อยช่วงการติดตามผ่าน @RestrictTo Tracer ที่กำหนดค่าได้ใน WorkManager (I17d7f, b/260214125)
  • เพิ่ม Configuration.workerCoroutineContext เพื่อควบคุม Dispatcher ที่มีการเรียกใช้ CoroutineWorker ซึ่งช่วยหลีกเลี่ยงการใช้ Dispatchers.Default ใน WorkManager ได้อย่างสมบูรณ์ (Icd1b7)
  • เพิ่มตัวแฮนเดิลข้อยกเว้นที่กำหนดเองสำหรับ Workers (Ib1b74, b/261190695)
  • ตอนนี้คุณสามารถสร้าง OneTimeWorkRequest.Builder และ PeriodicWorkRequest.Builder ด้วย KClass แทน Class ได้แล้ว val request = OneTimeWorkRequest.Builder(Worker::class).setConstraints(...).build() (Ib55f6)
  • ระบบได้ย้ายข้อมูลคลาส WorkManager ไปยัง Kotlin แล้ว ตอนนี้เมธอดที่ส่งคืน LiveData, ListenableFuture หรือ Flow จะให้ข้อมูลการเป็น Null ที่ถูกต้อง ซึ่งอาจต้องมีการเปลี่ยนแปลงในซอร์สโค้ดของไคลเอ็นต์ หากสมมติฐานเกี่ยวกับค่า Null ในโค้ดนั้นไม่ถูกต้อง (If6757)

เวอร์ชัน 2.10.0-alpha01

24 มกราคม 2024

androidx.work:work-*:2.10.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • นักพัฒนาแอปสามารถระบุ NetworkRequest เป็นข้อจำกัดสำหรับ Worker ผ่านเมธอด Constraints.setRequiredNetworkRequest ได้ ซึ่งจะช่วยให้ควบคุมได้อย่างละเอียดยิ่งขึ้นว่าจะให้ผู้ปฏิบัติงานนี้ทำงานในเครือข่ายใด

การเปลี่ยนแปลง API

  • เพิ่มความสามารถในการระบุ NetworkRequest เป็นข้อจำกัด (Id98a1, b/280634452)

เวอร์ชัน 2.9

เวอร์ชัน 2.9.1

7 สิงหาคม 2024

androidx.work:work-*:2.9.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.9.1 มีการคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขข้อขัดข้องที่เกิดจากWorkManagerการพยายามรีสตาร์ท Worker ที่ทำงานเป็นเวลานาน (เช่น Worker ที่ทำงานอยู่เบื้องหน้า) เมื่อประเภทงานที่ทำงานอยู่เบื้องหน้ามีสิทธิ์ที่จำเป็นสำหรับ Android 14 ที่ถูกเพิกถอน (b/333957914)

เวอร์ชัน 2.9.0

29 พฤศจิกายน 2023

androidx.work:work-*:2.9.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.9.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.8.0

  • การสังเกตการณ์ผ่าน Flow ตอนนี้คุณสามารถดูความคืบหน้าของคนงานผ่าน Flow ผ่าน WorkManager.getWorkInfosFlow และวิธีที่คล้ายกันแทน LiveData ได้แล้ว
  • ตอนนี้ WorkManager จะให้คำแนะนำว่าเหตุใดก่อนหน้านี้จึงหยุด Worker โดยสามารถค้นหาได้จากตัว Worker เองผ่านเมธอด getStopReason() หรือจาก WorkInfo ผ่าน getStopReason()
  • การกำหนดเวลาที่แน่นอนสำหรับผู้ปฏิบัติงานเป็นระยะๆ ผ่าน setNextScheduleTimeOverride ซึ่งจะช่วยให้คำนวณตารางเวลาการทำงานแบบเป็นระยะถัดไปแบบไดนามิกได้ ซึ่งสามารถนำไปใช้เพื่อติดตั้งใช้งานฟีเจอร์ขั้นสูง เช่น เวลาการรีเฟรชแบบปรับได้ ลักษณะการลองใหม่ที่กำหนดเอง หรือทำให้ Worker ของฟีดข่าวทำงานก่อนที่ผู้ใช้จะตื่นทุกเช้าโดยไม่มีการเปลี่ยนแปลง ExistingPeriodicWorkPolicy.UPDATE ควรใช้ร่วมกับเทคนิคเหล่านี้เพื่อหลีกเลี่ยงการยกเลิก Worker ที่กำลังทำงานอยู่ขณะกำหนดเวลา Worker ตัวถัดไป
  • การทดสอบ WorkManager ด้วยการจับคู่การทำงานของเธรดกับการทำงานจริง ExecutorsMode.PRESERVE_EXECUTORS สามารถใช้ใน initializeTestWorkManager เพื่อเก็บรักษาตัวดำเนินการที่ตั้งค่าไว้ใน Configuration และใช้เทรดหลักจริง
  • ระบบได้ย้าย Coroutines API เช่น CoroutineWorker จากอาร์ติแฟกต์เพิ่มเติม work-runtime-ktx ไปยังอาร์ติแฟกต์หลัก work-runtime แล้ว ตอนนี้ work-runtime-ktx จึงว่างเปล่า

การเปลี่ยนแปลง API

  • เพิ่ม stopReason ไปยัง WorkInfo แล้ว ซึ่งจะทำให้ stopReason พร้อมใช้งานหลังจากที่ Worker ทำงานแล้ว ซึ่งอาจเป็นประโยชน์ในการรายงานstopReasonในลักษณะที่ใช้งานได้ เนื่องจากเมื่อหยุด Worker แล้ว ระบบอาจปิดแอปเองอย่างรวดเร็ว (I21386)
  • อนุญาตให้ตั้งค่า Clock ผ่านการกำหนดค่าและใช้เพื่อขับเคลื่อนลำดับการดำเนินการของการทดสอบ Worker (Ic586e)
  • เพิ่มเมธอด getStopReason() ลงใน ListenableWorker ซึ่งจะให้คำใบ้ว่าเหตุใดจึงหยุด Worker (I07060)
  • เพิ่ม WorkManagerTestInitHelper#closeWorkDatabase() เพื่อหลีกเลี่ยงคำเตือนของ Closeguard เกี่ยวกับทรัพยากรที่รั่วไหล (Ia8d49)
  • ตอนนี้ตัวสร้างของ WorkInfo เป็นแบบสาธารณะแล้ว ซึ่งอาจเป็นประโยชน์ในการทดสอบ (Ia00b6, b/209145335)
  • ตอนนี้ work-runtime-ktx ว่างเปล่าแล้ว CoroutineWorker และตอนนี้ยูทิลิตีอื่นๆ ที่เฉพาะเจาะจงของ Kotlin พร้อมใช้งานในอาร์ติแฟกต์รันไทม์หลักของ Work แล้ว (I71a9a)
  • เพิ่มวิธีการ setNextScheduleTimeOverride ซึ่งช่วยให้ตั้งค่าตารางเวลาการทำงานเป็นระยะได้อย่างแม่นยำ (I3b4da)
  • เพิ่ม getNextScheduleTimeMillis เพื่อรับข้อมูลเวลาที่กำหนดให้เรียกใช้ลงใน WorkInfo (I797e4)
  • ระบบจะเพิ่มข้อมูลการหน่วงเวลาเริ่มต้นและระยะเวลาลงใน WorkInfo (I52f2f)
  • เพิ่มวิธีการสังเกตผู้ปฏิบัติงานผ่าน Flows ด้วยวิธีการ getWorkInfosByTagFlow, getWorkInfoByIdFlow, getWorkInfosForUniqueWorkFlow, getWorkInfosFlow (If122a)
  • เพิ่มคำอธิบายประกอบ @RequiresApi(...) ที่ขาดหายไปให้กับตัวสร้างและพร็อพเพอร์ตี้ของ Constraints ตอนนี้ค่าเหล่านี้สอดคล้องกับคำอธิบายประกอบที่เกี่ยวข้องในตัวตั้งค่าใน Constraints.Builder ซึ่งมีมาตั้งแต่ WorkManager เวอร์ชันแรกๆ (I6d7d2)
  • WorkManager มีขีดจำกัดแยกต่างหากสำหรับ Content URI Worker เพื่อให้มีสล็อตที่รับประกันใน JobScheduler เพื่อป้องกันไม่ให้พลาดการอัปเดตเนื้อหาภายใต้ภาระงานสูง คุณกำหนดค่าขีดจำกัดได้ผ่าน Configuration.Builder.setContentUriTriggerWorkersLimit (Ic128f)
  • เพิ่มข้อจำกัดใน WorkInfo (I162c0)

เวอร์ชัน 2.9.0-rc01

18 ตุลาคม 2023

androidx.work:work-*:2.9.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.9.0-rc01 มีคอมมิตต่อไปนี้

  • ไม่มีการเปลี่ยนแปลงตั้งแต่เวอร์ชันเบต้าล่าสุด

เวอร์ชัน 2.9.0-beta01

6 กันยายน 2023

androidx.work:work-*:2.9.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.9.0-beta01 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

เวอร์ชัน 2.9.0-alpha02

26 กรกฎาคม 2023

androidx.work:work-*:2.9.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ WorkManager จะให้คำแนะนำว่าเหตุใดก่อนหน้านี้จึงหยุด Worker โดยสามารถค้นหาได้จากตัว Worker เองผ่านเมธอด getStopReason() หรือจาก WorkInfo ผ่าน getStopReason()

การเปลี่ยนแปลง API

  • เพิ่ม stopReason ไปยัง WorkInfo แล้ว โดยจะทำให้ stopReason พร้อมใช้งานหลังจากที่ Worker ทำงาน ซึ่งอาจเป็นประโยชน์ในการรายงาน stopReason ในลักษณะที่ใช้งานได้ เนื่องจากเมื่อหยุด Worker แล้ว ระบบอาจปิดแอปเองอย่างรวดเร็ว (I21386)
  • อนุญาตให้ตั้งค่า Clock ผ่านการกำหนดค่าและใช้เพื่อขับเคลื่อนลำดับการดำเนินการของการทดสอบ Worker (Ic586e)
  • เพิ่มเมธอด getStopReason() ลงใน ListenableWorker ซึ่งจะให้คำใบ้ว่าเหตุใดจึงหยุด Worker (I07060)
  • เพิ่ม WorkManagerTestInitHelper#closeWorkDatabase() เพื่อหลีกเลี่ยงคำเตือนของ Closeguard เกี่ยวกับทรัพยากรที่รั่วไหล (Ia8d49)

แก้ไขข้อบกพร่อง

  • เพิ่มความสามารถในการข้าม overrideNextScheduleTime โดยใช้ TestDriver และแก้ไขปัญหาเกี่ยวกับความสามารถในการทดสอบ (Ic2905)

เวอร์ชัน 2.9.0-alpha01

7 มิถุนายน 2023

androidx.work:work-*:2.9.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • การสังเกตการณ์ผ่าน Flow ตอนนี้คุณสามารถดูความคืบหน้าของคนงานผ่าน Flow ผ่าน WorkManager.getWorkInfosFlow และวิธีที่คล้ายกันแทน LiveData ได้แล้ว
  • การกำหนดเวลาที่แน่นอนสำหรับผู้ปฏิบัติงานเป็นระยะๆ ผ่าน setNextScheduleTimeOverride ซึ่งจะช่วยให้คำนวณตารางเวลาการทำงานแบบเป็นระยะถัดไปแบบไดนามิกได้ ซึ่งสามารถนำไปใช้เพื่อติดตั้งใช้งานฟีเจอร์ขั้นสูง เช่น เวลาการรีเฟรชแบบปรับได้ ลักษณะการลองใหม่ที่กำหนดเอง หรือทำให้ Worker ของฟีดข่าวทำงานก่อนที่ผู้ใช้จะตื่นทุกเช้าโดยไม่มีการเปลี่ยนแปลง ExistingPeriodicWorkPolicy.UPDATE ควรใช้ร่วมกับเทคนิคเหล่านี้เพื่อหลีกเลี่ยงการยกเลิก Worker ที่กำลังทำงานอยู่ขณะกำหนดเวลา Worker คนถัดไป
  • WorkManagerในการทดสอบการจับคู่เธรดกับการผลิต ExecutorsMode.PRESERVE_EXECUTORS สามารถใช้เพื่อเก็บรักษาตัวดำเนินการที่ตั้งค่าไว้ใน Configuration และใช้เทรดหลักจริง
  • เราได้ย้าย API ของโครูทีน เช่น CoroutineWorker จากอาร์ติแฟกต์เพิ่มเติม work-runtime-ktx ไปยังอาร์ติแฟกต์หลัก work-runtime แล้ว work-runtime-ktx ว่างแล้ว

การเปลี่ยนแปลง API

  • ตอนนี้เครื่องมือสร้างของ WorkInfo พร้อมใช้งานแบบสาธารณะแล้ว ซึ่งอาจมีประโยชน์ในการทดสอบ (Ia00b6, b/209145335)
  • work-runtime-ktx ตอนนี้ว่างเปล่าแล้ว CoroutineWorker และตอนนี้ยูทิลิตีอื่นๆ ที่เฉพาะเจาะจงของ Kotlin พร้อมใช้งานในอาร์ติแฟกต์ work-runtime หลักแล้ว (I71a9a)
  • เพิ่มวิธีการ setNextScheduleTimeOverride ซึ่งช่วยให้ตั้งค่าตารางเวลาการทำงานเป็นระยะได้อย่างแม่นยำ (I3b4da)
  • เปลี่ยนชื่อ getEarliestRunTimeMillis เป็น getNextScheduleTimeMillis แล้ว (I2bd7a)
  • ระบบจะเพิ่มข้อมูลเวลาการทำงานตามกำหนดการครั้งถัดไปลงใน WorkInfo (I797e4)
  • ระบบจะเพิ่มข้อมูลการหน่วงเวลาเริ่มต้นและระยะเวลาลงใน WorkInfo (I52f2f)
  • เพิ่มวิธีการสังเกตผู้ปฏิบัติงานผ่าน Flows ด้วยวิธีการ getWorkInfosByTagFlow, getWorkInfoByIdFlow, getWorkInfosForUniqueWorkFlow, getWorkInfosFlow (If122a)
  • เพิ่มคำอธิบายประกอบ @RequiresApi(...) ที่ขาดหายไปให้กับตัวสร้างและพร็อพเพอร์ตี้ของข้อจำกัด ตอนนี้ค่าเหล่านี้สอดคล้องกับคำอธิบายประกอบที่เกี่ยวข้องในตัวตั้งค่าใน Constraints.Builder ซึ่งมีมาตั้งแต่ WorkManager เวอร์ชันแรกๆ (I6d7d2)
  • WorkManager มีขีดจำกัดแยกต่างหากสำหรับ Content URI Worker เพื่อให้มีสล็อตที่รับประกันใน JobScheduler เพื่อป้องกันไม่ให้พลาดการอัปเดตเนื้อหาภายใต้ภาระงานสูง คุณกำหนดค่าขีดจำกัดได้ผ่าน Configuration.Builder.setContentUriTriggerWorkersLimit (Ic128f)
  • เพิ่มข้อจำกัดใน WorkInfo (I162c0)

เวอร์ชัน 2.8

เวอร์ชัน 2.8.1

22 มีนาคม 2023

androidx.work:work-*:2.8.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.1 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไข ANR ใน RescheduleReceiver ซึ่งก่อนหน้านี้จัดการการออกอากาศพร้อมกัน 2 รายการไม่ถูกต้อง (b/236906724)

เวอร์ชัน 2.8.0

8 กุมภาพันธ์ 2023

androidx.work:work-*:2.8.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงสำคัญตั้งแต่เวอร์ชัน 2.7.0

ฟีเจอร์ใหม่

  • เราได้เพิ่มความสามารถในการอัปเดต WorkRequests ในลักษณะที่ไม่รบกวน โดยยังคงเวลาการจัดคิวเดิม การเชื่อมโยง ฯลฯ โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ในบล็อกโพสต์ฉบับละเอียด รวมถึง Javadoc สำหรับ WorkManager.updateWork และ ExistingPeriodicWorkPolicy.UPDATE

การเปลี่ยนแปลง API

  • WorkManager.updateWork ได้รับการเพิ่มเข้ามาเพื่ออัปเดตงานโดยคงเวลาการจัดคิวเดิมและการเชื่อมโยงไว้ (I9a248, b/219446409)
  • เพิ่ม ExistingPeriodicWorkPolicy.UPDATE แล้ว นโยบายนี้อนุญาตให้อัปเดตงานที่ทำเป็นระยะๆ ตามชื่อ ซึ่งคล้ายกับ REPLACE ที่มีอยู่ แต่รบกวนน้อยกว่า โดยจะไม่ยกเลิก Worker หากกำลังทำงานอยู่ และจะรักษาเวลาในการจัดคิวไว้ ซึ่งระบบจะคำนวณการหน่วงเวลาเริ่มต้นและระยะเวลาจากเวลาในการจัดคิวเดิม ไม่ใช่เวลาอัปเดต REPLACE เลิกใช้งานแล้วเพื่อลดความสับสนระหว่าง REPLACE กับ UPDATE ซึ่งมีชื่อคล้ายกันมาก หากยังต้องการใช้ความหมายเดิมของ REPLACE คุณสามารถใช้ CANCEL_AND_REENQUEUE ที่เพิ่งเพิ่มเข้ามาใหม่ซึ่งเหมือนกับ REPLACE ได้ (I985ed, b/219446409)
  • เพิ่มความสามารถในการสกัดกั้นข้อยกเว้นในการกำหนดเวลาโดยระบุผ่าน Consumer<Throwable> via setSchedulingExceptionHandler)
  • เพิ่มความสามารถในการระบุ Consumer<Throwable> ผ่าน setInitializationExceptionHandler เพื่อพิจารณาว่ามีปัญหาหรือไม่เมื่อพยายามเริ่มต้น WorkManager
  • ย้ายตัวช่วยในบรรทัดสำหรับ OneTimeWorkRequest และ PeriodicWorkRequest จาก androidx.work:work-runtime-ktx ไปยัง androidx.work:work-runtime (I0010f, b/209145335)
  • เพิ่มเมธอดตัวช่วย WorkQuery.fromIds, WorkQuery.fromStates, WorkQuery.fromUniqueWorkNames, WorkQuery.fromTags เพื่อสร้าง WorkQuery โดยตรง (b/199919736) (If48f2, b/199919736)
  • เพิ่ม getForegroundInfo ไปยัง Worker แล้ว (Ic1ead)
  • RxWorker ทั้งสำหรับ RxJava 2 และ RxJava 3 ตอนนี้มี setForeground ที่แสดงผล Completable ซึ่งใช้แทน setForegroundInfoAsync ที่แสดงผล ListenableFuture ได้แล้ว
  • RxWorker ทั้งสำหรับ RxJava 2 และ RxJava 3 มี getForegroundInfo ที่แสดงผล Single ซึ่งใช้แทน getForegroundInfoAsync ที่แสดงผล ListenableFuture ได้ (b/203851459)
  • ตอนนี้คุณสร้างข้อจำกัดได้โดยตรงแทนการใช้ Constraints.Builder ซึ่งสะดวกสำหรับผู้ใช้ Kotlin (Idc390, b/137568653)
  • เพิ่มความสามารถในการตรวจสอบว่ามีการเริ่มต้น WorkManager หรือไม่ นอกจากนี้ เรายังเพิ่ม getConfiguration() API ใหม่สำหรับนักพัฒนาไลบรารีเพื่อรับการกำหนดค่าที่ WorkManager เริ่มต้นด้วย (I6eff3, b/212300336)

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาเกี่ยวกับตัวจัดตารางเวลาแบบ Greedy ที่จะป้องกันไม่ให้ Worker ทำงานทันทีเมื่อมีการโหลด (I9686b, b/248111307)
  • เพิ่ม @RequiresPermission ลงใน API ที่ต้องให้สิทธิ์ POST_NOTIFICATIONS ใน SDK 33 ขึ้นไป (Ie542e, b/238790278)
  • ส่งต่อการยกเลิกใน CoroutineScope ไปยัง ListenableFuture เมื่อใช้ suspendCancellableCoroutine

เวอร์ชัน 2.8.0-rc01

7 ธันวาคม 2022

androidx.work:work-*:2.8.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.0-rc01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ไม่มีฟีเจอร์ใหม่ในรุ่นนี้ ซึ่งส่วนใหญ่เป็นการเพิ่มเวอร์ชัน

เวอร์ชัน 2.8.0-beta02

9 พฤศจิกายน 2022

androidx.work:work-*:2.8.0-beta02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.0-beta02 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขequalsวิธีการในWorkInfoซึ่งก่อนหน้านี้ไม่ได้พิจารณาข้อมูลรุ่นใหม่ (4977cc)

เวอร์ชัน 2.8.0-beta01

5 ตุลาคม 2022

androidx.work:work-*:2.8.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.0-beta01 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาเกี่ยวกับตัวจัดตารางเวลาแบบ Greedy ที่จะป้องกันไม่ให้ Worker ทำงานทันทีเมื่อมีการโหลด (I9686b, b/248111307)

เวอร์ชัน 2.8.0-alpha04

7 กันยายน 2022

androidx.work:work-*:2.8.0-alpha04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha04 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่ม WorkerInfo.getGeneration() และ WorkerParameters.getGeneration() ที่แสดงรุ่นของพนักงาน Worker มีหลายรุ่นหากได้รับการอัปเดตผ่าน WorkManager.updateWork หรือ WorkManager.enqueueUniquePeriodicWork โดยใช้ ExistingPeriodicWorkPolicy.UPDATE โปรดทราบว่าหาก Worker กำลังทำงานอยู่ วิธีนี้อาจแสดงผล Worker รุ่นใหม่กว่า Worker ที่กำลังทำงานอยู่ หากมีการอัปเดตเกิดขึ้นในระหว่างการเรียกใช้ Worker (I665c5, b/219446409) (I128a9, b/219446409)
  • เพิ่ม InitializationExceptionHandler ซึ่งเป็นตัวแฮนเดิลข้อยกเว้นที่ใช้เพื่อตรวจสอบว่ามีปัญหาหรือไม่เมื่อพยายามเริ่มต้น WorkManager (I061de)

เวอร์ชัน 2.8.0-alpha03

10 สิงหาคม 2022

androidx.work:work-*:2.8.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha03 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เราได้เพิ่มความสามารถในการอัปเดต WorkRequests โดยไม่รบกวนการทำงาน ซึ่งจะรักษาเวลาการจัดคิวเดิม การเชื่อมโยง ฯลฯ โปรดดูรายละเอียดเพิ่มเติมที่ WorkManager.updateWork และ ExistingPeriodicWorkPolicy.UPDATE

การเปลี่ยนแปลง API

  • WorkManager.updateWork ได้รับการเพิ่มเข้ามาเพื่ออัปเดตงานโดยคงเวลาการจัดคิวเดิมและการเชื่อมโยงไว้ (I9a248, b/219446409)
  • เพิ่ม ExistingPeriodicWorkPolicy.UPDATE แล้ว นโยบายนี้อนุญาตให้อัปเดตงานที่ทำเป็นระยะๆ ตามชื่อ ซึ่งคล้ายกับ REPLACE ที่มีอยู่ แต่รบกวนน้อยกว่า โดยจะไม่ยกเลิก Worker หากกำลังทำงานอยู่ และจะรักษาเวลาในการจัดคิวไว้ ซึ่งระบบจะคำนวณการหน่วงเวลาเริ่มต้นและระยะเวลาจากเวลาในการจัดคิวเดิม ไม่ใช่เวลาอัปเดต REPLACE ถูกเลิกใช้งานเพื่อลดความสับสนระหว่าง REPLACE และ UPDATE ซึ่งมีชื่อคล้ายกันมาก หากยังต้องการใช้ความหมายเดิมของ REPLACE คุณสามารถใช้ CANCEL_AND_REENQUEUE ที่เพิ่งเพิ่มเข้ามาใหม่ซึ่งเหมือนกับ REPLACE ได้ (I985ed, b/219446409)
  • เพิ่มความสามารถในการสกัดกั้นข้อยกเว้นการจัดเวลาโดยการกำหนด SchedulingExceptionHandler (I033eb)
  • ย้ายตัวช่วยในบรรทัดสำหรับ OneTimeWorkRequest และ PeriodicWorkRequest จาก androidx.work:work-runtime-ktx ไปยัง androidx.work:work-runtime (I0010f, b/209145335)

แก้ไขข้อบกพร่อง

  • เพิ่ม @RequiresPermission ลงใน API ที่ต้องให้สิทธิ์ POST_NOTIFICATIONS ใน SDK 33 ขึ้นไป (Ie542e, b/238790278)

เวอร์ชัน 2.8.0-alpha02

6 เมษายน 2022

androidx.work:work-*:2.8.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้คุณสร้างข้อจำกัดได้โดยตรงแทนการใช้ Builder ซึ่งสะดวกสำหรับผู้ใช้ Kotlin (Idc390, b/137568653)
  • เพิ่มความสามารถในการตรวจสอบว่ามีการเริ่มต้น WorkManager หรือไม่ นอกจากนี้ เรายังเพิ่ม getConfiguration() API ใหม่สำหรับนักพัฒนาไลบรารีเพื่อรับการกำหนดค่าที่ WorkManager เริ่มต้นด้วย (I6eff3, b/212300336)

เวอร์ชัน 2.8.0-alpha01

12 มกราคม 2022

androidx.work:work-*:2.8.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha01 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มเมธอด Helper WorkQuery.fromStates, WorkQuery.fromUniqueWorkNames, WorkQuery.fromTags เพื่อสร้าง WorkQuery โดยตรง (If48f2, b/199919736)
  • เพิ่มเมธอด BuildCompat เวอร์ชันทดลองสำหรับ SDK ในอนาคต (Iafd82, b/207528937)
  • เพิ่ม getForegroundInfo ไปยัง Worker (Ic1ead)
  • เพิ่มเมธอด Helper WorkQuery.fromIds เพื่อสร้าง WorkQuery จากรหัสโดยตรง (Ie5bdf, b/199919736)
  • ตอนนี้ RxWorker มี setForeground ที่ส่งคืน Completable ซึ่ง ใช้แทน setForegroundInfoAsync ที่ส่งคืน ListenableFuture ได้แล้ว (I85156)
  • ตอนนี้ RxWorker สำหรับ RxJava 2 มี getForegroundInfo ที่แสดงผล Single ซึ่ง ใช้แทน getForegroundInfoAsync ที่แสดงผล ListenableFuture ได้ (I21c91, b/203851459)
  • ตอนนี้ RxWorker สำหรับ RxJava 3 มี getForegroundInfo ที่ส่งคืน Single ซึ่ง ใช้แทน getForegroundInfoAsync ที่ส่งคืน ListenableFuture ได้ (I1ca8a)
  • ตอนนี้ RxWorker มี setForeground ที่ส่งคืน Completable ซึ่ง ใช้แทน setForegroundInfoAsync ที่ส่งคืน ListenableFuture ได้แล้ว (I992a3, b/203851459)

แก้ไขข้อบกพร่อง

  • ส่งต่อการยกเลิกใน CoroutineScope ไปยัง ListenableFuture เมื่อใช้ suspendCancellableCoroutine (I77e63)

เวอร์ชัน 2.7

เวอร์ชัน 2.7.1

17 พฤศจิกายน 2021

androidx.work:work-*:2.7.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.7.1 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • การยกเลิกใน CoroutineScope จะส่งต่อไปยัง ListenableFuture เมื่อใช้ suspendCancellableCoroutine (I77e63)
  • ระบบจะยกเว้นทันทีเมื่อมีการทำเครื่องหมายคำของานที่ล่าช้าว่าเร่งด่วน bef1762

เวอร์ชัน 2.7.0

13 ตุลาคม 2021

androidx.work:work-*:2.7.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.7.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.6.0

  • WorkManager เปิดตัว WorkRequest.Builder.setExpedited(...) API ใหม่เพื่อช่วยจัดการข้อจำกัดของบริการที่ทำงานอยู่เบื้องหน้าใน Android 12

  • เมื่อใช้ setExpedited(...) WorkManager จะมอบหมายให้งานที่เร่งด่วนใน JobScheduler เริ่มตั้งแต่ Android 12 ในขณะที่ยังคงความเข้ากันได้แบบย้อนหลังใน Android เวอร์ชันก่อนหน้าด้วยการมอบหมายให้ Foreground Service

เวอร์ชัน 2.7.0-rc01

29 กันยายน 2021

androidx.work:work-*:2.7.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.7.0-rc01 มีคอมมิตเหล่านี้

เวอร์ชันนี้เหมือนกับ androidx.work:work-*:2.7.0-beta01 ทุกประการ

เวอร์ชัน 2.7.0-beta01

1 กันยายน 2021

androidx.work:work-*:2.7.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.7.0-beta01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ลดการแย่งกันใช้ SQLite แบบหลายกระบวนการเมื่อเริ่มต้น WorkManager

การเปลี่ยนแปลง API

  • นำ @ExperimentalExpeditedWork API ออกเนื่องจาก API ของแพลตฟอร์มพื้นฐานสำหรับ Android 12 (S) มีความเสถียร (aosp/1792806)

แก้ไขข้อบกพร่อง

  • แสดงข้อความแสดงข้อผิดพลาดที่ดีขึ้นสำหรับผู้ปฏิบัติงานที่เร่งด่วนซึ่งไม่ได้ใช้ getForegroundInfoAsync() (aosp/1809376)

เวอร์ชัน 2.7.0-alpha05

21 กรกฎาคม 2021

androidx.work:work-*:2.7.0-alpha05 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha05 มีคอมมิตเหล่านี้

นอกจากนี้ รุ่นนี้ยังมีการแก้ไขข้อบกพร่องจากรุ่น WorkManager 2.6.0-beta02 ด้วย

เวอร์ชัน 2.7.0-alpha04

2 มิถุนายน 2021

androidx.work:work-*:2.7.0-alpha04 ได้รับการเผยแพร่แล้ว

นอกจากนี้ รุ่นนี้ยังมีการเปลี่ยนแปลงจากรุ่น 2.6.0-beta01 ด้วย

การเปลี่ยนแปลง API

แก้ไขข้อบกพร่อง

  • เมื่อกำหนดเวลางานเร่งด่วนใหม่ งานนั้นจะไม่เป็นงานเร่งด่วนอีกต่อไป งานเหล่านี้จะกลายเป็นงานปกติ

เวอร์ชัน 2.7.0-alpha03

21 เมษายน 2021

androidx.work:work-*:2.7.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha03 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • จาก WorkManager 2.6.0-alpha02: เพิ่มการรองรับ Worker ที่ทำงานในกระบวนการใดก็ได้ (Iaf200)

  • จาก WorkManager 2.6.0-alpha02: เพิ่ม RemoteCoroutineWorker ซึ่งเป็นการติดตั้งใช้งาน RemoteListenableWorker ที่เชื่อมโยงกับกระบวนการระยะไกลได้ (I30578)

การเปลี่ยนแปลง API

  • จาก WorkManager 2.6.0-alpha02:เพิ่มการรองรับข้อจํากัดของเครือข่าย TEMPORARILY_UNMETERED (I08d5e)
  • จาก WorkManager 2.6.0-alpha02:รองรับ Worker แบบหลายกระบวนการสำหรับ setProgressAsync() (Ib6d08)
  • จาก WorkManager 2.6.0-alpha02:ทำให้ WorkManagerInitializer เป็นแบบสาธารณะเพื่อให้ androidx.startup.Initializer อื่นๆ ใช้เป็นทรัพยากร Dependency ได้ (I5ab11)

เวอร์ชัน 2.7.0-alpha02

10 มีนาคม 2021

androidx.work:work-*:2.7.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha02 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ระบุการเปลี่ยนแปลงของ PendingIntent อย่างชัดเจนเพื่อแก้ไขข้อขัดข้องเมื่อกำหนดเป้าหมายเป็น Android 12 (b/180884673)

เวอร์ชัน 2.7.0-alpha01

18 กุมภาพันธ์ 2021

androidx.work:work-*:2.7.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha01 มีคอมมิตต่อไปนี้

ฟีเจอร์ใหม่

  • WorkManager เปิดตัวWorkRequest.Builder.setExpedited(...) API ใหม่เพื่อพิจารณาข้อจำกัดของบริการที่ทำงานอยู่เบื้องหน้าใน Android 12

    แอปพลิเคชันจะเปิดบริการที่ทำงานอยู่เบื้องหน้าไม่ได้อีกต่อไปเมื่ออยู่ในเบื้องหลัง ดังนั้น เพื่อให้รองรับงานที่ใช้เวลานานได้ดียิ่งขึ้น ซึ่งก่อนหน้านี้เชื่อมโยงกับวงจรของบริการที่ทำงานอยู่เบื้องหน้า แอปพลิเคชันจึงสามารถทำเครื่องหมาย WorkRequests เป็นเร่งด่วนได้

    API นี้มาแทนที่ API setForegroundAsync(...) / setForeground(...) ซึ่งเลิกใช้งานแล้ว

    เมื่อใช้ setExpedited(...) WorkManager จะมอบหมายให้งานที่เร่งด่วนใน JobScheduler เริ่มตั้งแต่ Android 12 ขณะเดียวกันก็มอบความเข้ากันได้แบบย้อนหลังใน Android เวอร์ชันก่อนหน้าด้วยการมอบหมายให้บริการที่ทำงานอยู่เบื้องหน้า

การเปลี่ยนแปลง API

  • เพิ่มการรองรับ WorkRequest แบบเร่งด่วน

เวอร์ชัน 2.6.0

เวอร์ชัน 2.6.0

1 กันยายน 2021

androidx.work:work-*:2.6.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.6.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.5.0

  • ตอนนี้ WorkManager ใช้ androidx.startup เพื่อเริ่มต้น WorkManager แล้ว หากคุณใช้ tools:node="remove" ContentProvider ที่ใช้ในการเริ่มต้น WorkManager ในอดีต คุณจะต้องทำดังนี้แทน

    <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>

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

  • เพิ่มการรองรับ Worker ที่ทำงานในกระบวนการใดก็ได้ (Iaf200)

  • เพิ่ม RemoteCoroutineWorker ซึ่งเป็นการติดตั้งใช้งาน RemoteListenableWorker ที่เชื่อมโยงกับกระบวนการระยะไกลได้ (I30578)

เวอร์ชัน 2.6.0-rc01

4 สิงหาคม 2021

androidx.work:work-*:2.6.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.6.0-rc01 มีคอมมิตต่อไปนี้

เวอร์ชันนี้เหมือนกับ androidx.work:work-*:2.6.0-beta02 ทุกประการ

เวอร์ชัน 2.6.0-beta02

21 กรกฎาคม 2021

androidx.work:work-*:2.6.0-beta02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.6.0-beta02 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ตอนนี้ RemoteWorkManager จะยกเลิกการเชื่อมโยงจาก RemoteWorkManagerService อย่างถูกต้อง ซึ่งจะช่วยให้ RemoteWorkManagerService ล้างข้อมูลได้อย่างถูกต้อง aosp/1730694
  • RemoteListenableWorker จะยกเลิกการเชื่อมโยงจาก RemoteWorkerService อย่างถูกต้อง ซึ่งจะช่วยให้ RemoteWorkerService ล้างข้อมูลได้อย่างถูกต้อง aosp/1743817
  • ForceStopRunnable ตอนนี้จะทำงานในกระบวนการของแอปหลักเท่านั้น ซึ่งเป็นการเพิ่มประสิทธิภาพและหลีกเลี่ยงการแย่งชิงทรัพยากรสำหรับแอปที่ใช้หลายกระบวนการ aosp/1749180, aosp/1761729

เวอร์ชัน 2.6.0-beta01

2 มิถุนายน 2021

androidx.work:work-*:2.6.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.6.0-beta01 มีคอมมิตเหล่านี้

รุ่นนี้มีการปรับปรุงเอกสารเล็กน้อย รุ่นนี้ส่วนใหญ่จะเหมือนกับ 2.6.0-alpha02

เวอร์ชัน 2.6.0-alpha02

21 เมษายน 2021

androidx.work:work-*:2.6.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มการรองรับสำหรับ Worker ที่ทำงานในกระบวนการใดก็ได้ (Iaf200)

  • เพิ่ม RemoteCoroutineWorker ซึ่งเป็นการติดตั้งใช้งาน RemoteListenableWorker ที่เชื่อมโยงกับกระบวนการระยะไกลได้ (I30578)

การเปลี่ยนแปลง API

  • เพิ่มการรองรับข้อจำกัดเครือข่าย TEMPORARILY_UNMETERED (I08d5e)
  • การรองรับ Worker แบบหลายกระบวนการสำหรับ setProgressAsync() (Ib6d08)
  • ตั้งค่า WorkManagerInitializer เป็นสาธารณะเพื่อให้ androidx.startup.Initializer อื่นๆ ใช้เป็นทรัพยากร Dependency ได้ (I5ab11)

เวอร์ชัน 2.6.0-alpha01

24 มีนาคม 2021

androidx.work:work-*:2.6.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • WorkManager ตอนนี้ใช้ androidx.startup เพื่อเริ่มต้น WorkManager แล้ว ก่อนหน้านี้ androidx.work.impl.WorkManagerInitializer เป็นผู้ดำเนินการนี้ (aosp/1608813)

    หากคุณเคยใช้ tools:node="remove" ContentProvider เพื่อเริ่มต้น วงจรของกระบวนการในอดีต คุณจะต้องทำดังนี้แทน

     <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.impl.WorkManagerInitializer"
        android:value="androidx.startup"
        tools:node="remove" />
 </provider>

    (หรือ)

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

การเปลี่ยนแปลง API

  • เพิ่ม Result.getOutputData() API ซึ่งจะแสดงผล outputData ของ ListenableWorker (Ie51e3)

แก้ไขข้อบกพร่อง

  • เพิ่มวิธีแก้ปัญหาสำหรับข้อบกพร่องของ OEM ซึ่งทำให้เกิด SecurityException เมื่อใช้ API ของ AlarmManager (aosp/1587518)

เวอร์ชัน 2.5.0

เวอร์ชัน 2.5.0

27 มกราคม 2021

androidx.work:work-*:2.5.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.5.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.4.0

  • อาร์ติแฟกต์ :work:work-multiprocess ใหม่สำหรับแอปที่ใช้หลายกระบวนการ ซึ่งจะช่วยเพิ่มประสิทธิภาพด้วยการรวมการจัดกำหนดการคำของานเป็นกระบวนการเดียว
    • หากต้องการใช้ work-multiprocess ให้กำหนดการอ้างอิงในรายการต่อไปนี้ implementation "androidx.work:work-multiprocess:2.5.0"
    • กำหนดกระบวนการหลักโดยใช้ Configuration.Builder.setDefaultProcessName(String)
    • เมื่อใช้ work-multiprocess คุณอาจต้องการใช้ RemoteWorkManager เพื่อจัดการ WorkRequest ด้วย RemoteWorkManager จะติดต่อกระบวนการที่กำหนดเสมอ ตัวกำหนดตารางเวลาในกระบวนการจะทำงานในกระบวนการที่กำหนดด้วย
  • บางครั้ง ActivityManager จะสร้างอินสแตนซ์ JobService เพื่อเริ่มงานไม่ได้ ซึ่งทำให้ระบบทิ้งงานที่เกี่ยวข้องโดยไม่มีการแจ้งเตือนเนื่องจากข้อบกพร่องของแพลตฟอร์ม WorkManager ตอนนี้จะช่วยให้มั่นใจได้ว่าจะมีงานสำรองสำหรับทุกๆ WorkRequest เมื่อมีการเริ่มต้น Application โดยการเทียบชื่องาน ซึ่งจะช่วยปรับปรุงความน่าเชื่อถือในการเรียกใช้งานอย่างมาก (b/172475041, aosp/1489577)
  • WorkManager จำกัดการเติบโตของฐานข้อมูลโดยการลดระยะเวลาบัฟเฟอร์ที่ระบบติดตาม WorkRequest หลังจากที่ WorkRequest เสร็จสมบูรณ์ ก่อนหน้านี้ระยะเวลาคือ 7 วัน โดยลดลงเหลือ 1 วัน + ระยะเวลา keepResultsForAtLeast (aosp/1419708)
  • ตอนนี้ TestListenableWorkerBuilder รองรับคลาสที่ทำให้เป็นจริงซึ่งขยาย ListenableWorker เพื่อให้การทดสอบง่ายขึ้น (aosp/1443299, b/169787349)
  • ตอนนี้เครื่องมือตรวจสอบ WorkManager พร้อมให้ใช้งานแล้วเมื่อใช้ Android Studio Arctic Fox

เวอร์ชัน 2.5.0-rc01

13 มกราคม 2021

androidx.work:work-*:2.5.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.5.0-rc01 มีคอมมิตต่อไปนี้

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องในกรณีที่ getWorkInfosLiveData ไม่ถูกต้องจะใช้ไม่ได้หลังจากอัปเดตเอนทิตีเมื่อใช้ API ที่อิงตาม WorkQuery (aosp/1540566, b/173769028)
  • แก้ไขข้อบกพร่องที่ทำให้ระบบไม่ได้ทำเครื่องหมายธุรกรรมในฐานข้อมูลว่าสำเร็จในบางกรณีซึ่งพบน้อยมาก ซึ่งทำให้เกิดปัญหาในอุปกรณ์ Motorola บางรุ่น (aosp/1535368, b/175944460)
  • แก้ไขข้อบกพร่องเพื่อไม่สนใจ NoSuchElementExceptions เมื่อพยายามยกเลิกการเชื่อมโยงจากกระบวนการที่หยุดทำงาน (aosp/1530589)
  • ปรับปรุง ConstraintTrackingWorker เพื่อหยุด ListenableWorker เฉพาะในกรณีที่ยังไม่ได้หยุด (aosp/1496844, b/172946965)
  • อัปเดตไลบรารี androidx.work เพื่อกำหนดเป้าหมายเป็น Java 8 (Ibd2f2)

เวอร์ชัน 2.5.0-beta02

2 ธันวาคม 2020

androidx.work:work-*:2.5.0-beta02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.5.0-beta02 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องใน androidx.work:work-multiprocess ซึ่ง WorkManager บล็อกเธรดการเรียกโดยไม่ตั้งใจเมื่อพยายามเชื่อมโยงกับกระบวนการที่กำหนด (aosp/1475538)
  • แก้ไขข้อบกพร่องที่ทำให้ระบบกระทบยอด PeriodicWorkRequest ไม่ถูกต้อง (b/172475041, aosp/1489577)
  • เพิ่มวิธีแก้ปัญหาข้อบกพร่องของแพลตฟอร์มเมื่อหยุดบริการที่ทำงานอยู่เบื้องหน้าขณะใช้ setForeground* API (b/170924044, aosp/1489901)

เวอร์ชัน 2.5.0-beta01

28 ตุลาคม 2020

androidx.work:work-*:2.5.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.5.0-beta01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • WorkManager จะจำกัดจำนวน WorkRequest ที่กำหนดเวลาในกระบวนการสามารถเลือกได้โดยอัตโนมัติ ระบบยังคงดำเนินการตามคำขอตามลำดับ FIFO (aosp/1455228)
  • WorkManager พยายามกู้คืนเมื่อที่เก็บข้อมูลของแอปพลิเคชันอยู่ในสถานะที่ไม่ดี (aosp/1463103)

แก้ไขข้อบกพร่อง

  • เมื่อListenableWorkerถูกขัดจังหวะ ให้ทำเครื่องหมายENQUEUEDทันทีเพื่อให้กำหนดเวลาใหม่ได้ในภายหลัง (aosp/1455618, b/170273988)

เวอร์ชัน 2.5.0-alpha03

14 ตุลาคม 2020

androidx.work:work-*:2.5.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • TestListenableWorkerBuilder และ TestWorkerBuilder ไม่ใช้ประเภทดิบ (I883ad, b/169787349)

แก้ไขข้อบกพร่อง

  • ใช้ ApplicationInfo เพื่อกำหนดชื่อของกระบวนการแอปเริ่มต้น (b/168716641, aosp/1429950)
  • แก้ไขกฎการมองเห็นสำหรับ RemoteWorkManager และ RemoteWorkContinuation ระบบจะไม่ทำเครื่องหมาย API เหล่านี้เป็น @Restricted อีกต่อไป (aosp/1432091)
  • แก้ไขกฎ ProGuard สำหรับ :work:work-multiprocess (aosp/1432091)
  • ปรับปรุงวงจรการแจ้งเตือนสำหรับงานที่ใช้เวลานานซึ่งเชื่อมโยงกับบริการที่ทำงานอยู่เบื้องหน้า (b/168502234, aosp/1431331)

เวอร์ชัน 2.5.0-alpha02

16 กันยายน 2020

androidx.work:work-*:2.5.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่ม API ไปยัง WorkQuery เพื่อให้ใช้ id ในการค้นหา WorkInfo ได้ (aosp/1412372, b/157335295)
  • WorkManager รองรับแอปที่ใช้หลายกระบวนการได้ดียิ่งขึ้นด้วยอาร์ติแฟกต์ใหม่ (androidx.work:work-multiprocess:*) อาร์ติแฟกต์ใหม่นี้ช่วยแก้ปัญหาบางอย่างที่แอปขนาดใหญ่พบได้ เช่น
    • โดยปกติแล้ว WorkManager จะต้องเริ่มต้นในทุกกระบวนการของแอป ซึ่งไม่ดีนักเนื่องจากจะทำให้เกิดการแย่งกันใช้ SQLite มากขึ้น ซึ่งจะทำให้เกิดปัญหาอื่นๆ ตามมา ตอนนี้ WorkManager มี API ใหม่ที่ใช้กำหนดกระบวนการของแอปหลักได้โดยใช้ Configuration#setDefaultProcessName(processName) processName คือชื่อกระบวนการที่สมบูรณ์ในตัวเองซึ่งมีลักษณะเป็น packageName:processName (เช่น com.example:remote)
    • ชุด API ใหม่: RemoteWorkManager และ RemoteWorkContinuation ถึง enqueue, cancel และ query คำของาน API เหล่านี้ไม่มีตัวแปร LiveData เพื่อหลีกเลี่ยงการแย่งกันใช้ SQLite ในหลายกระบวนการ ระบบจะส่งต่อการเรียกไปยัง enqueue, cancel และ query ไปยังกระบวนการแอป primary โดยใช้ AIDL และส่งคืน ListenableFuture ที่ไหลลื่น (aosp/1392657, aosp/1411210, aosp/1412215, aosp/1417713)

การเปลี่ยนแปลง API

  • ตอนนี้ WorkManager จะตัด WorkRequest ที่เสร็จสมบูรณ์แล้วซึ่งไม่มีการขึ้นต่อกันที่ไม่สมบูรณ์ออกอย่างจริงจังมากขึ้น ระยะเวลาเผื่อเปลี่ยนจาก 7 วันเป็น 1 วัน (aosp/1419708)

แก้ไขข้อบกพร่อง

  • ตอนนี้ WorkManager จะซิงค์งานอย่างรวดเร็วเพื่อให้งาน WorkRequest และ JobScheduler ซิงค์กันเมื่อมีการเริ่มต้น WorkManager (aosp/1412794, b/166292069)

เวอร์ชัน 2.5.0-alpha01

19 สิงหาคม 2020

androidx.work:work-*:2.5.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • การเปลี่ยนแปลง API ภายในซึ่งช่วยให้เราสามารถจัดหาเครื่องมือที่ดีขึ้นด้วย WorkManager ในอนาคต โปรดรอติดตามข้อมูลอัปเดตเพิ่มเติม

แก้ไขข้อบกพร่อง

  • จัดการ SecurityException เมื่อติดตามสถานะเครือข่ายในอุปกรณ์บางเครื่อง (aosp/1396969)

การมีส่วนร่วมภายนอก

  • แก้ไขเอกสารประกอบสำหรับ ArrayCreatingInputMerger โดย Zac Sweers (github/43)

เวอร์ชัน 2.4.0

เวอร์ชัน 2.4.0

22 กรกฎาคม 2020

androidx.work:work-*:2.4.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.4.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.3.0

  • ตอนนี้ตัวกำหนดตารางเวลาในกระบวนการของ WorkManager มีประสิทธิภาพมากขึ้นแล้ว ก่อนหน้านี้ Scheduler ในกระบวนการจะพิจารณาเฉพาะการดำเนินการที่ไม่มีการหน่วงเวลาและเป็นไปตามข้อจำกัด ตอนนี้ตัวกำหนดตารางเวลาในกระบวนการจะติดตาม WorkRequests ที่อาจดำเนินการในอนาคต รวมถึง PeriodicWorkRequests นอกจากนี้ Schedulerที่กำลังดำเนินการยังไม่สังเกตขีดจำกัดการตั้งเวลา (แต่ยังคงจำกัดขนาดของ Executor ที่ WorkManager ใช้) ซึ่งหมายความว่าตอนนี้แอปพลิเคชันสามารถเรียกใช้ WorkRequest ได้มากขึ้นเมื่อแอปอยู่เบื้องหน้า นอกจากนี้ WorkManager ยังเปิดตัว RunnableScheduler ใหม่ที่กำหนดค่าได้เพื่อจัดการการดำเนินการของงานที่ล่าช้าในเบื้องหน้า (aosp/1185778)
  • ตอนนี้ WorkManager รองรับ RxJava 3 แล้ว หากต้องการใช้ RxJava 3 คุณควรใส่การอ้างอิง implementation "androidx.work:work-rxjava3:2.4.0" ต่อไปนี้ (aosp/1277904)
  • เพิ่มความสามารถในการค้นหา WorkInfo โดยใช้ WorkQuery ซึ่งจะเป็นประโยชน์เมื่อนักพัฒนาแอปต้องการค้นหา WorkInfo โดยใช้การรวมแอตทริบิวต์หลายรายการ ดูข้อมูลเพิ่มเติมได้ที่ WorkQuery.Builder.fromStates(...), WorkQuery.Builder. fromTags(...) หรือ WorkQuery.Builder.fromUniqueWorkNames(...) (aosp/1253230, b/143847546)

  • เพิ่มความสามารถในการขอข้อมูลการวินิจฉัยจาก WorkManager โดยใช้

    adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>"

    ซึ่งมีข้อมูลที่เป็นประโยชน์มากมาย เช่น

    • คำของานที่เสร็จสมบูรณ์ในช่วง 24 ชั่วโมงที่ผ่านมา
    • WorkRequest ที่กำลังทำงานอยู่
    • WorkRequest ที่กำหนดเวลาไว้ (aosp/1235501)

  • เพิ่ม ExistingWorkPolicy.APPEND_OR_REPLACE ซึ่งคล้ายกับ APPEND แต่จะแทนที่เชนที่ยกเลิกหรือมีข้อกำหนดเบื้องต้นที่ไม่สำเร็จ (b/134613984, aosp/1199640)

  • มอบความสามารถในการเพิ่ม RunnableScheduler ที่กำหนดเองเพื่อติดตาม WorkRequest ที่ต้องดำเนินการในอนาคต โดยตัวกำหนดเวลาระดับกระบวนการจะใช้ข้อมูลนี้ (aosp/1203944)

  • เพิ่มการรองรับการเพิ่ม Factory แบบไดนามิกเพื่อมอบสิทธิ์ให้เมื่อใช้ DelegatingWorkerFactory (b/156289105, aosp/1309745)

  • ปรับการติดตามสำหรับข้อจำกัดของ BATTERY_NOT_LOW ให้สอดคล้องกับแพลตฟอร์มมากขึ้น (aosp/1312583)

  • ตอนนี้เครื่องจัดตารางเวลาในกระบวนการใช้ API ที่ดีขึ้นเพื่อกำหนดชื่อของกระบวนการ ซึ่งจะเป็นประโยชน์ในการรองรับแอปที่ใช้หลายกระบวนการได้ดียิ่งขึ้น (aosp/1324732)

  • กฎ Lint ใหม่ที่บังคับใช้

    • การใช้foregroundServiceTypeที่เหมาะสมเมื่อใช้ API ของ setForegroundAsync() (b/147873061, aosp/1215915)
    • การระบุรหัส JobScheduler ที่ WorkManager ควรใช้เมื่อใช้ JobService API โดยตรง aosp/1223567
    • เพิ่มกฎการตรวจสอบใหม่เพื่อให้แน่ใจว่าListenableWorkerการใช้งานจะpublicเมื่อใช้ WorkerFactory เริ่มต้น (aosp/1291262)

  • ตอนนี้ระบบจะส่งสัญญาณการเรียกไปยัง setForegroundAsync() ที่ไม่เสร็จสมบูรณ์ก่อนที่ ListenableWorker จะเสร็จสมบูรณ์ผ่าน IllegalStateException ใน ListenableFuture ที่ส่งคืน (aosp/1262743)

  • แก้ไขข้อบกพร่องที่ทำให้ ForegroundService ไม่หยุดทำงานหลังจากที่ Worker เบื้องหน้าถูกขัดจังหวะ (b/155579898, aosp/1302153)

  • แก้ไขข้อบกพร่องที่ WorkManager พยายามเรียกใช้หลายอินสแตนซ์ของ Worker ที่เชื่อมโยงกับ Foreground Service (b/156310133, aosp/1309853)

เวอร์ชัน 2.4.0-rc01

24 มิถุนายน 2020

androidx.work:work-*:2.4.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.4.0-rc01 มีคอมมิตต่อไปนี้

แก้ไขข้อบกพร่อง

  • ตอนนี้เครื่องจัดตารางเวลาในกระบวนการใช้ API ที่ดีขึ้นเพื่อกำหนดชื่อของกระบวนการ ซึ่งจะเป็นประโยชน์ในการรองรับแอปที่ใช้หลายกระบวนการได้ดียิ่งขึ้น (aosp/1324732)

เวอร์ชัน 2.4.0-beta01

20 พฤษภาคม 2020

androidx.work:work-gcm:2.4.0-beta01, androidx.work:work-runtime:2.4.0-beta01, androidx.work:work-runtime-ktx:2.4.0-beta01, androidx.work:work-rxjava2:2.4.0-beta01 และ androidx.work:work-testing:2.4.0-beta01 เวอร์ชัน 2.4.0-beta01 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่ทำให้ ForegroundService ไม่หยุดทำงานหลังจากที่ Worker เบื้องหน้าถูกขัดจังหวะ (b/155579898, aosp/1302153)
  • แก้ไขข้อบกพร่องที่ WorkManager พยายามเรียกใช้หลายอินสแตนซ์ของ Worker ที่เชื่อมโยงกับ Foreground Service (b/156310133, aosp/1309853)
  • เพิ่มการรองรับการเพิ่ม Factory แบบไดนามิกเพื่อมอบสิทธิ์ให้เมื่อใช้ DelegatingWorkerFactory (b/156289105, aosp/1309745)
  • ปรับการติดตามสำหรับข้อจำกัดของ BATTERY_NOT_LOW ให้สอดคล้องกับแพลตฟอร์มมากขึ้น (aosp/1312583)

เวอร์ชัน 2.4.0-alpha03

29 เมษายน 2020

androidx.work:work-*:2.4.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha03 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ WorkManager รองรับ RxJava 3 แล้ว หากต้องการใช้ RxJava 3 คุณควรใส่การอ้างอิง implementation "androidx.work:work-rxjava3:2.4.0-alpha03" ต่อไปนี้ (aosp/1277904)
  • เพิ่มกฎการตรวจสอบใหม่เพื่อให้แน่ใจว่าListenableWorkerการใช้งานจะpublicเมื่อใช้ WorkerFactory เริ่มต้น (aosp/1291262)

การเปลี่ยนแปลง API

  • การเรียกใช้ setProgressAsync() หลังจากที่ ListenableWorker ดำเนินการเสร็จสิ้นแล้วจะส่งสัญญาณ Exception ผ่าน ListenableFuture (aosp/1285494)
  • ตอนนี้ WorkQuery.Builder มีเครื่องหมาย final แล้ว (aosp/1275037)
  • เปลี่ยนชื่อWorkQuery.BuilderเมธอดจากโรงงานwithStates withTags และ withUniqueWorkNames เป็น fromStates, fromTags และ fromUniqueWorkNames ตามลำดับ (aosp/1280287)

แก้ไขข้อบกพร่อง

  • ไม่สนใจ SecurityException เมื่อติดตามสถานะเครือข่ายของอุปกรณ์ (b/153246136, aosp/1280813)

เวอร์ชัน 2.4.0-alpha02

1 เมษายน 2020

androidx.work:work-*:2.4.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มกฎ Lint ใหม่ที่จะแสดงคำเตือนเมื่อ WorkRequest ต้องใช้ทั้ง Constraints.setRequiresCharging(...) และ Constraints.setRequiresDeviceIdle(...) อุปกรณ์บางเครื่องจะไม่ชาร์จและไม่ได้ใช้งานพร้อมกัน ดังนั้นคำขอดังกล่าวจึงทำงานน้อยกว่าที่คาดไว้ (aosp/1253840)

การเปลี่ยนแปลง API

  • เพิ่มความสามารถในการค้นหา WorkInfo โดยใช้ WorkQuery ซึ่งจะเป็นประโยชน์เมื่อนักพัฒนาแอปต้องการค้นหา WorkInfo โดยใช้การรวมแอตทริบิวต์หลายรายการ ดูข้อมูลเพิ่มเติมได้ที่ WorkQuery.Builder withStates(...), WorkQuery.Builder withTags(...) หรือ WorkQuery.Builder withUniqueWorkNames(...) (aosp/1253230, b/143847546)

  • ตอนนี้ระบบจะส่งสัญญาณการเรียกไปยัง setForegroundAsync() ที่ไม่เสร็จสมบูรณ์ก่อนที่ ListenableWorker จะเสร็จสมบูรณ์ผ่าน IllegalStateException ใน ListenableFuture ที่ส่งคืน (aosp/1262743)

แก้ไขข้อบกพร่อง

  • แก้ไขกฎการตรวจสอบที่ตรวจหาระยะเวลาช่วงที่ไม่ถูกต้องสำหรับ PeriodicWorkRequest (aosp/1254846, b/152606442)

เวอร์ชัน 2.4.0-alpha01

4 มีนาคม 2020

androidx.work:work-*:2.4.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ตัวกำหนดตารางเวลาในกระบวนการของ WorkManager มีประสิทธิภาพมากขึ้นแล้ว ก่อนหน้านี้ตัวกำหนดเวลาระหว่างกระบวนการจะพิจารณาเฉพาะการดำเนินการที่ไม่ล่าช้าและเป็นไปตามข้อจำกัด ตอนนี้ตัวกำหนดเวลากระบวนการติดตาม WorkRequest ที่อาจดำเนินการในอนาคต รวมถึง PeriodicWorkRequest นอกจากนี้ Scheduler ในกระบวนการยังไม่สังเกตขีดจำกัดการจัดกำหนดการ (แต่ยังคงจำกัดขนาดของ Executor ที่ WorkManager ใช้) ซึ่งหมายความว่าตอนนี้แอปพลิเคชันสามารถดำเนินการWorkRequestได้มากขึ้นเมื่อแอปอยู่เบื้องหน้า (aosp/1185778)

  • เพิ่มความสามารถในการขอข้อมูลการวินิจฉัยจาก WorkManager โดยใช้ adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>" ซึ่งมีข้อมูลที่เป็นประโยชน์มากมาย เช่น

    • คำของานที่เสร็จสมบูรณ์ในช่วง 24 ชั่วโมงที่ผ่านมา
    • WorkRequest ที่กำลังทำงานอยู่
    • WorkRequest ที่กำหนดเวลาไว้ (aosp/1235501)

  • กฎ Lint ใหม่ที่บังคับใช้

    • การใช้foregroundServiceTypeที่เหมาะสมเมื่อใช้ API ของ setForegroundAsync() (b/147873061, aosp/1215915)
    • ระบุ JobScheduler รหัสที่ WorkManager ควรใช้เมื่อใช้ JobService API โดยตรง (aosp/1223567)

การเปลี่ยนแปลง API

  • เพิ่ม ExistingWorkPolicy.APPEND_OR_REPLACE ซึ่งคล้ายกับ APPEND แต่แทนที่เชนที่มีข้อกำหนดเบื้องต้นที่ถูกยกเลิกหรือล้มเหลว (b/134613984, aosp/1199640)

  • ให้ความสามารถในการเพิ่มRunnableSchedulerที่กำหนดเองเพื่อติดตามWorkRequestที่ต้องดำเนินการในอนาคต โดยตัวกำหนดเวลาระดับกระบวนการจะใช้ข้อมูลนี้ (aosp/1203944)

แก้ไขข้อบกพร่อง

  • เลิกใช้งาน setProgress() ใน RxWorker เนื่องจากก่อนหน้านี้ฟังก์ชันนี้จะแสดงผล Single<Void> ซึ่งเป็นประเภทที่เป็นไปไม่ได้ เพิ่ม API ใหม่ setCompletableProgress() ซึ่งจะแสดงผล Completable แทน และเพิ่มกฎ Lint ใหม่ที่จะช่วยในการย้ายข้อมูลไปยัง API ใหม่ (b/150080946, aosp/1242665)

เวอร์ชัน 2.3.4

เวอร์ชัน 2.3.4

18 มีนาคม 2020

androidx.work:work-*:2.3.4 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.3.4 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่ทำให้ Workers ที่ทำงานเป็นเวลานานหลายอินสแตนซ์ทำงานหลังจากเกินกรอบเวลาการดำเนินการ 10 นาที (aosp/1247484, b/150553353)
  • แก้ไข Lint ของ WorkManager IssueRegistry ขอขอบคุณ @ZacSweers จาก Slack สำหรับการมีส่วนร่วม (aosp/1217923)

เวอร์ชัน 2.3.3

เวอร์ชัน 2.3.3

4 มีนาคม 2020

androidx.work:work-*:2.3.3 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.3.3 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องในเรื่องที่หากWorkerถูกขัดจังหวะ ระบบจะไม่กำหนดเวลาใหม่ให้ถูกต้อง (b/150325687, aosp/1246571)

เวอร์ชัน 2.3.2

เวอร์ชัน 2.3.2

19 กุมภาพันธ์ 2020

androidx.work:work-*:2.3.2 ได้รับการเผยแพร่ เวอร์ชัน 2.3.2 มีคอมมิตต่อไปนี้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ WorkManager เกินขีดจำกัดงาน 100 รายการใน JobScheduler ในบางกรณี (aosp/1226859, b/149092520)
  • แก้ไขเงื่อนไขการแข่งขันใน ConstraintControllers (aosp/1220100)
  • ปรับปรุงวงจรบริการที่ทำงานอยู่เบื้องหน้าในการจัดการสำหรับ Worker ที่ทำงานเป็นเวลานาน (aosp/1226295)
  • ปรับปรุงการจัดการการยกเลิกการแจ้งเตือนสำหรับ Worker ที่ทำงานเป็นเวลานานเมื่อมีการยกเลิก Worker (aosp/1228346)

เวอร์ชัน 2.3.1

เวอร์ชัน 2.3.1

5 กุมภาพันธ์ 2020

androidx.work:work-*:2.3.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.3.1 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • จัดการวงจรของ Notificationสำหรับ Worker ที่ทำงานเป็นเวลานานได้ดีขึ้น ซึ่งจะทำงานเมื่อ Service ที่ทำงานอยู่เบื้องหน้าใช้งานอยู่ (aosp/1218539, b/147249312)
  • ตอนนี้ WorkManager ต้องใช้ androidx.sqlite:sqlite-framework:2.1.0 เวอร์ชันเสถียร (aosp/1217729)
  • เพิ่มกฎการตรวจสอบโค้ดเพื่อให้แน่ใจว่าได้ระบุ foregroundServiceType ใน AndroidManifest.xml เมื่อใช้ foregroundServiceType ใน ForegroundInfo (aosp/1214207, b/147873061)

เวอร์ชัน 2.3.0

เวอร์ชัน 2.3.0

22 มกราคม 2020

androidx.work:work-*:2.3.0 เปิดตัวโดยไม่มีการเปลี่ยนแปลงใดๆ ตั้งแต่ 2.3.0-rc01 เวอร์ชัน 2.3.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.2.0

  • การสนับสนุนสำหรับงานที่ใช้เวลานานหรืองานสำคัญผ่าน ListenableWorker#setForegroundAsync()
  • การสนับสนุนความคืบหน้าของผู้ปฏิบัติงานผ่าน ListenableWorker#setProgressAsync()
  • ตอนนี้ WorkManager จะรวมกฎ Lint เพิ่มเติมเป็นส่วนหนึ่งของไลบรารี ซึ่งจะช่วยตรวจจับข้อบกพร่องได้ตั้งแต่เนิ่นๆ

เวอร์ชัน 2.3.0-rc01

8 มกราคม 2020

androidx.work:work-*:2.3.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.3.0-rc01 มีคอมมิตเหล่านี้

รุ่นนี้เหมือนกับ 2.3.0-beta02

แก้ไขข้อบกพร่อง

  • ตอนนี้อาร์ติแฟกต์ work-testing จะกำหนดทรัพยากร Dependency ใน api บน work-runtime-ktx (aosp/1194410)

เวอร์ชัน 2.3.0-beta02

18 ธันวาคม 2019

androidx.work:work-*:2.3.0-beta02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.3.0-beta02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มข้อความแสดงข้อผิดพลาดที่ดีขึ้นสำหรับข้อยกเว้น SQLite ที่กู้คืนไม่ได้ (aosp/1185777)
  • เพิ่มกฎการตรวจสอบโค้ดที่ช่วยให้มั่นใจได้ว่าระบบจะนำ Content Provider androidx.work.impl.WorkManagerInitializer ออกจาก AndroidManifest.xml เมื่อใช้การเริ่มต้นตามต้องการ (aosp/1167007)
  • เพิ่มคำเตือน Lint เมื่อใช้ enqueue() สำหรับ PeriodicWorkRequest แทน enqueueUniquePeriodicWork() (aosp/1166032)

การเปลี่ยนแปลง API

  • ForegroundInfo กำหนดให้คุณต้องระบุ notificationId ที่จะใช้เมื่อใช้ ListenableWorker.setForegroundAsync() นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ซึ่งช่วยให้คุณเรียกใช้ Worker ที่ทำงานเป็นเวลานานหลายรายการพร้อมกันได้ WorkManager ยังจัดการอายุการใช้งานของ Notification ที่ระบุได้ดีขึ้นด้วย (b/145473554, aosp/1181208, asop/1181216, asop/1183577)

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องในการใช้งาน AlarmManager ที่สัญญาณเตือนไม่ได้รับการล้างข้อมูลอย่างถูกต้อง (aosp/1156444)
  • แก้ไขข้อบกพร่องที่ทำให้รายการ WorkRequest ว่างเปล่าทำให้สร้างเชน WorkContinuation ไม่ถูกต้อง (b/142835274, aosp/1157051)

การเปลี่ยนแปลงการขึ้นต่อกัน

  • ตอนนี้ WorkManager ใช้ Room 2.2.2 แล้ว

เวอร์ชัน 2.3.0-beta01

20 พฤศจิกายน 2019

androidx.work:work-*:2.3.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.3.0-beta01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มกฎการตรวจสอบใหม่ซึ่งป้องกันข้อผิดพลาดของนักพัฒนาซอฟต์แวร์เนื่องจากการใช้งาน androidx.work.Configuration.Provider ไม่ถูกต้องเมื่อใช้การเริ่มต้นตามต้องการ aosp/1164559

เวอร์ชัน 2.3.0-alpha03

23 ตุลาคม 2019

androidx.work:work-*:2.3.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha03 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่ม WorkManager.createCancelPendingIntent() API ซึ่งช่วยให้ยกเลิก WorkRequest ได้ง่ายๆ โดยไม่ต้องลงทะเบียนคอมโพเนนต์อื่นใน AndroidManifest.xml API นี้ช่วยให้ยกเลิก WorkRequest จาก Notification ได้ง่ายเป็นพิเศษ เราคาดว่าฟีเจอร์นี้จะทำงานร่วมกับ API ใหม่ในเบื้องหน้าในเวอร์ชัน 2.3.0
  • ตอนนี้ WorkManager ขึ้นอยู่กับ androidx.room:*:2.2.0 เวอร์ชันที่เสถียรแล้ว

การเปลี่ยนแปลง API

  • เปลี่ยนชื่อ ForegroundInfo.getNotificationType() เป็น ForegroundInfo.getForegroundServiceType() เพื่อให้สอดคล้องกับ API ของแพลตฟอร์มพื้นฐานมากขึ้น (b/142729893, aosp/1143316)

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่เกิดจากการเรียกใช้ setTransactionSuccessful() โดยไม่จำเป็นนอกธุรกรรม ซึ่งจะเกิดขึ้นกับการย้ายข้อมูลที่พบได้ยาก (b/142580433, aosp/1141737)

เวอร์ชัน 2.3.0-alpha02

9 ตุลาคม 2019

androidx.work:work-*:2.3.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ WorkManager รองรับการเรียกใช้งานที่ใช้เวลานานหรืองานสำคัญที่ควรให้ระบบปฏิบัติการทำงานต่อไป ดูข้อมูลเพิ่มเติมได้ที่ ListenableWorker#setForegroundAsync() (หรือ CoroutineWorker#setForeground() สำหรับ Kotlin) (aosp/1133636)

การเปลี่ยนแปลง API

  • เราได้เปลี่ยนชื่อ containsKey API ใน Data เป็น hasKeyWithValueOfType แล้ว นอกจากนี้ เรายังได้เปลี่ยนชื่อวิธีการขยายที่เกี่ยวข้องในktxด้วย (b/141916545)

แก้ไขข้อบกพร่อง

  • WorkManager จะจัดกำหนดเวลาการทำงานอย่างเป็นธรรมเมื่อจำนวน WorkRequest ที่จัดคิวไว้ใกล้ถึงขีดจำกัดการจัดกำหนดเวลา (aosp/1105766)
  • WorkManager จะเรียกใช้ ListenableWorker#onStopped() ก็ต่อเมื่อยังไม่ได้ทำงานให้เสร็จสมบูรณ์ (b/140055777)
  • ตอนนี้ WorkManager จะนำข้อมูลความคืบหน้าออกเมื่อ Worker ถูกขัดจังหวะหรือเข้าถึงสถานะสิ้นสุด (aosp/1114572)
  • Data ตอนนี้มีtoString()การแสดงข้อมูลที่เป็นประโยชน์มากขึ้น (b/140945323)
  • Data มีequals()วิธีที่ดีกว่าแล้ว นอกจากนี้ยังรองรับ deepEquals สำหรับประเภท Array ด้วย (b/140922528)
  • ตอนนี้ WorkManager จัดเก็บฐานข้อมูลภายในและไฟล์การตั้งค่าไว้ในไดเรกทอรีที่ไม่มีการสำรองข้อมูล (b/114808216)

เวอร์ชัน 2.3.0-alpha01

22 สิงหาคม 2019

androidx.work:work-*:2.3.September 5, 20190-alpha01 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่

ฟีเจอร์ใหม่

  • ListenableWorker สามารถตั้งค่าความคืบหน้าผ่าน setProgressAsync() API ได้แล้ว นอกจากนี้ ยังได้เพิ่ม suspend API ที่เกี่ยวข้องใน CoroutineWorker และ setProgress ใน RxWorker ซึ่งจะแสดงผล Single<Void>setProgress API ใหม่เหล่านี้ช่วยให้ Workers สามารถสื่อสารข้อมูลความคืบหน้าผ่าน WorkInfo ซึ่งมี API getProgress ที่เกี่ยวข้อง (b/79481554)
  • Data มี containsKey() API ที่ใช้ตรวจสอบว่าข้อมูลนำเข้าของ Worker มีคีย์ที่มีประเภทที่คาดไว้ (b/117136838)
  • ตอนนี้คุณสามารถจัดลำดับ Data ได้โดยใช้ Data.toByteArray() และ Data.fromByteArray() โปรดทราบว่า Data ไม่มีการรับประกันการควบคุมเวอร์ชัน ดังนั้นคุณไม่ควรบันทึกไว้หรือใช้สำหรับการสื่อสารระหว่างกระบวนการ (IPC) ระหว่างแอปพลิเคชัน โดยจะใช้ได้อย่างปลอดภัยเฉพาะในกระบวนการต่างๆ ของแอปพลิเคชันเดียวกัน
  • เพิ่มความสามารถในการระบุ InputMergerFactory ผ่าน Configuration.setInputMergerFactory (b/133273159)

การเปลี่ยนแปลง API

  • WorkManager จะส่งอินสแตนซ์ของ IllegalStateException หาก WorkerFactory ส่งอินสแตนซ์ของ ListenableWorker ซึ่งเรียกใช้ก่อนหน้านี้ (b/139554406)
  • การอัปเดตเอกสารประกอบเกี่ยวกับการListenableFutureยกเลิกและonStopped()การเรียกกลับใน ListenableWorker (b/138413671)

แก้ไขข้อบกพร่อง

  • ตอนนี้ตัวกำหนดเวลาระหว่างกระบวนการจะไม่สนใจ WorkRequest ที่มีข้อจำกัด idle ตอนนี้ JobScheduler จะรับคำขอเหล่านี้เมื่ออุปกรณ์idle จริงๆ เท่านั้น (aosp/1089779)
  • TestScheduler ตอนนี้ใช้ Executor ที่ระบุอย่างถูกต้องสำหรับตัวเรียกใช้งานภายในในงานทดสอบแล้ว (aosp/1090749)

เวอร์ชัน 2.2.0

เวอร์ชัน 2.2.0

15 สิงหาคม 2019

androidx.work:work-*:2.2.0 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่

ผลงานนี้เหมือนกับ androidx.work:work-*:2.2.0-rc01 ทุกประการ

การเปลี่ยนแปลงที่สำคัญในเวอร์ชัน 2.2.0 จากเวอร์ชัน 2.1.0

androidx.work:work-gcm:2.2.0 คืออาร์ติแฟกต์ Maven ใหม่ที่รองรับการใช้ GCMNetworkManager เป็นตัวกำหนดตารางเวลาเมื่อบริการ Google Play พร้อมใช้งานสำหรับระดับ API <= 22 นี่คือการขึ้นต่อกันที่ไม่บังคับซึ่งช่วยให้การประมวลผลเบื้องหลังมีความน่าเชื่อถือและมีประสิทธิภาพมากขึ้นใน API เวอร์ชันเก่า หากแอปใช้บริการ Google Play ให้เพิ่มทรัพยากร Dependency นี้ลงในไฟล์ Gradle เพื่อรับการสนับสนุน GCMNetworkManager โดยอัตโนมัติ หากบริการ Google Play ไม่พร้อมใช้งาน WorkManager จะยังคงกลับไปใช้ AlarmManager ในอุปกรณ์รุ่นเก่า

เวอร์ชัน 2.2.0-rc01

30 กรกฎาคม 2019

androidx.work:work-*:2.2.0-rc01 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องในการติดตั้งใช้งาน AlarmManager ที่ทำให้ Service ปิดตัวก่อนเวลาอันควรและส่งผลให้เกิด RejectedExecutionException ในบางกรณี (aosp/1092374) (b/138238197)
  • เพิ่มวิธีแก้ปัญหาชั่วคราวสำหรับ NullPointerException เมื่อใช้ API ของ JobScheduler ในอุปกรณ์บางรุ่น (aosp/1091020) (b/138364061), (b/138441699)

เวอร์ชัน 2.2.0-beta02

19 กรกฎาคม 2019

androidx.work:work-*:2.2.0-beta02 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่

แก้ไขข้อบกพร่อง

  • นำการขึ้นต่อกันของ Jacoco ที่ไม่ได้ตั้งใจออก ซึ่งมีการนำมาใช้ใน 2.2.0-beta01

เวอร์ชัน 2.2.0-beta01

17 กรกฎาคม 2019

androidx.work:work-*:2.2.0-beta01 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่

ฟีเจอร์ใหม่

  • androidx.work:work-gcm:2.2.0-beta01 คืออาร์ติแฟกต์ Maven ใหม่ที่รองรับการใช้ GCMNetworkManager เป็นตัวกำหนดตารางเวลาเมื่อบริการ Google Play พร้อมใช้งานสำหรับระดับ API <= 22 ซึ่งเป็นทรัพยากร Dependency ที่ไม่บังคับที่จะช่วยให้การประมวลผลในเบื้องหลังมีความน่าเชื่อถือและมีประสิทธิภาพมากขึ้นใน API เวอร์ชันเก่า หากแอปใช้บริการ Google Play ให้เพิ่มทรัพยากร Dependency นี้ลงในไฟล์ Gradle เพื่อรับการสนับสนุน GCMNetworkManager โดยอัตโนมัติ หากบริการ Google Play ไม่พร้อมใช้งาน WorkManager จะยังคงกลับไปใช้ AlarmManager ในอุปกรณ์รุ่นเก่า

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาสำหรับ IllegalArgumentException เมื่อติดตามสถานะเครือข่ายในแท็บเล็ต Nvidia Shield K1 (aosp/1010188)

เวอร์ชัน 2.1.0

เวอร์ชัน 2.1.0

11 กรกฎาคม 2019

androidx.work:work-*:2.1.0 ได้รับการเผยแพร่แล้ว ผลงานนี้เหมือนกับ androidx.work:work-*:2.1.0-rc01 ทุกประการ

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.0.1

  • work-runtime-ktx ตอนนี้ต้องใช้ Java 8 หากพบปัญหา คุณสามารถเพิ่มข้อมูลต่อไปนี้ในbuild.gradleได้ kotlinOptions { jvmTarget = "1.8" }
  • เพิ่มการเริ่มต้นตามต้องการสำหรับ WorkManager ซึ่งจะสร้าง WorkManager เมื่อมีการอ้างอิงเท่านั้น b/127497100 หากต้องการตั้งค่าโปรเจ็กต์สำหรับการเริ่มต้นตามต้องการ ให้ทำดังนี้
    1. ปิดใช้ตัวเริ่มต้นอัตโนมัติ
    2. ใช้ Configuration.Provider ในออบเจ็กต์ Application ที่กำหนดเอง
    3. เปลี่ยนการอ้างอิงทั้งหมดของ WorkManager.getInstance() เป็น WorkManager.getInstance(Context) ส่วนหนึ่งของการเปลี่ยนแปลงนี้คือเราได้ เลิกใช้งาน WorkManager.getInstance() การโทรหาหมายเลขใหม่ WorkManager.getInstance(Context)ที่ใช้แทนจะปลอดภัยกว่าเสมอ แม้ว่าคุณจะไม่ได้ เริ่มต้นใช้งานตามต้องการก็ตาม
  • PeriodicWorkRequest รองรับการหน่วงเวลาเริ่มต้นแล้ว คุณสามารถใช้วิธี setInitialDelayใน PeriodicWorkRequest.Builder เพื่อตั้งค่า การหน่วงเวลาเริ่มต้นได้ b/111404867
  • เพิ่มความสามารถในการมอบสิทธิ์ให้ WorkerFactorys ที่ลงทะเบียนอย่างน้อย 1 รายโดยใช้ DelegatingWorkerFactory b/131435993
  • เพิ่มความสามารถในการปรับแต่ง Executor ที่ WorkManager ใช้สำหรับ การบันทึกบัญชีภายในทั้งหมดผ่าน Configuration.Builder.setTaskExecutor
  • เพิ่มความสามารถในการสร้างคลาส Worker และ ListenableWorker ที่ทดสอบหน่วยได้โดยใช้ TestWorkerBuilder และ TestListenableWorkerBuilder ในอาร์ติแฟกต์ work-testing
    • โปรดทราบว่า work-testing จะดึง Kotlin มาเป็นทรัพยากร Dependency และ รวมส่วนขยาย Kotlin หลายรายการโดยค่าเริ่มต้น
  • เพิ่มจำนวนความพยายามในการเรียกใช้ไปยัง WorkInfo b/127290461
  • ตอนนี้ Data ประเภทจัดเก็บและเรียกข้อมูลไบต์และอาร์เรย์ไบต์ได้แล้ว การดำเนินการนี้จะไม่เปลี่ยนขนาดสูงสุดของDataออบเจ็กต์
  • ตอนนี้ WorkManager ขึ้นอยู่กับ Room 2.1.0 ซึ่งน่าจะช่วยแก้ไขปัญหาเกี่ยวกับฐานข้อมูลได้

เวอร์ชัน 2.1.0-rc01

27 มิถุนายน 2019

androidx.work:work-*:2.1.0-rc01 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่

แก้ไขข้อบกพร่อง

  • แก้ไขข้อบกพร่องที่ทำให้แอปพลิเคชันขัดข้องเมื่อเรียกใช้งานที่มี JobScheduler ขณะที่กำลังสำรองข้อมูล b/135858602

เวอร์ชัน 2.1.0-beta02

20 มิถุนายน 2019

androidx.work:work-*:2.1.0-beta02 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่

แก้ไขข้อบกพร่อง

  • TestListenableWorkerBuilder ตอนนี้ใช้ WorkerFactory ที่ถูกต้องเมื่อสร้างอินสแตนซ์ของ ListenableWorker b/135275844
  • แก้ไขข้อบกพร่องที่ทำให้เกิดการเลื่อนในกรอบเวลาการดำเนินการสำหรับ WorkRequest เนื่องจากกระบวนการสิ้นสุดลง b/135272196

เวอร์ชัน 2.1.0-beta01

13 มิถุนายน 2019

androidx.work:work-*:2.1.0-beta01 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่

แก้ไขข้อบกพร่อง

  • ตอนนี้ WorkManager ขึ้นอยู่กับ Room 2.1.0 ซึ่งน่าจะช่วยแก้ไขปัญหาเกี่ยวกับฐานข้อมูลได้
  • นำ I/O ของดิสก์เริ่มต้นบางรายการในเทรดหลักออกแล้ว
  • แก้ไขปัญหาการหยุดชะงักที่อาจเกิดขึ้นในการติดตามข้อจำกัด b/134361006
  • ยกเลิกงานที่ไม่ถูกต้องซึ่งระบุแหล่งที่มาเป็น WorkManager ล่วงหน้า b/134058261
  • เพิ่มการเรียกที่ป้องกันบางอย่างไปยัง API ของ JobScheduler สำหรับอุปกรณ์ที่ทำงานไม่ถูกต้อง

เวอร์ชัน 2.1.0-alpha03

5 มิถุนายน 2019

androidx.work:*:2.1.0-alpha03 ได้รับการเผยแพร่แล้ว

แก้ไขข้อบกพร่อง

  • ปรับปรุงเอกสารประกอบสำหรับ PeriodicWorkRequest
  • WorkManagerTestInitHelper ตอนนี้ใช้ตัวดำเนินการเบื้องหลังที่ถูกต้องสำหรับการทดสอบแล้ว
  • การแก้ไขปัญหา SQLite เมื่อจัดการธุรกรรมขนาดใหญ่ในอุปกรณ์บางรุ่น (b/130182503)
  • ตอนนี้ทรัพยากร Dependency ของ WorkManager มีความละเอียดยิ่งขึ้น (b/133169148)
  • วิธีแก้ปัญหาข้อบกพร่องเฉพาะของ OEM ในการติดตั้งใช้งาน JobScheduler เมื่อกำหนดเวลางานโดยใช้ WorkManager
  • การปรับปรุงตัวกำหนดตารางเวลาที่อิงตาม AlarmManager เกี่ยวกับอายุการใช้งานของบริการซึ่งก่อนหน้านี้ทำให้เกิดข้อขัดข้องที่พบได้ยาก (b/133313734)

เวอร์ชัน 2.1.0-alpha02

16 พฤษภาคม 2019

เปิดตัว WorkManager 2.1.0-alpha02 เวอร์ชันนี้มี API ใหม่หลายรายการ

การเปลี่ยนแปลง API

  • PeriodicWorkRequest รองรับการหน่วงเวลาเริ่มต้นแล้ว คุณสามารถใช้วิธี setInitialDelayใน PeriodicWorkRequest.Builder เพื่อตั้งค่า การหน่วงเวลาเริ่มต้นได้ b/111404867

  • เพิ่มความสามารถในการมอบสิทธิ์ให้ WorkerFactorys ที่ลงทะเบียนอย่างน้อย 1 รายโดยใช้ DelegatingWorkerFactory b/131435993

  • เพิ่มความสามารถในการปรับแต่ง Executor ที่ WorkManager ใช้สำหรับ การบันทึกบัญชีภายในทั้งหมดผ่าน Configuration.Builder.setTaskExecutor

  • ปรับปรุงเอกสารเกี่ยวกับ WorkRequest.keepResultsForAtLeast (b/130638001) การเริ่มต้นตามต้องการ และ PeriodicWorkRequest.Builder (b/131711394)

เวอร์ชัน 2.1.0-alpha01

24 เมษายน 2019

เปิดตัว WorkManager 2.1.0-alpha01 เวอร์ชันนี้มี API ใหม่หลายรายการ โปรดทราบว่าตั้งแต่เวอร์ชันนี้เป็นต้นไป จะมีฟีเจอร์ใหม่ๆ ที่ จะไม่ได้รับการพอร์ตย้อนกลับไปยังรุ่น 1.x เราขอแนะนำให้เปลี่ยนไปใช้ 2.x

การเปลี่ยนแปลง API

  • เพิ่มการเริ่มต้นตามต้องการสำหรับ WorkManager ซึ่งจะสร้าง WorkManager เมื่อมีการอ้างอิงเท่านั้น b/127497100 หากต้องการตั้งค่าโปรเจ็กต์สำหรับการเริ่มต้นตามต้องการ ให้ทำดังนี้
    1. ปิดใช้ตัวเริ่มต้นอัตโนมัติ
    2. ใช้ Configuration.Provider ในออบเจ็กต์ Application ที่กำหนดเอง
    3. เปลี่ยนการอ้างอิงทั้งหมดของ WorkManager.getInstance() เป็น WorkManager.getInstance(Context) ส่วนหนึ่งของการเปลี่ยนแปลงนี้คือเราได้ เลิกใช้งาน WorkManager.getInstance() การโทรหาหมายเลขใหม่ WorkManager.getInstance(Context)ที่ใช้แทนจะปลอดภัยกว่าเสมอ แม้ว่าคุณจะไม่ได้ เริ่มต้นใช้งานตามต้องการก็ตาม
  • เพิ่มความสามารถในการสร้างคลาส Worker และ ListenableWorker ที่ทดสอบหน่วยได้โดยใช้ TestWorkerBuilder และ TestListenableWorkerBuilder ในอาร์ติแฟกต์ work-testing
    • โปรดทราบว่า work-testing จะดึง Kotlin มาเป็นทรัพยากร Dependency แต่ก็ รวมส่วนขยาย Kotlin หลายรายการไว้ด้วยโดยค่าเริ่มต้น
  • เพิ่มจำนวนความพยายามในการเรียกใช้ไปยัง WorkInfo b/127290461
  • ตอนนี้ Data ประเภทจัดเก็บและเรียกข้อมูลไบต์และอาร์เรย์ไบต์ได้แล้ว การดำเนินการนี้จะไม่เปลี่ยนขนาดสูงสุดของDataออบเจ็กต์
  • เลิกใช้งาน CoroutineWorker.coroutineContext แล้ว ฟิลด์นี้มีการพิมพ์อย่างไม่ถูกต้องเป็น CoroutineDispatcher คุณไม่จำเป็นต้องใช้ฟิลด์นี้อีกต่อไปเนื่องจากคุณสามารถไปที่ coroutineContext ที่ต้องการได้ด้วยตนเองในส่วนเนื้อหาของฟังก์ชันที่ระงับ
  • ตอนนี้ RxWorker.createWork() และ RxWorker.getBackgroundScheduler() มี คำอธิบายประกอบที่มีประเภทการคืนค่า @NonNull แล้ว

เวอร์ชัน 2.0.1

เวอร์ชัน 2.0.1

9 เมษายน 2019

WorkManager 2.0.1 เปิดตัวแล้ว รุ่นนี้เหมือนกับ 2.0.1-rc01

เวอร์ชัน 2.0.1-rc01

3 เมษายน 2019

WorkManager 2.0.1-rc01 เปิดตัวแล้ว เวอร์ชันนี้มีการแก้ไขข้อบกพร่องบางอย่าง สำหรับผู้ใช้เวอร์ชันเดิม 1.x การเปลี่ยนแปลงบางอย่างเหล่านี้จะปรากฏใน 1.0.1-rc01 ด้วย

แก้ไขข้อบกพร่อง

  • ตอนนี้การทดสอบ Robolectric ทำงานร่วมกับ WorkManager ได้อย่างถูกต้องแล้ว b/122553577
  • แก้ไขการขัดข้องในกรณีที่พบได้ยากซึ่งการติดตามข้อจำกัดไม่ได้รับการล้างใน API ก่อน JobScheduler b/129226383
  • แก้ไขStackOverflowErrorที่เกี่ยวข้องกับเชนงานที่ยาว b/129091233
  • อัปเดตเอกสารประกอบสำหรับ PeriodicWorkRequests เพื่อระบุว่า API 23 ไม่รองรับเวลาที่ยืดหยุ่น
  • แก้ไขลิงก์ที่เสียบางลิงก์ในเอกสารประกอบ Kotlin

เวอร์ชัน 2.0.0

เวอร์ชัน 2.0.0

20 มีนาคม 2019

WorkManager 2.0.0 เปิดตัวแล้ว เวอร์ชันนี้เหมือนกับ 2.0.0-rc01 และเป็น เวอร์ชัน AndroidX ของ 1.0.0 แบบเสถียรที่มีการอ้างอิง AndroidX เราขอแนะนำให้กำหนดเป้าหมายเวอร์ชันนี้แทนเวอร์ชัน 1.x เดิม การพัฒนาที่ใช้งานอยู่ทั้งหมดจะมุ่งเน้นไปที่เวอร์ชัน 2.x และเวอร์ชัน 1.x จะได้รับการแก้ไขข้อบกพร่องที่สำคัญในช่วงเวลาจำกัด

เวอร์ชัน 2.0.0-rc01

7 มีนาคม 2019

WorkManager 2.0.0-rc01 เปิดตัวแล้ว เวอร์ชันนี้เหมือนกับเวอร์ชัน 1.0.0 ที่เสถียรทุกประการ แต่มีทรัพยากร Dependency ของ AndroidX เมื่อเวอร์ชันนี้กลายเป็นเวอร์ชัน 2.0.0 ที่เสถียรแล้ว คุณควร รวมเวอร์ชันนี้ไว้ด้วย และเวอร์ชัน 1.x เดิมจะได้รับการแก้ไขข้อบกพร่องที่สำคัญ บางอย่างเท่านั้น การพัฒนาที่ใช้งานอยู่ทั้งหมดจะมุ่งเป้าไปที่เวอร์ชัน 2.x

การอ้างอิงก่อน AndroidX

ดูข้อมูลเกี่ยวกับการใช้ส่วนขยาย Kotlin ได้ที่เอกสารประกอบ KTX
เอกสารอ้างอิง: Java

Groovy

dependencies {
    def work_version = "1.0.1"

    // (Java only)
    implementation "android.arch.work:work-runtime:$work_version"

    // Kotlin + coroutines
    implementation "android.arch.work:work-runtime-ktx:$work_version"

    // optional - RxJava2 support
    implementation "android.arch.work:work-rxjava2:$work_version"
    // optional - Test helpers
    androidTestImplementation "android.arch.work:work-testing:$work_version"
}

Kotlin

dependencies {
    val work_version = "1.0.1"

    // (Java only)
    implementation("android.arch.work:work-runtime:$work_version")

    // Kotlin + coroutines
    implementation("android.arch.work:work-runtime-ktx:$work_version")

    // optional - RxJava2 support
    implementation("android.arch.work:work-rxjava2:$work_version")

    // optional - Test helpers
    androidTestImplementation("android.arch.work:work-testing:$work_version")
}

เวอร์ชัน 1.0.1

เวอร์ชัน 1.0.1

9 เมษายน 2019

WorkManager 1.0.1 เปิดตัวแล้ว รุ่นนี้เหมือนกับ 1.0.1-rc01

โปรดทราบว่าเราขอแนะนำให้ผู้ใช้อัปเดตเป็น WorkManager 2.x เนื่องจาก เราจะอัปเดตเวอร์ชัน 1.x น้อยมากในอนาคต นอกจากนี้ จะไม่มีการเปิดตัว API ใหม่สำหรับไลบรารี 1.x ด้วย

เวอร์ชัน 1.0.1-rc01

2 เมษายน 2019

WorkManager 1.0.1-rc01 เปิดตัวแล้ว เวอร์ชันนี้มีการแก้ไขข้อบกพร่องบางอย่าง

แก้ไขข้อบกพร่อง

  • ตอนนี้การทดสอบ Robolectric ทำงานร่วมกับ WorkManager ได้อย่างถูกต้องแล้ว b/122553577
  • แก้ไขการขัดข้องในกรณีที่พบได้ยากซึ่งการติดตามข้อจำกัดไม่ได้รับการล้างใน API ก่อน JobScheduler b/129226383
  • แก้ไขStackOverflowErrorที่เกี่ยวข้องกับเชนงานที่ยาว b/129091233

เวอร์ชัน 1.0.0

เวอร์ชัน 1.0.0

5 มีนาคม 2019

นี่คือ WorkManager เวอร์ชัน 1.0.0 ที่เสถียรแล้ว WorkManager เวอร์ชันนี้เหมือนกับ 1.0.0-rc02

เวอร์ชัน 1.0.0-rc02

21 กุมภาพันธ์ 2019

นี่คือรุ่นที่อาจได้รับการเผยแพร่รุ่นที่ 2 สำหรับ WorkManager เวอร์ชัน 1.0.0 ที่เสถียรแล้ว รุ่นนี้มีการแก้ไขข้อบกพร่อง 2 รายการ

แก้ไขข้อบกพร่อง

  • Workerได้รับการตั้งเวลาอย่างถูกต้องแล้วหลังจากแอปพลิเคชันขัดข้อง b/124546316

  • Worker ที่ส่ง Exception ที่ไม่ได้ตรวจสอบจะได้รับการทำเครื่องหมายอย่างถูกต้องเป็น FAILED และจะไม่ทำให้กระบวนการของแอปขัดข้องอีกต่อไป

เวอร์ชัน 1.0.0-rc01

14 กุมภาพันธ์ 2019

นี่คือรุ่นที่อาจได้รับการเผยแพร่สำหรับ WorkManager เวอร์ชันเสถียร 1.0.0 รุ่นนี้มีการแก้ไขข้อบกพร่อง 1 รายการ

แก้ไขข้อบกพร่อง

  • ตอนนี้การใช้งานที่อิงตาม AlarmManager จะพิจารณาflex windows สำหรับ PeriodicWorkRequest อย่างถูกต้องแล้ว b/124274584

เวอร์ชัน 1.0.0-beta05

6 กุมภาพันธ์ 2019

รุ่นนี้มีการแก้ไขข้อบกพร่องบางอย่าง

แก้ไขข้อบกพร่อง

  • แก้ไขกรณีที่ใช้ JobScheduler.getPendingJob(...) ใน API 23 b/123893059
  • แก้ไขNullPointerExceptionในอุปกรณ์ที่ใช้ Android 5.1 (API ระดับ 22) หรือต่ำกว่า b/123835104

เวอร์ชัน 1.0.0-beta04

4 กุมภาพันธ์ 2019

รุ่นนี้มีการแก้ไขข้อบกพร่องบางอย่าง

แก้ไขข้อบกพร่อง

  • ปรับปรุงการตั้งเวลา PeriodicWork สำหรับการติดตั้งใช้งานที่อิงตาม AlarmManager
  • แก้ไขกรณีที่ WorkManager ติดตามข้อจำกัดไม่ถูกต้องเมื่อ ใช้การติดตั้งใช้งานที่อิงตาม AlarmManager b/123379508
  • แก้ไขกรณีที่ WorkManager ไม่สามารถลองทำงานอีกครั้งเมื่อกระบวนการสิ้นสุดลงเมื่อ ใช้การติดตั้งใช้งานที่อิงตาม AlarmManager b/123329850
  • แก้ไขกรณีที่ทำให้ WorkManager รั่วไหล Wakelocks เมื่อใช้การติดตั้งใช้งานที่อิงตาม AlarmManager

เวอร์ชัน 1.0.0-beta03

25 มกราคม 2019

รุ่นนี้มีการแก้ไขข้อบกพร่องบางอย่าง

แก้ไขข้อบกพร่อง

  • เราได้แนะนำการถดถอย 1.0.0-beta02 ซึ่งทำให้งานไม่ทำงาน อย่างถูกต้องในบางสถานการณ์ b/123211993
  • แก้ไขกรณีที่งานไม่ปฏิบัติตามเวลาการหยุดชั่วคราวอย่างถูกต้อง b/122881597
  • แก้ไขConcurrentModificationExceptionในอุปกรณ์ที่ใช้ Android 5.1 (API or) หรือต่ำกว่า ซึ่งเป็นการแก้ไขต่อเนื่องจากใน 1.0.0-beta02 b/121345393
  • เพิ่ม exported=false สำหรับคอมโพเนนต์บางอย่างในไฟล์ Manifest ที่ไม่มี คำอธิบายประกอบนี้
  • รวมข้อมูลเกี่ยวกับวิธีที่ WorkManager โต้ตอบกับระบบปฏิบัติการไว้ใน เอกสารประกอบระดับแพ็กเกจ

เวอร์ชัน 1.0.0-beta02

15 มกราคม 2019

รุ่นนี้มีการแก้ไขข้อบกพร่องบางอย่าง

แก้ไขข้อบกพร่อง

  • แก้ไขกรณีขอบที่งานเป็นระยะอาจทำงานมากกว่า 1 ครั้งต่อช่วงเวลา ในอุปกรณ์ที่ใช้ Android 6.0 (API ระดับ 23) b/121998363
  • แก้ไขConcurrentModificationExceptionในอุปกรณ์ที่ใช้ Android 5.1 (API ระดับ 22) หรือต่ำกว่า b/121345393
  • แก้ไขการดำเนินการที่ไม่ถูกต้องของงานเมื่อไม่เป็นไปตามข้อจำกัดในอุปกรณ์ที่ใช้ Android 5.1 (API ระดับ 22) หรือต่ำกว่า b/122578012
  • การจัดการการทำงานที่เพิ่มประสิทธิภาพแล้วเพื่อให้เสร็จเร็วขึ้นในบางกรณีที่พบได้ยาก b/122358129
  • เพิ่มการเปลี่ยนแปลงเพื่อจัดการกับเงื่อนไขการแข่งขันที่อาจเกิดขึ้นในอินสแตนซ์หลายรายการของ LiveData ที่ WorkManager ใช้
  • เปลี่ยนไปใช้ Room dependency 1.1.1 แทน 1.1.1-rc01 โดยเวอร์ชันเหล่านี้เหมือนกัน b/122578011

เวอร์ชัน 1.0.0-beta01

19 ธันวาคม 2018

รุ่นนี้ไม่มีการเปลี่ยนแปลง API และในอนาคต WorkManager จะยังคงมี API ที่เสถียรจนกว่าจะถึงเวอร์ชันถัดไป เว้นแต่จะมีปัญหาที่ร้ายแรง รุ่นนี้มีการแก้ไขข้อบกพร่องบางอย่าง

แก้ไขข้อบกพร่อง

  • งานย่อยที่ยกเลิกไปก่อนหน้านี้ของงานหลักที่ทำเสร็จสมบูรณ์แล้วจะไม่ทำงานอีกต่อไป b/120811767
  • คลาสการบันทึกที่เริ่มต้นอย่างถูกต้อง (ส่วนใหญ่จะแสดงในระหว่างการทดสอบ)

เวอร์ชัน 1.0.0-alpha13

12 ธันวาคม 2018

การเปิดตัวนี้มีการเปลี่ยนแปลง API เล็กน้อยซึ่งจะเป็นประโยชน์สำหรับผู้ใช้ Kotlin บางราย

การเปลี่ยนแปลง API

  • ย้าย androidx.work.Result ไปเป็นคลาสภายในของ ListenableWorker แล้ว ซึ่งจะช่วยป้องกันไม่ให้การปรับโครงสร้างขัดแย้งกับคลาส Result ระดับบนสุดของ Kotlin นี่เป็นการเปลี่ยนแปลง API ที่ทำให้เกิดข้อผิดพลาด b/120564418

การเปลี่ยนแปลง API ที่ทำให้เกิดข้อผิดพลาด

  • ย้าย androidx.work.Result ไปเป็นคลาสภายในของ ListenableWorker แล้ว

เวอร์ชัน 1.0.0-alpha12

5 ธันวาคม 2018

รุ่นนี้มีการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่น โปรดดูส่วนการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นด้านล่าง เรามีแนวโน้มที่จะเปิดตัวเวอร์ชันนี้เป็นเวอร์ชันเบต้าแรก alpha12 ยังมีการอัปเดตเอกสารประกอบอย่างครอบคลุมด้วย

การเปลี่ยนแปลง API

  • อาร์ติแฟกต์ใหม่ work-rxjava2 เปิดตัว RxWorker นี่คือ ListenableWorker ที่คาดหวัง Single<Payload>
  • เราได้นำการรองรับ Firebase JobDispatcher ออกแล้วเนื่องจากจะเลิกใช้งานในเร็วๆ นี้ ซึ่งหมายความว่าเราจะไม่work-firebaseอัปเดตอาร์ติแฟกต์อีกต่อไปเมื่อเข้าสู่เวอร์ชันเบต้า เราจะพิจารณาเพิ่มตัวเลือกอื่นในอนาคต
  • รวม Payload เป็น Result Result ตอนนี้เป็น "คลาสที่ปิดผนึก" ที่มีการใช้งานจริง 3 อย่าง ซึ่งคุณรับได้ผ่าน Result.success() (หรือ Result.success(Data)), Result.failure() (หรือ Result.failure(Data)) และ Result.retry() ตอนนี้ ListenableFuture ของคุณจะแสดงผลเป็น Result แทน Payload Worker ไม่มีเมธอด Getter และ Setter สำหรับเอาต์พุต Data นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • เพิ่ม Constraints.Builder.setTriggerContentMaxDelay(long, TimeUnit) และ Constraints.Builder.setTriggerContentUpdateDelay(long, TimeUnit) รวมถึงตัวแปรต่างๆ เพื่อรองรับ URI ของเนื้อหาที่ทริกเกอร์ช้าได้ดียิ่งขึ้น b/119919774
  • เพิ่มตัวแปร WorkRequest.Builder.setBackoffCriteria(BackoffPolicy, Duration) แล้ว เมธอดนี้ต้องใช้ API 26
  • เพิ่มเมธอดส่วนขยาย Kotlin Operation.await() และ ListenableFuture.await()
  • เปลี่ยนชื่อ Operation.getException() เป็น Operation.getThrowable() แล้ว นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • ContentUriTriggers คลาสและเมธอดที่อ้างอิงถึงคลาสนี้จะไม่มีให้ใช้งานแบบสาธารณะอีกต่อไป นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • นำเมธอด varargs ที่เหลือใน WorkManager, WorkContinuation และ OneTimeWorkRequest ออกเพื่อปรับปรุง API หากต้องการแก้ไขปัญหาการบิลด์ คุณสามารถห่อหุ้ม varargs ที่มีอยู่ด้วย Arrays.asList(...) เรายังคงรวมเวอร์ชันที่มีอาร์กิวเมนต์เดียวของแต่ละเมธอดไว้ นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • นำ WorkContinuation.combine(OneTimeWorkRequest, *) รูปแบบออกแล้ว เนื่องจาก API ที่นำเสนอมีความซับซ้อน combine เมธอดที่มีอยู่จึงเข้าใจได้ง่ายกว่า นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

แก้ไขข้อบกพร่อง

  • การใช้งานก่อน Marshmallow มีความน่าเชื่อถือมากขึ้นในการกู้คืนจากการสิ้นสุดกระบวนการของงานที่กำลังดำเนินการอยู่
  • LiveData ที่สังเกตได้ผ่าน observeForever จะได้รับการติดตามผ่าน WorkManager นี่คือการพอร์ตการแก้ไขไลบรารี Room ย้อนกลับ b/74477406
  • ตอนนี้ Data.Builder.build() จะส่งข้อยกเว้นหากออบเจ็กต์ที่ซีเรียลไลซ์มีขนาดเกินขนาดสูงสุด ก่อนหน้านี้เหตุการณ์นี้จะเกิดขึ้นในเธรดเบื้องหลังเท่านั้น ซึ่งคุณไม่สามารถจัดการได้อย่างเหมาะสม
  • แยกความแตกต่างระหว่างงานที่หยุดกับงานที่ยกเลิก getWorkInfoById() จะแสดง WorkInfo พร้อม CANCELLED State ในช่วง ListenableWorker.onStopped()
  • ถือว่า null Result เป็นความล้มเหลวใน ListenableWorker b/120362353
  • การแก้ไขแบบคาดการณ์สำหรับ Shield Tablet ที่ใช้ API 24 ซึ่งบางครั้งจะแสดง IllegalArgumentException b/119484416

การเปลี่ยนแปลง API ที่ทำให้เกิดข้อผิดพลาด

  • เราได้นำการรองรับ Firebase JobDispatcher ออกแล้วเนื่องจากจะเลิกใช้งานในเร็วๆ นี้ ซึ่งหมายความว่าเราจะไม่work-firebaseอัปเดตอาร์ติแฟกต์อีกต่อไปเมื่อเข้าสู่เวอร์ชันเบต้า เราจะพิจารณาเพิ่มตัวเลือกอื่นในอนาคต
  • รวม Payload เป็น Result Result ตอนนี้เป็น "คลาสที่ปิดผนึก" ที่มีการใช้งานจริง 3 อย่าง ซึ่งคุณรับได้ผ่าน Result.success() (หรือ Result.success(Data)), Result.failure() (หรือ Result.failure(Data)) และ Result.retry() ตอนนี้ ListenableFuture ของคุณจะแสดงผลเป็น Result แทน Payload Worker ไม่มีเมธอด Getter และ Setter สำหรับเอาต์พุต Data
  • เพิ่มเมธอดส่วนขยาย Kotlin Operation.await() และ ListenableFuture.await()
  • เปลี่ยนชื่อ Operation.getException() เป็น Operation.getThrowable() แล้ว
  • ContentUriTriggers คลาสและเมธอดที่อ้างอิงถึงคลาสนี้จะไม่มีให้ใช้งานแบบสาธารณะอีกต่อไป
  • นำเมธอด varargs ที่เหลือใน WorkManager, WorkContinuation และ OneTimeWorkRequest ออกเพื่อปรับปรุง API หากต้องการแก้ไขปัญหาการบิลด์ คุณสามารถห่อหุ้ม varargs ที่มีอยู่ด้วย Arrays.asList(...) เรายังคงรวมเวอร์ชันที่มีอาร์กิวเมนต์เดียวของแต่ละเมธอดไว้
  • นำ WorkContinuation.combine(OneTimeWorkRequest, *) รูปแบบออกแล้ว เนื่องจาก API ที่นำเสนอมีความซับซ้อน combine เมธอดที่มีอยู่จึงเข้าใจได้ง่ายกว่า

เวอร์ชัน 1.0.0-alpha11

8 พฤศจิกายน 2018

รุ่นนี้มีการเปลี่ยนแปลงหลายอย่างที่จะกลายเป็น API ที่เสถียรใน beta รุ่นนี้มีการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่น โปรดดูส่วนการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นด้านล่าง

การเปลี่ยนแปลง API

  • work-runtime-ktx เปิดตัว CoroutineWorker ใหม่
  • เปลี่ยนชื่อ WorkStatus เป็น WorkInfo แล้ว เราได้เปลี่ยนชื่อตัวแปรของเมธอด getStatus ที่เกี่ยวข้องทั้งหมดเป็นตัวแปร getWorkInfo ที่เกี่ยวข้องแล้ว นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • ListenableWorker.onStopped() ไม่รับอาร์กิวเมนต์บูลีนที่ระบุว่ามีการยกเลิก WorkRequest หรือไม่แล้ว WorkManager ไม่ได้แยกความแตกต่างนี้อีกต่อไป นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • เปลี่ยนชื่อแพ็กเกจ androidx.work.test เป็นแพ็กเกจ androidx.work.testing แล้ว นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • ตัวตั้งค่าใน Constraints จะไม่อยู่ใน API สาธารณะอีกต่อไป นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • WorkerParameters.getTriggeredContentUris() และ WorkerParameters.getTriggeredContentAuthorities() แสดงผลอาร์เรย์ก่อนหน้านี้ ตอนนี้เมธอดเหล่านี้จะแสดงผลคอลเล็กชัน นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • เปลี่ยนชื่อ ListenableWorker.onStartWork() เป็น ListenableWorker.startWork() นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • ตัวสร้างสำหรับ WorkStatus ไม่ได้เป็นส่วนหนึ่งของ Public API อีกต่อไป นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • เปลี่ยนชื่อ Configuration.getMaxJobSchedulerID() และ Configuration.getMinJobSchedulerID() เป็น Configuration.getMinJobSchedulerId() และ Configuration.getMaxJobSchedulerId() ตามลำดับ นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • เพิ่มคำอธิบายประกอบ @NonNull จำนวนมากใน API สาธารณะเพื่อปรับปรุงการยศาสตร์ของ API
  • เพิ่ม WorkManager.enqueueUniqueWork() API เพื่อจัดคิว OneTimeWorkRequest ที่ไม่ซ้ำกันโดยไม่ต้องสร้าง WorkContinuation
  • ตอนนี้ตัวแปรทั้งหมดของเมธอด enqueue และ cancel ใน WorkManager จะแสดงผลประเภท Operation ใหม่ นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • enqueue ทุกรูปแบบจะไม่ยอมรับ varargs สำหรับ WorkRequest อีกต่อไป นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ โปรดใช้คอลเล็กชันแทน คุณใช้ Arrays.asList() เพื่อแก้ไขโค้ดที่มีอยู่ได้ เราดำเนินการเช่นนี้เพื่อลดจำนวนพื้นผิวและเมธอดของ API
  • ตอนนี้การพยายาม initialize WorkManager มากกว่า 1 ครั้งต่อกระบวนการจะทำให้เกิด IllegalStateException นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

แก้ไขข้อบกพร่อง

  • WorkRequest.Builder ในอาร์ติแฟกต์ work-runtime-ktx จะใช้ ListenableWorker แทน แก้ไข b/117666259
  • ตรวจสอบว่าเวลาเรียกใช้ครั้งถัดไปสำหรับ PeriodicWork อยู่ในอนาคต แก้ไข b/118204399
  • หลีกเลี่ยง I/O ของดิสก์ที่อาจเกิดขึ้นเมื่อใช้ WorkManager ในการเริ่มต้นแอป แก้ไข b/117796731
  • แก้ไขภาวะแข่งขันใน WorkConstraintsTracker แก้ไข android-workmanager/issues/56

การเปลี่ยนแปลง API ที่ทำให้เกิดข้อผิดพลาด

  • เปลี่ยนชื่อ WorkStatus เป็น WorkInfo แล้ว เราได้เปลี่ยนชื่อตัวแปรของเมธอด getStatus ที่เกี่ยวข้องทั้งหมดเป็นตัวแปร getWorkInfo ที่เกี่ยวข้องแล้ว
  • ListenableWorker.onStopped() ไม่รับอาร์กิวเมนต์บูลีนที่ระบุว่ามีการยกเลิก WorkRequest หรือไม่แล้ว WorkManager ไม่ได้แยกความแตกต่างนี้อีกต่อไป
  • เปลี่ยนชื่อแพ็กเกจ androidx.work.test เป็นแพ็กเกจ androidx.work.testing แล้ว
  • ตัวตั้งค่าใน Constraints จะไม่อยู่ใน API สาธารณะอีกต่อไป
  • WorkerParameters.getTriggeredContentUris() และ WorkerParameters.getTriggeredContentAuthorities() แสดงผลอาร์เรย์ก่อนหน้านี้ ตอนนี้เมธอดเหล่านี้จะแสดงผลคอลเล็กชัน
  • เปลี่ยนชื่อ ListenableWorker.onStartWork() เป็น ListenableWorker.startWork()
  • ตัวสร้างสำหรับ WorkStatus ไม่ได้เป็นส่วนหนึ่งของ Public API อีกต่อไป
  • เปลี่ยนชื่อ Configuration.getMaxJobSchedulerID() และ Configuration.getMinJobSchedulerID() เป็น Configuration.getMinJobSchedulerId() และ Configuration.getMaxJobSchedulerId() ตามลำดับ
  • ตอนนี้ตัวแปรทั้งหมดของเมธอด enqueue และ cancel ใน WorkManager จะแสดงผลประเภท Operation ใหม่
  • enqueue ทุกรูปแบบจะไม่ยอมรับ varargs สำหรับ WorkRequest อีกต่อไป
  • ตอนนี้การพยายาม initialize WorkManager มากกว่า 1 ครั้งต่อกระบวนการจะทำให้เกิด IllegalStateException

เวอร์ชัน 1.0.0-alpha10

11 ตุลาคม 2018

รุ่นนี้รองรับงานแบบไม่พร้อมกันที่นักพัฒนาแอปควบคุม รุ่นนี้มีการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่น โปรดดูส่วนการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นด้านล่าง

เราคาดว่า WorkManager กำลังเข้าสู่ระยะสุดท้ายของช่วงอัลฟ่า เราคาดว่า API จะมีความเสถียรในรุ่นเบต้า ดังนั้นโปรดสละเวลาส่งความคิดเห็นในเครื่องมือติดตามปัญหา

การเปลี่ยนแปลง API

  • นำdeprecatedวิธีการและคลาสทั้งหมดก่อนหน้านี้ออก โดยเฉพาะWorkerตัวสร้างเริ่มต้น นี่เป็นการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นในระบบ
  • เปลี่ยนชื่อ NonBlockingWorker เป็น ListenableWorker ซึ่งตอนนี้เป็นชั้นเรียนสาธารณะที่ไม่ได้ซ่อนและพร้อมใช้งานแล้ว
    • ListenableWorker จะให้สิทธิ์เข้าถึงเมธอดนามธรรม 1 รายการ ListenableFuture<Payload> onStartWork() ซึ่งเรียกใช้ในเทรดหลัก คุณสามารถเลือกที่จะเริ่มและประมวลผลงานแบบอะซิงโครนัสได้ เมื่อเสร็จแล้ว คุณควรจะอัปเดต ListenableFuture อย่างเหมาะสม การใช้งานอ้างอิงของ ListenableFuture มีให้ในแพ็กเกจ Futures ใน alpha02 (ดูส่วน WorkManager ด้านล่าง)
    • Worker ขยาย ListenableWorker และยังคงทำงานเช่นเดิมด้วยวิธีการ Result doWork() แบบนามธรรม
    • ย้ายบางวิธีและสมาชิกจาก Worker ไปยัง ListenableWorker
    • ในเร็วๆ นี้เราจะจัดหาการใช้งานอ้างอิงสำหรับ ListenableWorker ที่ใช้ Kotlin Coroutines (เมื่อเผยแพร่เวอร์ชันที่เสถียรแล้ว) และ RxJava2
  • ระบบได้ผสานรวมอินเทอร์เฟซ WorkerFactory และการใช้งานจริง DefaultWorkerFactory เข้ากับคลาสนามธรรมที่ชื่อ WorkerFactory แล้ว การใช้งานนี้ช่วยให้มั่นใจได้ว่าระบบจะเรียกใช้ลักษณะการทำงานเริ่มต้นที่อิงตามการสะท้อนเป็นความพยายามสุดท้ายสำหรับอินสแตนซ์ WorkerFactory ที่ผู้ใช้สร้างขึ้น นี่เป็นการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • นำ WorkManager.synchronous() และ WorkContinuation.synchronous() รวมถึงเมธอดที่เกี่ยวข้องทั้งหมดออก เพิ่ม ListenableFuture<Void> เป็นประเภทการคืนค่าของเมธอดหลายรายการใน API นี่เป็นการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นในระบบ
    • ตอนนี้คุณสามารถรับและสังเกตการณ์แบบซิงโครนัสได้โดยใช้ ListenableFuture เช่น WorkManager.enqueue() เคยแสดงผลเป็น void แต่ตอนนี้จะแสดงผลเป็น ListenableFuture<Void> คุณเรียกใช้ ListenableFuture.addListener(Runnable, Executor) หรือ ListenableFuture.get() เพื่อเรียกใช้โค้ดได้เมื่อการดำเนินการเสร็จสมบูรณ์
    • โปรดทราบว่า ListenableFutures เหล่านี้ไม่ได้บอกว่าการดำเนินการสำเร็จหรือไม่ แต่จะบอกว่าการดำเนินการเสร็จสิ้นแล้ว คุณยังคงต้องเชื่อมโยงเมธอด WorkManager เพื่อดูข้อมูลนี้
    • เราไม่สนใจการเรียก cancel() ในออบเจ็กต์เหล่านี้ เนื่องจากทำให้เกิดความสับสนและยากต่อการให้เหตุผล (คุณกำลังยกเลิกการดำเนินการหรือผลงานที่ได้) ซึ่งเป็นไปตามFutureสัญญา
    • เพื่อรักษาความเท่าเทียมกับเมธอด getStatus* แบบซิงโครนัส เราจึงได้จัดเตรียมตัวแปร ListenableFuture และเปลี่ยนชื่อตัวแปรที่มีอยู่ซึ่งส่งคืน LiveData ให้มี "LiveData" เป็นส่วนหนึ่งของชื่ออย่างชัดเจน (เช่น getStatusesByIdLiveData(UUID)) การเปลี่ยนแปลง API นี้ทำให้เกิดการเปลี่ยนแปลงที่ทำให้ใช้งานร่วมกันไม่ได้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ทราบจาก alpha09 เกี่ยวกับไฟล์ androidx-annotations.pro ที่ซ้ำกัน คุณอาจนำวิธีแก้ปัญหาจากหมายเหตุประจำรุ่นก่อนหน้าออกได้โดยลบ exclude 'META-INF/proguard/androidx-annotations.pro' ออกจากไฟล์ Gradle
  • เพิ่มการกำหนดค่า ProGuard เพื่อเก็บตัวสร้าง Worker ใหม่ b/116296569
  • แก้ไขปัญหาที่อาจเกิดขึ้นNullPointerExceptionในสภาวะการแข่งขันที่REPLACEงานถูกb/116253486 และ b/116677275
  • WorkContinuation.combine() ตอนนี้รับ WorkContinuation อย่างน้อย 1 รายการแล้ว ไม่ใช่ 2 รายการขึ้นไป b/117266752

การเปลี่ยนแปลง API ที่ทำให้เกิดข้อผิดพลาด

  • นำdeprecatedวิธีการและคลาสทั้งหมดก่อนหน้านี้ออก โดยเฉพาะWorkerตัวสร้างเริ่มต้น
  • ระบบได้ผสานรวมอินเทอร์เฟซ WorkerFactory และการใช้งานจริง DefaultWorkerFactory เข้ากับคลาสนามธรรมที่ชื่อ WorkerFactory แล้ว
  • นำ WorkManager.synchronous() และ WorkContinuation.synchronous() ออกแล้ว
  • ตอนนี้เมธอด WorkManager.getStatus*() จะแสดงผลเป็น ListenableFuture WorkManager.getStatus*LiveData() คืน LiveData

เวอร์ชัน 1.0.0-alpha09

19 กันยายน 2018

ปัญหาที่ทราบ

หากพบปัญหา "พบไฟล์มากกว่า 1 รายการที่มีเส้นทางที่ไม่ขึ้นอยู่กับระบบปฏิบัติการ 'META-INF/proguard/androidx-annotations.pro'" โปรดใส่ข้อมูลต่อไปนี้ในไฟล์ Gradle เป็นวิธีแก้ปัญหาชั่วคราวในขณะที่เราแก้ไขปัญหาใน alpha10

Groovy

android {
    packagingOptions {
        exclude 'META-INF/proguard/androidx-annotations.pro'
    }
}

Kotlin

android {
    packagingOptions {
        exclude("META-INF/proguard/androidx-annotations.pro")
    }
}

แก้ไขข้อบกพร่อง

  • เพิ่มการแก้ไขอีกรายการที่จำเป็นสำหรับข้อผิดพลาด "100 งาน" b/115560696
  • เพิ่มการแก้ไขข้อผิดพลาดในการละเมิดข้อจำกัดของคีย์นอกเนื่องจากสภาวะการแข่งขัน b/114705286
  • เรียกใช้ ConstraintTrackingWorker.onStopped(boolean) ที่ได้รับมอบสิทธิ์ไปยัง Worker ที่เกี่ยวข้อง b/114125093
  • บังคับใช้การหน่วงเวลาการหยุดชั่วคราวขั้นต่ำที่ถูกต้องสำหรับ Firebase JobDispatcher b/113304626
  • การรับประกันการทำงานแบบหลายเธรดที่ได้รับการปรับปรุงภายในไลบรารี
  • แก้ไขปัญหาที่อาจเกิดขึ้นกับการกรองข้อมูลที่ซ้ำกันLiveDataภายใน

การเปลี่ยนแปลง API

  • ตอนนี้คุณสร้างอินสแตนซ์ Worker ของตัวเองได้ที่รันไทม์โดยระบุ WorkerFactory เป็นส่วนหนึ่งของ WorkManager.Configuration Factory สำรองคือ DefaultWorkerFactory ซึ่งตรงกับลักษณะการทำงานของ WorkManager เวอร์ชันก่อนหน้า
    • ตอนนี้เราได้ทำเครื่องหมายว่าเลิกใช้ตัวสร้างเริ่มต้นสำหรับ Worker และ NonBlockingWorker แล้ว โปรดใช้ตัวสร้างใหม่ (Worker(Context, WorkerParameters)) และเรียกใช้ super(Context, WorkerParameters) เนื่องจาก WorkManager เวอร์ชันในอนาคตจะนำตัวสร้างเริ่มต้นออก
  • เราได้เริ่มใช้ ListenableFuture อาร์ติแฟกต์ใหม่เป็นการภายใน (ไม่มีการอ้างอิง Guava) เราจะเปิดตัว ListenableFutures ใน API ในรุ่นที่กำลังจะเปิดตัว การเปลี่ยนแปลงนี้จะรองรับการซ่อน NonBlockingWorker ในท้ายที่สุด
  • เพิ่มความสามารถในการทริกเกอร์งานที่กำหนดเวลาใน TestDriver ผ่าน TestDriver.setInitialDelayMet(UUID) และ TestDriver.setPeriodDelayMet(UUID) b/113360060

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

  • ตัวสร้าง Worker และ NonBlockingWorker เริ่มต้นเลิกใช้งานแล้ว โปรดย้ายข้อมูลไปยังตัวสร้างใหม่โดยเร็วที่สุด เวอร์ชันในอนาคตจะนำตัวสร้างเริ่มต้นออก

เวอร์ชัน 1.0.0-alpha08

27 สิงหาคม 2018

แก้ไขข้อบกพร่อง

  • ติดป้ายกำกับคอมโพเนนต์ WorkManager อย่างชัดเจนว่าไม่รู้จักการบูตโดยตรงเพื่อไม่ให้คอมโพเนนต์เริ่มทำงานระหว่างการบูตโดยตรง ในอนาคตเราจะให้บริการ WorkManager เวอร์ชันที่รองรับการบูตโดยตรง b/112665532
  • แก้ไขปัญหาที่งานที่ลองอีกครั้งไม่ทำงาน b/112604021
  • แก้ไขงานที่ทำเป็นระยะๆ ไม่ทำงานซ้ำๆ (เกี่ยวข้องกับปัญหาข้างต้น) b/112859683
  • ใช้นโยบายการหยุดชั่วคราวเมื่อกระบวนการของแอปทํางานอยู่แล้ว
  • แก้ไขข้อความข้อยกเว้นใน Data เพื่อระบุว่าขีดจำกัดคือ 10 KB
  • ลดค่าสูงสุดของ Configuration.setMaxSchedulerLimit(int) เป็น 50 เพื่อพิจารณาเวลาในการตอบสนองบางอย่างในJobScheduler การประมวลผลเสร็จสมบูรณ์ b/112817355

เวอร์ชัน 1.0.0-alpha07

16 สิงหาคม 2018

แก้ไขข้อบกพร่อง

  • แก้ไขคำค้นหา SQL ที่อาจมีขีดจำกัดที่เป็นลบซึ่งอาจแสดงผลลัพธ์ได้ไม่จำกัด
  • ตอนนี้งานที่ดำเนินการเสร็จแล้วจะยกเลิกสำเนาที่รอดำเนินการทั้งหมดของงานนั้นในตัวจัดตารางเวลาอื่นๆ ได้อย่างถูกต้อง ซึ่งทำให้มีงานเกินขีดจำกัดที่ JobScheduler งาน b/111569265
  • แก้ไขConcurrentModificationExceptionในConstraintTracker b/112272753
  • เปลี่ยนคำอธิบายประกอบประเภทการคืนค่าของ Data.getBooleanArray(String) และ Data.getIntArray(String) เป็น @Nullable แทน @NonNull b/112275229

การเปลี่ยนแปลง API

  • ตอนนี้ Worker ได้ขยายเวลาสำหรับชั้นเรียนใหม่ NonBlockingWorker การดำเนินการนี้จะไม่ส่งผลต่อการใช้งานปัจจุบัน ในอนาคต NonBlockingWorker จะกลายเป็นเอนทิตีที่รองรับอย่างเต็มรูปแบบสำหรับโซลูชันการแยกข้อความที่กำหนดเอง
  • เปลี่ยนคำอธิบายประกอบประเภทการคืนค่าของ Data.getBooleanArray(String) และ Data.getIntArray(String) เป็น @Nullable แทน @NonNull b/112275229
  • ส่วนขยาย Kotlin: เลิกใช้งาน Map.toWorkData() และเพิ่ม workDataOf(vararg Pair<String, Any?>) ระดับบนสุดเพื่อให้สอดคล้องกับ API ที่มีอยู่มากขึ้น

เวอร์ชัน 1.0.0-alpha06

1 สิงหาคม 2018

แก้ไขข้อบกพร่อง

  • ป้องกันการล็อกฐานข้อมูลเมื่อกำหนดเวลางาน b/111801342
  • แก้ไขข้อบกพร่องที่ทำให้ PeriodicWork ไม่ทำงานตามกำหนดเวลาเมื่ออยู่ในโหมดพักเครื่อง b/111469837
  • แก้ไข Race Condition เมื่อติดตามข้อจำกัดซึ่งทำให้ WorkManager ขัดข้อง googlecodelabs/android-workmanager/issues/56
  • สร้าง WorkRequest ที่ไม่ซ้ำกันเมื่อใช้ WorkRequest.Builder#build() b/111408337
  • เปิดใช้ RescheduleReceiver เฉพาะเมื่อมี WorkRequest ที่ต้องการใช้ b/111765853

เวอร์ชัน 1.0.0-alpha05

24 กรกฎาคม 2018

การเปลี่ยนแปลง API

  • ตอนนี้ WorkManager.getInstance() มีคำอธิบายประกอบเป็น @NonNull แทน @Nullable แล้ว แต่หากไม่ได้เริ่มต้น Singleton อย่างถูกต้องในกรณีของการเริ่มต้นด้วยตนเอง เมธอดจะส่ง IllegalStateException ออกมา นี่คือการเปลี่ยนแปลง API ที่ทำให้เกิดข้อผิดพลาด
  • เพิ่ม API ใหม่ Configuration.Builder.setMinimumLoggingLevel(int) ซึ่งควบคุมความละเอียดของ WorkManager ได้ โดยค่าเริ่มต้น WorkManager จะบันทึก Log.INFO ขึ้นไป
  • เปลี่ยนลายเซ็นของ Data.getString() เพื่อไม่ให้ใช้ค่าเริ่มต้นอีกต่อไป (ค่าเริ่มต้นคือ null โดยนัย) การเปลี่ยนแปลงนี้เป็นการเปลี่ยนแปลง API ที่ทำให้เกิดข้อขัดข้อง
  • ทำเครื่องหมายบางวิธีที่จำเป็นสำหรับการใช้งานภายในเท่านั้นเป็น @hide ซึ่งรวมถึงตัวสร้าง Constraints, Data.toByteArray() และ Data.fromByteArray(byte[]) นี่เป็นการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นในระบบ

แก้ไขข้อบกพร่อง

  • WorkManager จะไม่เรียกใช้งานในกรณีที่ทราบว่ามีการสำรองข้อมูลอัตโนมัติอีกต่อไป ซึ่งอาจทำให้เกิดข้อขัดข้อง b/110564377
  • แก้ไขการกำหนดเวลาซ้ำของ PeriodicWorkRequest เมื่อใช้ JobScheduler b/110798652
  • แก้ไขปัญหาที่ PeriodicWorkRequests ทำงานไม่ถูกต้องหลังจากอุปกรณ์เข้าสู่โหมดพัก b/111469837
  • แก้ไขปัญหาความล่าช้าในช่วงแรกเมื่อใช้ Firebase JobDispatcher b/111141023
  • แก้ไขปัญหาการแข่งขันและปัญหาการกำหนดเวลาที่อาจเกิดขึ้น
  • ล้างข้อมูล BroadcastReceiver ที่ไม่จำเป็นอีกต่อไปอย่างถูกต้อง
  • เพิ่มประสิทธิภาพการกำหนดเวลางานใหม่เมื่อแอปรีสตาร์ทหลังจากถูกบังคับปิด
  • อนุญาตให้เรียกใช้TestScheduler.setAllConstraintsMet(UUID)ก่อนหรือหลังการจัดคิวWorkRequestที่ระบุ b/111238024

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

  • ตอนนี้ WorkManager.getInstance() มีคำอธิบายประกอบเป็น @NonNull แทน @Nullable แล้ว
  • เปลี่ยนลายเซ็นของ Data.getString() เพื่อไม่ให้ใช้ค่าเริ่มต้นอีกต่อไป (ค่าเริ่มต้นคือ null)
  • ทำเครื่องหมายบางวิธีที่จำเป็นสำหรับการใช้งานภายในเท่านั้นเป็น @hide ซึ่งรวมถึงตัวสร้าง Constraints, Data.toByteArray() และ Data.fromByteArray(byte[])

เวอร์ชัน 1.0.0-alpha04

26 มิถุนายน 2018

แก้ไขข้อบกพร่อง

  • ตอนนี้ระบบจะกำหนดเวลาใหม่ให้ PeriodicWorkRequest อย่างถูกต้องเมื่อใช้การติดตั้งใช้งานตาม AlarmManager
  • แก้ไข ANR ที่อาจเกิดขึ้นเมื่อกำหนดเวลาผู้ปฏิบัติงานทั้งหมดใหม่หลังจากบังคับหยุดหรือรีบูต b/110507716
  • เพิ่มคำอธิบายประกอบเกี่ยวกับค่า Null ให้กับ API ของ WorkManager ต่างๆ b/110344065
  • บันทึกข้อยกเว้นที่ตรวจไม่พบซึ่งเกิดขึ้นระหว่างการดำเนินการของ Worker b/109900862
  • อนุญาตการย้ายข้อมูลฐานข้อมูลที่ทำลายข้อมูลในกรณีที่คุณตัดสินใจที่จะย้อนกลับไปใช้ WorkManager เวอร์ชันเก่า b/74633270
  • แก้ไขการทำงานล้มเหลวในการย้ายข้อมูลหากมีการสร้างแท็กโดยนัยที่ซ้ำกัน นี่เป็นปัญหาที่พบได้ยากมาก ซึ่งจะเกิดขึ้นก็ต่อเมื่อคุณใช้รูปแบบแท็กโดยนัยเดียวกันด้วยตนเองเท่านั้น

เวอร์ชัน 1.0.0-alpha03

19 มิถุนายน 2018

แก้ไขข้อบกพร่อง

  • แก้ไข Race Condition ในการติดตั้งใช้งานที่อิงตาม AlarmManager b/80346526

  • แก้ไขงานที่ซ้ำกันเมื่อใช้ JobScheduler หลังจากรีบูตอุปกรณ์

  • ตอนนี้งานที่มีทริกเกอร์ URI ของเนื้อหาจะยังคงอยู่แม้จะรีบูต b/80234744

  • อัปเดตเอกสาร b/109827628, b/109758949, b/80230748

  • แก้ไขข้อขัดข้องเมื่อจัดคิว WorkRequest อีกครั้ง b/109572353

  • แก้ไขคำเตือนของคอมไพเลอร์ Kotlin เมื่อใช้การขึ้นต่อกันของ work-runtime-ktx

  • ตอนนี้ WorkManager ใช้ Room เวอร์ชัน 1.1.1-rc1 แล้ว

การเปลี่ยนแปลง API

  • เพิ่ม getStatusesSync() ซึ่งเป็นเวอร์ชันเรียลไทม์ของ WorkContinuation.getStatuses()
  • Worker สามารถแยกความแตกต่างระหว่างการยกเลิกที่ผู้ใช้เป็นผู้เริ่มกับการหยุดชั่วคราวที่ระบบปฏิบัติการเป็นผู้ขอ Worker.isStopped() จะแสดงผล true หากมีการขอให้หยุด Worker.isCancelled() จะแสดง true เมื่อมีการยกเลิกงานอย่างชัดเจน b/79632247
  • เพิ่มการรองรับ JobParameters#getNetwork() ใน API 28 ซึ่งจะแสดงผ่าน Worker.getNetwork()
  • เพิ่ม Configuration.Builder.setMaxSchedulerLimit(int maxSchedulerLimit) เพื่อให้คุณบังคับใช้จำนวนงานที่ส่งไปยัง JobScheduler หรือ AlarmManager ได้ ซึ่งจะช่วยป้องกันไม่ให้ WorkManager ใช้ช่อง JobScheduler ที่ว่างทั้งหมด
  • เพิ่ม Configuration.setJobSchedulerJobIdRange(int minJobSchedulerId, int maxJobSchedulerId) ซึ่งช่วยกำหนดช่วงรหัสงาน JobScheduler ที่ปลอดภัยสำหรับ WorkManager ในการใช้งาน b/79996760
  • Worker.getRunAttemptCount() แสดงผลจำนวนการเรียกใช้ปัจจุบันสำหรับ Worker ที่ระบุ b/79716516
  • WorkManager.enqueueUniquePeriodicWork(String uniqueWorkName, ExistingPeriodicWorkPolicy existingPeriodicWorkPolicy, PeriodicWorkRequest periodicWork) ช่วยให้คุณจัดคิว PeriodicWorkRequest ที่ไม่ซ้ำกันได้ b/79600647
  • WorkManager.cancelAllWork() จะยกเลิก Worker ทั้งหมด ไลบรารีที่ขึ้นอยู่กับ WorkManager สามารถค้นหาเวลาที่เรียกใช้วิธีนี้ครั้งล่าสุดได้โดยใช้ WorkManager.getLastCancelAllTimeMillis() เพื่อล้างสถานะภายในเพิ่มเติม
  • เพิ่ม WorkManager.pruneWork() เพื่อนำงานที่เสร็จสมบูรณ์แล้วออกจากฐานข้อมูลภายใน b/79950952, b/109710758

การเปลี่ยนแปลงลักษณะการทำงาน

  • เพิ่มแท็กโดยนัยสำหรับ WorkRequest ทั้งหมด ซึ่งเป็นชื่อคลาสที่มีคุณสมบัติครบถ้วนสำหรับ Worker ซึ่งช่วยให้สามารถนำ WorkRequest ออกได้โดยไม่ต้องมี tag หรือเมื่อไม่มี id b/109572351

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

  • เปลี่ยนชื่อ Worker.WorkerResult เป็น Worker.Result แล้ว
  • Worker.onStopped ตอนนี้มีพารามิเตอร์เพิ่มเติม isCancelled ซึ่งตั้งค่าเป็นtrue เมื่อWorker ถูกยกเลิกอย่างชัดเจน

เวอร์ชัน 1.0.0-alpha02

24 พฤษภาคม 2018

แก้ไขข้อบกพร่อง

  • แก้ไข NullPointerException ใน State.isFinished() b/79550068
  • แก้ไขปัญหาที่ทำให้ระบบกำหนดเวลา Worker ใหม่ในวันที่ Application.onCreate() b/79660657
  • แก้ไขปัญหาที่คุณสามารถกำหนดเวลาทำงานได้มากกว่าที่ระบบปฏิบัติการอนุญาต b/79497378
  • ย้ายการล้าง Wake Lock ที่เชื่อมโยงกับ Worker ไปยังเธรดเบื้องหลัง
  • ตอนนี้การติดตั้งใช้งาน AlarmManager จะล้างข้อมูลอย่างถูกต้องเมื่อการทำงานที่รอดำเนินการทั้งหมดเสร็จสมบูรณ์
  • แก้ไขการค้นหา SQL ในการล้างข้อมูลซึ่งส่งผลต่อภาษาที่ไม่ใช่ภาษาอังกฤษ b/80065360
  • เพิ่มการรองรับ float ใน Data b/79443878
  • ตอนนี้ Data.Builder.putAll() จะแสดงอินสแตนซ์ของ Builder b/79699162
  • Javadoc และการแก้ไขเพิ่มเติมในเอกสารประกอบ b/79691663

การเปลี่ยนแปลง API

  • Workerสามารถตอบสนองต่อการหยุดได้ คุณใช้ Worker.isStopped() เพื่อตรวจสอบว่า Worker หยุดทำงานแล้วหรือไม่ Worker.onStopped() สามารถใช้เพื่อดำเนินการล้างข้อมูลแบบเบาได้
  • Worker.getTags() API จะแสดงผล Set ของแท็กที่เชื่อมโยงกับ Worker
  • เพิ่มโอเวอร์โหลด javax.time.Duration สำหรับ API ที่ใช้ทั้งระยะเวลาและ TimeUnits @RequiresApi(26) เป็นผู้ดูแล
  • ส่วนขยาย WorkManager ได้ย้ายจากแพ็กเกจ androidx.work.ktx ไปยังแพ็กเกจ androidx.work แล้ว ส่วนขยายเดิมจะเลิกใช้งานและจะนำออกในเวอร์ชันถัดไป
  • Configuration.withExecutor() เลิกใช้งานแล้ว โปรดใช้ Configuration.setExecutor() แทน

เวอร์ชัน 1.0.0-alpha01

8 พฤษภาคม 2018

WorkManager ช่วยให้การกำหนดเวลาและการดำเนินการ งานในเบื้องหลังที่รับประกันและคำนึงถึงข้อจำกัดง่ายขึ้น รุ่นแรกนี้คือ 1.0.0-alpha01