Zum Hauptinhalt springen

B1 Mobile

B1 Mobile ist die primäre Mitglieder-seitige Mobile-App für ChurchApps, gebaut mit React Native und Expo. Es ermöglicht Gemeindeglieder, Verzeichnisse anzuzeigen, auf Spenden zuzugreifen, Anwesenheit zu überprüfen, Benachrichtigungen zu empfangen und mit ihrer Gemeinde-Gemeinschaft zu interagieren.

Vor dem Start

  • Installieren Sie Node.js und Expo CLI — siehe Voraussetzungen
  • Installieren Sie Android Studio (für Android-Emulator) oder Xcode (für iOS-Simulator)
  • Konfigurieren Sie Ihr API-Ziel (Staging oder lokal) — siehe Umgebungsvariablen

Setup

  1. Repository klonen:

    git clone https://github.com/ChurchApps/B1Mobile.git
  2. Abhängigkeiten installieren:

    cd B1Mobile && npm install
  3. Umgebungsvariablen konfigurieren — Sample-Datei kopieren und API-Endpoints aktualisieren:

    cp dotenv.sample.txt .env
  4. Expo Dev-Server starten:

    npm start
Tipp

Sie können die Expo Go-App auf einem physischen Gerät für schnelle Tests nutzen, ohne Android Studio oder Xcode einzurichten.

Umgebungsvariablen

VariableBeschreibung
STAGEUmgebungsstadium (z.B., dev, staging, prod)
CONTENT_ROOTRoot-URL für Content-Lieferung
MEMBERSHIP_APIMembership-API-Endpoint
MESSAGING_APIMessaging-API-Endpoint
ATTENDANCE_APIAttendance-API-Endpoint
GIVING_APIGiving-API-Endpoint
DOING_APIDoing-API-Endpoint
CONTENT_APIContent-API-Endpoint
LESSONS_ROOTRoot-URL für Lessons-Content

Wichtige Befehle

BefehlBeschreibung
npm startExpo Dev-Server starten
npm run androidAuf Android-Emulator ausführen
npm run iosAuf iOS-Simulator ausführen
npm run testTests ausführen (Jest)

Production-Builds

Vor Erstellung eines Production-Builds müssen Versionsnummern in allen folgenden Dateien aktualisiert werden:

  • package.json
  • app.config.js
  • android/app/build.gradle
  • ios/B1Mobile/Info.plist

Android

npm run build:android

Dies nutzt EAS Build, um die Android-Binärdatei zu erstellen.

iOS

eas build --platform ios --profile production

OTA-Updates

Um ein Over-the-Air-Update zu pushen (ohne App-Store-Review):

npm run update:production
Info

OTA-Updates sind ideal für JavaScript-Only-Änderungen. Wenn Sie Native-Code oder Abhängigkeiten modifizieren, müssen Sie stattdessen einen vollständigen Store-Build submitten.

Verwandte Artikel

  • Mobile-Deployment — Vollständiger Leitfaden zum Bauen, Submitten und Deployen von Mobile-Apps
  • Umgebungsvariablen — Vollständige Referenz für Mobile-Umgebungskonfiguration