Requisitos previos
Las herramientas que necesita dependen de los proyectos en los que planee trabajar. Esta página enumera todo el software requerido, organizado por área de desarrollo, desde los requisitos universales hasta las herramientas específicas de cada plataforma.
Antes de comenzar
- Revise la Descripción general del proyecto para determinar en qué proyectos desea trabajar
- Tenga acceso de administrador en su equipo de desarrollo para instalar software
Todos los proyectos
Estos son necesarios sin importar en qué proyecto trabaje:
| Herramienta | Versión | Notas |
|---|---|---|
| Node.js | 20+ | Se requiere la versión 22+ para B1App y LessonsApp (Next.js 16); 24+ para la API |
| npm | Incluido con Node.js | Se usa como gestor de paquetes en todos los proyectos |
| Git | Última versión | Cada proyecto es un repositorio separado |
Use un gestor de versiones de Node como nvm (macOS/Linux) o nvm-windows (Windows) para cambiar fácilmente entre versiones de Node.
Desarrollo de la API (backend)
Si planea ejecutar la API localmente (en lugar de conectarse a las API de demostración):
| Herramienta | Versión | Notas |
|---|---|---|
| MySQL | 8.0+ | Cada módulo de la API usa su propia base de datos |
Necesitará seis bases de datos para la API principal: membership, attendance, content, giving, messaging y doing. La API incluye scripts para inicializar el esquema; consulte la guía Configuración local de la API.
Desarrollo de aplicaciones móviles
Para B1Checkin, LessonsScreen u otras aplicaciones de React Native / Expo:
| Herramienta | Versión | Notas |
|---|---|---|
| Expo CLI | Última versión | Instalación global: npm install -g expo-cli |
| Android Studio | Última versión | Necesario para el desarrollo en Android (incluye el SDK de Android) |
| Xcode | Última versión | Necesario para el desarrollo en iOS (solo macOS) |
Puede usar la aplicación Expo Go en un dispositivo físico para pruebas rápidas sin Android Studio ni Xcode. Sin embargo, para compilar binarios de producción se requieren las herramientas nativas.
Desarrollo de FreeShow (aplicación de escritorio)
FreeShow tiene dependencias de compilación nativas adicionales, porque compila módulos nativos de Node (como canvas):
Todas las plataformas
| Herramienta | Versión | Notas |
|---|---|---|
| Python | 3.12 | Requerido por node-gyp para compilar módulos nativos |
| setuptools | Última versión | Instalación mediante pip install setuptools |
Windows
| Herramienta | Notas |
|---|---|
| Visual Studio | La edición Community es suficiente |
| Carga de trabajo "Desarrollo de escritorio con C++" | Selecciónela durante la instalación de Visual Studio |
| Windows 10 SDK | Incluido en la carga de trabajo de C++; asegúrese de que esté marcado |
Puede instalar las herramientas de compilación de Visual Studio desde la línea de comandos:
npm install --global windows-build-tools
O bien, instale Visual Studio Community y seleccione la carga de trabajo "Desarrollo de escritorio con C++" durante la instalación.
Linux
sudo apt-get install libfontconfig1-dev
macOS
Normalmente, las herramientas de línea de comandos de Xcode son suficientes:
xcode-select --install
Verifique su instalación
Ejecute estos comandos para confirmar que todo está instalado:
node --version # Debería mostrar v20.x.x o superior
npm --version # Debería mostrar 10.x.x o superior
git --version # Debería mostrar git version 2.x.x
mysql --version # Solo necesario para el desarrollo local de la API
Próximos pasos
- Descripción general del proyecto -- Conozca todos los proyectos y lo que hace cada uno
- Variables de entorno -- Configure sus archivos
.env