Who Drinks

Simple drinking game as a mobile application. Each card dictates who drinks or what game to play.

Getting started

Requirements

React Native 0.63
Redux Toolkit 1.5

Installation

Android

Connect phone or start an emulator.
Open up console to root of project and install dependencies with npm install.
Start React Native with npm start.
Open another terminal and run npm run android. Following a successful build, return to first CLI to see the installation
On successful installation, the app should begin on your phone.

Notes for Development

If any environment variables are changed in any .env file, you will need to stop any react-native processes and start again while also resetting cache using npm run start-rc.
To connect from emulator to a local running API (such as API running on IIS via Visual Studio), target http://10.0.2.2 instead of localhost.

Debugging

Open the developer menu on phone by one of the following methods:

Once the app has finished building, in the same terminal that is currently running react-native (the one where command npm start was used), type the letter d.
With the emulator window open (at least for android), hit Ctrl + M to display the developer menu.

Then select 'Debug' which should open up browser to http://localhost:8081/debugger-ui/. Otherwise manually open this up in chrome browser. Open developer tools. Use Ctrl + P to search for file and starting adding breakpoints for debugging.

Production

Android Release

Create a .env file and populate environment variables. Use .env.development as example. If going to test first on your own phone in step 2, use http instead of https for external requests, but make sure to switch back to https for deployment.
You can test the app on your phone by connecting via usb, making sure emulator is not running and then run npx react-native run-android --variant=release.
Update the version in package.json and android/app/build.gradle (android.defaultConfig.versionCode and android.defaultConfig.versionName).
Make sure the whodrinks-upload-key.keystore file exists in android/app directory.
Add the keystore password to android/gradle.properties for the variables MYAPP_UPLOAD_STORE_PASSWORD and MYAPP_UPLOAD_KEY_PASSWORD. DO NOT commit this into source control.
It may be necessary to update the target sdk version to be at least the minimum accepted target level by Google Play. Either update them manually in android/build.gradle (if it isn't there, update in android/app/build.gradle). Field to update for are buildToolsVersion, compileSdkVersion, targetSdkVersion and supportLibVersion. You may need to open the android project in Android Studio and run "File > Sync Project with Gradle Files";
cd android && gradlew bundleRelease.
The generated Android App Bundle (AAB) can be found under android/app/build/outputs/bundle/release/app.aab, and is ready to be uploaded to Google Play

For more info go to the React Native guide.

Authors

Jeffrey Huang - jeffrey.huang@recaura.com

jeff-v-h/WhoDrinks