--- title: "Nutrient 2024.2 migration guide" canonical_url: "https://www.nutrient.io/guides/android/migration-guides/pspdfkit-2024-2-migration-guide/" md_url: "https://www.nutrient.io/guides/android/migration-guides/pspdfkit-2024-2-migration-guide.md" last_updated: "2026-05-18T04:02:30.169Z" description: "Discover the latest API changes in Nutrient Android SDK 2024.2, including deprecations, new initialization methods, and updates to Jetpack Compose package." --- This guide outlines the changes to Nutrient Android SDK 2024.2. ## Breaking API changes `PSPDFKitInitializationProvider` was changed to `InitializationProvider` and moved to a different package, and `com.pspdfkit` is now `com.pspdfkit.initialization`. Additionally, the Jetpack Compose package has been changed. Refer to the [Compose Package Structure](https://www.nutrient.io/guides/android/migration-guides/pspdfkit-2024-2-migration-guide.md#compose-package-structure) section for more information. ## Deprecations and new APIs Our old `initialize` methods in the top-level `PSPDFKit` class have been deprecated in favor of a single [`initialize`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit/-nutrient/initialize.html) method that takes `Context` and [`InitializationOptions`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.initialization/-initialization-options/index.html). The following changes have been made: - All the previous `initialize` methods have been replaced with [`initialize(context: Context, options: InitializationOptions? = null)`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit/-nutrient/initialize.html). - `clearCaches` replaced `PSPDFKit.clearCaches(context: Context, clearDiskCache: Boolean)` with [`PSPDFKit.clearCaches()`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit/-nutrient/clear-caches.html). - [`AnnotationEditingController`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui.special_mode.controller/-annotation-editing-controller/index.html) - `getCurrentlySelectedAnnotation()` is marked as deprecated. It still works, but it only returns the first selected annotation. - The new method `getCurrentlySelectedAnnotations()` should be used instead. - The new method `getCurrentSingleSelectedAnnotation()` returns the selected annotation only if a single annotation is currently selected. - The new method `hasCurrentlySelectedAnnotations()` tells you if anything is selected at all. - The new [`AnnotationTool.ANNOTATION_MULTI_SELECTION`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui.special_mode.controller/-annotation-tool/-a-n-n-o-t-a-t-i-o-n_-m-u-l-t-i_-s-e-l-e-c-t-i-o-n/index.html) can be found in the annotation toolbar and starts annotation multi-selection mode. - The new method [`PdfFragment.enterAnnotationEditingMode(@NonNull final List annotations)`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui/-pdf-fragment/enter-annotation-editing-mode.html) takes multiple annotations. The old method, which only takes a single annotation as a parameter, is still available. - [`OnAnnotationSelectedListener`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui.annotations/-on-annotation-selected-listener/index.html) has a new method, `onAnnotationSelectionFinished`, which is called after all selections have been processed individually and notified via [`onAnnotationSelected`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui.annotations/-on-annotation-selected-listener/on-annotation-selected.html). ## Compose package structure We updated our package structure for multiple files related to Jetpack Compose support. The files that were accessible before on the `com.pspdfkit.jetpack.compose` package will be now accessible on new paths, such as `com.pspdfkit.jetpack.compose.components`. This is done to better organize the files and make it easier to find the required files. The files are now organized in the following structure: - `Components` — This contains all the independent `Compose` components that can be used to build a custom UI for Nutrient. - `Interactors` — This contains all the files that can be used to interact with the `DocumentView`. - `Views` — This contains the composable views that can be used to display PDFs. - `Utilities` — This contains classes that are used to provide extra functionality. ### The new structure looks as follows: ``` └── 📁compose └── 📁components └── MainToolbar.kt └── 📁interactors └── DefaultListeners.kt └── DocumentConnection.kt └── DocumentListener.kt └── DocumentManager.kt └── DocumentState.kt └── 📁utilities └── ExperimentalPSPDFKitApi.kt └── NonFragmentActivityException.kt └── 📁views └── DocumentView.kt └── ImageDocumentView.kt ``` --- ## Related pages - [10 4 Migration Guide](/guides/android/migration-guides/10-4-migration-guide.md) - [10 3 Migration Guide](/guides/android/migration-guides/10-3-migration-guide.md) - [2024 8 Migration Guide](/guides/android/migration-guides/2024-8-migration-guide.md) - [Nutrient 10 Migration Guide](/guides/android/migration-guides/nutrient-10-migration-guide.md) - [10 5 Migration Guide](/guides/android/migration-guides/10-5-migration-guide.md) - [Pspdfkit 2024 1 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-1-migration-guide.md) - [Migrate to electronic signatures](/guides/android/migration-guides/migrating-to-electronic-signatures.md) - [Pspdfkit 2 1 Migration Guide](/guides/android/migration-guides/pspdfkit-2-1-migration-guide.md) - [Pspdfkit 2024 4 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-4-migration-guide.md) - [Pspdfkit 2024 3 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-3-migration-guide.md) - [Pspdfkit 2024 6 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-6-migration-guide.md) - [Pspdfkit 3 1 Migration Guide](/guides/android/migration-guides/pspdfkit-3-1-migration-guide.md) - [Pspdfkit 4 4 Migration Guide](/guides/android/migration-guides/pspdfkit-4-4-migration-guide.md) - [Pspdfkit 2024 7 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-7-migration-guide.md) - [Pspdfkit 5 1 Migration Guide](/guides/android/migration-guides/pspdfkit-5-1-migration-guide.md) - [Migrate to Nutrient 3.0 with ease](/guides/android/migration-guides/pspdfkit-3-migration-guide.md) - [2024 9 Migration Guide](/guides/android/migration-guides/2024-9-migration-guide.md) - [Pspdfkit 5 2 Migration Guide](/guides/android/migration-guides/pspdfkit-5-2-migration-guide.md) - [Migration guide for Android SDK 4 features](/guides/android/migration-guides/pspdfkit-4-migration-guide.md) - [Pspdfkit 6 3 Migration Guide](/guides/android/migration-guides/pspdfkit-6-3-migration-guide.md) - [Pspdfkit 5 5 Migration Guide](/guides/android/migration-guides/pspdfkit-5-5-migration-guide.md) - [Pspdfkit 5 Migration Guide](/guides/android/migration-guides/pspdfkit-5-migration-guide.md) - [Pspdfkit 6 2 Migration Guide](/guides/android/migration-guides/pspdfkit-6-2-migration-guide.md) - [Pspdfkit 6 1 Migration Guide](/guides/android/migration-guides/pspdfkit-6-1-migration-guide.md) - [Pspdfkit 5 3 Migration Guide](/guides/android/migration-guides/pspdfkit-5-3-migration-guide.md) - [Pspdfkit 6 Migration Guide](/guides/android/migration-guides/pspdfkit-6-migration-guide.md) - [Pspdfkit 6 4 Migration Guide](/guides/android/migration-guides/pspdfkit-6-4-migration-guide.md) - [Pspdfkit 6 6 Migration Guide](/guides/android/migration-guides/pspdfkit-6-6-migration-guide.md) - [Pspdfkit 8 6 Migration Guide](/guides/android/migration-guides/pspdfkit-8-6-migration-guide.md) - [Pspdfkit 7 Migration Guide](/guides/android/migration-guides/pspdfkit-7-migration-guide.md) - [Pspdfkit 8 8 Migration Guide](/guides/android/migration-guides/pspdfkit-8-8-migration-guide.md) - [Pspdfkit 8 7 Migration Guide](/guides/android/migration-guides/pspdfkit-8-7-migration-guide.md) - [Pspdfkit 8 9 Migration Guide](/guides/android/migration-guides/pspdfkit-8-9-migration-guide.md) - [Pspdfkit 8 Migration Guide](/guides/android/migration-guides/pspdfkit-8-migration-guide.md) - [Upgrading](/guides/android/advanced-integration/upgrading.md)