EAS (Expo Application Services) Deployment Patterns

EAS est la suite Expo pour builder, tester, et distribuer des apps React Native sans devoir configurer Xcode/Android Studio localement. Trois services clés : EAS Build, EAS Submit, EAS Update.

1. Setup initial

# Install EAS CLI
npm install -g eas-cli

# Login
eas login

# Configurer un projet
cd my-app
eas build:configure
# Génère eas.json et ajoute projectId dans app.json

2. eas.json — profiles de build

{
  "cli": {
    "version": ">= 14.0.0",
    "appVersionSource": "remote"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "channel": "development",
      "env": {
        "API_URL": "https://dev.example.com"
      }
    },
    "preview": {
      "distribution": "internal",
      "channel": "preview",
      "ios": {
        "simulator": true
      },
      "env": {
        "API_URL": "https://staging.example.com"
      }
    },
    "production": {
      "channel": "production",
      "autoIncrement": true,
      "env": {
        "API_URL": "https://api.example.com"
      }
    }
  },
  "submit": {
    "production": {
      "ios": {
        "appleId": "developer@example.com",
        "ascAppId": "1234567890",
        "appleTeamId": "ABCD1234EF"
      },
      "android": {
        "serviceAccountKeyPath": "./pc-api-xxx.json",
        "track": "production",
        "releaseStatus": "completed"
      }
    }
  }
}

3. EAS Build (cloud builds)

# Build preview pour TestFlight Internal
eas build --profile preview --platform ios

# Build production pour soumission App Store
eas build --profile production --platform ios

# Build Android APK pour test interne
eas build --profile preview --platform android

# Build Android AAB pour Play Store
eas build --profile production --platform android

iOS Simulator build (dev)

eas build --profile preview --platform ios --local  # ou sur EAS si tu veux

Les builds iOS simulator ne nécessitent pas de certificats Apple — utile pour du test rapide.

4. Credentials management

iOS

# Laisser EAS gérer les certificats
eas credentials
# → iOS → Set up a new build credential

EAS peut :

• Créer un certificat Apple automatiquement
• Générer un provisioning profile
• Stocker le tout sur EAS servers (chiffré)

Ou bien uploader manuellement les credentials existants.

Android

eas credentials
# → Android → Set up a new build credential

• Keystore auto-généré par EAS (recommandé pour nouveaux projets)
• Ou upload d'un keystore existant (obligatoire pour continuer sur une app déjà en Play Store)

Règle critique : le keystore Android doit être sauvegardé off-site. Si perdu, impossible de publier une update.

5. EAS Submit

# Submit à App Store Connect (TestFlight → Review → App Store)
eas submit --profile production --platform ios --latest

# Submit à Play Console
eas submit --profile production --platform android --latest

Prérequis iOS :

• Apple Developer Program ($99/an)
• App créée dans App Store Connect
• ascAppId dans eas.json

Prérequis Android :

• Google Play Console ($25 one-time)
• App créée dans Play Console
• Service account JSON avec droits "Release Manager"

6. EAS Update (OTA updates)

# Publier une update JS/assets sans rebuild
eas update --branch production --message "Fix login bug"

Les users reçoivent la update au prochain lancement de l'app (ou via Updates.checkForUpdateAsync() en code).

Limites :

• Seulement les changements JavaScript + assets
• Un rebuild est nécessaire si modif native (permissions, nouveaux packages natifs)
• EAS Update est limité aux versions natives compatibles (runtimeVersion)

Runtime version

// app.json
{
  "expo": {
    "runtimeVersion": {
      "policy": "appVersion"
    }
  }
}

appVersion policy : chaque version native est sa propre "runtime". Les updates OTA ne vont que vers les users sur la même version native.

7. Environment variables

EAS injecte les variables déclarées dans eas.json au moment du build. Pour les secrets :

# Secret côté EAS (chiffré)
eas secret:create --scope project --name STRIPE_KEY --value sk_live_xxx

# Le build l'injecte comme env var

Dans le code :

const STRIPE_KEY = process.env.EXPO_PUBLIC_STRIPE_KEY // accessible côté JS runtime si préfixé EXPO_PUBLIC_

Règle : les vars préfixées EXPO_PUBLIC_ sont accessibles dans le JS bundle (donc visible par les users). Les vars sans préfixe sont server-side only (build-time).

8. Monorepo support

// eas.json dans un monorepo pnpm
{
  "build": {
    "production": {
      "node": "20.0.0",
      "pnpm": "9.0.0",
      "prebuildCommand": "pnpm --filter=@app/mobile install"
    }
  }
}

Aussi possible via cli.requireCommit: true pour forcer un commit avant chaque build (évite les builds avec du working dir sale).

9. GitHub Actions integration

# .github/workflows/eas-build.yml
name: EAS Build

on:
  push:
    branches: [main]
    paths: ['apps/mobile/**']

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - name: Install EAS CLI
        run: npm install -g eas-cli
      - name: Install deps
        run: pnpm install
      - name: EAS Build
        run: eas build --profile production --platform all --non-interactive
        env:
          EXPO_TOKEN: ${{ secrets.EXPO_TOKEN }}

EXPO_TOKEN = personal access token généré sur expo.dev/accounts/<username>/settings/access-tokens.

10. Build caches

EAS cache automatiquement :

• node_modules
• Pods iOS (CocoaPods)
• Gradle Android

Pour forcer un rebuild sans cache : --clear-cache.

Anti-patterns

1. Keystore Android non backupé → app bloquée si EAS perd le fichier
2. EXPO_PUBLIC_* pour un secret → secret exposé dans le bundle
3. Pas de appVersionSource: remote → conflits de version entre devs
4. EAS Update sans runtime version → crash sur devices avec natives différentes
5. Build production sans test preview d'abord → crash en prod
6. Service account Android avec trop de droits → scope minimal "Release Manager"
7. Submit auto sans review → soumission à la review sans QA

Checklist

• eas.json committé avec profiles dev / preview / production
• Credentials iOS + Android configurés
• Secrets EAS configurés (pas hardcodés)
• runtimeVersion policy définie
• EAS Build testé en preview avant prod
• TestFlight Internal setup pour le QA
• Submit testé sur le premier release
• GitHub Actions configuré avec EXPO_TOKEN
• Backup keystore Android sauvegardé hors EAS

Quand déléguer

• Finalisation App Store → skill deploy-app-store (dans ce plugin)
• Finalisation Play Store → skill deploy-play-store (dans ce plugin)
• Expo-specific code → expo-expert (dans atum-stack-mobile)
• React Native custom native modules → agents atum-stack-mobile

Ressources

• https://docs.expo.dev/eas/
• https://docs.expo.dev/build/introduction/
• https://docs.expo.dev/submit/introduction/
• https://docs.expo.dev/eas-update/introduction/