Перейти к основному содержимому

Как выложить код AppX на GitHub

Каждое приложение AppX — это обычный проект Expo + React Native, и в каждом тарифе его можно целиком скачать в ZIP. Значит, его можно хранить в своём репозитории GitHub с помощью обычного git. Это руководство проводит по всем шагам.

примечание

Это руководство описывает ручной способ; он работает в каждом тарифе.

Что понадобится​

  • Установленный на компьютере git
  • Аккаунт на GitHub
  • Проект AppX хотя бы с одним собранным экраном

Шаг 1 — Скачайте код​

Откройте проект, нажмите Скачать код в верхней панели, затем Скачать код (ZIP). Вы получите ZIP со всем проектом.

Шаг 2 — Распакуйте архив​

Распакуйте файл в новую пустую папку и откройте терминал в этой папке:

cd path/to/your-app

Шаг 3 — Создайте git-репозиторий​

Сначала создайте .gitignore

В ZIP нет файла .gitignore. Перед коммитом создайте его и впишите node_modules/, .expo/ и .env, а также убедитесь, что в папке нет файла с настоящими ключами.

git init
git add .
git commit -m "First version from AppX"

Шаг 4 — Создайте репозиторий на GitHub​

Откройте github.com/new, выберите имя и создайте репозиторий. Не ставьте галочку «Add a README», чтобы первой отправке не с чем было сливаться.

Шаг 5 — Отправьте код​

Замените адрес на тот, который GitHub показывает для вашего нового репозитория:

git branch -M main
git remote add origin https://github.com/YOUR-USERNAME/YOUR-REPO.git
git push -u origin main

Теперь ваш код на GitHub.

Как выглядит репозиторий​

Типичный проект AppX — это обычное приложение Expo. Файлы лежат прямо в корне ZIP:

app/                   <- Экраны Expo Router
components/            <- Переиспользуемые компоненты
constants/             <- Цвета и тема
hooks/                 <- Свои хуки
app.json               <- Конфигурация Expo
package.json           <- Зависимости
tsconfig.json          <- Конфигурация TypeScript
README.md              <- Как запустить проект
.npmrc                 <- Настройки npm, нужные проекту

Любой, кто клонирует репозиторий, может запустить проект локально:

npm install
npx expo start

Поскольку это обычный проект Expo, он работает с остальными вашими инструментами — пул-реквестами, код-ревью и любым CI, которым вы уже пользуетесь.

Как обновить репозиторий позже​

Когда вы изменили приложение в AppX и хотите, чтобы репозиторий совпадал:

  1. Снова скачайте ZIP и распакуйте его.
  2. Скопируйте новые файлы поверх локальной папки. Скрытую папку .git не трогайте.
  3. Сделайте коммит и отправьте:
git add .
git commit -m "Update from AppX"
git push

Изменения, сделанные в репозитории, в AppX обратно не попадают.

О секретах​

Не храните API-ключи и другие секретные значения в репозитории.

Редактор кода

Читайте и правьте тот же код прямо в AppX.

Публикация

Как мы вместе с вами выводим приложение в магазины.