In-App Updates

Enable your testers to easily stay up to date with the latest releases. Integrate the App Center SDK (and the Distribution Module) for iOS, Android, or Xamarin to automatically enable in-app notification for new releases. Once completed, all future releases through App Center will trigger an in-app notification for each tester allowing a quick upgrade to the latest version.

Important

At this time, there are some limitations to In-App Updates:

  1. Android devices will not be prompted for an update if there is no change in versionCode or versionName.
  2. For iOS public in-app updates, if you use the private track, Apple has a default dialog that will have to be dismissed. Login is not required for the public flow.
  3. In-App Updates don't work on windows/UWP applications.

Public In-App Updates

To enable public in-app updates, create a public distribution group and distribute a release with the App Center SDK. Once your testers install the app, they will be alerted when new releases are publicly available.

FAQ

  1. Why are testers asked to authenticate repeatedly?
  • AppCenter SDK uses a device's default browser to store cookies. In the following cases, SDK will ask for reauthentication:
    • Tester cleared cookies from device's default browser.
    • Tester disabled cookies for the device's default browser.
    • Tester closed the first authentication window after opening the app.
    • App Secret used to initialize the SDK is not the same as the one listed on the AppCenter web portal.
  1. Why do testers not see an in-app update message when a new version of the app is released?
  • Multiple scenarios can cause testers to not get in-app update notifications:
    • App Center SDK distribute feature is disabled. App Center SDK distribute feature must be enabled and initialized at app launch. If testers installed a version with the distribute feature disabled, they would need to install the latest version manually.
    • Automatic check for update is disabled. If automatic check for update is disabled, the app will not check for new releases at startup. The check will happen at the time checkForUpdate is called.
    • Release version of your app is incorrect for a new release
      • For Android: increment version code.
      • For iOS: increment CFBundleShortVersionString and conform to semantic versioning standards
  1. Why do testers see "In-app Update disabled" message?
  • Multiple scenarios can make the App Center SDK to display this message:
    • The app was not installed from App Center.
    • The version a tester installed was not released via App Center or the release was deleted on App Center.
    • App secret used in the SDK is incorrect. To get your app secret, go to your app's settings page, click on the triple vertical dots at the top right-hand corner, and copy app secret.
      • If you have migrated your App from HockeyApp, refer to the following articles:
        • iOS: [Migrating from HockeyApp][~/transition/ios-sdk-migration?tabs=objc#21-convert-the-application-identifier]
        • Android: [Migrating from HockeyApp][~/transition/android-sdk-migration#21-convert-the-application-identifier]