Expo build: Create your first build — Expo Documentation

Для небольшого приложения сборки для платформ Android и iOS запускаются в течение нескольких минут. Если у вас возникнут какие-либо проблемы на этом пути, вы можете связаться с ними на форумах Expo или в Discord.

EAS Build — это новая и быстро развивающаяся услуга. Прежде чем приступить к созданию сборки для своего проекта, мы рекомендуем ознакомиться со страницей ограничений и другими предварительными условиями ниже.

У вас еще нет проекта? Без проблем. С помощью этого руководства можно быстро и легко создать приложение «Hello world», которое можно использовать.

• Установите Expo CLI, выполнив команду:

• Выполните следующую команду, чтобы создать новый проект:

EAS Build также хорошо работает с проектами, созданными с помощью npx create-react-native-app , npx react -родной , зажигание -cli и другие инструменты начальной загрузки проекта.

Сборка EAS доступна всем, у кого есть учетная запись Expo, независимо от того, платите ли вы за EAS или используете наш бесплатный уровень. Вы можете зарегистрироваться на https://expo.dev/signup.

Платные подписчики получают улучшения качества, такие как дополнительные параллельные сборки, приоритетный доступ для минимизации времени, в течение которого ваши сборки стоят в очереди, и увеличенные ограничения на время ожидания сборки. Узнайте больше о различных планах и преимуществах по ценам EAS.

1

CLI EAS — это приложение командной строки, которое вы будете использовать для взаимодействия со службами EAS с вашего терминала. Для его установки выполните команду:

Вы также можете использовать приведенную выше команду, чтобы проверить, доступна ли новая версия интерфейса командной строки EAS. Мы рекомендуем вам всегда оставаться в курсе последней версии.

Мы рекомендуем использовать npm вместо yarn для глобальной установки пакетов. В качестве альтернативы вы можете использовать npx eas-cli@latest , просто не забудьте использовать это вместо eas всякий раз, когда это требуется в документации.

2

Если вы уже вошли в учетную запись Expo с помощью интерфейса командной строки Expo, вы можете пропустить шаги, описанные в этом разделе. Если нет, выполните следующую команду для входа в систему:

Вы можете проверить, вошли ли вы в систему, запустив eas whoami .

3

Чтобы настроить проект iOS или Android для сборки EAS, выполните следующую команду:

Если вы хотите узнать больше о том, что происходит за кулисами, вы можете прочитать справочник по процессу настройки сборки.

В некоторых сценариях может потребоваться дополнительная настройка:

• Вы переносите управляемое приложение Expo из "expo build" ? Узнайте о различиях.
• Зависит ли код вашего приложения от переменных среды? Добавьте их в конфигурацию сборки.
• Ваш проект находится внутри монорепозитория? Следуйте этим инструкциям.
• Используете ли вы частные пакеты npm? Добавьте свой токен npm.
• Зависит ли ваше приложение от конкретных версий таких инструментов, как Node, Yarn, npm, CocoaPods или Xcode? Укажите эти версии в конфигурации сборки.

4

Сборка для эмулятора/устройства Android или симулятора iOS

Самый простой способ опробовать сборку EAS — создать сборку, которую можно запустить на устройстве/эмуляторе Android или симуляторе iOS. Это быстрее, чем загружать его в магазин, и вам не нужны учетные записи разработчиков магазина. Если вы хотите попробовать это, прочитайте о создании устанавливаемого APK для Android и создании сборки симулятора для iOS.

Сборка для магазинов приложений

Перед началом процесса сборки для магазинов приложений вам потребуется учетная запись разработчика магазина и создание или предоставление учетных данных для подписи приложения.

Независимо от того, есть ли у вас опыт создания учетных данных для подписи приложений, EAS CLI сделает всю тяжелую работу. Вы можете подписаться на EAS CLI, чтобы обрабатывать учетные данные для подписи приложения. Ознакомьтесь с инструкциями по учетным данным для подписи приложения Android или процессом подписания приложения iOS ниже для получения дополнительной информации.

Вы можете создать и подписать свое приложение с помощью EAS Build, но вы не можете загрузить его в Google Play Store, если у вас нет членства, единовременная плата в размере 25 долларов США.

Если вы собираетесь использовать EAS Build для создания выпускных сборок для Apple App Store, вам необходим доступ к учетной записи с членством в программе Apple Developer Program за 99 долларов США.

После того, как вы подтвердите, что у вас есть учетная запись в Google Play Store или Apple App Store, и решите, должен ли CLI EAS обрабатывать учетные данные для подписи приложения, вы можете приступить к следующему набору команд для создания магазина платформы:

90 005 Вы можете прикрепить сообщение к сборке, передав --message команде сборки, например, eas build --platform ios --message "Некое сообщение" . Сообщение появится на сайте. Это удобно, когда вы хотите оставить заметку с целью сборки для вашей команды.

Кроме того, вы можете использовать опцию --platform all для одновременной сборки Android и iOS:

Если вы освободили app для хранения ранее и иметь существующие учетные данные для подписи приложения, которые вы хотите использовать, следуйте этим инструкциям, чтобы настроить их.

Учетные данные для подписи приложения Android

• Если вы еще не создали хранилище ключей для своего приложения, вы можете позволить EAS CLI позаботиться об этом за вас, выбрав Создать новое хранилище ключей , и все готово. Хранилище ключей безопасно хранится на серверах EAS.
• Если вы ранее создавали приложение с помощью expo build:android , вы можете использовать здесь те же учетные данные.
• Если вы хотите создать хранилище ключей вручную, см. дополнительную информацию в руководстве по учетным данным Android.

Учетные данные для подписи приложения iOS

• Если вы еще не создали профиль обеспечения и/или сертификат распространения, вы можете позволить EAS CLI позаботиться об этом за вас, войдя в свою учетную запись Apple Developer Program и следуя инструкциям.
• Если вы уже создали свое приложение с помощью expo build:ios , вы можете использовать здесь те же учетные данные.
• Если вы хотите сгенерировать свои учетные данные вручную, обратитесь к руководству по учетным данным iOS для получения дополнительной информации.

5

По умолчанию команда eas build будет ожидать завершения сборки, но вы можете прервать ее, если не хотите ждать. Отслеживайте ход выполнения и читайте журналы, перейдя по ссылке на страницу сведений о сборке, которую EAS CLI запрашивает после запуска процесса сборки. Вы также можете найти эту страницу, посетив панель управления сборкой или выполнив следующую команду:

Если вы являетесь членом организации и ваша сборка выполняется от ее имени, вы найдете сведения о сборке на панели управления сборкой для этой учетной записи.

Ваша сборка не удалась? Дважды проверьте, выполнили ли вы все применимые инструкции на этапе настройки, и при необходимости обратитесь к руководству по устранению неполадок.

6

Если вы дошли до этого шага, поздравляем! В зависимости от того, какой путь вы выбрали, теперь у вас либо есть сборка, готовая к загрузке в магазин приложений, либо у вас есть сборка, которую вы можете установить непосредственно на устройство Android/симулятор iOS.

Распространите свое приложение в магазине приложений

Вы сможете отправить приложение в магазин приложений только в том случае, если вы создали его специально для этой цели. Если вы создали сборку для магазина, узнайте, как отправить свое приложение в магазины приложений с помощью EAS Submit.

Установите и запустите приложение

Вы сможете установить приложение непосредственно на устройство Android/iOS Simulator только в том случае, если вы специально создали его для этой цели. Если вы создали приложение для распространения в магазине приложений, вам нужно будет загрузить его в магазин приложений, а затем установить его оттуда (например, из приложения Apple TestFlight).

Чтобы узнать, как установить приложение непосредственно на устройство Android/симулятор iOS, перейдите на страницу сведений о сборке с панели управления сборкой и нажмите кнопку «Установить».

Мы провели вас через шаги по созданию вашей первой сборки с помощью EAS Build, не вдаваясь слишком глубоко в какую-либо конкретную часть процесса.

Когда вы будете готовы узнать больше, мы рекомендуем перейти к разделу «Начать сборку » этой документации, чтобы узнать о таких темах, как:

• Конфигурация с помощью eas.json
• Внутреннее распределение
• Обновления
• Автоматизация отправки
• Запуск сборок из CI

Вы также можете просмотреть справочный раздел, чтобы узнать больше о темах, которые вас больше всего интересуют, например:

• Создание веб-перехватчиков
• Построить серверную инфраструктуру
• Как работают процессы сборки Android и iOS

Сборка APK для Android-эмуляторов и устройств

Узнайте, как настроить и установить . apk для эмуляторов и устройств Android при использовании EAS Build.

Формат файла по умолчанию, используемый при создании приложений для Android с помощью EAS Build, — Android App Bundle (AAB/ .aab ). Этот формат оптимизирован для распространения в Google Play Store. Однако AAB нельзя установить непосредственно на ваше устройство. Чтобы установить сборку непосредственно на Android-устройство или эмулятор, вместо этого необходимо собрать пакет Android (APK/ .apk ).

Чтобы сгенерировать .apk , измените eas.json , добавив одно из следующих свойств в профиль сборки: 226)

android.gradleCommand от до :app:assembleRelease , :app:assembleDebug или любая другая команда gradle, которая создает . apk

 {
  "строить": {
    "предварительный просмотр": {
      "андроид": {
        "тип сборки": "apk"
      }
    },
    "предварительный просмотр2": {
      "андроид": {
        "gradleCommand": ": приложение: assembleRelease"
      }
    },
    "предварительный просмотр3": {
      «Клиент развития»: правда
    },
    "производство": {}
  }
}
 

Теперь вы можете запустить сборку с помощью следующей команды:

Помните, что вы можете назвать профиль как угодно. Мы назвали профиль предварительный просмотр . Однако вы можете назвать его локальный , эмулятор или как вам больше подходит.

Эмулятор («Виртуальное устройство»)

Если вы еще не устанавливали и не запускали эмулятор Android, следуйте инструкциям по эмулятору Android Studio, прежде чем продолжить.

После завершения сборки интерфейс командной строки предложит вам автоматически загрузить и установить ее в эмуляторе Android. При появлении запроса нажмите Y , чтобы установить его непосредственно на эмуляторе.

Если у вас несколько сборок, вы также можете в любой момент запустить команду eas build:run , чтобы загрузить конкретную сборку и автоматически установить ее в эмуляторе Android: run -p android

Команда также показывает список доступных сборок вашего проекта. Вы можете выбрать сборку для установки на эмуляторе из этого списка. Каждая сборка в списке имеет идентификатор сборки, время, прошедшее с момента создания сборки, номер сборки, номер версии и информацию о коммите git. В списке также отображаются недопустимые сборки, если они есть в проекте.

Например, на изображении ниже показана сборка проекта:

Когда установка сборки будет завершена, она появится на главном экране. Если это сборка для разработки, откройте окно терминала и запустите сервер разработки, выполнив команду npx expo start . Для SDK 48 и ниже используйте флаг --dev-client с командой.

Запуск последней сборки

Передайте флаг --latest команде eas build:run , чтобы загрузить и установить последнюю сборку на эмуляторе Android:

Физическое устройство

Загрузка непосредственно на устройство

• После завершения сборки скопируйте URL в APK из деталей сборки страницу или ссылку, предоставленную после завершения сборки eas .
• Отправьте этот URL-адрес на свое устройство.

  No related posts.