The Audius React Native mobile client
# 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# 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 androidIf you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..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.
-
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