Vai al contenuto principale

Prerequisiti

Gli strumenti necessari dipendono dai progetti su cui intendi lavorare. Questa pagina elenca tutto il software richiesto, organizzato per area di sviluppo, dai requisiti comuni alle toolchain specifiche per piattaforma.

Prima di iniziare

  • Consulta la Panoramica dei progetti per decidere su quali progetti vuoi lavorare
  • Assicurati di avere i privilegi di amministratore sul tuo computer di sviluppo per installare il software

Tutti i progetti​

Questi strumenti sono richiesti indipendentemente dal progetto su cui lavori:

StrumentoVersioneNote
Node.js20+La versione 22+ è richiesta per B1App e LessonsApp (Next.js 16); la 24+ per l'Api
npmIncluso con Node.jsUtilizzato come gestore di pacchetti in tutti i progetti
GitUltima versioneOgni progetto è un repository separato
Suggerimento

Usa un gestore di versioni di Node come nvm (macOS/Linux) o nvm-windows (Windows) per passare facilmente da una versione di Node all'altra.

Sviluppo del backend API​

Se prevedi di eseguire l'API localmente (anziché puntare alle API di demo):

StrumentoVersioneNote
MySQL8.0+Ogni modulo dell'API utilizza il proprio database

Per l'API principale ti serviranno sei database: membership, attendance, content, giving, messaging e doing. L'API include degli script per inizializzare lo schema -- consulta la guida configurazione locale dell'API.

Sviluppo delle app mobili​

Per B1Checkin, LessonsScreen o altre app React Native / Expo:

StrumentoVersioneNote
Expo CLIUltima versioneInstallazione globale: npm install -g expo-cli
Android StudioUltima versioneNecessario per lo sviluppo Android (include l'Android SDK)
XcodeUltima versioneNecessario per lo sviluppo iOS (solo macOS)
Info

Puoi usare l'app Expo Go su un dispositivo fisico per test rapidi senza Android Studio o Xcode. Tuttavia, per creare binari di produzione sono necessarie le toolchain native.

Sviluppo di FreeShow (app desktop)​

FreeShow richiede dipendenze native aggiuntive per la compilazione, perché compila moduli Node nativi (come canvas):

Tutte le piattaforme​

StrumentoVersioneNote
Python3.12Richiesto da node-gyp per la compilazione dei moduli nativi
setuptoolsUltima versioneInstallazione tramite pip install setuptools

Windows​

StrumentoNote
Visual StudioL'edizione Community è sufficiente
Carico di lavoro "Sviluppo desktop con C++"Selezionalo durante l'installazione di Visual Studio
Windows 10 SDKIncluso nel carico di lavoro C++; assicurati che sia selezionato

Puoi installare gli strumenti di compilazione di Visual Studio da riga di comando:

npm install --global windows-build-tools

In alternativa, installa Visual Studio Community e seleziona il carico di lavoro "Sviluppo desktop con C++" durante l'installazione.

Linux​

sudo apt-get install libfontconfig1-dev

macOS​

Di solito bastano gli Strumenti da riga di comando di Xcode:

xcode-select --install

Verifica dell'installazione​

Esegui questi comandi per confermare che tutto sia installato:

node --version    # Dovrebbe stampare v20.x.x o superiore
npm --version # Dovrebbe stampare 10.x.x o superiore
git --version # Dovrebbe stampare git version 2.x.x
mysql --version # Necessario solo per lo sviluppo locale dell'API

Passaggi successivi​