--- title: "Upgrading" canonical_url: "https://www.nutrient.io/guides/ios/getting-started/upgrading/" md_url: "https://www.nutrient.io/guides/ios/getting-started/upgrading.md" last_updated: "2026-05-30T02:20:01.321Z" description: "Comprehensive upgrade guide for Nutrient iOS SDK covering version migrations, breaking changes, and new features." --- In this guide, we cover how to migrate to the latest version of PSPDFKit for all integration methods. ## XCFramework Manual Integration In most cases, all you need to do to upgrade a [manual PSPDFKit integration](https://www.nutrient.io/sdk/ios/getting-started.md) is replace the `PSPDFKit.xcframework` and `PSPDFKitUI.xcframework` files in your project’s references. Simply copy the new `PSPDFKit.xcframework` and `PSPDFKitUI.xcframework` files to the disk location of your existing `PSPDFKit.xcframework` and `PSPDFKitUI.xcframework` files and replace them when prompted. ## Swift Package Manager Go to the project’s Swift Packages tab and edit the package options version rule to always use the latest release. If you used a specific version instead, then update the package options to the desired version. ## CocoaPods If you set up your Podfile to use [the latest release URL](https://www.nutrient.io/guides/ios/miscellaneous/advanced-cocoapods-integration.md#always-use-the-latest-release-recommended), all you need to do is issue `pod update`. If you used a [pinned version URL](https://www.nutrient.io/guides/ios/miscellaneous/advanced-cocoapods-integration.md#pinning-to-a-specific-version-eg-1310) instead, first update the URL to the desired version and then run `pod update`. ## Carthage We recommend [migrating from Carthage to Swift Package Manager](/guides/ios/knowledge-base/how-do-i-migrate-from-carthage-to-spm.md). If you set up your Cartfile to use the latest release, all you need to do is issue `carthage update`. If you used a specific version instead, first update the URL to the desired version and then run `carthage update`. ## API Changes After an upgrade, you might see new warnings or build errors due to PSPDFKit API changes. Commonly used APIs are normally deprecated before being changed — we annotate these methods with `@Deprecated` and provide a migration strategy. We recommend you upgrade deprecated APIs as soon as possible, as APIs that are less commonly used may be changed without prior notice and this might lead to build failures on your side. If that happens, consult the [changelog](https://www.nutrient.io/guides/ios/changelog.md) and the [migration guides](https://www.nutrient.io/guides/ios/upgrade.md) for details on how to resolve the issue. --- ## Related pages - [14 9 Migration Guide](/guides/ios/migration-guides/14-9-migration-guide.md) - [Migrate to electronic signatures](/guides/ios/migration-guides/migrating-to-electronic-signatures.md) - [14 2 Migration Guide](/guides/ios/migration-guides/14-2-migration-guide.md) - [Migrating From Apple Pdfkit](/guides/ios/migration-guides/migrating-from-apple-pdfkit.md) - [Pspdfkit 10 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-3-migration-guide.md) - [Pspdfkit 12 2 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-2-migration-guide.md) - [Pspdfkit 10 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-migration-guide.md) - [Migrating To Advanced Digital Signatures Api](/guides/ios/migration-guides/migrating-to-advanced-digital-signatures-api.md) - [Pspdfkit 10 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-4-migration-guide.md) - [Pspdfkit 11 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-3-migration-guide.md) - [Pspdfkit 11 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-5-migration-guide.md) - [Pspdfkit 13 Migration Guide](/guides/ios/migration-guides/pspdfkit-13-migration-guide.md) - [Pspdfkit 12 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-3-migration-guide.md) - [Pspdfkit 13 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-13-3-migration-guide.md) - [Pspdfkit 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-4-migration-guide.md) - [Pspdfkit 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-5-migration-guide.md) - [Pspdfkit 12 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-migration-guide.md) - [Pspdfkit 7 6 Migration Guide](/guides/ios/migration-guides/pspdfkit-7-6-migration-guide.md) - [Pspdfkit 11 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-4-migration-guide.md) - [Pspdfkit 6 Migration Guide](/guides/ios/migration-guides/pspdfkit-6-migration-guide.md) - [Pspdfkit 6 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-6-5-migration-guide.md) - [Pspdfkit 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-3-migration-guide.md) - [Pspdfkit 9 2 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-2-migration-guide.md) - [Pspdfkit 9 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-4-migration-guide.md) - [Pspdfkit 9 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-3-migration-guide.md) - [Pspdfkit 9 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-5-migration-guide.md) - [Pspdfkit 9 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-migration-guide.md) - [PSPDFKit 8 migration guide for iOS developers](/guides/ios/migration-guides/pspdfkit-8-migration-guide.md) - [Migrate to PSPDFKit 7 with ease](/guides/ios/migration-guides/pspdfkit-7-migration-guide.md)