Standard Version Expo Bumpers

Standard Version custom updaters for Expo

When publishing bare workflows using Expo Publish, Expo does not make sure that updates are only pushed to devices which have the correct binary. This can cause old app versions, which do not have the required native dependencies, to receive new javascript bundle updates.

The recommended solution is to use Runtime Versions. However, Runtime Versions is not compatible with the Expo classic build system (expo build).

The second option is to use Expo Channels.

This module contains bumpers which assist in keeping both methods in sync with the app version number.

npm install @torah-anytime/standard-version-expo

Update Expo Runtime Version

Note from the Expo docs: Custom runtime versions are not supported on the classic build system (expo build); these apps will always use the SDK version as the basis for determining runtime compatibility.

WARNING: The Android Manifest (android/app/src/main/AndroidManifest.xml) must already contain <meta-data android:name=“expo.modules.updates.EXPO_RUNTIME_VERSION” android:value=“<any value>"/>. Otherwise it will throw an error.

// .versionrc.js
module.exports = {
  bumpFiles: [
    // ...
    {
      filename: "ios/TorahAnyTime/Supporting/Expo.plist",
      updater: require("@torah-anytime/standard-version-expo/dist/ios/native/runtime-version"),
    },
    {
      filename: "android/app/src/main/AndroidManifest.xml",
      updater: require("@torah-anytime/standard-version-expo/dist/android/native/runtime-version"),
    },
  ],
};

Update Expo Release Channel

WARNING: The Android Manifest (android/app/src/main/AndroidManifest.xml) must already contain <meta-data android:name=“expo.modules.updates.EXPO_RELEASE_CHANNEL” android:value=“<any value>"/>. Otherwise it will throw an error.

To automatically update the iOS and Android Expo release channel to match the app version install this package and add the bump files:

// .versionrc.js
module.exports = {
  bumpFiles: [
    // ...
    {
      filename: "ios/<YourAppName>/Supporting/Expo.plist",
      updater: require("@torah-anytime/standard-version-expo/dist/ios/native/release-channel"),
    },
    {
      filename: "android/app/src/main/AndroidManifest.xml",
      updater: require("@torah-anytime/standard-version-expo/dist/android/native/release-channel"),
    },
  ],
};

To test if your configuration works as expected, you can run standard version in dry mode. This shows you what will happen, without actually applying the versions and tags.

npx standard-version --dry-run

Credit

Inspired by: https://github.com/brettdh/standard-version-expo