---
title: "Nutrient 2.1 migration guide"
canonical_url: "https://www.nutrient.io/guides/android/migration-guides/pspdfkit-2-1-migration-guide/"
md_url: "https://www.nutrient.io/guides/android/migration-guides/pspdfkit-2-1-migration-guide.md"
last_updated: "2026-05-21T11:22:21.505Z"
description: "Migration guide for Nutrient Android SDK version 2.1 with breaking changes, API updates, and upgrade instructions."
---

Prior to version 2.1, there were two different Nutrient activities: `PSPDFActivity` and `PSPDFAppCompatActivity`. Each of these had two different base classes, [`FragmentActivity`](http://developer.android.com/reference/android/support/v4/app/FragmentActivity.html) and [`AppCompatActivity`](http://developer.android.com/reference/android/support/v7/app/AppCompatActivity.html), respectively. Version 2.1 simplifies activities by only having a single `PSPDFActivity` that extends [`AppCompatActivity`](http://developer.android.com/reference/android/support/v7/app/AppCompatActivity.html).

Below you’ll find the steps for migrating your app to Nutrient Android SDK 2.1.

- Replace `pspdfkit-2.0.x.aar` with `pspdfkit-2.1.aar`.

- If you have a custom Nutrient activity, let it extend `com.pspdfkit.ui.PSPDFActivity`.

- Inside the `AndroidManifest.xml`:
  1. Use your custom activity or the default `com.pspdfkit.ui.PSPDFActivity`.
  2. Use an activity theme that extends `Theme.AppCompat` (important!).

The manifest entry should look similar to this:

```xml

<activity android:name="com.pspdfkit.ui.PSPDFActivity"
          android:theme="@style/Theme.AppCompat.Light.DarkActionBar"
          android:windowSoftInputMode="adjustNothing" />

```
---

## 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)
- [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 1 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-1-migration-guide.md)
- [Pspdfkit 2024 4 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-4-migration-guide.md)
- [Pspdfkit 2024 2 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-2-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 2024 7 Migration Guide](/guides/android/migration-guides/pspdfkit-2024-7-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)
- [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)
- [Pspdfkit 5 3 Migration Guide](/guides/android/migration-guides/pspdfkit-5-3-migration-guide.md)
- [Pspdfkit 5 5 Migration Guide](/guides/android/migration-guides/pspdfkit-5-5-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 2 Migration Guide](/guides/android/migration-guides/pspdfkit-6-2-migration-guide.md)
- [Pspdfkit 6 3 Migration Guide](/guides/android/migration-guides/pspdfkit-6-3-migration-guide.md)
- [Pspdfkit 6 1 Migration Guide](/guides/android/migration-guides/pspdfkit-6-1-migration-guide.md)
- [Pspdfkit 6 6 Migration Guide](/guides/android/migration-guides/pspdfkit-6-6-migration-guide.md)
- [Pspdfkit 5 Migration Guide](/guides/android/migration-guides/pspdfkit-5-migration-guide.md)
- [Pspdfkit 6 4 Migration Guide](/guides/android/migration-guides/pspdfkit-6-4-migration-guide.md)
- [Pspdfkit 7 Migration Guide](/guides/android/migration-guides/pspdfkit-7-migration-guide.md)
- [Pspdfkit 8 7 Migration Guide](/guides/android/migration-guides/pspdfkit-8-7-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 6 Migration Guide](/guides/android/migration-guides/pspdfkit-6-migration-guide.md)
- [Pspdfkit 8 8 Migration Guide](/guides/android/migration-guides/pspdfkit-8-8-migration-guide.md)
- [Pspdfkit 8 Migration Guide](/guides/android/migration-guides/pspdfkit-8-migration-guide.md)
- [Upgrading](/guides/android/advanced-integration/upgrading.md)