Skip to content

Latest commit

 

History

History
147 lines (112 loc) · 6.83 KB

environment-setup.md

File metadata and controls

147 lines (112 loc) · 6.83 KB
Raw

The following instructions apply to the mobile apps for iOS and Android built in React Native. Download the iOS version here and the Android version here. Source code can be found at https://github.com/XRPL-Labs/XUMM-App.

If you run into any issues getting your environment set up, check the Troubleshooting section at the bottom for common solutions.

A macOS computer is required to build the XUMM App iOS mobile app.

Environment Setup

iOS and Android

Install the following prerequisite software to develop and build the iOS or Android apps. For macOS, we recommend using Homebrew as a package manager.

Install NodeJS.

This includes YARN which is also needed. Currently minimum version 12.18.4 is required with yarn 1.22.4.

MacOS
  • To install using Homebrew open a terminal and execute ..
    $ brew install node
  • Install using NVM by following the instructions here
  • Download and install the package from the NodeJS website
Linux
  • Install using your distributions package manager (Note that different distros provide different node versions which might be lower than 10.11.0 and may cause problems)
  • Install using NVM by following the instructions here
  • Download and install the package from the NodeJS website

Install Watchman. (minimum required version is 4.9.0)

MacOS
  • To install using Homebrew open a terminal and execute .. 
    $ brew install watchman
Linux
  • On Linux you have to build Watchman yourself. See the official Watchman guide.
    • Note that you need to increase your inotify limits for watchman to work properly
    • If you encounter a warning about a missing C++ compiler you need to install the c++ extension from you distros package manager (Ubuntu: g++, RHEL/Fedora: gcc-g++)

Install react-native-cli tools

Use yarn to install React Native CLI Tools globally (minimum required version is 2.0.1)

$ yarn global add react-native-cli

Obtaining the source code

We use GitHub to host the source code so we recommend that you install Git to get the source code. Optionally, you can also contribute by submitting pull requests. If you do not have git installed you can do so with Homebrew by opening a terminal and executing:

MacOS
$ brew install git
Linux

Some distributions come with git preinstalled but you'll most likely have to install it yourself. For most distributions the package is simply called git

Additional setup for iOS

  1. Install Xcode to build and run the app on iOS. (minimum required version is 12.4)
  2. Install Cocoapods using the gem method. You'll need it to install the project's iOS dependencies. (required version is 1.10.1)

Additional setup for Android

Download and install Android Studio or the Android SDK command line tools.

Environment Variables

Make sure you have the following ENV VARS configured: - ANDROID_HOME to where Android SDK is located (likely /Users/<username>/Library/Android/sdk or /home/<username>/Android/Sdk) - Make sure your PATH includes ANDROID_HOME/tools and ANDROID_HOME/platform-tools - Install NDK $ANDROID_HOME/tools/bin/sdkmanager --install "ndk;20.1.5948944"

MacOS

  • On Mac, this usually requires adding the following lines to your ~/.bash_profile file:

    export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools:$PATH
export ANDROID_NDK_HOME=$ANDROID_SDK_ROOT/ndk/20.1.5948944

  • Then reload your bash configuration:

    source ~/.bash_profile
Linux

  • On Linux the home folder is located under /home/<username> which results in a slightly different path

    export ANDROID_HOME=/home/<username>/Android/Sdk
export PATH=$ANDROID_HOME/platform-tools:$PATH
export PATH=$ANDROID_HOME/tools:$PATH

  • Then also relead you configuration

    source ~/.bash_profile
    • Note that depending on the shell your using this might need to be put into a different file such as ~/.zshrc. Adjust this accordingly.
    • Also this documentation assumes you chose the default path for your Android SDK installation. If you chose a different path adjust accordingly.

Installing the right SDKs and SDK Tools

In the SDK Manager using Android Studio or the Android SDK command line tool, ensure the following are installed

  • SDK Tools (you may have to click "Show Package Details" to expand packages)

    • Android SDK Build-Tools 29.0.2
    • Android Emulator
    • Android SDK Platform-Tools
    • Android SDK Tools
    • Google Play services
    • Intel x86 Emulator Accelerator (HAXM installer)
    • Support Repository
      • Android Support Repository
      • Google Repository

  • SDK Platforms (you may have to click "Show Package Details" to expand packages)

    • Android 5 (Lollipop) or above
      • Google APIs
      • SDK Platform
        • For Android 7 or above -> Android SDK Platform 24 or above
        • For Android 5/6 -> Android SDK Platform 23 or below
      • Intel x86 Atom_64 System Image
    • Any other API version that you want to test

Obtaining the Source Code

In order to develop and build the XUMM mobile app you'll need to get a copy of the source code. Forking the XUMM-App repository will also make it easy to contribute your work back to the project in the future.

  1. Fork the XUMM-App repository on GitHub.

  2. Clone your fork locally:

    • Open a terminal
    • Change to a directory you want to hold your local copy
    • Run git clone https://github.com/<username>/XUMM-App.git if you want to use HTTPS, or git clone git@github.com:<username>/XUMM-App.git if you want to use SSH

    <username> refers to the username or organization in GitHub that forked the repository

  3. Change the directory to XUMM-App.

    cd XUMM-App

  4. Run make pre-run in order to install all the dependencies.

  5. Run make generate-locales to generate locale files