B1 Mobile
B1 Mobile er den primære medlems-vendte mobilapp for ChurchApps, bygget med React Native og Expo. Det tillader kirkmedlemmer at se mappeoplysninger, få adgang til giver, kontrollere tilstedeværelse, modtage meddelelser og interagere med deres kirkfællesskab.
Før du begynder
- Installer Node.js og Expo CLI -- se Forudsætninger
- Installer Android Studio (til Android-emulator) eller Xcode (til iOS-simulator)
- Konfigurér dit API-mål (staging eller lokalt) -- se Miljøvariabler
Setup
-
Klon lageret:
git clone https://github.com/ChurchApps/B1Mobile.git -
Installer afhængigheder:
cd B1Mobile && npm install -
Konfigurér miljøvariabler -- kopier sampelfilen og opdater API-endpoints:
cp dotenv.sample.txt .env -
Start Expo dev-serveren:
npm start
Du kan bruge Expo Go-appen på en fysisk enhed til hurtig test uden Android Studio eller Xcode.
Miljøvariabler
| Variable | Beskrivelse |
|---|---|
STAGE | Miljøscene (f.eks. dev, staging, prod) |
CONTENT_ROOT | Rod-URL til indholdslevering |
MEMBERSHIP_API | Medlemskabs-API-endpoint |
MESSAGING_API | Messaging-API-endpoint |
ATTENDANCE_API | Deltagelses-API-endpoint |
GIVING_API | Giving API-endpoint |
DOING_API | Doing API-endpoint |
CONTENT_API | Indhold API-endpoint |
LESSONS_ROOT | Rod-URL til lektionsindhold |
Vigtige kommandoer
| Command | Beskrivelse |
|---|---|
npm start | Start Expo dev-server |
npm run android | Kør på Android-emulator |
npm run ios | Kør på iOS-simulator |
npm run test | Kør test (Jest) |
Produktionsbyggerier
Før oprettelse af en produktionsbygning skal versionsnumre opdateres i alle følgende filer:
package.jsonapp.config.jsandroid/app/build.gradleios/B1Mobile/Info.plist
Android
npm run build:android
Dette bruger EAS Build til at oprette Android-binæren.
iOS
eas build --platform ios --profile production
OTA-opdateringer
For at skubbe en over-the-air-opdatering (uden app store-gennemsyn):
npm run update:production
OTA-opdateringer er ideelle til JavaScript-kun-ændringer. Hvis du ændrer native code eller afhængigheder, skal du i stedet indsende en fuldt butiksbyg.
Relaterede artikler
- Mobilinstallation -- Fuld vejledning til byggeri, indlevering og installation af mobilapps
- Miljøvariabler -- Fuldstændig reference til mobil miljøkonfiguration