Preview

Install a release on your own phone, exactly as users get it, so you can try its patches before they go out widely.

Install the release

With a phone connected over USB and USB debugging on:

$ overpush preview android

This installs the newest release and opens it. An app bundle is installed the way the Play Store does it: only the parts for this phone. The first time, it downloads a small tool from Google for this, which needs Java; Android Studio comes with it.

--release-versionAnother release, by its id.
--deviceWhich phone, when more than one is connected (its adb devices serial).

"The phone has your app signed with a different key." The phone already has the store version, signed with your release key. Uninstall it from the phone, or keep your release key in android/key.properties (Flutter's standard setup) so previews are signed the same way.

Xiaomi, Redmi and some other phones ask on screen before installing over USB. Keep the phone unlocked and tap Install.

Install the release

Preview installs a release built for your own devices, which needs no distribution certificate:

$ overpush release ios --artifact app
$ overpush preview ios

With an iPhone connected, this installs the release and opens it. --bundle-id tells it the app's identifier if it can't be read from the Xcode project.

Check a TestFlight or App Store install

To see what the app already on a connected iPhone did, including which patch it's running:

$ overpush verify ios --installed

Try a patch on it

  1. Make a visible change

    Some text on the first screen is easiest to spot.

  2. Publish to a small share

    $ overpush patch android --rollout-percent 5
    $ overpush patch ios --rollout-percent 5

    Your phone may fall outside 5%; use 100 while testing alone, or test on a release no users have.

  3. Restart the app twice

    Open it, wait a few seconds while the patch downloads, then close it fully and open it again. The patch runs from that start.

What's next

Create a patchEvery option of overpush patch. Rollouts & rolling backWiden a patch, or pull it back.