How to troubleshoot Titanium SDK build failures related to missing Android SDK path

Before you begin, ensure you have Node.js, the Titanium CLI, and an Android SDK installed.

1. Open a terminal and verify the ANDROID_SDK environment variable points to your SDK root: echo $ANDROID_SDK (or echo %ANDROID_SDK% on Windows).
2. If the variable is unset or incorrect, set it temporarily: export ANDROID_SDK=/path/to/android-sdk (macOS/Linux) or set ANDROID_SDK=C:\path\to\android-sdk (Windows).
3. Run npm ci to install exact dependencies.
4. Execute the build command, explicitly passing the SDK path if needed: npm run cleanbuild --android-sdk $ANDROID_SDK.
5. Watch the output for errors; a successful build will finish with “BUILD SUCCESSFUL” and generate the native binaries in the build directory.
6. Optionally run the unit test suite: npm run test:android to confirm the built SDK works.

If the build fails, revert any temporary environment changes, reinstall the SDK with npm ci again, and consult the logs for missing dependencies.