Updating the SDK

Overview

The Encore SDK is a public Swift Package — updating is the standard Swift Package Manager flow, with no token or authenticated URL required.

Update via Xcode

In Xcode’s left sidebar, expand Package Dependencies
Find and right-click the Encore package (resolved from https://github.com/EncoreKit/ios-sdk)
Select Update Package

Alternatively, select File → Packages → Update to Latest Package Versions to update all packages at once.

If your project still points at an old https://www.github.com/... URL, update the package Location to https://github.com/EncoreKit/ios-sdk (Your Project → Package Dependencies → the Encore package → Location column). No token is needed.

Verify the Update

After updating, check the package version in Xcode’s Package Dependencies to confirm you’re on the latest release.

Updating to 1.4.57 or Later — Purchase Handler Return Value

One-time migration check for subscription managers. If you use a subscription manager (RevenueCat, Superwall, Adapty, Qonversion, or your own billing), make sure your onPurchaseRequest handler returns a Bool. The older ... async throws -> Void overload is deprecated — it can’t signal success or failure, so the offer sheet’s dismiss behavior is unreliable. Integrations created on 1.4.57 or later already use the Bool-returning form, so this check only applies when migrating an older integration.

Return true once the purchase succeeds so Encore auto-dismisses the offer sheet; return false (or throw) to keep it up so the user can retry. For example, with RevenueCat:

Encore.shared.onPurchaseRequest { purchaseRequest in
    let products = try await Purchases.shared.products([purchaseRequest.productId])
    guard let product = products.first else { return false }
    let result = try await Purchases.shared.purchase(product: product)
    return !result.userCancelled
}

See onPurchaseRequest() for StoreKit, Adapty, Qonversion, and custom subscription-manager examples.

If you encounter issues after updating, reach out to admin@joinyaw.com.

iOS

Android

Web

Bridges

Updating the SDK

Overview

Update via Xcode

Verify the Update

Updating to 1.4.57 or Later — Purchase Handler Return Value

​Overview

​Update via Xcode

​Verify the Update

​Updating to 1.4.57 or Later — Purchase Handler Return Value

Overview

Update via Xcode

Verify the Update

Updating to 1.4.57 or Later — Purchase Handler Return Value