SportySpots

Android:

Setting up React Native environment on Ubuntu 18.04

Read the following docs before starting!! Below you'll find some extra help.

• https://facebook.github.io/react-native/docs/getting-started.html

• https://www.techomoro.com/how-to-install-and-setup-react-native-on-ubuntu-17-10/

• https://medium.com/@chad_morrow/getting-started-with-react-native-on-ubuntu-from-scratch-f622c8677d1e

Installing Java

sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer
sudo apt-get install oracle-java8-set-default

Source: https://medium.com/@aashimad1/install-android-studio-in-ubuntu-b8aed675849f

Installing watchman

> sudo apt-get update
> sudo apt-get upgrade
> git clone https://github.com/facebook/watchman.git
> cd watchman/
> git checkout v4.9.0
> sudo apt-get install -y autoconf automake build-essential python-dev libssl-dev libtool pkg-config
> ./autogen.sh
> ./configure
> make
> sudo make install

> echo "fs.inotify.max_user_watches=524288" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p && echo "fs.inotify.max_queued_events=524288" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p && echo "fs.inotify.max_user_instances=524288" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

Source: https://facebook.github.io/watchman/docs/install.html#buildinstall

Troubleshooting: facebook/watchman#163 https://askubuntu.com/questions/716431/inotify-max-user-watches-value-resets-on-reboot-how-to-change-it-permanently https://unix.stackexchange.com/questions/13751/kernel-inotify-watch-limit-reached

Install adb

If you get /bin/sh: 1: adb: not found error, install adb:

sudo apt-get update
sudo apt-get install adb

source: facebook/react-native#11413

adb version mismatch

If you get the following error:

ADB server didn't ACK
* failed to start daemon *
error: cannot connect to daemon`

You need to make sure that the adb version installed globally and the one used by the Android SDK match. In order to do so, either point or copy Android sdk adb to usr/bin to solve adb mismatch versions:

pointing (didn't test this! probably iOS)

sudo ln -sf ~/Library/Android/sdk/platform-tools/adb /usr/local/bin

copy

sudo cp ~/Android/Sdk/platform-tools/adb /usr/bin

source: expo/expo-cli#153

Create local.properties file inside android folder

Add the following code to the local.properties field based on the location of you android sdk. Replace YOUR_USERNAME accordingly!

sdk.dir = /home/<YOUR_USERNAME>/Android/Sdk

Create .env file in root folder

Create a .env file from .env.example placing it in the root of the project

Decrypt google.json

git-crypt unlock

Genymotion devices

When creating a new device make sure to choose a device with android version >= 8.1

Get started

Prerequisites

• Node (Version: v8.9.4)
• Yarn (Version: 1.3.2)
• NPM (Version: 5.6.0)
• NVM (Version: 0.33.8)

Local Development

Setup

nvm use
yarn reset

Run App

REF: facebook/react-native#20774

cd node_modules/react-native/scripts && ./ios-install-third-party.sh && cd ../../../
cd node_modules/react-native/third-party/glog-0.3.5/ && ../../scripts/ios-configure-glog.sh && cd ../../../../

yarn run react-native run-ios

Run Storybook

yarn run storybook

How to Run App

1. cd to the repo
2. Run Build for either OS

• for iOS
  • run react-native run-ios
• for Android
  • Run Genymotion
  • run react-native run-android

Standard Compliant

This project adheres to Standard. Our CI enforces this, so we suggest you enable linting to keep your project compliant during development.

To Lint on Commit

This is implemented using husky. There is no additional setup needed.

Bypass Lint

If you have to bypass lint for a special commit that you will come back and clean (pushing something to a branch etc.) then you can bypass git hooks with adding --no-verify to your commit command.

Understanding Linting Errors

The linting rules are from JS Standard and React-Standard. Regular JS errors can be found with descriptions here, while React errors and descriptions can be found here.

Secrets

This project uses react-native-config to expose config variables to your javascript code in React Native. You can store API keys and other sensitive information in a .env file:

API_URL=https://myapi.com
GOOGLE_MAPS_ANDROID_API_KEY=abcdefgh

and access them from React Native like so:

import Secrets from 'react-native-config'

Secrets.API_URL  // 'https://myapi.com'
Secrets.GOOGLE_MAPS_ANDROID_API_KEY  // 'abcdefgh'

Generate release key React Native Official Release Documentation

keytool -genkey -v -keystore sportyspots-release-key.keystore -alias sportyspots-release-key-alias -keyalg RSA -keysize 2048 -validity 20000

Place sportyspots-release-key.keystore in android/app directory

Create a gradle.properties file in ~/.gradle/

Add the following to gradle.properties file

SPORTYSPOTS_RELEASE_STORE_FILE=sportyspots-release-key.keystore
SPORTYSPOTS_RELEASE_KEY_ALIAS=sportyspots-release-key-alias
SPORTYSPOTS_RELEASE_STORE_PASSWORD=******
SPORTYSPOTS_RELEASE_KEY_PASSWORD=******

The .env file is ignored by git keeping those secrets out of your repo.

Get started

1. Copy .env.example to .env
2. Add your config variables
3. Follow instructions at https://github.com/luggit/react-native-config#setup
4. Done!

Git Crypt

Git Crypt

Github Reference - Associate Email with GPG Key List your keys

gpg --list-secret-keys --keyid-format LONG

Git crypt export symmetric key

git-crypt export-key /path/to/key/symmetric_binary_key.key

Convert binary key to base64 encoded string

openssl base64 -A -in symmetric_binary_key.key -out symmetric_base64.key

Convery base64 key to binary key

openssl base64 -d -A -in symmetric_base64_key.key -out symmetric_binary_key.key

Firebase

1. download google-services.json from Firebase project and add it to /android/app/
2. enable debug mode and logs:

>> adb shell setprop debug.firebase.analytics.app io.invertase.firebase.analytics.RNFirebaseAnalyticsPackage
>> adb shell setprop log.tag.FA VERBOSE
>> adb shell setprop log.tag.FA-SVC VERBOSE
>> adb logcat -v time -s FA FA-SVC

This behavior persists until you explicitly disable Debug mode by executing the following command:

adb shell setprop debug.firebase.analytics.app .none.