Voraussetzungen
Welche Werkzeuge Sie benötigen, hängt davon ab, an welchen Projekten Sie arbeiten möchten. Diese Seite listet die gesamte erforderliche Software nach Entwicklungsbereich auf, von den universellen Anforderungen bis zu den plattformspezifischen Toolchains.
Bevor Sie beginnen
- Lesen Sie die Projektübersicht, um festzulegen, an welchen Projekten Sie arbeiten möchten
- Sie benötigen Administratorrechte auf Ihrem Entwicklungsrechner, um Software zu installieren
Alle Projekte
Diese Anforderungen gelten unabhängig davon, an welchem Projekt Sie arbeiten:
| Werkzeug | Version | Hinweise |
|---|---|---|
| Node.js | 20+ | Version 22+ ist für B1App und LessonsApp (Next.js 16) erforderlich; 24+ für die Api |
| npm | Wird mit Node.js installiert | Wird in allen Projekten als Paketmanager verwendet |
| Git | Neueste Version | Jedes Projekt ist ein eigenes Repository |
Verwenden Sie einen Node-Versionsmanager wie nvm (macOS/Linux) oder nvm-windows (Windows), um einfach zwischen Node-Versionen zu wechseln.
Backend-API-Entwicklung
Wenn Sie die API lokal ausführen möchten (anstatt auf die Demo-APIs zu verweisen):
| Werkzeug | Version | Hinweise |
|---|---|---|
| MySQL | 8.0+ | Jedes API-Modul verwendet eine eigene Datenbank |
Für die Kern-API benötigen Sie sechs Datenbanken: membership, attendance, content, giving, messaging und doing. Die API enthält Skripte zur Initialisierung des Schemas -- siehe die Anleitung API lokale Einrichtung.
Mobile-App-Entwicklung
Für B1Checkin, LessonsScreen oder andere React-Native- / Expo-Apps:
| Werkzeug | Version | Hinweise |
|---|---|---|
| Expo CLI | Neueste Version | Global installieren: npm install -g expo-cli |
| Android Studio | Neueste Version | Erforderlich für die Android-Entwicklung (enthält das Android SDK) |
| Xcode | Neueste Version | Erforderlich für die iOS-Entwicklung (nur macOS) |
Für schnelle Tests auf einem physischen Gerät können Sie die Expo-Go-App verwenden, ohne Android Studio oder Xcode zu benötigen. Zum Erstellen von Produktionsbinärdateien sind jedoch die nativen Toolchains erforderlich.
FreeShow (Desktop-App) Entwicklung
FreeShow benötigt zusätzliche native Build-Abhängigkeiten, da native Node-Module (wie canvas) kompiliert werden:
Alle Plattformen
| Werkzeug | Version | Hinweise |
|---|---|---|
| Python | 3.12 | Wird von node-gyp zur Kompilierung nativer Module benötigt |
| setuptools | Neueste Version | Installation über pip install setuptools |
Windows
| Werkzeug | Hinweise |
|---|---|
| Visual Studio | Die Community-Edition reicht aus |
| Workload „Desktopentwicklung mit C++“ | Während der Visual-Studio-Installation auswählen |
| Windows 10 SDK | Im C++-Workload enthalten; stellen Sie sicher, dass es ausgewählt ist |
Die Visual-Studio-Build-Tools können Sie über die Kommandozeile installieren:
npm install --global windows-build-tools
Alternativ installieren Sie Visual Studio Community und wählen während der Installation den Workload „Desktopentwicklung mit C++“ aus.
Linux
sudo apt-get install libfontconfig1-dev
macOS
Die Xcode Command Line Tools reichen in der Regel aus:
xcode-select --install
Installation überprüfen
Führen Sie diese Befehle aus, um zu prüfen, ob alles installiert ist:
node --version # Sollte v20.x.x oder höher ausgeben
npm --version # Sollte 10.x.x oder höher ausgeben
git --version # Sollte git version 2.x.x ausgeben
mysql --version # Nur für die lokale API-Entwicklung erforderlich
Nächste Schritte
- Projektübersicht -- Alle Projekte und ihre Funktionen im Überblick
- Umgebungsvariablen -- Konfigurieren Sie Ihre
.env-Dateien