Some of the things might not work since the latest migration to latest react native.

TODO: Update this document wherever it is not applicable.

💻 Setup (Currently for Android Only)

1: Clone the repo and cd to root directory.

2: Install the depedencies.

yarn install

3: Install the pods (via Cocoapods) (Required for ios development)

npx pod-install ios

4: Create .env file in root, copy content from https://ti-app.slack.com/archives/CE68JUXPC/p1564943184000300 and paste it in the file.

5: (Optional) Create .prettierrc in root and add your config ;)

6: Ensure that emulator is running or an android device is connected with adb setup properly.

7: Run following command in seperate terminal (not in integrated terminal of vscode).

yarn android

9: Now get your 🎧 on and spill out pure 🔥. TIA 🙏.

Build

Debug Build:

cd android/
./gradlew assembleDebug

You can find the build here: app/build/outputs/apk/

Release Build:

1: Get release.keystore.properties from https://ti-app.slack.com/files/UE5JTSF4Z/FS53VKJN7/release.keystore.properties and put it in ./android directory.

2: Get tiarelase.keystore from https://ti-app.slack.com/files/UE5JTSF4Z/FSGHYL3KP/tiarelease.keystore and put it in ./android/app directory.

3: Generate a release build.

cd android
./gradlew assembleRelease

Resources

Generating sha1 for google-api: https://aboutreact.com/getting-sha1-fingerprint-for-google-api-console/

Troubleshooting

After changing your styles.xml in android/app/src/main/res/values if you get an error "Failed to capture fingerprint of output files for task ':app:processDebugResources' property 'sourceOutputDir' during up-to-date check." error, do following and run again:

cd android
./gradlew clean
cd ..
yarn android

Sometimes you may need to reset or clear the React Native packager's cache. To do so, you can pass the --reset-cache flag to the start script:

npm start --reset-cache
# or
yarn start --reset-cache

If you get an error like Nullable is not a symbol or something, try this: https://stackoverflow.com/a/56681395
For following error && Running on Device:

error Could not install the app on the device, read the error above for details. Make sure you have an Android emulator running or a device connected and have set up your Android development environment:

adb kill-server
adb start-server

Make sure you don't have the previous version of app with differnt signature on your device.

Facing problem with blocked port: https://stackoverflow.com/a/55450873/5692089
Getting SHA1 (mostly for firebase) from keystore

Note: For debug keystore storepass and keypass are generally android.

keytool -list -v -alias {alias-name} -keystore {path-too-keystore}

Getting key hash for facebook.

keytool -exportcert -alias {alias-name} -keystore {path-to-keystore} | openssl sha1 -binary | openssl base64

For Execution failed for task ':app:mergeReleaseResources' Error: Duplicate resources:

https://stackoverflow.com/a/52750886/5692089

There is a script named android-release-gradle-fix under ./scripts directory which will do the necessary changes to troubleshoot the above error. For script to run properly, remove the node_modules and run yarn install again.

rm -rf node_modules

yarn install

If you run npm install on ci like jenkins, you may get error: postinstall: cannot run in wd %s %s (wd=%s) node => just use

yarn install --unsafe-perm instead

Way to check signing details of the apk file

keytool -list -printcert -jarfile app-release.apk

To check the android logs

adb logcat | grep 'com.tiapp'

To enable debug logging on your development device, set two adb shell flags before running your app:

adb shell setprop log.tag.Fabric DEBUG
adb shell setprop log.tag.CrashlyticsCore DEBUG

To disable:

adb shell setprop log.tag.Fabric INFO
adb shell setprop log.tag.CrashlyticsCore INFO

To enable Analytics Debug mode on an Android device, execute the following commands:

adb shell setprop debug.firebase.analytics.app package_name

To disable:

adb shell setprop debug.firebase.analytics.app .none.

Samples

(Yet To Add)

TODO: