Capture the package-manager error
Keep the complete ADB output and identify the application ID being installed. Confirm the target device and existing package:
adb devices
adb shell pm path com.example.app
Use your actual application ID. If more than one device is connected, select it explicitly. ADB reference.
Compare the installed and incoming identities
Inspect the new APK's package name and signing certificate. For the installed app, use an authorized extraction or the known release record for that distribution path. A debug build, local release and Play build may all share an application ID while carrying different certificates.
A key rotation can introduce additional signing-lineage considerations. Do not reduce every case to “the visible certificate string changed” without checking the supported update arrangement. Android signing.
Choose the fix that preserves the intended identity
| Situation | Better response |
|---|---|
| Debug APK over a Play release | Use a separate debug application ID or a disposable test install |
| Wrong release keystore | Correct the signing configuration and rebuild |
| Mixed split set | Obtain a coherent package set from one release |
| Intentional signing migration | Follow the documented rotation or distribution workflow |
Changing the filename or version name does not make an unrelated signer compatible. A higher version code alone also does not resolve a signing mismatch.
Treat uninstalling as a data decision
For a throwaway development app, uninstalling can be a reasonable way to replace one identity with another. For a production user's installation, first understand backup, account recovery and local-data consequences. Do not recommend destructive removal as a universal one-line fix.
If testing update behavior, an uninstall invalidates the test: you are now testing a fresh installation rather than an upgrade.
Verify the corrected update path
Install the corrected release over the intended previous version, confirm data is retained and exercise startup and authentication. Record the two version codes and the expected certificate relationship.
APKLint's signature viewer helps compare public signing metadata. It cannot inspect every aspect of the device's package-manager state or authorize an incompatible update. Use the actual error and signing records to determine why Android rejected the operation.
Sources and further reading
Reference review: 22 September 2026. Examples illustrate the workflow; check your installed versions, release artifact and account-specific Console requirements before applying them. This guide is not a claim that APKLint executed your project or verified your private account.
Android inspection tools and practical release guides. About APKLint · Report a correction
