Kotlin Coroutines在Android中的實踐

本文轉載自查看原文 2019-12-05 09:32 1730 Coroutines/ Android/ Kotlin

Coroutines在Android中的實踐

前面兩篇文章講了協程的基礎知識和協程的通信.
見:

Kotlin Coroutines不復雜, 我來幫你理一理
Kotlin協程通信機制: Channel
舉的例子可能離實際的應用代碼比較遙遠.

這篇我們就從Android應用的角度, 看看實踐中都有哪些地方可以用到協程.

本文被收錄在: https://github.com/mengdd/KotlinTutorials

Coroutines的用途

Coroutines在Android中可以幫我們做什么:

取代callbacks, 簡化代碼, 改善可讀性.
保證Main safety.
結構化管理和取消任務, 避免泄漏.

這有一個例子:

suspend fun fetchDocs() {                      // Dispatchers.Main
    val result = get("developer.android.com")  // Dispatchers.Main
    show(result)                               // Dispatchers.Main
}

suspend fun get(url: String) =                 // Dispatchers.Main
    withContext(Dispatchers.IO) {              // Dispatchers.IO (main-safety block)
        /* perform network IO here */          // Dispatchers.IO (main-safety block)
    }                                          // Dispatchers.Main
}

這里get是一個suspend方法, 只能在另一個suspend方法或者在一個協程中調用.

get方法在主線程被調用, 它在開始請求之前suspend了協程, 當請求返回, 這個方法會resume協程, 回到主線程. 網絡請求不會block主線程.

main-safety是如何保證的呢?

dispatcher決定了協程在什么線程上執行. 每個協程都有dispatcher. 協程suspend自己, dispatcher負責resume它們.

Dispatchers.Main: 主線程: UI交互, 更新LiveData, 調用suspend方法等.
Dispatchers.IO: IO操作, 數據庫操作, 讀寫文件, 網路請求.
Dispatchers.Default: 主線程之外的計算任務(CPU-intensive work), 排序, 解析JSON等.

一個好的實踐是使用withContext()來確保每個方法都是main-safe的, 調用者可以在主線程隨意調用, 不用關心里面的代碼到底是哪個線程的.

管理協程

之前講Scope和Structured Concurrency的時候提過, scope最典型的應用就是按照對象的生命周期, 自動管理其中的協程, 及時取消, 避免泄漏和冗余操作.

在協程之中再啟動新的協程, 父子協程是共享scope的, 也即scope會track其中所有的協程.

協程被取消會拋出CancellationException.

coroutineScope和supervisorScope可以用來在suspend方法中啟動協程. Structured concurrency保證: 當一個suspend函數返回時, 它的所有工作都執行完畢.

它們兩者的區別是: 當子協程發生錯誤的時候, coroutineScope會取消scope中的所有的子協程, 而supervisorScope不會取消沒有發生錯誤的其他子協程.

Activity/Fragment & Coroutines

在Android中, 可以把一個屏幕(Activity/Fragment)和一個CoroutineScope關聯, 這樣在Activity或Fragment生命周期結束的時候, 可以取消這個scope下的所有協程, 好避免協程泄漏.

利用CoroutineScope來做這件事有兩種方法: 創建一個CoroutineScope對象和activity的生命周期綁定, 或者讓activity實現CoroutineScope接口.

方法1: 持有scope引用:

class Activity {
    private val mainScope = MainScope()
    
    fun destroy() {
        mainScope.cancel()
    }
}

方法2: 實現接口:

class Activity : CoroutineScope by CoroutineScope(Dispatchers.Default) {
    fun destroy() {
        cancel() // Extension on CoroutineScope
    }
}

默認線程可以根據實際的需要指定.
Fragment的實現類似, 這里不再舉例.

ViewModel & Coroutines

Google目前推廣的MVVM模式, 由ViewModel來處理邏輯, 在ViewModel中使用協程, 同樣也是利用scope來做管理.

ViewModel在屏幕旋轉的時候並不會重建, 所以不用擔心協程在這個過程中被取消和重新開始.

方法1: 自己創建scope

private val viewModelJob = Job()

private val uiScope = CoroutineScope(Dispatchers.Main + viewModelJob)

默認是在UI線程.
CoroutineScope的參數是CoroutineContext, 是一個配置屬性的集合. 這里指定了dispatcher和job.

在ViewModel被銷毀的時候:

override fun onCleared() {
    super.onCleared()
    viewModelJob.cancel()
}

這里viewModelJob是uiScope的job, 取消了viewModelJob, 所有這個scope下的協程都會被取消.

一般CoroutineScope創建的時候會有一個默認的job, 可以這樣取消:

uiScope.coroutineContext.cancel()

方法2: 利用`viewModelScope`

如果我們用上面的方法, 我們需要給每個ViewModel都這樣寫. 為了避免這些boilerplate code, 我們可以用viewModelScope.

注: 要使用viewModelScope需要添加相應的KTX依賴.

For ViewModelScope, use androidx.lifecycle:lifecycle-viewmodel-ktx:2.1.0-beta01 or higher.

viewModelScope綁定的是Dispatchers.Main, 會自動在ViewModel clear的時候自動取消.

用的時候直接用就可以了:

class MainViewModel : ViewModel() {
    // Make a network request without blocking the UI thread
    private fun makeNetworkRequest() {
       // launch a coroutine in viewModelScope 
        viewModelScope.launch(Dispatchers.IO) {
            // slowFetch()
        }
    }

    // No need to override onCleared()
}

所有的setting up和clearing工作都是庫完成的.

LifecycleScope & Coroutines

每一個Lifecycle對象都有一個LifecycleScope.

同樣也需要添加依賴:

For LifecycleScope, use androidx.lifecycle:lifecycle-runtime-ktx:2.2.0-alpha01 or higher.

要訪問CoroutineScope可以用lifecycle.coroutineScope或者lifecycleOwner.lifecycleScope屬性.

比如:

activity.lifecycleScope.launch {}
fragment.lifecycleScope.launch {}
fragment.viewLifecycleOwner.launch {}

lifecycleScope可以啟動協程, 當Lifecycle結束的時候, 任何這個scope中啟動的協程都會被取消.

這比較適合於處理一些帶delay的UI操作, 比如需要用handler.postDelayed的更新UI的操作, 有多個操作的時候嵌套難看, 還容易有泄漏問題.

用了lifecycleScope之后, 既避免了嵌套代碼, 又自動處理了取消.

lifecycleScope.launch {
    delay(DELAY)
    showFullHint()
    delay(DELAY)
    showSmallHint()
}

LifecycleScope和ViewModelScope

但是LifecycleScope啟動的協程卻不適合調用repository的方法. 因為它的生命周期和Activity/Fragment是一致的, 太碎片化了, 容易被取消, 造成浪費.

設備旋轉時, Activity會被重建, 如果取消請求再重新開始, 會造成一種浪費.

可以把請求放在ViewModel中, UI層重新注冊獲取結果. viewModelScope和lifecycleScope可以結合起來使用.

舉例: ViewModel這樣寫:

class NoteViewModel: ViewModel {
    val noteDeferred = CompletableDeferred<Note>()
    
    viewModelScope.launch {
        val note = repository.loadNote()
        noteDeferred.complete(note)
    }
    
    suspend fun loadNote(): Note = noteDeferred.await()
}

而我們的UI中:

fun onCreate() {
    lifecycleScope.launch {
        val note = userViewModel.loadNote()
        updateUI(note)
    }
}

這樣做之后的好處:

ViewModel保證了數據請求沒有浪費, 屏幕旋轉不會重新發起請求.
lifecycleScope保證了view沒有leak.

特定生命周期階段

盡管scope提供了自動取消的方式, 你可能還有一些需求需要限制在更加具體的生命周期內.

比如, 為了做FragmentTransaction, 你必須等到Lifecycle至少是STARTED.

上面的例子中, 如果需要打開一個新的fragment:

fun onCreate() {
    lifecycleScope.launch {
        val note = userViewModel.loadNote()
        fragmentManager.beginTransaction()....commit() //IllegalStateException
    }
}

很容易發生IllegalStateException.

Lifecycle提供了:
lifecycle.whenCreated, lifecycle.whenStarted, lifecycle.whenResumed.

如果沒有至少達到所要求的最小生命周期, 在這些塊中啟動的協程任務, 將會suspend.

所以上面的例子改成這樣:

fun onCreate() {
    lifecycleScope.launchWhenStarted {
        val note = userViewModel.loadNote()
        fragmentManager.beginTransaction()....commit()
    }
}

如果Lifecycle對象被銷毀(state==DESTROYED), 這些when方法中的協程也會被自動取消.

LiveData & Coroutines

LiveData是一個供UI觀察的value holder.

LiveData的數據可能是異步獲得的, 和協程結合:

val user: LiveData<User> = liveData {
    val data = database.loadUser() // loadUser is a suspend function.
    emit(data)
}

這個例子中的liveData是一個builder function, 它調用了讀取數據的方法(一個suspend方法), 然后用emit()來發射結果.

同樣也是需要添加依賴的:

For liveData, use androidx.lifecycle:lifecycle-livedata-ktx:2.2.0-alpha01 or higher.

實際上使用時, 可以emit()多次:

val user: LiveData<Result> = liveData {
    emit(Result.loading())
    try {
        emit(Result.success(fetchUser()))
    } catch(ioException: Exception) {
        emit(Result.error(ioException))
    }
}

每次emit()調用都會suspend這個塊, 直到LiveData的值在主線程被設置.

LiveData還可以做變換:

class MyViewModel: ViewModel() {
    private val userId: LiveData<String> = MutableLiveData()
    val user = userId.switchMap { id ->
        liveData(context = viewModelScope.coroutineContext + Dispatchers.IO) {
            emit(database.loadUserById(id))
        }
    }
}

如果數據庫的方法返回的類型是LiveData類型, emit()方法可以改成emitSource(). 例子見: Use coroutines with LiveData.

網絡/數據庫 & Coroutines

根據Architecture Components的構建模式:

ViewModel負責在主線程啟動協程, 清理時取消協程, 收到數據時用LiveData傳給UI.
Repository暴露suspend方法, 確保方法main-safe.
數據庫和網絡暴露suspend方法, 確保方法main-safe. Room和Retrofit都是符合這個pattern的.

Repository暴露suspend方法, 是主線程safe的, 如果要對結果做一些heavy的處理, 比如轉換計算, 需要用withContext自行確定主線程不被阻塞.

Retrofit & Coroutines

Retrofit從2.6.0開始提供了對協程的支持.

定義方法的時候加上suspend關鍵字:

interface GitHubService {
    @GET("orgs/{org}/repos?per_page=100")
    suspend fun getOrgRepos(
        @Path("org") org: String
    ): List<Repo>
}

suspend方法進行請求的時候, 不會阻塞線程.
返回值可以直接是結果類型, 或者包一層Response:

@GET("orgs/{org}/repos?per_page=100")
suspend fun getOrgRepos(
    @Path("org") org: String
): Response<List<Repo>>

Room & Coroutines

Room從2.1.0版本開始提供對協程的支持. 具體就是DAO方法可以是suspend的.

@Dao
interface UsersDao {
    @Query("SELECT * FROM users")
    suspend fun getUsers(): List<User>

    @Insert
    suspend fun insertUser(user: User)

    @Update
    suspend fun updateUser(user: User)

    @Delete
    suspend fun deleteUser(user: User)
}

Room使用自己的dispatcher來確定查詢運行在后台線程.
所以你的代碼不應該使用withContext(Dispatchers.IO), 會讓代碼變得復雜並且查詢變慢.

更多內容可見: Room 🔗 Coroutines.

WorkManager & Coroutines

WorkManager也有協程版本, 添加work-runtime-ktx依賴, 然后改變基類, 以前繼承Worker, 現在繼承CoroutineWorker.
比如:

class UploadNotesWorker(...) : CoroutineWorker(...) {
    suspend fun doWork(): Result {
        val newNotes = db.queryNewNotes()
        noteService.uploadNotes(newNotes)
        db.markAsSynced(newNotes)
        return Result.success()
    }
}

這段代碼其中數據庫用Room, 網絡用Retrofit, 這樣3個方法都是suspend的.

用了協程的版本之后, 取消操作更容易.

更詳細的請看: Threading in CoroutineWorker

異常處理

suspend方法中的異常將會resume到調用者.
更一般的, 協程中的錯誤會通知到它的調用者或者scope.

launch和async的異常處理不同.
這是因為async返回值, 是期待await調用的, 所以會持有異常, 在調用await()的時候才返回(結果或異常).
所以如果await()沒有被調用的話, 異常就會被吃了.

測試

推薦使用runBlockingTest來替換runBlocking, 將會利用virtual time, 節省測試時間.

更多關於測試的詳細內容見: kotlinx-coroutines-test

參考

博客:

Google的視頻:

歡迎關注微信公眾號: 聖騎士Wind

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 android中通過kotlin使用WebView（二） android中通過kotlin使用WebView kotlin使用anko在Android中實現Activity跳轉，超優雅！ Kotlin, Android的Swift Android Kotlin 連接 http Android架構（一）MVP架構在Android中的實踐 Android的Kotlin秘方（I）：OnGlobalLayoutListener Android開發者的Kotlin：書 Android-Kotlin-枚舉enum Android studio中java調用Kotlin類報錯：無法找到符號