---
title: "Adapty iOS SDK'yı v4.3 ve v4.4'e Geçirme"
description: "Adapty iOS SDK v4.3 ve v4.4'e geçiş: fiyat, hata kodu, özel eylem ve özel varlık kodunuzu güncelleyin, ardından yeni bir yedek dosyası indirin."
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

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](#changes-in-v44) uygulayın. 4.0 kullanan bir uygulamanın önce [v4.1 değişikliklerine](migration-to-ios-sdk-41) 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](#fallback-files) olmadan, her placement yedekten yararlanamaz.
:::

## Hızlı başvuru kılavuzu \{#quick-reference\}

| Ö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 \{#changes-in-v43\}

### localizedPrice ve currencyCode artık opsiyonel değil \{#prices-are-no-longer-optional\}

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:

```diff showLineNumbers
- 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 \{#new-error-code\}

4.3, `billingPlanUnavailable` [hata kodunu](ios-sdk-error-handling#storekit-errors) 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ı \{#reporttransaction-overload-is-deprecated\}

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:

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

## v4.4'teki Değişiklikler \{#changes-in-v44\}

### AdaptyUI.Action.custom İki Değer İçeriyor \{#custom-actions\}

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:

```diff showLineNumbers
  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 \{#custom-assets\}

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:

  ```diff showLineNumbers
  - "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:

  ```diff showLineNumbers
  - "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](ios-flow-custom-elements) okuyacağından, yeni dal boş bırakılabilir: `case .data: break`.

### AdaptyProduct.localizedBillingPeriod artık kullanımdan kaldırıldı \{#localizedbillingperiod-is-deprecated\}

`AdaptyProduct`, ürün için her ödemeyi açıklayan bir [`subscriptionPricingTerms`](fetch-paywalls-and-products) ö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:

```diff showLineNumbers
- let period = product.localizedBillingPeriod
+ let period = product.subscriptionPricingTerms?.localizedBillingPeriod
```

### Yedek dosyalar

[Yedek dosya](fallback-flows) formatı SDK 4.4 sürümünde değişti. Dosyayı **[Placements](https://app.adapty.io/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."
:::