More detailed information on the wiki. In particular, check out our contributor guidelines!
The Zooniverse Mobile app is a React Native app that allows folks like you and me to contribute to astronomy, ecology, and anthropology research from their couch, bathtub, or bus stop (but don't swipe and drive, please).
mobile
).npm install
(later, if you need to reinstall dependencies for some reason, you can run rm -rf node_modules/ && npm install
)npm start
.
On the command line, from the mobile
directory, run:
cd ios && rm -rf Podfile.lock && pod install && cd ..
. You may need to brew install cocoapods
first.npm run ios
adb devices
and confirm you see your device listed. If not use [Running on device - android]https://reactnative.dev/docs/running-on-device?platform=android for troubleshootingMYAPP_RELEASE_STORE_FILE=/path/to/your/keystore.jks
MYAPP_RELEASE_KEY_ALIAS=android
MYAPP_RELEASE_STORE_PASSWORD=android
MYAPP_RELEASE_KEY_PASSWORD=**you can find this in passbolt**
You will have to get the key itself from an existing maintainer. We are looking for a way to securely store this so you can get it without worrying about corruption. You don't need it to build for debugging—only for release to the Play Store.
npm run android
. Shortly, your emulator should boot with the Zooniverse app on it.
react-native run-android
will install the build, but fail in launching the app due to a bug with the react-native
script with having a separate applicationId
for development builds.You may also want to set up error reporting from your local copy of the application to our reporting service, Sentry. Here are instructions on how to do that!
This project is setup with Reactotron. Learn more here. Reactotron is useful for:
adb reverse tcp:9090 tcp:9090
before running the project.