--- title: "PSPDFKit 12.2 Migration Guide" canonical_url: "https://www.nutrient.io/guides/ios/migration-guides/pspdfkit-12-2-migration-guide/" md_url: "https://www.nutrient.io/guides/ios/migration-guides/pspdfkit-12-2-migration-guide.md" last_updated: "2026-06-09T10:22:07.675Z" description: "Migration guide for Nutrient iOS SDK version 12.2 with breaking changes, API updates, and upgrade instructions." --- This guide covers updating an iOS or Mac Catalyst project from PSPDFKit 12 or PSPDFKit 12.1 to PSPDFKit 12.2. Update as soon as possible to take advantage of future new features and fixes. ## Removed Deprecated APIs This version of PSPDFKit removes APIs that have been deprecated for more than a year. Consequently, it removes APIs that were deprecated from PSPDFKit 11 to PSPDFKit 11.4. The table below summarizes the APIs removed in this release: | Removed Deprecated API | Migration Strategy | | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `FileManager.fileHandleForWriting(to:withBlock:)` | Nutrient didn’t call this method. Use `NSFileCoordinator` and `NSFileHandle` directly. | | `FileManager.fileHandle(forUpdating:withBlock:)` | Nutrient didn’t call this method. Use `NSFileCoordinator` and `NSFileHandle` directly. | | `RenderOptions.drawAppearanceStream` | This property was set to `true` by PSPDFKit to suppress drawing the existing appearance stream of an annotation when generating a new one. Due to changes in the drawing model for annotations in PSPDFKit 10.2, this is obsolete. | | `ColorPickerFactory` | Nutrient now uses the system color picker, which doesn’t support customizing the available colors. | | `ColorPalette` | Nutrient now uses the system color picker, which doesn’t support customizing the available colors. | | `ColorPatch` | Nutrient now uses the system color picker, which doesn’t support customizing the available colors. | | `ColorPatch.ColorSet` | Nutrient now uses the system color picker, which doesn’t support customizing the available colors. | --- ## Related pages - [Migrating From Apple Pdfkit](/guides/ios/migration-guides/migrating-from-apple-pdfkit.md) - [14 9 Migration Guide](/guides/ios/migration-guides/14-9-migration-guide.md) - [14 2 Migration Guide](/guides/ios/migration-guides/14-2-migration-guide.md) - [Migrating To Advanced Digital Signatures Api](/guides/ios/migration-guides/migrating-to-advanced-digital-signatures-api.md) - [Migrate to electronic signatures](/guides/ios/migration-guides/migrating-to-electronic-signatures.md) - [Pspdfkit 10 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-3-migration-guide.md) - [Pspdfkit 10 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-4-migration-guide.md) - [Pspdfkit 10 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-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 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 13 Migration Guide](/guides/ios/migration-guides/pspdfkit-13-migration-guide.md) - [Pspdfkit 12 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-migration-guide.md) - [Pspdfkit 11 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-4-migration-guide.md) - [Pspdfkit 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-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 6 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-6-5-migration-guide.md) - [Pspdfkit 6 Migration Guide](/guides/ios/migration-guides/pspdfkit-6-migration-guide.md) - [Pspdfkit 7 6 Migration Guide](/guides/ios/migration-guides/pspdfkit-7-6-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) - [Migrate to PSPDFKit 7 with ease](/guides/ios/migration-guides/pspdfkit-7-migration-guide.md) - [Upgrading](/guides/ios/getting-started/upgrading.md) - [Pspdfkit 9 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-5-migration-guide.md) - [PSPDFKit 8 migration guide for iOS developers](/guides/ios/migration-guides/pspdfkit-8-migration-guide.md) - [Pspdfkit 9 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-migration-guide.md)