Hooligram React Native Android App

How to run

1. git clone https://github.com/hooligram/hooligram-client.git

2. cd hooligram-client

3. Define environment variables in file named .env in project root:

   API_HOST=ws://<domain>:<port>/<end-point>

   To connect to a localhost server, use 10.0.2.2 as <domain> (for emulators).

4. Ensure emulator is ready or mobile device is connected to your machine.

5. yarn or npm install

6. yarn android or npm run android

Remote debugging on a real device

1. adb reverse tcp:8081 tcp:8081
2. Open React Native Debugger.
3. Shake the device & select Debug JS Remotely.

Connecting to local hooligram-server

For debugging end-to-end, sometimes it's good to connect to a local a hooligram-server. Assuming a local server is running on ws://localhost:8080 (see the README at the hooligram-server repo on how to run the server locally):

1. Set API_HOST=ws://localhost:8080 in .env file.
2. Run the emulator.
3. adb tcp:8080 tcp:8080
4. yarn android
5. Check out the client & the server logs. You should see that they are interacting with each other!

Generating signed APK

1. Fill up android/gradle.properties details.

   RELEASE_KEY_ALIAS=*******
   RELEASE_KEY_PASSWORD=*******
   RELEASE_STORE_FILE=*******
   RELEASE_STORE_PASSWORD=*******

2. Put hooligram.keystore file in android/app directory.

3. cd android

4. ./gradlew assembleRelease

5. Find the APK here android/app/build/outputs/apk/release/app-release.apk