mobile

Audius Mobile Client

The Audius React Native mobile client

Setup

Running iOS

# Create the ios bundle. Should only have to run once.
npm run bundle:ios

# Start the react-native server
npm run mobile

# Run a simulator using a prod configuration
npm run ios
# Run a simulator using a stage configuration
npm run ios:stage
# Run a simulator using a dev configuration
npm run ios:dev

# Run the app on a device
npm run ios:device "Raymond's iPhone"
# To see available devices
xcrun xctrace list devices

Running Android

# Start the react-native server
npm run mobile

# Run a simulator using a prod configuration
npm run android
# Run a simulator using a stage configuration
npm run android:stage
# Run a simulator using a dev configuration
npm run android:dev

# Look at android devices
adb devices
# Connect device to dev server
adb -s <device name> reverse tcp:8081 tcp:8081
# Run on device
npm run android

If you run into issues, try cleaning the android build folder

cd android && ./gradlew clean && cd ..

Running Storybook

npm run start:storybook

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

Debugging

To debug the app follow the instructions here

You can also start react and redux devtools with

npm run react-devtools -w @audius/mobile

npm run redux-devtools -w @audius/mobile

On Android, you can use the adb Android Studio tool or

# Show device logs
adb logcat '*:V'

• Sometimes the app will crash due a configuration error or something outside of the realm of JS and you won't get any helpful information from React Native. In those cases, it's time to break open XCode and run from there to pinpoint the issue.

Helpful

• If your app is crashing after running for a second, or crashing on startup with no error message, it's probably an environment variable problem, and you should check to make sure you have them all. Debug using XCode.

• Other commands and things:

# opens debug menu on an Android device
adb shell input keyevent 82

# Busts the package cache for RN
npm start -- --reset-cache

# Clean build
# first manually close all running instances of metro
watchman watch-del-all
npm start -- --reset-cache
npm run ios:dev