1. Node.js

Скачать: https://nodejs.org/en → установить LTS (например, 22.18.0).

Во время установки рекомендуется снять галочки с опций автоматической установки дополнительного инструментария.

Проверка в PowerShell / CMD:
node -v
npm -v

2. Git

Скачать: https://git-scm.com → установить.

После установки ОБЯЗАТЕЛЬНО настроить пользователя (выполнить в терминале):

git config --global user.name "Ваше Имя" (любое имя)
git config --global user.email "ваша_почта@example.com"
(почта на которую вы зарегистрировали github, так же надо что б почта на github была подтверждена)

Проверка:
git --version
git config --global --list

3. Java Development Kit (JDK)

Скачать: https://adoptium.net → установить Temurin 21 (рекомендуется для RN 0.76+).

Проверка:
java -version
javac -version

Важно: После установки убедись, что переменные окружения настроены правильно.

4. Android Studio

Скачать: https://developer.android.com/studio → установить.
При установке ✅ Android Studio, ✅ Android Virtual Device.

После установки:

1. Первоначальная автоматическая настройка:
1. Запусти Android Studio. При первом запуске откроется мастер настройки (Setup Wizard).
2. Выбери режим Standard (Стандартный) и заверши процесс (если будет выбор, а так просто выполнить установку по умолчанию).
3. Мастер автоматически скачает и установит компоненты самой последней версии (например, API 36). Это нормально.
4. Дождись полного завершения загрузки и установки. Студия откроется на стартовом экране.
2. Удаление стандартного эмулятора (если он создан):
1. На стартовом экране Android Studio нажми More Actions (в центре экрана под New Project, Open, Clone Repository) → Virtual Device Manager.
2. Если в списке есть любой эмулятор (например, "Medium Phone") — нажми на значок ⋮ (три точки) напротив него и выбери Delete. Подтверди удаление.
3. Создание правильного эмулятора для проекта:
1. В окне Device Manager нажми кнопку Create device (или +).
2. Выбери устройство: В категории Phone выбери Pixel 6a
3. ВАЖНО: В колонке Play должен быть иконка Google play, если нету то выбери любой другой смартфон у которого есть иконка Google Play → Нажми Next.
   (Google Play нужен для работы биометрии на смартфоне, без Google Play биометрия не будет работать)
4. API надо выбрать UpsideDownCake, API Level: 34 (но можно выбрать любой другой, но лучше 34 так как он надежнее и проще по нагрузке).
5. КРИТИЧЕСКИ ВАЖНО: Services обязательно должен быть Google Play (а не "Google APIs" или "Android Open Source").
6. Заверши настройку: Дайте эмулятору любое имя (например, Pixel_6a_API_34), оставьте остальные настройки по умолчанию → Нажми Finish.

4. Настройка переменных окружения (❗КРИТИЧЕСКИ ВАЖНО)

1. "Переменные среды"
1. Открой окно "Переменные среды":
2. Нажми на клавиатуре Win + R.
3. В появившемся окне "Выполнить" введи sysdm.cpl.
4. Нажми Enter. Откроется окно "Свойства системы".
5. Перейди во вкладку "Дополнительно".
6. Внизу окна нажми кнопку "Переменные среды...".
2. Создай переменную ANDROID_HOME:
1. В открывшемся окне в разделе "Системные переменные" нажми кнопку "Создать...".
2. В поле "Имя переменной:" введи ANDROID_HOME.
3. В поле "Значение переменной:" введи путь к SDK:
   C:\Users\<ТВОЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ>\AppData\Local\Android\Sdk
   (Обязательно замени <ТВОЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ> на имя своей учетной записи Windows!)
4. Нажми "ОК".
3. Добавь пути в системную переменную Path:
1. В том же разделе "Системные переменные" найди переменную Path.
2. Выдели её и нажми кнопку "Измени...".
3. В открывшемся окне нажми "Создать" — появится новая пустая строка.
4. Вставь в неё следующее значение: %ANDROID_HOME%\platform-tools
5. Снова нажми "Создать" и вставь: %ANDROID_HOME%\emulator
6. Снова нажми "Создать" и вставь: %ANDROID_HOME%\tools\bin
7. Важно: Добавляй именно отдельными строками, как на картинке ниже, а не все через точку с запятой.
8. После добавления всех трёх путей нажми "ОК".
4. Закрой все окна:
1. Нажми "ОК" в окне "Переменные среды".
2. Нажми "ОК" в окне "Свойства системы".
5. Перезапусти терминал/PowerShell/VS Code! Это обязательный шаг, чтобы изменения вступили в силу.

5. VS Code

Скачать: https://code.visualstudio.com → установить как редактор по умолчанию для Git.

Путь: C:\Users\<ТВОЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ>\AppData\Local\Programs\Microsoft VS Code

Расширения:

1. React Native Tools
2. ES7+ React/Redux/React-Native snippets
3. Prettier – Code formatter
4. JavaScript (ES6) code snippets

6. React Native — настройка проекта

1. Склонировать проект с GitHub :
1. Создай папку в удобном месте, к примеру E:/Project
2. Открой папку VS Code 'ом, в терминале выполни:
3. git clone https://github.com/Project/test.git
   (Если данная ссылка кому то и принадлежит, то она тут используется исключительно в образовательных целях.)
4. Это создаст папку E:/Project/test
2. Переходи в нее
   cd test
3. И затем установить все зависимости проекта (это создаст папку node_modules):
   npm install

7. Запуск эмулятора и приложения

1. Запусти эмулятор Android через AVD Manager в Android Studio. Дождись полной загрузки.
2. (Рекомендуется) Проверь подключение в терминале:
   adb devices
1. Должен отобразиться твой эмулятор (например, emulator-5554 device).
3. В терминале VS Code (в папке проекта Project/test) выполни одну команду:
   npx react-native run-android
1. Эта команда автоматически запустит Metro Bundler, соберет и установит приложение на эмулятор.
4. После успешной установки приложение откроется. Окно с Metro не закрывай.
5. Внесение изменений: Сохраняй (Ctrl+S) любой файл с кодом → изменения мгновенно появятся в приложении (Hot Reload).

8. DevTools (опционально)

В Metro терминале можно нажать на 3 кнопки r j d, каждая из них сделает свое действие, а именно:

r → Можно просто нажимать в консоли r для hot-reload (быстрая пересборка/можно использовать вместо того чтоб полностью закрывать приложение на эмуляторе)
j → откроется React Native DevTools в Chrome.
d → Откроет меню разработчика (пока лучше туда не лезть)

Окно Metro Bundler не закрываем. Если нужно ввести другие команды — открой новый терминал в VS Code.

9. Работа с Git и процесс обновлений

После того как ты внес изменения в код (добавил экран, исправил баг и т.д.), чтобы отправить их в общий репозиторий, нужно следовать нескольким шагам. Никогда не пушим сразу в главную ветку main.

1. Проверь, на какой ветке ты находишься и обнови main
1. Эта команда покажет текущую ветку (она будет подсвечена звездочкой)
   git branch
2. Если ты не на main, переключись на нее
   git checkout main
3. Забери самые свежие обновления с GitHub
   git pull origin main
2. Создай новую ветку для своей задачи
1. Ветку лучше называть понятно, что ты в ней делаешь.
2. Создай и перейди в новую ветку (замени 'feature/settings-screen' на свое название)
   git checkout -b feature/settings-screen
3. Добавь и сохрани (закоммить) свои изменения
1. Регулярно сохраняй свою работу.
2. Добавить все измененные файлы (или можно указать конкретные файлы через пробел)
   git add .
3. (Опционально) Проверка перед коммитом — посмотреть, какие файлы будут закоммичены:
   git status
4. Создать "сохранение" (коммит) с понятным описанием
   git commit -m "feat: add new SettingsScreen with user profile"
4. Отправь (запушь) свою ветку на GitHub
1. В первый раз нужно отправить ветку и связать ее с GitHub
   git push -u origin feature/settings-screen
2. Все последующие пуши в эту же ветку можно делать просто:
   git push
5. Создай Pull Request (PR) на GitHub
1. Зайди на страницу репозитория: https://github.com/Project/test.git
2. GitHub сам предложит тебе создать Pull Request для свежезапушенной ветки.
3. Или перейди во вкладку "Pull requests" → "New pull request".
4. Убедись, что base — это main, а compare — это твоя ветка (feature/settings-screen).
5. Напиши понятное название и описание для своего PR (что ты сделал? что изменилось?).
6. Создай PR. Теперь твои изменения могут проверить и затем добавить в главную ветку.
6. После мержа PR (объединения с main)
1. Когда твой PR будет принят и объединен с main, можно удалить ветку локально и на GitHub, а затем обновить main.
2. Переключись на main
   git checkout main
3. Забери обновленный main с GitHub
   git pull origin main
4. Удали локальную ветку, которая уже не нужна
   git branch -d feature/settings-screen
5. (Опционально) Удали ветку на GitHub
   git push origin --delete feature/settings-screen

Заключение / Что дальше?

Поздравляем! 🎉

Вы успешно настроили все необходимые инструменты и окружение для разработки. Теперь у вас есть:

1. Установленные и настроенные Node.js, Git, JDK, Android Studio и VS Code.
2. Созданный и готовый к работе эмулятор Android.
3. Локальная копия проекта со всеми зависимостями.
4. Запущенное и работающее приложение на эмуляторе.

Следующие шаги:

1. Ознакомьтесь с кодом проекта в VS Code.
2. Внесите небольшое изменение (например, измените текст на главном экране), чтобы убедиться, что Hot Reload работает.
3. Изучите процесс работы с Git в пункте 9 инструкции, чтобы начать вносить свой вклад в проект.
4. Если что-то пошло не так — сверьтесь с инструкцией ещё раз, проверьте пути и версии. Самые частые проблемы — невнимательная настройка переменных окружения ANDROID_HOME и PATH.
   

Сообщество RyukoHQ:

• Наш сайт: https://ryukohq.com
• Наш Telegram-канал: https://t.me/RyukoHQ

Удачной разработки!