Migrar el SDK de iOS de Adapty a v4.3 y v4.4

Para actualizar tu app del SDK de iOS de Adapty 4.1 o 4.2 a 4.4, aplica todos los cambios de esta guía. Si tu app ya usa 4.3, aplica solo los cambios introducidos en v4.4. Una app en 4.0 necesita primero los cambios de v4.1.

Warning

El formato del archivo de respaldo cambió en la versión 4.4 y el compilador no puede detectar un archivo desactualizado. Sin un nuevo archivo de respaldo, cada placement perderá su respaldo.

Referencia rápida

AntesDespuésVersión
localizedPrice y currencyCode pueden ser nilAmbas propiedades siempre devuelven una cadena4.3.0
Sin código de error billingPlanUnavailableAdaptyError.ErrorCode incluye billingPlanUnavailable4.3.0
Adapty.reportTransaction con un Transaction simpleAdapty.reportTransaction con un VerificationResult<Transaction>; la sobrecarga de Transaction está obsoleta4.3.2
case let .custom(id)case let .custom(id, _)4.4.0
AdaptyUICustomAssetAdaptyUIAsset; AdaptyCustomAsset no cambia4.4.0
.color(.uiColor(x)) y .color(.swiftUIColor(c)).color(Color(uiColor: x)) y .color(c)4.4.0
AdaptyUICustomFontAsset(font:defaultColor:defaultLetterSpacing:defaultLineHeight:)AdaptyUIFontAsset(font:color:letterSpacing:lineHeight:)4.4.0
Sin recursos de datosAdaptyUIAsset incluye .data para recursos de datos4.4.0
AdaptyProduct.localizedBillingPeriodsubscriptionPricingTerms?.localizedBillingPeriod4.4.0
Archivo de respaldo descargado para 4.1–4.3Nuevo formato de archivo de respaldo; descarga el archivo de nuevo4.4.0

Cambios en v4.3

localizedPrice y currencyCode ya no son opcionales

En la versión 4.3, las propiedades localizedPrice y currencyCode de AdaptyPaywallProduct y AdaptySubscriptionOffer siempre devuelven una cadena, nunca nil. El código que las comprueba como nil con if let, guard let o ?. no compila. Elimina estas comprobaciones:

- if let price = product.localizedPrice {
-     priceLabel.text = price
- }
+ priceLabel.text = product.localizedPrice

Elimina también los valores por defecto con ?? en estas propiedades: compilan, pero con una advertencia.

AdaptyError.ErrorCode incluye billingPlanUnavailable

4.3 añade el código de error billingPlanUnavailable. Una sentencia switch que lista todos los códigos de error sin rama default dejará de compilarse. Para solucionarlo, añade una rama case .billingPlanUnavailable o una rama default.

La sobrecarga Transaction de reportTransaction está obsoleta

En la versión 4.3.2, la sobrecarga Adapty.reportTransaction(_:withVariationId:) que acepta una Transaction sin firma de App Store genera una advertencia de obsolescencia. Para reportar la transacción con su firma de App Store, pasa el VerificationResult<Transaction> que devuelve StoreKit:

- try await Adapty.reportTransaction(transaction, withVariationId: variationId)
+ try await Adapty.reportTransaction(verificationResult, withVariationId: variationId)

Cambios en v4.4

AdaptyUI.Action.custom contiene dos valores

Cuando un usuario pulsa un botón con una acción personalizada, tu app recibe AdaptyUI.Action.custom. En la versión 4.4, incluye un segundo valor, arguments, después del ID de la acción. En el closure didPerformAction y en el método delegado flowController(_:didPerform:), añade _ para este segundo valor:

  switch action {
- case let .custom(id):
+ case let .custom(id, _):
      if id == "openNewPaywall" {
          // Display another flow or paywall
      }
  default:
      break
  }
switch action.id {
case .system(let id) where id == "login":
    // Handle login
case .system(let id) where id == "restore":
    // Handle restore
case .custom(_, let id):
    // Custom action
    print("Custom action: \(id)")
@unknown default:
    break
}

Recursos personalizados

En la versión 4.4, AdaptyUICustomAsset pasa a llamarse AdaptyUIAsset. El nombre anterior genera una advertencia de deprecación.

Los recursos de color, fuente y datos cambian de tres maneras:

  • Recursos de color: .color acepta un Color de SwiftUI. AdaptyUICustomColorAsset se elimina. Envuelve un UIColor en Color(uiColor:) y pasa un Color de SwiftUI directamente:

    - "brand_color": .color(.uiColor(brandColor)),
    + "brand_color": .color(Color(uiColor: brandColor)),
  • Activos de fuente: AdaptyUIFontAsset usa color:, letterSpacing:, y lineHeight: en lugar de defaultColor:, defaultLetterSpacing:, y defaultLineHeight:. El parámetro color: acepta un Color de SwiftUI:

    - "title_font": .font(AdaptyUICustomFontAsset(font: titleFont, defaultColor: .uiColor(.white), defaultLineHeight: 24)),
    + "title_font": .font(AdaptyUIFontAsset(font: titleFont, color: .white, lineHeight: 24)),
  • Activos de datos: AdaptyUIAsset incluye un nuevo tipo de activo, .data. Una sentencia switch que lista todos los tipos de activo sin rama default dejará de compilar. Solo los elementos personalizados leen activos de datos, por lo que la nueva rama puede estar vacía: case .data: break.

AdaptyProduct.localizedBillingPeriod está obsoleto

AdaptyProduct tiene una propiedad subscriptionPricingTerms que describe cada pago del producto: su precio y la frecuencia con la que el usuario paga. En la versión 4.4, localizedBillingPeriod, el texto que indica la frecuencia de pago, se traslada de AdaptyProduct a subscriptionPricingTerms. AdaptyProduct.localizedBillingPeriod sigue funcionando, pero con una advertencia de obsolescencia: devuelve subscriptionPricingTerms?.localizedBillingPeriod. Para eliminar la advertencia, lee la propiedad desde los términos de precios:

- let period = product.localizedBillingPeriod
+ let period = product.subscriptionPricingTerms?.localizedBillingPeriod

Archivos de respaldo

El formato del archivo de respaldo cambió en el SDK 4.4. Descarga el archivo nuevamente desde Placements > Fallbacks, selecciona Adapty SDK v4.4.0 and higher y agrégalo a tu app.

El archivo descargado se llama ios_4_4_0_fallback.json. Asígnale el nombre que tu app pasa a Bundle.main.url(forResource:withExtension:), o actualiza ese nombre en la llamada.

Warning

Un archivo de respaldo desactualizado no produce ningún error de compilación. Cada placement pierde silenciosamente su paywall de respaldo. El log del SDK mostrará entonces “The fallback paywalls version is not correct. Download a new one from the Adapty Dashboard.”