Setup Guidelines for OXXO TV

OXOO Envato Project Setup Documentation:

1. JDK Installation

   • Download and install the latest JDK (currently using version 23).

   • Optionally, set the environment path for Java for ease of access.

2. Android Studio Setup

   • Download and install the latest Android Studio (currently using Ladybug Feature Drop 2024.2.2).

   • Open Android Studio after installation is complete.

3. SDK & Tool Dependencies
   When setting up Android Studio, ensure the following components are installed:

   • Android SDK: Versions 15 & 14.

   • Android SDK Platform: Version 34.

   • Android SDK Build Tools: Versions 36.0.0-rc3, 35.0.0, and 34.0.0.

   • NDK (Native Development Kit): Versions 28.0.1267, 27.2.1247, and 21.3.6528147 (recommended for the project).

   • Android SDK Command Line Tools: Currently using version 17.0.

   • CMake: Versions 3.31.1 and 3.10.2.4988404 (recommended for the project).

Possible Bug Fix / Issue Fix Guidelines:

1. Java Version Compatibility

   • Always use Java 21 or higher.

   • Verify the installed version by running java -version in the terminal.

2. Gradle & Distribution Version

   • Recommended Distribution Url version: 8.12.

   • Avoid downgrading unless absolutely necessary.

3. Android SDK & Build Tools

   • Ensure Android SDK Platform Tools and Build Tools are up-to-date.

   • Install the following if missing:

     • Android SDK Build Tools: 36.0.0-rc3, 35.0.0, and 34.0.0.

4. Dependency Updates

   • Always update dependencies before running the project.

   • Resolve conflicts using gradlew dependencies.

5. NDK and CMake Compatibility

   • Use recommended NDK versions: 28.0.1267, 27.2.1247, and 21.3.6528147.

   • Ensure CMake versions 3.31.1 and 3.10.2.4988404 are installed.

6. Fixing Common Issues

   • Build Fails: Run gradlew clean and rebuild the project.

   • App Crashes: Check logs using adb logcat.

   • Dependency Issues: Run gradlew --refresh-dependencies.

7. Android Studio Configuration

   • Use Android Studio Ladybug Feature Drop 2024.2.2 or newer.

   • Ensure Android SDK Platform 34 is installed.

By following these steps and guidelines, you can set up and troubleshoot the OXOO project effectively.