From a17f39c63a21162195ba3dde9182947a17fb6792 Mon Sep 17 00:00:00 2001 From: staszekscp Date: Thu, 21 Nov 2024 12:12:24 +0100 Subject: [PATCH] Add HybridApp troubleshooting section in README.md --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index bbdc191920ab..9bb85f1704c4 100644 --- a/README.md +++ b/README.md @@ -505,6 +505,26 @@ If you'd like to add HybridApp-specific patches, use the `--patch-dir` flag: `npx patch-package --patch-dir Mobile-Expensify/patches` +### HybridApp troubleshooting + +#### Cleaning the repo +- `npm run clean` - deep clean of all HybridApp artifacts (including NewDot's `node_modules`) +- `npm run clean -- --ios` - clean only iOS HybridApp artifacts (`Pods`, `build` folder, `DerivedData`) +- `npm run clean -- --android` - clean only Android HybridApp artifacts (`.cxx`, `build`, and `.gradle` folders, execute `./gradlew clean`) + +If you'd like to do it manually, remember to `cd Mobile-Expensify` first! + +#### Common errors +1. **Please check your internet connection** - set `_isOnDev` in `api.js` to always return `false` +2. **CDN: trunk URL couldn't be downloaded** - `cd Mobile-Expensify && pod repo remove trunk` + +3. **Task :validateSigningRelease FAILED** - open `Mobile-Expensify/Android/build.gradle` and do the following: + ``` + - signingConfig signingConfigs.release + + signingConfig signingConfigs.debug + ``` +4. **Build service could not create build operation: unknown error while handling message: MsgHandlingError(message: "unable to initiate PIF transfer session (operation in progress?)")** - reopen XCode + ---- # Philosophy