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.
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
| Önce | Sonra | Sürüm |
|---|---|---|
localizedPrice ve currencyCode değerleri nil olabilir | Her iki özellik de her zaman bir string döndürür | 4.3.0 |
billingPlanUnavailable hata kodu yok | AdaptyError.ErrorCode artık billingPlanUnavailable içeriyor | 4.3.0 |
Adapty.reportTransaction ile düz bir Transaction | Adapty.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 |
AdaptyUICustomAsset | AdaptyUIAsset; AdaptyCustomAsset değişmedi | 4.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 yok | AdaptyUIAsset artık veri asset’leri için .data içeriyor | 4.4.0 |
AdaptyProduct.localizedBillingPeriod | subscriptionPricingTerms?.localizedBillingPeriod | 4.4.0 |
| 4.1–4.3 için yedek dosya indirildi | Yeni yedek dosya formatı; dosyayı tekrar indirin | 4.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, SwiftUIColoralır.AdaptyUICustomColorAssetkaldırıldı. BirUIColor’ıColor(uiColor:)ile sarmalayın ve doğrudan SwiftUIColorgeçirin:- "brand_color": .color(.uiColor(brandColor)), + "brand_color": .color(Color(uiColor: brandColor)), -
Font varlıkları:
AdaptyUIFontAsset,defaultColor:,defaultLetterSpacing:vedefaultLineHeight:yerinecolor:,letterSpacing:velineHeight:parametrelerini alır.color:parametresi bir SwiftUIColoralı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 vedefaultdalı bulunmayan birswitchifadesi 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.
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.”