--- title: "Nutrient 8.8 migration guide" canonical_url: "https://www.nutrient.io/guides/android/migration-guides/pspdfkit-8-8-migration-guide/" md_url: "https://www.nutrient.io/guides/android/migration-guides/pspdfkit-8-8-migration-guide.md" last_updated: "2026-06-09T10:25:14.344Z" description: "Discover breaking API changes in Nutrient Android SDK 8.8, including updates to measurement tools and configurations for enhanced functionality." --- This guide provides the necessary steps for migrating from Nutrient Android SDK 8 to [Nutrient Android SDK 8.8](/guides/android/changelog.md#8.8.0). Before updating to Nutrient Android SDK 8.8, make sure your app is running at least Nutrient Android SDK 8. If you’re running an earlier version, see our [previous migration guides](/guides/android/upgrade.md) first, which will guide you through the necessary update steps up to version 8.8. **Steps:** 1. ## Upgrading Nutrient Inside your `app/build.gradle.kts` file, update the version of the `io.nutrient:nutrient` dependency to `8.8.0`: ```diff dependencies { - implementation("io.nutrient:nutrient:8.7.0") + implementation("io.nutrient:nutrient:8.8.0") } ``` ### Upgrading OCR dependencies If your project also integrates the [Nutrient OCR library](https://www.nutrient.io/guides/android/ocr/overview.md), make sure to upgrade the version of all OCR dependencies too: ```diff dependencies { - implementation("io.nutrient:nutrient-ocr:8.7.0") - implementation("io.nutrient:nutrient-ocr-english:8.7.0") + implementation("io.nutrient:nutrient-ocr:8.8.0") + implementation("io.nutrient:nutrient-ocr-english:8.8.0")... } ``` 2. ## API changes Nutrient Android SDK 8.8 introduces a new version of the measurement tools introduced in version 8.4! There are a few breaking API changes that this version brings, so if you’re using any of the measurement tool APIs, read carefully. - `FloatPrecision` has changed to [`MeasurementPrecision`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.annotations.measurements/-measurement-precision/index.html). This is a breaking change if you were previously using `FloatPrecision`. - Scale and precision have been combined into one class, [`MeasurementValueConfiguration`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.annotations.measurements/-measurement-value-configuration/index.html). - Multiple [`MeasurementValueConfiguration`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.annotations.measurements/-measurement-value-configuration/index.html)s can be stored and selected via the UI or API using [`MeasurementValueConfigurationEditor`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.annotations.measurements/-measurement-value-configuration-editor/index.html). - To add/remove precision and scale, you can now use: - [`MeasurementValueConfigurationEditor#add(MeasurementValueConfiguration, boolean)`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.annotations.measurements/-measurement-value-configuration-editor/add.html) - [`MeasurementValueConfigurationEditor#remove(context, MeasurementValueConfiguration)`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.annotations.measurements/-measurement-value-configuration-editor/remove.html) - To get all the configurations, you can now use: - [`MeasurementValueConfigurationEditor#getConfigurations()`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.annotations.measurements/-measurement-value-configuration-editor/get-configurations.html) - New snapping options — [snap to point](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.preferences/-p-s-p-d-f-kit-preferences/set-measurement-snapping-enabled.html), [snap to self](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.preferences/-p-s-p-d-f-kit-preferences/set-snap-to-self-enabled.html), and [snapping to smart guides](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.preferences/-p-s-p-d-f-kit-preferences/set-smart-guides-enabled.html) — can be found in [`PSPDFKitPreferences`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.preferences/-p-s-p-d-f-kit-preferences/index.html) and turned off/on via this API. ### Other API changes The API to customize the minimum annotation size for specific annotation types has changed. If you use this API, you’ll need to change your code for this version to work. (#39922) Old: `PdfConfiguration.Builder#setMinimumAnnotationSize(AnnotationType, Size)` New: [`Annotation#setMinimumAnnotationSizeForType(AnnotationType, Size)`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.annotations/-annotation/set-minimum-annotation-size-for-type.html) 3. ## Deprecations - `PdfDocument#isValidForEditing` has been deprecated in favor of `PdfDocument#isWritableAndCanSave`. (#40058) - `PdfDocument#setMeasurementScale` is deprecated. For more information, see above. - `PdfDocument#getMeasurementScale` is deprecated. For more information, see above. - `PdfDocument#setMeasurementPrecision` is deprecated. For more information, see above. - `PdfDocument#getMeasurementPrecision` is deprecated. For more information, see above. - `Scale#defaultScale` has been deprecated in favor of `MeasurementValueConfiguration#defaultConfiguration().getScale()`. --- ## Related pages - [10 3 Migration Guide](/guides/android/migration-guides/10-3-migration-guide.md) - [10 4 Migration Guide](/guides/android/migration-guides/10-4-migration-guide.md) - [10 5 Migration Guide](/guides/android/migration-guides/10-5-migration-guide.md) - [2024 9 Migration Guide](/guides/android/migration-guides/2024-9-migration-guide.md) - [2024 8 Migration Guide](/guides/android/migration-guides/2024-8-migration-guide.md) - [Pspdfkit 2 1 Migration Guide](/guides/android/migration-guides/pspdfkit-2-1-migration-guide.md) - [Migrate to electronic signatures](/guides/android/migration-guides/migrating-to-electronic-signatures.md) - [Nutrient 10 Migration Guide](/guides/android/migration-guides/nutrient-10-migration-guide.md) - [Pspdfkit 2024 2 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-2-migration-guide.md) - [Pspdfkit 2024 1 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-1-migration-guide.md) - [Pspdfkit 2024 3 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-3-migration-guide.md) - [Pspdfkit 2024 4 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-4-migration-guide.md) - [Pspdfkit 2024 7 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-7-migration-guide.md) - [Pspdfkit 2024 6 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-6-migration-guide.md) - [Pspdfkit 4 4 Migration Guide](/guides/android/migration-guides/pspdfkit-4-4-migration-guide.md) - [Pspdfkit 3 1 Migration Guide](/guides/android/migration-guides/pspdfkit-3-1-migration-guide.md) - [Migrate to Nutrient 3.0 with ease](/guides/android/migration-guides/pspdfkit-3-migration-guide.md) - [Pspdfkit 5 1 Migration Guide](/guides/android/migration-guides/pspdfkit-5-1-migration-guide.md) - [Pspdfkit 5 2 Migration Guide](/guides/android/migration-guides/pspdfkit-5-2-migration-guide.md) - [Pspdfkit 5 3 Migration Guide](/guides/android/migration-guides/pspdfkit-5-3-migration-guide.md) - [Pspdfkit 6 1 Migration Guide](/guides/android/migration-guides/pspdfkit-6-1-migration-guide.md) - [Pspdfkit 5 5 Migration Guide](/guides/android/migration-guides/pspdfkit-5-5-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 6 2 Migration Guide](/guides/android/migration-guides/pspdfkit-6-2-migration-guide.md) - [Pspdfkit 7 Migration Guide](/guides/android/migration-guides/pspdfkit-7-migration-guide.md) - [Pspdfkit 6 4 Migration Guide](/guides/android/migration-guides/pspdfkit-6-4-migration-guide.md) - [Pspdfkit 5 Migration Guide](/guides/android/migration-guides/pspdfkit-5-migration-guide.md) - [Pspdfkit 8 7 Migration Guide](/guides/android/migration-guides/pspdfkit-8-7-migration-guide.md) - [Pspdfkit 6 Migration Guide](/guides/android/migration-guides/pspdfkit-6-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 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)