All Collections
Manage Content
Apps
Version Management
What are Android's requirements when uploading a new version of an app?
What are Android's requirements when uploading a new version of an app?

Requirements to retain app data between app updates.

Josh Franzen avatar
Written by Josh Franzen
Updated over a week ago
  1. The packageName of the new version must match the packageName of the previous version.

    • Unity: Player Settings > Other Settings > Identification > Package Name

    • Unreal: Project Settings > Android > Android Package Name

  2. The versionCode of the new version must be greater than the versionCode of the previous version. In other words, versionCode must be rolled forward.

    • Unity: Player Settings > Other Settings > Identification > Bundle Version Code

    • Unreal: Project Settings > Android > Store Version

  3. Sign the new version of your app with the same key that was used to sign the previous version. Create and use a custom keystore and ensure it's used by the entire Android development team and any build machine producing .apk files.

๐Ÿ’ก While not required, anytime you have a new version of an app and roll forward the versionCode, it is recommended to likewise roll forward the versionName following a numbering convention that makes sense for you and your dev team.

  • Unity: Player Settings > Other Settings > Identification > Version

  • Unreal: Project Settings > Android > Version Display Name

Did this answer your question?