Build Commands Documentation

Project compatible with next build

  • Retal

  • SAQ

This document explains how to use different build commands for iOS and Android in development, staging, and production environments. The commands follow a consistent naming convention, and each is tailored to specific environments and platforms. There are also special instructions for working with simulators and real devices for both iOS and Android.

Prerequisites

Before running any build commands, ensure the following tools are installed on your machine:

brew install fastlane
brew install cocoapods
brew install watchman
brew install expo-orbit
brew install --cask zulu@17

Additionally, set your JAVA_HOME environment variable for Zulu Java 17:

bashCopy codeexport JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home

Development Builds

iOS Development

For building iOS development versions, use the following commands:

  • Real device:

    yarn build-ios-development

    This builds the app for a real device in development mode.

  • Simulator: If you are working with the iOS simulator, use this command to build for the simulator:

    yarn build-ios-development-simulator

    Note: It is important to specify the development-simulator profile for simulator builds.

Android Development

For Android development builds, the following command will generate an APK for development mode:

Staging Builds

Staging builds are typically used for testing purposes. Use these commands to build staging versions of the app:

iOS Staging

To build an iOS app for the staging environment:

Android Staging

To build an Android APK for the staging environment:

Production Builds

Production builds are optimized and ready for release. Use these commands when preparing for final deployment.

iOS Production

For building iOS production versions, use:

Android Production

For building an Android APK for production, use:

Installation on Devices

iOS

  • Simulator: To install the build on an iOS simulator, use Expo Orbit and upload the .tar.gz file to the selected simulator.

  • Real Device: You can install the build on a real iOS device using AirDrop. Simply send the .ipa file to your phone, and install it directly.

Android

  • Simulator: For Android, the APK can be sent directly to the simulator and installed.

  • Real Device: To install the APK on a real Android device, use sharedrop.io to send the APK to the device.

Last updated