1. WorkManager
1). 簡介
其實就是"管理一些要在后臺工作的任務, -- 即使你的應用沒啟動也能保證任務能被執行"，WorkManager在底層, 會根據你的設備情況, 選用JobScheduler, Firebase的JobDispatcher, 或是AlarmManager。WorkManager并不是為了那種在應用內的后臺線程而設計出來的. 這種需求你應該使用ThreadPool。
2). 引入
- kolin
# Android Studio 3.0， 3.0以下版本請使用complie
ext.work_version = "1.0.0-alpha02"
// WorkManager
implementation "android.arch.work:work-runtime:$work_version" // use -ktx for Kotlin
// optional - Firebase JobDispatcher support
implementation "android.arch.work:work-firebase:$work_version"
// optional - Test helpers
androidTestImplementation "android.arch.work:work-testing:$work_version"
- java
# 必須加入
implementation "android.arch.work:work-runtime:1.0.0-alpha01"
2. 用法
1). 執行一次的任務
- PullWorker.kt
/**
* Pull 任務
* 創建步驟：
* 1. 繼承Worker類
* 2. 重寫doWork()方法
* Created by mazaiting on 2018/6/6.
*/
class PullWorker : Worker() {
override fun doWork(): WorkerResult {
// 模擬設置頁面中的"是否接受推送"是否被勾選
val isOkay = this.inputData.getBoolean("key_accept_bg_work", false)
// 判斷是否推送
if (isOkay) {
// 模擬長時間工作
Thread.sleep(5000)
// 獲取數據
val pulledResult = startPull()
// 設置輸出數據
val output = Data.Builder().putString("key_pulled_result", pulledResult).build()
// 存放數據
outputData = output
// 返回成功
return WorkerResult.SUCCESS
} else {
// 返回失敗
return WorkerResult.FAILURE
}
}
/**
* 開始推送
*/
private fun startPull(): String {
return "[worker] pull messages from backend."
}
}
- PullEngine.kt
/**
* Pull 引擎
* Created by mazaiting on 2018/6/6.
*/
class PullEngine {
fun scheduleOneTimeWork(context: Context) {
// 設置任務，執行一次
val pullRequest = OneTimeWorkRequestBuilder<PullWorker>()
.setInputData(
Data.Builder()
.putBoolean("key_accept_bg_work", true)
.build()
)
.build()
WorkManager.getInstance().enqueue(pullRequest)
// 將請求入列
WorkManager.getInstance().enqueue(pullRequest)
// 獲取請求ID
val pullRequestId = pullRequest.id
// 存在SharedPreference中
PreferenceManager
.getDefaultSharedPreferences(context)
.edit()
.putString("pullId", pullRequestId.toString())
.apply()
}
}
- MainApplication.kt(注意在AndroidManifest.xml文件中配置)
class MainApplication : Application() {
override fun onCreate() {
super.onCreate()
// 任務執行一次
PullEngine().scheduleOneTimeWork(this.applicationContext)
}
}
- MainActivity.kt
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// UUID實現了Serializable接口，能由toString(),fromString()與String互轉
val uuid = UUID.fromString(
PreferenceManager.getDefaultSharedPreferences(this.applicationContext)
.getString("pullId", "")
)
WorkManager.getInstance()
// 獲取狀態ID
.getStatusById(uuid)
// 觀察數據
.observe(this, Observer<WorkStatus>{ status ->
if (null != status && status.state.isFinished) {
val pulledResult = status.outputData.getString("key_pulled_result","")
Log.e("MainActivity", pulledResult)
}
})
}
}
-
打印結果
圖1.png
2). 任務設置約束
fun scheduleOneTimeWork(context: Context) {
val constraints = Constraints.Builder()
// 負荷
.setRequiresCharging(true)
.build()
// 設置任務，執行一次
val pullRequest = OneTimeWorkRequestBuilder<PullWorker>()
// 設置約束
.setConstraints(constraints)
// 輸入數據
.setInputData(
Data.Builder()
.putBoolean("key_accept_bg_work", true)
.build()
)
.build()
// 將請求入列
WorkManager.getInstance().enqueue(pullRequest)
// 獲取請求ID
val pullRequestId = pullRequest.id
// 存在SharedPreference中
PreferenceManager
.getDefaultSharedPreferences(context)
.edit()
.putString("pullId", pullRequestId.toString())
.apply()
}
3). 取消任務
// 獲取請求ID
val pullRequestId = pullRequest.id
// 取消任務
WorkManager.getInstance().cancelWorkById(pullRequestId)
4). 任務鏈
WorkManager.getInstance()
.beginWith(workA)
// Note: WorkManager.beginWith() returns a
// WorkContinuation object; the following calls are
// to WorkContinuation methods
.then(workB) // FYI, then() returns a new WorkContinuation instance
.then(workC)
.enqueue()
或
WorkManager.getInstance()
// First, run all the A tasks (in parallel):
.beginWith(workA1, workA2, workA3)
// ...when all A tasks are finished, run the single B task:
.then(workB)
// ...then run the C tasks (in any order):
.then(workC1, workC2)
.enqueue()
再或
val chain1 = WorkManager.getInstance()
.beginWith(workA)
.then(workB)
val chain2 = WorkManager.getInstance()
.beginWith(workC)
.then(workD)
val chain3 = WorkContinuation
.combine(chain1, chain2)
.then(workE)
chain3.enqueue()
5). 定時任務
/**
* 執行任務
*/
fun schedulePeriodicWork(context: Context) {
val constraints = Constraints.Builder()
// 負荷
.setRequiresCharging(true)
.build()
// 設置任務執行時長，并設置輸入參數
// 長期任務，循環
val pullRequest = PeriodicWorkRequestBuilder<PullWorker>(30, TimeUnit.SECONDS)
.setConstraints(constraints)
.setInputData(
Data.Builder()
.putBoolean("key_accept_bg_work", true)
.build()
)
.build()
// 將請求入列
WorkManager.getInstance().enqueue(pullRequest)
// 獲取請求ID
val pullRequestId = pullRequest.id
// 存在SharedPreference中
PreferenceManager
.getDefaultSharedPreferences(context)
.edit()
.putString("pullId", pullRequestId.toString())
.apply()
}
