chore: automate example app publishing to app stores

.github/workflows/publish-example-app.yml

@@ -0,0 +1,186 @@
+name: Publish example app
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Release tag to publish the example app for, e.g. v6.0.0
+        required: true
+      platform:
+        description: Platform to build. Defaults to all.
+        required: false
+        default: all
+        type: choice
+        options:
+          - all
+          - ios
+          - android
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-example-app
+
+jobs:
+  publish:
+    name: Build and submit example app
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          ref: main
+
+      - name: Setup
+        uses: ./.github/actions/setup
+
+      - name: Resolve release tag and submit profile
+        id: release
+        env:
+          TAG: ${{ github.event.release.tag_name || inputs.tag }}
+          PLATFORM: ${{ inputs.platform }}
+        run: |
+          if [ -z "$TAG" ]; then
+            echo "::error::No release tag to publish the example app for."
+            exit 1
+          fi
+
+          if [ "${TAG#*-}" != "$TAG" ]; then
+            profile=preview
+          else
+            profile=production
+          fi
+
+          platform=${PLATFORM:-all}
+
+          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
+          echo "profile=$profile" >> "$GITHUB_OUTPUT"
+          echo "platform=$platform" >> "$GITHUB_OUTPUT"
+          echo "Publishing $platform for $TAG using the $profile submit profile."
+
+      - name: Setup Expo
+        uses: expo/expo-github-action@c7b66a9c327a43a8fa7c0158e7f30d6040d2481e # v8.2.1
+        with:
+          eas-version: latest
+          token: ${{ secrets.EXPO_TOKEN }}
+
+      - name: Check Expo authentication
+        working-directory: ./example
+        run: |
+          if ! eas whoami; then
+            echo "::error::Could not authenticate with Expo, check EXPO_TOKEN."
+            exit 1
+          fi
+
+      - name: Decide between an update and a build
+        id: decide
+        working-directory: ./example
+        env:
+          PROFILE: ${{ steps.release.outputs.profile }}
+          PLATFORM: ${{ steps.release.outputs.platform }}
+        run: |
+          platforms="$PLATFORM"
+          if [ "$PLATFORM" = "all" ]; then
+            platforms="ios android"
+          fi
+
+          build=false
+          for platform in $platforms; do
+            hash=$(npx expo-updates fingerprint:generate --platform "$platform" | jq -r '.hash')
+
+            existing=$(eas build:list \
+              --platform "$platform" \
+              --channel "$PROFILE" \
+              --fingerprint-hash "$hash" \
+              --status finished \
+              --limit 1 \
+              --json \
+              --non-interactive | jq 'length')
+
+            echo "$platform: fingerprint $hash, $existing matching build(s)"
+            [ "$existing" -eq 0 ] && build=true
+          done
+
+          echo "build=$build" >> "$GITHUB_OUTPUT"
+          if [ "$build" = true ]; then
+            echo "Native code changed, building and submitting."
+          else
+            echo "No native change, publishing an update instead."
+          fi
+
+      - name: Bump example app version
+        if: steps.decide.outputs.build == 'true'
+        run: node scripts/bump-example-version.ts example/app.json
+
+      - name: Build and submit to the app stores
+        id: submit
+        if: steps.decide.outputs.build == 'true'
+        working-directory: ./example
+        env:
+          PROFILE: ${{ steps.release.outputs.profile }}
+          PLATFORM: ${{ steps.release.outputs.platform }}
+        run: |
+          eas build \
+            --platform "$PLATFORM" \
+            --profile "$PROFILE" \
+            --auto-submit-with-profile "$PROFILE" \
+            --non-interactive
+
+      - name: Publish an update
+        id: update
+        if: steps.decide.outputs.build == 'false'
+        working-directory: ./example
+        env:
+          PROFILE: ${{ steps.release.outputs.profile }}
+          TAG: ${{ steps.release.outputs.tag }}
+        run: |
+          eas update \
+            --branch "$PROFILE" \
+            --message "$TAG" \
+            --non-interactive
+
+      - name: Open version bump PR
+        if: ${{ always() && (steps.submit.outcome == 'success' || steps.submit.outcome == 'failure' || steps.submit.outcome == 'cancelled') }}
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          base: main
+          add-paths: example/app.json
+          branch: chore/example-app-version-${{ steps.release.outputs.tag }}
+          commit-message: 'chore: bump example app version for ${{ steps.release.outputs.tag }}'
+          title: 'chore: bump example app version for ${{ steps.release.outputs.tag }}'
+          labels: example app
+          body: Version bump for ${{ steps.release.outputs.tag }}.
+
+      - name: Summarise
+        if: ${{ !cancelled() && (steps.submit.outcome == 'success' || steps.update.outcome == 'success') }}
+        env:
+          TAG: ${{ steps.release.outputs.tag }}
+          PROFILE: ${{ steps.release.outputs.profile }}
+          BUILT: ${{ steps.decide.outputs.build }}
+        run: |
+          if [ "$BUILT" = "true" ]; then
+            echo "Built and submitted $TAG using the $PROFILE profile." >> "$GITHUB_STEP_SUMMARY"
+          else
+            echo "Published an OTA update for $TAG on the $PROFILE channel." >> "$GITHUB_STEP_SUMMARY"
+          fi
+
+  report-failure:
+    name: Report failure
+    needs: publish
+    if: ${{ always() && needs.publish.result != 'success' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Report failure
+        env:
+          TAG: ${{ github.event.release.tag_name || inputs.tag }}
+        run: |
+          echo "::error::Example app deployment failed for $TAG. The release itself is fine, only the demo app did not update."
+          echo "Check EAS and the stores before re-running, a build may already have been submitted." >> "$GITHUB_STEP_SUMMARY"

CONTRIBUTING.md

@@ -109,6 +109,8 @@ yarn release
 
 NOTE: You must have a `GITHUB_TOKEN` environment variable available. You can create a GitHub access token with the "repo" access [here](https://github.com/settings/tokens).
 
+We use EAS for auto-deployments of the example app. Releases with no native changes ship OTA. Releases with native code changes will be pushed to Stores automatically and job will create a PR with version bump, merge it to avoid two releases shipping under the same version. Android will also be auto-submitted for review, iOS still requires manual submission. Pre-releases are shipped to internal track and TestFlight only.
+
 ## Reporting issues
 
 You can report issues on our [bug tracker](https://github.com/callstack/react-native-paper/issues). Please follow the issue template when opening an issue.

example/.fingerprintignore

@@ -0,0 +1,2 @@
+# prevents build failures due to version mismatch
+node_modules/expo-modules-jsi/apple/Products/

example/app.json

@@ -16,11 +16,12 @@
     "owner": "react-native-paper",
     "ios": {
       "bundleIdentifier": "com.callstack.reactnativepaperexample",
-      "buildNumber": "26.0.5"
+      "infoPlist": {
+        "ITSAppUsesNonExemptEncryption": false
+      }
     },
     "android": {
       "package": "com.callstack.reactnativepaperexample",
-      "versionCode": 38,
       "permissions": [
         "READ_EXTERNAL_STORAGE",
         "WRITE_EXTERNAL_STORAGE"
@@ -37,7 +38,7 @@
       }
     },
     "runtimeVersion": {
-      "policy": "sdkVersion"
+      "policy": "fingerprint"
     },
     "updates": {
       "url": "https://u.expo.dev/ba8f5139-58fe-48f0-b2f2-2d675b6eb2d4"

example/eas.json

@@ -0,0 +1,35 @@
+{
+  "cli": {
+    "appVersionSource": "remote"
+  },
+  "build": {
+    "production": {
+      "node": "24.13.0",
+      "autoIncrement": true,
+      "android": {
+        "buildType": "app-bundle"
+      },
+      "channel": "production"
+    },
+    "preview": {
+      "extends": "production",
+      "channel": "preview"
+    }
+  },
+  "submit": {
+    "production": {
+      "android": {
+        "track": "production"
+      },
+      "ios": {
+        "ascAppId": "1548934513"
+      }
+    },
+    "preview": {
+      "extends": "production",
+      "android": {
+        "track": "internal"
+      }
+    }
+  }
+}

scripts/__tests__/bump-example-version.test.ts

@@ -0,0 +1,50 @@
+import { afterEach, expect, it } from '@jest/globals';
+import { execFileSync } from 'node:child_process';
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+const script = join(__dirname, '..', 'bump-example-version.ts');
+
+const directories: string[] = [];
+
+const writeAppConfig = (version: string) => {
+  const directory = mkdtempSync(join(tmpdir(), 'bump-example-version-'));
+  directories.push(directory);
+  const appConfigPath = join(directory, 'app.json');
+
+  writeFileSync(
+    appConfigPath,
+    JSON.stringify({ expo: { name: 'Example', version } }, null, 2) + '\n'
+  );
+
+  return appConfigPath;
+};
+
+const bump = (appConfigPath: string) => {
+  execFileSync('node', [script, appConfigPath], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+
+  return JSON.parse(readFileSync(appConfigPath, 'utf8')).expo.version;
+};
+
+afterEach(() => {
+  directories.splice(0).forEach((directory) => {
+    rmSync(directory, { recursive: true, force: true });
+  });
+});
+
+it('bumps the minor version', () => {
+  expect(bump(writeAppConfig('3.16.0'))).toBe('3.17.0');
+});
+
+it('increments the minor version past a single digit', () => {
+  expect(bump(writeAppConfig('3.9.0'))).toBe('3.10.0');
+});
+
+it('fails when the current version is not a valid version', () => {
+  expect(() => bump(writeAppConfig('not-a-version'))).toThrow(
+    /got "not-a-version"/
+  );
+});

scripts/bump-example-version.ts

@@ -0,0 +1,33 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+
+type AppConfig = { expo?: { version?: string } };
+
+const appConfigPath = process.argv[2];
+
+if (!appConfigPath) {
+  console.error(
+    'Usage: node scripts/bump-example-version.ts <path to the example app config>'
+  );
+  process.exit(1);
+}
+
+const appConfig: AppConfig = JSON.parse(readFileSync(appConfigPath, 'utf8'));
+const expo = appConfig.expo;
+const currentVersion = expo?.version;
+const parsed = /^(\d+)\.(\d+)\.(\d+)$/.exec(currentVersion ?? '');
+
+if (!expo || !parsed) {
+  console.error(
+    `Expected a "major.minor.patch" version at expo.version in ${appConfigPath}, got ${JSON.stringify(currentVersion)}.`
+  );
+  process.exit(1);
+}
+
+const [, major, minor] = parsed;
+const nextVersion = `${major}.${Number(minor) + 1}.0`;
+
+expo.version = nextVersion;
+
+writeFileSync(appConfigPath, JSON.stringify(appConfig, null, 2) + '\n');
+
+console.log(`Bumped example app version to ${nextVersion}`);