Предварительные требования
Необходимые инструменты зависят от того, над какими проектами вы планируете работать. На этой странице перечислено всё необходимое программное обеспечение, организованное по областям разработки, от универсальных требований до платформенно-специфичных инструментов.
Прежде чем начать
- Ознакомьтесь с Обзором проектов, чтобы определить, над какими проектами вы хотите работать
- Убедитесь, что у вас есть права администратора на вашей машине для разработки для установки программного обеспечения
Все проекты
Эти требования обязательны вне зависимости от того, над каким проектом вы работаете:
| Инструмент | Версия | Примечания |
|---|---|---|
| Node.js | 20+ | Версия 22+ требуется для B1App и LessonsApp (Next.js 16) |
| npm | Поставляется с Node.js | Используется как пакетный менеджер во всех проектах |
| Git | Последняя | Каждый проект — отдельный репозиторий |
Используйте менеджер версий Node, например nvm (macOS/Linux) или nvm-windows (Windows), для удобного переключения между версиями Node.
Разработка бэкенд-API
Если вы планируете запускать API локально (а не использовать staging):
| Инструмент | Версия | Примечания |
|---|---|---|
| MySQL | 8.0+ | Каждый модуль API использует собственную базу данных |
Вам понадобятся шесть баз данных для основного API: membership, attendance, content, giving, messaging и doing. API включает скрипты для инициализации схемы — см. руководство по локальной настройке API.
Разработка мобильных приложений
Для B1Mobile, B1Checkin, LessonsScreen или других приложений React Native / Expo:
| Инструмент | Версия | Примечания |
|---|---|---|
| Expo CLI | Последняя | Установите глобально: npm install -g expo-cli |
| Android Studio | Последняя | Требуется для разработки под Android (включает Android SDK) |
| Xcode | Последняя | Требуется для разработки под iOS (только macOS) |
Вы можете использовать приложение Expo Go на физическом устройстве для быстрого тестирования без Android Studio или Xcode. Однако для сборки продакшн-бинарников потребуются нативные инструменты.
Разработка FreeShow (настольное приложение)
FreeShow имеет дополнительные нативные зависимости сборки, поскольку компилирует нативные модули Node (например, canvas):
Все платформы
| Инструмент | Версия | Примечания |
|---|---|---|
| Python | 3.12 | Требуется node-gyp для компиляции нативных модулей |
| setuptools | Последняя | Установите через pip install setuptools |
Windows
| Инструмент | Примечания |
|---|---|
| Visual Studio | Community-версия достаточна |
| Рабочая нагрузка "Desktop development with C++" | Выберите во время установки Visual Studio |
| Windows 10 SDK | Включён в рабочую нагрузку C++; убедитесь, что отмечен |
Вы можете установить инструменты сборки Visual Studio через командную строку:
npm install --global windows-build-tools
Или установите Visual Studio Community и выберите рабочую нагрузку "Desktop development with C++" во время установки.
Linux
sudo apt-get install libfontconfig1-dev
macOS
Обычно достаточно Xcode Command Line Tools:
xcode-select --install
Проверьте установку
Запустите эти команды, чтобы убедиться, что всё установлено:
node --version # Should print v20.x.x or higher
npm --version # Should print 10.x.x or higher
git --version # Should print git version 2.x.x
mysql --version # Only needed for local API development
Следующие шаги
- Обзор проектов -- Посмотрите все проекты и узнайте, что они делают
- Переменные окружения -- Настройте файлы
.env