Cancelled due to client's disappearance.

• front - the frontend part of the project. It is a vite JS+Rust(WASM) app.
• app - an Apache Cordova app that wraps the frontend part into a mobile app.

TODO: consider preparing a Docker image with the development environment.

• Navigate to the directory where you want to keep the directory with the project:

cd .../path/to/your/directory

• Ensure you have git installed:

git --version

• Clone the project:

git clone https://github.com/JohnScience/betting_app

• Navigate to the directory with the project:

cd betting_app

• Ensure you have npm installed:

npm --version

• Install the JS dependencies for both the frontend and the app:

cd app && npm install && cd ../front && npm install

• Ensure you have Rust and wasm-pack installed.

rustc --version
wasm-pack --version

• Ensure you have Android Studio installed.

• Ensure your ANDROID_HOME environment variable is set to the path to your Android SDK directory, e.g. C:\Users\USER\AppData\Local\Android\Sdk.

# On Windows
echo %ANDROID_HOME%
# On Linux/MacOS
echo $ANDROID_HOME

• Ensure that you have the Android tools in your PATH environment variable:

  • ANDROID_HOME/tools,
  • ANDROID_HOME/tools/bin,
  • ANDROID_HOME/platform-tools.

Satisfying Gradle's Compatibility Matrix can be difficult because, at the time of writing this, it paints a too optimistic picture. The latest Gradle (8.3) doesn't support the latest JDK version (20). You can use the tools that works for you but the following setup is known to work:

• Ensure you have JDK of version Amazon Corretto 19.0.2 installed. To do that, you can open Android Studio and navigate to File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle -> Gradle JDK. Screenshot. If there's no menu where you can pick a Gradle JDK, you might need to create a new dummy Android project first.

• Add the path to Amazon Corretto 19.0.2 JDK (e.g. C:\Users\USER\.jdks\corretto-19.0.2) to JAVA_HOME environment variable.

# On Windows
echo %JAVA_HOME%
# On Linux/MacOS
echo $JAVA_HOME

• Add JAVA_HOME/bin to your PATH environment variable.

javac --version

• Ensure you have Gradle 7.6 installed at <...>/.jdks/../.gradle/wrapper/dists. The directory is likely to be called gradle-7.6-all. If it is not there yet, you can install it from https://gradle.org/releases/ and put there (for convenience).

• Ensure you set GRADLE_HOME to the path of your gradle binaries (e.g. C:\Users\USER\.gradle\wrapper\dists\gradle-7.6-all\9f832ih6bniajn45pbmqhk2cw\gradle-7.6). Note that the structure of the directory that was produced by Android Studio also contains a directory whose name is a hash.

• Add GRADLE_HOME/bin to your PATH environment variable.

gradle --version

Picking the right version of Android SDK and NDK can also be tricky. The following setup is known to work:

• Open Android Studio and navigate to Tools -> SDK Manager -> Languages & Frameworks -> Android SDK -> SDK Platforms. Even though Cordova currently imposes android:minSdkVersion of 24 and android:targetSdkVersion of 33, you have to ensure that only Android SDK platform 33 under Android 13.0 ("Tiramisu") is checked. Screenshot.

• Change the tab from SDK Platforms to SDK Tools and check NDK (Side by side) of version 25.0.8775105. TODO: consider choosing a newer version of NDK.

• Click Apply and wait for the SDK and NDK to be installed.

• Set NDK_HOME environment variable as ANDROID_HOME/ndk/25.0.8775105.

# On Windows
echo %NDK_HOME%
# On Linux/MacOS
echo $NDK_HOME

Change directory to the front where nearly all the work will be done:

cd front

Assuming you have the dependencies installed, you can tweak the frontend part and see the changes.

npm run dev

Once you are happy with the changes, you can build the frontend part for testing it on a mobile device:

npm run test-on-<android|ios>

TODO: add iOS target, possibly via cordova-ios, and check if it works as intended.

Note: testing on a mobile device takes more than a minute.