Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mondo-mob/wrangler-sim-expo-setup
These instructions are for wranglers who wish to set up their MacBooks for running iOS and/or Android simulators with Expo Go installed on them.
https://github.com/mondo-mob/wrangler-sim-expo-setup
Last synced: about 2 months ago
JSON representation
These instructions are for wranglers who wish to set up their MacBooks for running iOS and/or Android simulators with Expo Go installed on them.
- Host: GitHub
- URL: https://github.com/mondo-mob/wrangler-sim-expo-setup
- Owner: mondo-mob
- Created: 2022-07-11T09:02:17.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-05-04T12:25:46.000Z (over 1 year ago)
- Last Synced: 2023-05-04T14:26:41.200Z (over 1 year ago)
- Language: JavaScript
- Size: 1.11 MB
- Stars: 0
- Watchers: 7
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Expo for Wranglers
These instructions are for wranglers who wish to set up their MacBooks for running iOS and/or Android simulators with Expo Go and/or Expo Development Builds.
## Prerequisites
### Expo
You'll need to create an Expo account at https://expo.dev and be granted access to any particular Expo/RN projects you want to run.
### Common setup
1. Install Xcode via the AppStore
2. Once completed, open Xcode. It will likely install more components.
3. Open a Terminal, you will be pasting a series of commands (below) into this terminal. You should wait for each command to complete before continuing. You'll know it's complete once you see the cursor again.
4. Install Homebrew
```shell
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
This command will prompt for a password. Enter the password of your current mac user.
After installation Brew will likely ask you to run a couple of commands to add Brew to your path.
5. Install `n`
```shell
brew install n
```
6. Install node 16
```shell
sudo n 16
```
7. Install git
```shell
brew install git
```
8. Clone this repository somewhere appropriate, if you're not sure where just use your home directory
```shell
cd ~
git clone https://github.com/mondo-mob/wrangler-sim-expo-setup.git
```
9. Change directory into the repository that was cloned in the last step above. For example:
```shell
cd ~/wrangler-sim-expo-setup
```
10. Install NPM modules
```shell
npm i
```
11. Login to Expo
```
npx expo login
```
12. Configure XCode
- Open Xcode and click on the Xcode --> Preferences menu
- Click the `Locations` tab
- If no `Command Line Tools` open is selected, click on the select dropdown to select one (there should be a single item in there to select)
### Android setup (if required)
1. Install Android Studio
```shell
brew install --cask android-studio
```
2. ... SDK setup, emulator installation etc ....
## Expo Go
**Only use this section if the target project is compatible with Expo Go.**
This will install Expo Go onto a simulator/emulator.
Once installed you can open your project specific url.
### iOS Simulator
1. Start Expo
```shell
npm run start:expo-go
```
2. Press `i` to open an iOS simulator and install Expo Go on it
3. Expo Go should be installed onto the simulator now. Open the simulator and paste your Expo project link into Safari, which should open your app.
You can switch devices using the `Simulators` menu.
### Android emulator
1. Start desired emulator from Android Studio
2. Download Expo Go apk file from https://expo.dev/tools
3. Drag apk file onto running simulator to install.
## Expo Development Builds
**Only use this section if the target project is using development builds.**
### iOS simulator
iOS Simulators require a specific simulator build to be created.
This must already be made created by the development team before running the steps below.
1. Configure application
- Within `wrangler-sim-expo-setup` project download in previous steps, open the `app.json` file in your editor of choice
- Change the `owner` and `slug` properties to match those of the desired Expo project. You can find these on the Project Overview in the Expo Console.
2. Install simulator build
```
npx eas-cli build:run -p ios
```
3. If prompted to login, then login with your Expo credentials
4. If prompted `Existing EAS project found... Configure this project?` Choose `yes`.
5. A list of available builds should be shown. Select the build you wish to install (usually the latest one)
6. If prompted to select an emulator, choose the simulator you wish to install onto
7. Once installed you can open the development build application on the simulator and then open the desired project url via the "Enter URL manually" option.
These steps can be repeated to install newer builds or to install onto other simulators.
### Android simulator
1. Start desired emulator from Android Studio
2. Download desired Development build apk from Expo console.
3. Drag apk file onto running simulator to install.
These steps can be repeated to install newer builds or to install onto other emulators.
### Android device
1. Download and install the required build apk from Expo Console