Lumipat sa pangunahing nilalaman

Mga Kinakailangan

Ang mga kasangkapang kailangan mo ay nakadepende sa mga proyektong balak mong pagtrabahuhan. Nakalista sa pahinang ito ang lahat ng kinakailangang software, na inayos ayon sa lugar ng development, mula sa mga pangkalahatang kinakailangan hanggang sa mga toolchain na partikular sa platform.

Bago Ka Magsimula

  • Basahin ang Project Overview para malaman kung aling mga proyekto ang gusto mong pagtrabahuhan
  • Kailangan mo ng administrator access sa iyong development machine para mag-install ng software

Lahat ng Proyekto​

Kinakailangan ang mga ito anuman ang proyektong pagtatrabahuhan mo:

ToolBersyonMga Tala
Node.js20+Kailangan ang bersyon 22+ para sa B1App at LessonsApp (Next.js 16); 24+ para sa Api
npmKasama ng Node.jsGinagamit na package manager sa lahat ng proyekto
GitPinakabagoMagkakahiwalay na repository ang bawat proyekto
Tip

Gumamit ng Node version manager tulad ng nvm (macOS/Linux) o nvm-windows (Windows) para madaling makapagpalit ng bersyon ng Node.

Backend API Development​

Kung balak mong patakbuhin ang API nang lokal (sa halip na gamitin ang mga demo API):

ToolBersyonMga Tala
MySQL8.0+Gumagamit ang bawat API module ng sarili nitong database

Kakailanganin mo ng anim na database para sa core API: membership, attendance, content, giving, messaging, at doing. May mga script ang API para i-initialize ang schema -- tingnan ang gabay na API local setup.

Mobile App Development​

Para sa B1Checkin, LessonsScreen, o iba pang React Native / Expo app:

ToolBersyonMga Tala
Expo CLIPinakabagoI-install nang global: npm install -g expo-cli
Android StudioPinakabagoKailangan para sa Android development (kasama ang Android SDK)
XcodePinakabagoKailangan para sa iOS development (macOS lang)
Impormasyon

Maaari mong gamitin ang Expo Go app sa totoong device para sa mabilisang pagsubok nang walang Android Studio o Xcode. Gayunman, kailangan ng native toolchain para makabuo ng production binary.

FreeShow (Desktop App) Development​

May karagdagang native build dependency ang FreeShow dahil nagko-compile ito ng native Node module (gaya ng canvas):

Lahat ng Platform​

ToolBersyonMga Tala
Python3.12Kailangan ng node-gyp para sa pag-compile ng native module
setuptoolsPinakabagoI-install gamit ang pip install setuptools

Windows​

ToolMga Tala
Visual StudioSapat na ang Community edition
"Desktop development with C++" workloadPiliin habang nag-i-install ng Visual Studio
Windows 10 SDKKasama sa C++ workload; siguraduhing may check ito

Maaari mong i-install ang Visual Studio build tools sa pamamagitan ng command line:

npm install --global windows-build-tools

O i-install ang Visual Studio Community at piliin ang "Desktop development with C++" workload habang nag-i-install.

Linux​

sudo apt-get install libfontconfig1-dev

macOS​

Kadalasang sapat na ang Xcode Command Line Tools:

xcode-select --install

I-verify ang Iyong Installation​

Patakbuhin ang mga command na ito para makumpirmang tama ang lahat ng naka-install:

node --version    # Dapat mag-print ng v20.x.x o mas mataas
npm --version # Dapat mag-print ng 10.x.x o mas mataas
git --version # Dapat mag-print ng git version 2.x.x
mysql --version # Kailangan lang para sa lokal na API development

Susunod na Hakbang​