Adapty iOS SDK'yı v4.3 ve v4.4'e Geçirme

Uygulamanızı Adapty iOS SDK 4.1 veya 4.2’den 4.4’e güncellemek için bu kılavuzdaki her değişikliği uygulayın. Uygulamanız zaten 4.3 kullanıyorsa yalnızca v4.4’te yapılan değişiklikleri uygulayın. 4.0 kullanan bir uygulamanın önce v4.1 değişikliklerine ihtiyacı vardır.

Warning

Yedek dosya formatı 4.4 sürümünde değişti ve derleyici eski bir dosyayı tespit edemez. Yeni bir yedek dosya olmadan, her placement yedekten yararlanamaz.

Hızlı başvuru kılavuzu

ÖnceSonraSürüm
localizedPrice ve currencyCode değerleri nil olabilirHer iki özellik de her zaman bir string döndürür4.3.0
billingPlanUnavailable hata kodu yokAdaptyError.ErrorCode artık billingPlanUnavailable içeriyor4.3.0
Adapty.reportTransaction ile düz bir TransactionAdapty.reportTransaction artık VerificationResult<Transaction> alıyor; Transaction aşırı yüklemesi kullanımdan kaldırıldı4.3.2
case let .custom(id)case let .custom(id, _)4.4.0
AdaptyUICustomAssetAdaptyUIAsset; AdaptyCustomAsset değişmedi4.4.0
.color(.uiColor(x)) ve .color(.swiftUIColor(c)).color(Color(uiColor: x)) ve .color(c)4.4.0
AdaptyUICustomFontAsset(font:defaultColor:defaultLetterSpacing:defaultLineHeight:)AdaptyUIFontAsset(font:color:letterSpacing:lineHeight:)4.4.0
Veri asset’i yokAdaptyUIAsset artık veri asset’leri için .data içeriyor4.4.0
AdaptyProduct.localizedBillingPeriodsubscriptionPricingTerms?.localizedBillingPeriod4.4.0
4.1–4.3 için yedek dosya indirildiYeni yedek dosya formatı; dosyayı tekrar indirin4.4.0

v4.3’teki Değişiklikler

localizedPrice ve currencyCode artık opsiyonel değil

4.3 sürümünde, AdaptyPaywallProduct ve AdaptySubscriptionOffer nesnesinin localizedPrice ve currencyCode özellikleri artık her zaman bir string döndürür, hiçbir zaman nil döndürmez. Bu özellikleri if let, guard let veya ?. ile nil kontrolüne tabi tutan kodlar derlenmez. Bu kontrolleri kaldırın:

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

Bu özelliklerde ?? ile belirtilen varsayılan değerleri de kaldırın: bunlar derlenir ama uyarı üretir.

AdaptyError.ErrorCode artık billingPlanUnavailable içeriyor

4.3, billingPlanUnavailable hata kodunu ekliyor. Her hata kodunu listeleyen ve default dalı olmayan bir switch ifadesi artık derlenmez. Bunu düzeltmek için case .billingPlanUnavailable dalı ya da bir default dalı ekleyin.

reportTransaction’ın Transaction aşırı yüklemesi kullanımdan kaldırıldı

4.3.2 sürümünde, App Store imzası olmadan yalnızca Transaction alan Adapty.reportTransaction(_:withVariationId:) aşırı yüklemesi kullanımdan kaldırma uyarısı verir. İşlemi App Store imzasıyla birlikte bildirmek için StoreKit’in döndürdüğü VerificationResult<Transaction> değerini geçirin:

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

v4.4’teki Değişiklikler

AdaptyUI.Action.custom İki Değer İçeriyor

Bir kullanıcı özel eylemli bir butona dokunduğunda, uygulamanız AdaptyUI.Action.custom alır. 4.4 sürümünde, eylem ID’sinin ardından ikinci bir değer olan arguments eklendi. didPerformAction closure’ında ve flowController(_:didPerform:) delegate metodunda, bu ikinci değer için _ ekleyin:

  switch action {
- case let .custom(id):
+ case let .custom(id, _):
      if id == "openNewPaywall" {
          // Display another flow or paywall
      }
  default:
      break
  }

title: “iOS – Adapty’yi uygulamanıza entegre edin” description: “Adapty iOS SDK’yı Swift veya Objective-C projenize entegre edin.” metadataTitle: “iOS SDK Entegrasyonu | Adapty Dokümanları”

Kod, id’yi bir string ile karşılaştıran kısımda, _ ekleyene kadar derlenmez. Diğer kodlar hâlâ derlenir; ancak “enum case ‘custom’ has 2 associated values; matching them as a tuple is deprecated” uyarısı verir. O kodda id, yalnızca action ID’sini değil, her iki değeri de içerir. Xcode’un bu uyarıyı gösterdiği her yere _ ekleyin.

Özel varlıklar

4.4 sürümünde AdaptyUICustomAsset, AdaptyUIAsset olarak yeniden adlandırıldı. Eski ad kullanıldığında deprecation uyarısı tetiklenir.

Renk, font ve data varlıkları üç şekilde değişti:

  • Renk varlıkları: .color, SwiftUI Color alır. AdaptyUICustomColorAsset kaldırıldı. Bir UIColor’ı Color(uiColor:) ile sarmalayın ve doğrudan SwiftUI Color geçirin:

    - "brand_color": .color(.uiColor(brandColor)),
    + "brand_color": .color(Color(uiColor: brandColor)),
  • Font varlıkları: AdaptyUIFontAsset, defaultColor:, defaultLetterSpacing: ve defaultLineHeight: yerine color:, letterSpacing: ve lineHeight: parametrelerini alır. color: parametresi bir SwiftUI Color alır:

    - "title_font": .font(AdaptyUICustomFontAsset(font: titleFont, defaultColor: .uiColor(.white), defaultLineHeight: 24)),
    + "title_font": .font(AdaptyUIFontAsset(font: titleFont, color: .white, lineHeight: 24)),
  • Veri varlıkları: AdaptyUIAsset, yeni bir varlık türü olan .data’yı içeriyor. Her varlık türünü listeleyen ve default dalı bulunmayan bir switch ifadesi artık derlenmeyecektir. Veri varlıklarını yalnızca özel öğeler okuyacağından, yeni dal boş bırakılabilir: case .data: break.

AdaptyProduct.localizedBillingPeriod artık kullanımdan kaldırıldı

AdaptyProduct, ürün için her ödemeyi açıklayan bir subscriptionPricingTerms özelliğine sahiptir: fiyatı ve kullanıcının ne sıklıkla ödeme yaptığını. 4.4 sürümünde, kullanıcının ne sıklıkta ödeme yaptığını gösteren metin olan localizedBillingPeriod, AdaptyProduct’tan subscriptionPricingTerms’e taşındı. AdaptyProduct.localizedBillingPeriod hâlâ çalışmakta olup kullanım dışı bırakma uyarısı verir: subscriptionPricingTerms?.localizedBillingPeriod değerini döndürür. Uyarıyı kaldırmak için özelliği fiyatlandırma koşullarından okuyun:

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

Yedek dosyalar

Yedek dosya formatı SDK 4.4 sürümünde değişti. Dosyayı Placements > Fallbacks bölümünden tekrar indirin, Adapty SDK v4.4.0 and higher seçeneğini belirleyin ve uygulamanıza ekleyin.

İndirilen dosyanın adı ios_4_4_0_fallback.json olacaktır. Uygulamanızın Bundle.main.url(forResource:withExtension:) çağrısına geçirdiği adı kullanın ya da bu çağrıdaki adı güncelleyin.

Warning

Güncel olmayan bir yedek dosya herhangi bir derleme hatası üretmez. Her placement sessizce yedek paywall’unu kaybeder. SDK günlüğü ardından şunu gösterir: “The fallback paywalls version is not correct. Download a new one from the Adapty Dashboard.”