Distribuzione dell'app mobile
Le app mobile Expo di ChurchApps, come B1 Checkin, vengono compilate con Expo EAS Build oppure con una build Gradle locale e distribuite tramite gli store delle app. Questa pagina spiega come compilare, inviare e pubblicare aggiornamenti over-the-air sia per Android sia per iOS, usando B1 Checkin come esempio.
Prima di iniziare
- Configura l'app in locale -- vedi App mobile
- Installa e configura la EAS CLI
- Assicurati di avere accesso a Google Play Console (Android) e/o App Store Connect di Apple (iOS)
Creazione della build
Android
Le build di rilascio per Android vengono eseguite in locale e firmate con il keystore di rilascio fornito da EAS. Scaricalo una sola volta con npx eas-cli credentials -p android (scegli credentials.json: Download credentials from EAS), quindi esegui:
yarn build:android
Il bundle per Google Play viene salvato in android/app/build/outputs/bundle/release/app-release.aab. Per creare la build su EAS, esegui invece yarn build:android:eas.
iOS
Le build iOS vengono sempre eseguite su EAS:
yarn build:ios
Invio agli store delle app
Android -- Google Play Store
Carica il file AAB tramite Play Console oppure invialo con EAS:
npx eas-cli submit -p android --path android/app/build/outputs/bundle/release/app-release.aab
iOS -- Apple App Store
Invia direttamente la build iOS tramite EAS:
eas submit --platform ios
Aggiornamenti OTA
Per le modifiche che riguardano solo JavaScript e non richiedono la revisione dello store, usa gli aggiornamenti over-the-air (OTA):
yarn update
Questo comando usa EAS Update per inviare le modifiche direttamente agli utenti, senza un invio completo allo store.
Gli aggiornamenti OTA sono molto più rapidi delle build per gli store: le modifiche possono raggiungere gli utenti in pochi minuti anziché in giorni. Usali per correzioni di bug, modifiche al testo e piccoli interventi sull'interfaccia che non coinvolgono codice nativo.
Numeri di versione
Prima di creare una build per lo store, i numeri di versione devono essere aggiornati in più file:
package.jsonapp.jsonandroid/app/build.gradle(versionNameeversionCode)
Il numero di build iOS viene incrementato automaticamente da EAS.
Dimenticare di aggiornare i numeri di versione in tutti i file causerà errori di build o il rifiuto dell'app da parte dello store. Controlla attentamente ogni file elencato sopra prima di avviare una build di produzione.
Articoli correlati
- App mobile -- Guida alla configurazione locale e allo sviluppo
- Distribuzione delle API -- Distribuzione delle API di backend
- Distribuzione delle app web -- Distribuzione delle applicazioni web frontend