Spring til hovedindhold

Forudsætninger

De værktøjer, du har brug for, afhænger af, hvilke projekter du planlægger at arbejde på. Denne side viser alle påkrævede software organiseret efter udviklingsfelt, fra universelle krav til platform-specifikke værktøjskæder.

Før du begynder

  • Gennemgå Projektoversigt for at bestemme, hvilke projekter du vil arbejde på
  • Har administratoradgang på din udviklingsmaskine til installation af software

Alle projekter

Disse er påkrævede uanset, hvilket projekt du arbejder på:

ToolVersionNotes
Node.js20+Version 22+ påkrævet for B1App og LessonsApp (Next.js 16)
npmKommer med Node.jsBruges som package manager på tværs af alle projekter
GitSenesteHvert projekt er et separat lager
tip

Brug en Node version manager som nvm (macOS/Linux) eller nvm-windows (Windows) til let at skifte mellem Node-versioner.

Backend API-udvikling

Hvis du planlægger at køre API'en lokalt (i stedet for at pege på staging):

ToolVersionNotes
MySQL8.0+Hvert API-modul bruger sin egen database

Du får brug for seks databaser for kerne-API'en: membership, attendance, content, giving, messaging og doing. API'en indeholder scripter til initialisering af skemaet -- se vejledningen Lokalt API Setup.

Mobil-app udvikling

For B1Mobile, B1Checkin, LessonsScreen eller andre React Native / Expo-apps:

ToolVersionNotes
Expo CLISenesteInstaller globalt: npm install -g expo-cli
Android StudioSenestePåkrævet til Android-udvikling (inkluderer Android SDK)
XcodeSenestePåkrævet til iOS-udvikling (kun macOS)
info

Du kan bruge Expo Go-appen på en fysisk enhed til hurtig test uden Android Studio eller Xcode. Dog kræver byggeri af produktionsbinære filer de oprindelige værktøjskæder.

FreeShow (Desktop App) Udvikling

FreeShow har yderligere native build-afhængigheder, fordi den kompilerer native Node-moduler (som canvas):

Alle platforme

ToolVersionNotes
Python3.12Påkrævet af node-gyp til kompilering af native moduler
setuptoolsSenesteInstaller via pip install setuptools

Windows

ToolNotes
Visual StudioCommunity edition er tilstrækkelig
"Skrivebordudvikling med C++"-arbejdsbelastningVælg under Visual Studio-installation
Windows 10 SDKInkluderet i C++-arbejdsbelastningen; sørg for, at den er markeret

Du kan installere Visual Studio build tools via kommandolinjen:

npm install --global windows-build-tools

Eller installer Visual Studio Community og vælg "Skrivebordudvikling med C++"-arbejdsbelastningen under installationen.

Linux

sudo apt-get install libfontconfig1-dev

macOS

Xcode Command Line Tools er typisk tilstrækkelig:

xcode-select --install

Bekræft din installation

Kør disse kommandoer for at bekræfte, at alt er installeret:

node --version    # Bør udskrive v20.x.x eller højere
npm --version # Bør udskrive 10.x.x eller højere
git --version # Bør udskrive git version 2.x.x
mysql --version # Kun påkrævet til lokal API-udvikling

Næste trin