Skip to content

Latest commit

 

History

History
114 lines (74 loc) · 3.85 KB

environment.md

File metadata and controls

114 lines (74 loc) · 3.85 KB
Raw

Environment Setup

iOS

Package Manager

Install brew package manager. NOTE: To successfully run the iOS e2e tests, it is essential to install the brew package manager.

How to install brew

watchman

Watchman is a tool by Facebook for watching changes in the filesystem. It is highly recommended you install it for better performance.

brew install watchman

Ruby

MacOS ships with an old ruby version that is incompatible with this project

It is recommended to install a Ruby version manager such as rbenv

Install ruby version defined in the file .ruby-version

Troubleshooting 
  # Inspect that ruby is in path
  which ruby

  # Ensure you are using the correct ruby version
  ruby --version

Gems

Install bundler gem to manage and install gems such as Cocoapods. The bundle install command, which is run during yarn setup handles installing gem versions as specified in the project's GemFile

gem install bundler -v 2.5.8 && bundle install --gemfile=ios/Gemfile

Xcode

The easiest way to install Xcode is via the Mac App Store. Installing Xcode will also install the iOS Simulator and all the necessary tools to build your iOS app.

Xcode Command Line Tools

You will also need to install the Xcode Command Line Tools. Open Xcode, then choose Settings... (or Preferences...) from the Xcode menu. Go to the Locations panel and install the tools by selecting the most recent version in the Command Line Tools dropdown.

Installing an iOS Simulator in Xcode

To install a simulator, open Xcode > Settings... (or Preferences...) and select the Platforms (or Components) tab. Select a simulator with the corresponding version of iOS you wish to use.

If you are using Xcode version 14.0 or greater than to install a simulator, open Xcode > Settings > Platforms tab, then click "+" icon and select iOS… option.

Node

It is recommended to install a Node version manager such as nodenv, nvm, asdf

Install node version defined in the file .nvmrc

Yarn v1

Ensure you are using the correct yarn version (yarn v1) as noted in the package.json.

Install Yarn using corepack (recommended) 
corepack enable

# check yarn version
yarn --version
Install Yarn V1 with NPM 
npm install -g yarn

# check yarn version
yarn --version

Android

Install Android Studio

  • Set environment variable JAVA_HOME=/Applications/Android Studio.app/Contents/jbr/Contents/Home to use the Java version shipped with Android Studio
  • Go to Settings > Languages & Frameworks > Android SDK
  • Shortcut: Selecting More Actions > SDK Manager from the "Welcome to Android Studio" page will also bring you here.
    • Select SDK Tools tab
    • Check Show Package Details option below the tools list to show available versions
    • Locate NDK (Side-by-side) option in the tools list
    • Check NDK version 24.0.8215888
    • Locate CMake option in the tools list
    • Check CMake version 3.22.1
    • Click "Apply" or "OK" to download
  • Finally, start the emulator from Android Studio:

WIP

You are ready to setup metamask-mobile project in your system!