Skip to content

[NO QA] Document solution for JDK Android build error #65698

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Julesssss merged 2 commits into from
Jul 9, 2025
Merged

[NO QA] Document solution for JDK Android build error #65698

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fcf5567
add guide for JDK Android build error
Julesssss Jul 8, 2025
8dd86c3
add bonus git cache tip
Julesssss Jul 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions contributingGuides/HYBRID_APP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,15 @@ It's a valid question, especially because clean builds may take some time. On th
3. Whenever `package-lock.json` has changed - this may indicate that some packages with native code were bumped (however it's not always necessary, see [[#Should I rebuild HybridApp after bumping a `node_module`?]])
4. Whenever you've updated `.env` files
This means that if you changed only React Native code, and didn't pull any changes, the rebuilt is probably not necessary. If something doesn't work, you can always restart the Metro bundler using the following command `npm run start --reset-cache`

💡 **Tip**: If you're still experiencing build issues after running `npm run clean`, try a full Git clean:

```
git clean -fdx
```
This will remove all untracked files and directories, ensuring no lingering artifacts interfere with the build process.
**Warning**: This will delete **all untracked files**, including anything not committed—make sure you’ve backed up anything important.

### Should I rebuild HybridApp after bumping a `node_modules` library?
The `package-lock.json` file contains information about exact versions of `node_modules` that will be installed on your machine. If you've bumped a dependency on your PR you can easily check to see if you would need to rebuild the app by going to the `./node_modules/<PACKAGE_NAME>`, and seeing if there are any Objective-C, Swift, Java, Kotlin or C++ files. Usually they are located in `ios` or `android` folders.
### How to clear platform-specific cache?
Expand Down Expand Up @@ -164,6 +173,22 @@ IMPORTANT: It's easily to confuse this error with a very similar one: `Failed to
This error indicates that YAPL JS (OldDot's JavaScript code) hasn't been built properly. In order to fix that, do the following:
1. cd to `Mobile-Expensify`
2. run `npm run grunt:build:shared`

### Error: `No JDK found / Please select a valid JDK`
Android Studio and Gradle require a JDK (Java Development Kit) to build the app. If you're seeing this error or being prompted to select a JDK, it means no valid JDK has been configured. Our project requires JDK 17, so make sure you select or install that version.

**To fix this:**
- Open Android Studio.
- Go to File > Project Structure > SDK Location.
- Under JDK Location:
- Set the path to a previously installed JDK 17
- Or select the default JDK bundled with Android Studio (on macOS, that's usually at /Applications/Android Studio.app/Contents/jbr) only if it is JDK 17

Alternatively, from the terminal:
```
export JAVA_HOME=$(/usr/libexec/java_home -v17)
```

### How to find an `.apk`, and install it on your device?

After a successful build, gradle creates an `.apk` file, which you can install on your android devices/emulators. There is a chance that eg. the app failed to install after a successful build, or you want to test the app on another device. In this case you **don't need to rebuild the app**, because you can reuse the existing `.apk`. These are the steps how to do it:
Expand Down