Swift Concurrency まとめ

Last updated at 2025-03-07Posted at 2021-08-16

WWDC

Meet async/await in Swift

非同期処理をコールバックやデリゲートで書いていましたが、async/awaitキーワードを使って自然にかけるようになりました。

非同期の処理を行う関数、変数やイニシャライザの宣言部分にasyncをつけます。これを呼び出す時、awaitキーワードをつけて呼ぶだけです。エラー処理のあるような関数ではthrowsも同時につけることが多いと思いますが、async throwsの順で、呼び出し時はtry awaitの順でつけます。

hoge.swift

func someAsyncfunction() async throws String {
...
}

let result = try await someAsyncfunction()

awaitで他の関数呼び出している関数自体も、asyncキーワードをつけて宣言し直す必要があります。

async をつけると、そこで一旦処理がストップし、先に進まなくなります。しかしスレッドを占有はしないため、待っている間も他の処理（例えばユーザーのUI操作への対応など）は挟まることができます。asyncをつけた処理が終わると、一旦ストップしていた処理が再開し、次の業に進んでいくことになります。

awaitは、次の行以降でその関数の結果が必要な時に使う
async letは、次の行では直ちにその関数の結果は必要なく、もっと後になってからで良いという時に使う
awaitでもasync letでも、アプリの他の箇所で行われている非同期処理は止まらない

というのが区別のポイントです。

.hoge.swift

func someAsyncfunction() async throws String {
...
}

func anotherAsyncfunction() async throws String? {
   let result = try? await someAsyncfunction()
   return result
}

非同期処理の関数は、XCTestでテストするときexpectationを使ってわざわざ待ち受けするなど、面倒な書き方をしなくてはいけませんでしたが、これも必要なくなり、普通の関数とほとんど同じように書けるようになります。違うのはasyncをつけるだけです。

なんらかのクロージャの中でasyncを使おうとすると、そのクロージャ自体がawaitに対応していないためそのままだとうまく使えない場合があります。その場合、async { }クロージャで囲うと対応できます。

既存で、コールバックを使っている非同期処理関数を、continuationを使って、awaitの関数に置き換えることができます。
continuation.resume()を呼んだところで結果が返されますが、全てのパスでresume()を一回必ず呼んでいることを確かめる必要があります。呼んでいないとコンパイラから警告が来るとのこと。

なお、このようなコンパイラの警告がないUnsafeContinuationもあります。これはパフォーマンス重視の場合に使用しますが、resumeの呼び方を間違っていないかどうか入念なテストがいると思われます。

また、逆に一つのパスでresume()を複数回呼ばないように気をつけましょう。これも警告が出るとのこと。

既存でデリゲートを使っている非同期処理も、continuationをメンバー変数とすることで、awaitの関数に置き換えることができます。

Explore structured concurrency in Swift

https://developer.apple.com/videos/play/wwdc2021/10134/
https://docs.swift.org/swift-book/LanguageGuide/Concurrency.html

上のセッションでも述べられていましたが、
async をつけると、そこで一旦処理がストップし、先に進まなくなります。asyncをつけた処理が終わると、一旦ストップしていた処理が再開し、次の行に進んでいくことになります。複数のasyncをつけた非同期処理があるとなると、そのままでは、一つ目が終わるまでストップし、その後初めて二つ目のasyncに進むことになります。↓

.hoge.swift

let (data, _) = try await URLSession.shared.data(for: imageRequest) //終わるまで次の行に行かない
let (metadata, _) = try await URLSession.shared.data(for: metadataRequest) //終わるまで次の行に行かない

async let

ここで普通のasyncではなくasync letというものを使うと、async letのところで処理が一旦ストップせず、子タスクが作られてそちらで処理される一方、メインの処理はすぐ次の行の処理に進んでいくことになります。そこで処理がサスペンドするわけではないのでawaitないしtry awaitは不要となります。のちに変数の中身を参照するとき初めてawaitをつけていくことになります。
例えば以下では、画像データのダウンロードが終わるのを待たず、メタデータのダウンロードも始まり、二つの非同期処理が同時に走ることになります。

.hoge.swift


func fetchOneThumbnail(withID id: String) async throws -> UIImage {
   async let (data, _) = URLSession.shared.data(for: imageRequest) //子タスクを作り、直ちに次の行に進む
   async let (metadata, _) = URLSession.shared.data(for: metadataRequest) //こタスクを作り、直ちに次の行に進む

   guard 
      let size = parseSize(from: try await metadata), // この時点で初めてtry awaitをつける
      let image = try await UIImage(data?).byPreparingThumbnail(ofSize: size) // この時点で初めてtry awaitをつける
   else {
   //throw some error
   }
}

この時、内部的には、Taskというクラスのオブジェクトが内部的には作られています。
関数fetchOneThumbnailが親タスクとなり、その下に子タスクdata metadataがぶら下がる形となるのです。
Taskはキャンセル可能です。しかしキャンセルした時も自動的にTaskがストップするわけではないので、キャンセルがありうるようなケースでは、キャンセルされたかどうかをチェックする必要があります。明示的にキャンセルする場合のほか、Taskを設定したクラスが消滅した場合などにもキャンセルされるので、基本Taskの中には常にキャンセルチェックを入れたほうがいいでしょう。

checkCancellation
isCancelled

以上はポーリング的にキャンセルされたかを定期的にチェックする感じです。

AsyncSequence内部など、キャンセルされた時に直ちに検知し何かしたい場合は、withTaskCancellationHandlerが利用できます。参考: WWDC 構造化並行処理の基本を超えて

以下、引用

Download.swift

import Foundation

class Wrapper<Wrapped> {
    var value: Wrapped
    init(_ value: Wrapped) { self.value = value }
}

func download(url: URL) async throws -> Data? {
    let urlSessionTask: Wrapper<URLSessionTask?> = Wrapper(nil)

    return try await withTaskCancellationHandler {
        try await withUnsafeThrowingContinuation { continuation in
            urlSessionTask.value = URLSession.shared.dataTask(with: url) { data, _, error in
                if let error = error {
                    continuation.resume(throwing: error)
                } else {
                    continuation.resume(returning: data)
                }
            }
            urlSessionTask.value?.resume()
        }
    } onCancel: {
        urlSessionTask.value?.cancel()
    }
}

以上、引用
Swift ConcurrencyのwithTaskCancellationHandlerとSendableより

Storeという会社さんが導入した例が以下になります。open-ai generatorにより生成した内容だそうです。

以下、引用

open class func session(sessionParams: SessionParams? = nil) async throws -> SessionToken {
    var requestTask: RequestTask?
    return try await withTaskCancellationHandler {
        try Task.checkCancellation()
        return try await withCheckedThrowingContinuation { continuation in
            guard !Task.isCancelled else {
                continuation.resume(throwing: CancellationError())
                return
            }

            requestTask = sessionWithRequestBuilder(sessionParams: sessionParams).execute { result in
                switch result {
                case let .success(response):
                    continuation.resume(returning: response.body)
                case let .failure(error):
                    continuation.resume(throwing: error)
                }
            }
        }
    } onCancel: { [requestTask] in
        requestTask?.cancel()
    }
}

以上、引用 STORES 予約アプリへのasync/await導入より

Group Tasks

動きとしてはasync letと同じく複数の非同期処理を同時並行でやるものとしてgroup tasksがあります。

withTaskGroup関数やwithThrowingTaskGroup関数でGroupTaskを開始します。

GroupTaskのクロージャ内でasyncを呼ぶと、子タスクを手動で開始できます。

複数の子タスクから結果を集約していくことになると思いますが、実は上のようにthumnailsという辞書型にデータを集めていくようなやり方だとコンパイルエラーが出ます。

子タスクからは変数に同時平行的にアクセスが走る可能性があるので、値型の変数や、actor、同時平行アクセスに対する対処を実装したクラス以外にはアクセスすべきではありません。物によってはこのようにコンパイルエラーが出ます。

下のようにfor awaitを使って子タスクの結果を集約すれば、コンパイルエラーは出ません。

Unstructured Tasks

以上までのタスク・子タスクの関係性を利用しての同時平行処理をStructured Tasksと呼んでいますが、タスクを利用しない同時平行処理をUnstructured Tasksと呼びます。

具体的には、例えばApple のUIKitでさまざまに定義されているデリゲートのメソッドなどはasyncで定義されていないので、そのままだと内部でawaitを呼ぶことができません。その際、async {}関数を使うと、どこからでもawaitが使えるようになります。

以下は、コレクションビューにおいて、あるアイテムが画面に出現したら画像ダウンロードを開始するが、画面から消えたらキャンセルする一例になります。コレクションビューのデリゲートがasyncなしであるためそのままではawaitを中で使うことができないので、async {}関数を用いて使っています。

Meet AsyncSequence

for-await-inループまたはfor-try-await-inで、連続した非同期処理を行うことができます。

for-await-inループを使うには対象がAsyncSequenceプロトコルに準拠している必要があります。しかし、既存のコールバックやデリゲートを使う処理など、AsyncSequenceプロトコルに準拠していない物でも、AsyncStreamでラップしてしまうと、比較的簡単にfor-await-inループに適合させられるようになります。

実際に使ってみると、以下のようになります。

Protect mutable state with Swift actors

Actorとはshared mutable stateを隔離し、データ競合を防ぐもの

データ競合というのが発生することがあります。二箇所（２スレッド）以上の箇所から同じデータにアクセスし、しかも読み込みではなく書き込みが一つ以上含まれる場合は、データ競合が起こり得ます。

値型(基本型や構造体など)のデータであれば、複数の箇所から参照されるということが起こり得ない（常にローカルでコピーが作られる）ので、データ競合は起こり得ません。が、他方で複数の場所から参照できる共有の状態というのは、値型では実現できないということになります。

というわけで今までは、複数箇所から同時並行的に参照・変更され得るような、共有のデータ（Shared mutable state in concurrent programs）を実現するには、参照型（クラスなど）で競合が起きないようDispatchQueueなどを用いるなどして注意深くコードを書くしかありませんでした。

今回導入されるActorでは、Shared Mutable Stateを簡単に実現できるように設計されたものです。Actor自身の状態を他のプログラム全ての部分から隔離する設計となっています。

Actorタイプはクラスと同様参照型で、クラスや構造体と同様変数・関数・イニシャライザ・エクステンションなどを定義することができます。

以下のように、データ競合を避けるため、Actorへアクセスする際はawaitキーワードで待受をする必要があります。

他方Actor自身がActor自身にアクセスするときは特に待受する必要はありません。

データが想定と異なる変更をされる可能性があることに注意

注意点として、Actorは複数箇所から（awaitで）アクセスされることから、awaitで待っている間に他の箇所からのアクセスによりActorの状態が当初の予想から変わってしまっていることがあります。そのためそれをあらかじめ想定しておく必要があります。

例えば以下は、画像をダウンロードするためのActorです。

まず、キャッシュをチェックし、キャッシュがある場合はダウンロードをせずにキャッシュを返しています。(if let cached = chche[url] { return cached })

もしキャッシュがなかったら初めてダウンロードをし、ダウンロードした画像をキャッシュに入れていくわけです。

最初の段階でキャッシュがないことをチェックしてはいます。しかし、ダウンロードが時間がかかる上、他の箇所からもこの部分のコードを通って同時にダウンロードをしている可能性があります。すると他の箇所から実行されているダウンロードが先に完了し、キャッシュを埋めている可能性があります。つまり最初の行でキャッシュがないことを確認していたとしても、自分の画像ダウンロードが終わった時には、他の画像でキャッシュが埋められている可能性があるわけです。

そのため、ダウンロードが終わった後(時間がかかる処理が終わった後)も、もう一度キャッシュをチェックする処理を入れています。そうして、キャッシュが入っていた時は元のキャッシュを尊重してダウンロードしてきた画像は破棄する、という例が紹介されています。
(cache[url] = cache[url, default: image]; return cache[url])

nonisolated キーワードを使ったプロトコルへの適合

actorをプロトコルに適合させる際問題が発生することがあります。何かactor内にある状態をにアクセスするようなメソッドを実装しなければいけないのに、awaitキーワードをつけることができないので、結果プロトコルに適合できないというような場合です。

この場合は、そのメソッドだけnonisolatedキーワードをつけると対応できます。nonisolatedキーワードをつけるということは、その部分はActorの外側として扱われるので、Actorの内側にある状態(mutable shared state)にアクセスすることはできません。下の例では、定数のidNumberにアクセスしているだけなので問題は生じません。

もしnonisolatedをつけているところからActorの変数にアクセスしようとすると、mutable shared stateにアクセスしようとしていることになるので、コンパイルエラーになります。

Actorが所有できるのはSendableプロトコルに適合した型のみ

もしActorが何かのクラス（以下ではBookクラス）の変数を所有していたとしましょう。するとクラスは参照型なので、他の箇所からもアクセスできてしまいます。つまり、Actorの内部の状態がActorを経ずに参照されてしまうということになります。

これを防ぐために、Actorが保有できるのは新しく導入されたSendableプロトコルに適合した型のみとされています。Sendableは複数スレッドからの実行の文脈で安全に共有できるかどうかの性質を表しています。値型（構造体・基本型など）や、Actorや、immutableなクラスが適合しています。言い換えれば、普通のクラスはSendableに適合していません。従って、Actorは変数として普通のクラスを持つことはできません。

なおSendableに適合するには、ある型の持っている変数が全てSendableに適合している必要があります。また、ジェネリックを用いる型をSendableに適合したい場合は、ジェネリックで導入する型が全てSendableに適合している必要があります。

メソッド・クロージャをSendableに適合させるには@Sendableでマーカーをつけます。@Sendableメソッドは値型の変数しか使うことができません。メソッドがキャプチャする対象もSendableプロトコルに適合している必要があります。以下では、@Sendableのクロージャの中でmutable関数を使っているのでエラーとなっています。

main actor

メインスレッド（UIの更新などを行うスレッド）というものがありました。今まで、例えばAPIなどでデータを持ってきた後、そのデータを用いてUIを更新する場合は、明示的にメインスレッドで行うようにするため、DispatchQueue.main.async {}等を使っていたかと思います。

今回導入されたmain actorはこれを簡単にできるようになっています。関数や変数に@MainActorという文字をつけると、それらの実行は常にメインスレッド上で行われることが保証されます。クラスの宣言などに@MainActorをつけた場合は、そのクラスの全変数・メソッドに@MainActorをつけたのと同じになります。

プログラムの中で、データを扱う部分の中でUIと接する部分（データを用いてUIに影響を与える部分）に@MainActorを使っていくと良いでしょう。

Discover concurrency in SwiftUI

async マークの付いた非同期メソッド(サーバーから画像をダウンロードする) を持っている、ObservableObjectに@MainActorマークをつける例が紹介されています。

これにより、該当のオブジェクトのメソッドが常にメインスレッド上で実行されることが保証されます。async キーワードをつけていることにより、非同期処理と実行中は一旦メインスレッドが明け渡しされるので、UIが止まってしまう心配はありません。非同期処理の終了次第、画面の更新の処理がメインスレッドで確実に行われることになります。