APIs asíncronas en D1 SDK 4.5.0

APIs asíncronas en D1 SDK 4.5.0

Descripción general

D1 SDK 4.5.0 introduce actualizaciones de API asincrónicas para iOS.

Las API actualizadas son compatibles con la concurrencia de Swift.

Use esta guía para revisar las API afectadas y actualizar su aplicación del emisor.

Qué cambió

La superficie de API anterior está deprecada en D1 SDK 4.5.0.

Si su aplicación del emisor usa llamadas asincrónicas, reemplace los controladores de finalización con las API de concurrencia de Swift.

Esta página enumera las API cambiadas en 4.5.0.

Migrar a digitalCardService

1

Revise su integración actual

Identifique las API de D1 SDK deprecadas que usa su aplicación del emisor.

Céntrese en las API ahora expuestas a través de digitalCardService.

2

Inicialice digitalCardService

Inicialice digitalCardService de d1Task antes de llamar a las API actualizadas.

3

Reemplace los controladores de finalización

Reemplace cada API con controlador de finalización por la correspondiente async throws API.

4

Valide los flujos migrados

Compile y pruebe su aplicación del emisor después de la migración.

Valide los flujos actualizados de tarjeta digital.

Actualice el manejo asincrónico

Use las API de concurrencia de Swift si su aplicación del emisor usa concurrencia de Swift.

Esto hace que el código asincrónico sea más fácil de leer y mantener.

digitalCardService las llamadas ahora usan async throws en lugar de controladores de finalización.

Cambios de API en 4.5.0

Use esta sección para revisar las API cambiadas en D1 SDK 4.5.0.

Inicialice el servicio desde d1Task antes de llamar a las API.

let digitalCardService = try d1Task.digitalCardService()

digitalCardService

activateDigitalCard(withDigitalCardID:)

Antes:

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

Ahora:

public func activateDigitalCard(withDigitalCardID digitalCardID: String) async throws

activateDigitalCard(_:)

Antes:

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

Ahora:

public func activateDigitalCard(_ cardID: String) async throws

digitalCardList(_:)

Antes:

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

Ahora:

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

updateDigitalCard(_:digitalCard:action:)

Antes:

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

Ahora:

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