D1 SDK 4.5.0 の非同期 API

D1 SDK 4.5.0 の非同期 API

概要

D1 SDK 4.5.0 では、iOS 向けの非同期 API 更新が導入されます。

更新された API は Swift Concurrency をサポートします。

このガイドを使用して、影響を受ける API を確認し、イシュアアプリケーションを更新してください。

変更点

以前の API サーフェスは、D1 SDK 4.5.0 で非推奨になりました。

イシュアアプリケーションで非同期呼び出しを使用している場合は、完了ハンドラーを Swift Concurrency API に置き換えてください。

このページでは、4.5.0 で変更された API を一覧表示します。

移行先 digitalCardService

1

現在の統合を確認する

イシュアアプリケーションで使用されている非推奨の D1 SDK API を特定します。

現在次を通じて公開されている API に注目してください digitalCardService.

2

初期化 digitalCardService

初期化 digitalCardService から d1Task 更新された API を呼び出す前に。

3

完了ハンドラーを置き換える

各完了ハンドラー API を対応する async throws API に置き換えます。

4

移行したフローを検証する

移行後にイシュアアプリケーションをビルドしてテストします。

更新されたデジタルカードのフローを検証します。

非同期処理を更新する

イシュアアプリケーションで Swift Concurrency を使用している場合は、Swift Concurrency API を使用してください。

これにより、非同期コードの可読性と保守性が向上します。

digitalCardService 呼び出しでは現在 async throws 完了ハンドラーの代わりに使用されます。

4.5.0 の API 変更

このセクションを使用して、D1 SDK 4.5.0 で変更された API を確認してください。

サービスを次から初期化します d1Task API を呼び出す前に。

let digitalCardService = try d1Task.digitalCardService()

digitalCardService

activateDigitalCard(withDigitalCardID:)

以前:

public func activateDigitalCard(withDigitalCardID digitalCardID: String,
                                   completion: @escaping (D1Error?) -> Void)

現在:

public func activateDigitalCard(withDigitalCardID digitalCardID: String) async throws

activateDigitalCard(_:)

以前:

public func activateDigitalCard(_ cardID: String,
                                   completion: @escaping (D1Error?) -> Void)

現在:

public func activateDigitalCard(_ cardID: String) async throws

digitalCardList(_:)

以前:

public func digitalCardList(_ cardID: String,
                               completion: @escaping ([DigitalCard]?, D1Error?) -> Void)

現在:

public func digitalCardList(_ cardID: String) async throws -> [DigitalCard]

updateDigitalCard(_:digitalCard:action:)

以前:

public func updateDigitalCard(_ cardID: String,
                                 digitalCard: DigitalCard,
                                 action: CardAction,
                                 completion: @escaping (Bool, D1Error?) -> Void)

現在:

public func updateDigitalCard(_ cardID: String,
                                 digitalCard: DigitalCard,
                                 action: CardAction) async throws