carlsonsantana/openbor-android-builder repository overview

⁠OpenBOR Android Builder on Docker

This project allows you to build OpenBOR games for Android using Docker.

⁠Volumes

You must mount the following volumes when running the Docker image. These mounts provide the necessary input files and define the location for the final output.

• /bor.pak your compiled OpenBOR game;
• /icon.png the icon for your Android game;
• /icon_background.png the background icon for your Android game;
• /output the directory where the aligned or signed .apk and .aab will be created;
• (Optional) /game_certificate.key the keystore file used to sign the .apk file⁠ and sign the .aab file⁠, if passed you must pass the following environment variables GAME_KEYSTORE_PASSWORD, GAME_KEYSTORE_KEY_ALIAS and GAME_KEYSTORE_KEY_PASSWORD;
• (Optional) /run/secrets/game_keystore_password the keystore password in plain text file, required when /game_certificate.key volume is filled and GAME_KEYSTORE_PASSWORD environment variable isn't filled;
• (Optional) /run/secrets/game_keystore_key_alias the key alias in keystore in plain text file, required when /game_certificate.key volume is filled and GAME_KEYSTORE_KEY_ALIAS environment variable isn't filled;
• (Optional) /run/secrets/game_keystore_key_password the key password in keystore in plain text file, required when /game_certificate.key volume is filled and GAME_KEYSTORE_KEY_PASSWORD environment variable isn't filled.

⁠Environment Variables

• GAME_APK_NAME the Application ID⁠ (e.g., com.mycompany.mygame) of your Android game;
• GAME_NAME the name displayed beneath the app icon on the device;
• GAME_VERSION_CODE the version number code of your game (example: "100"), new versions must have a greater value than old ones;
• GAME_VERSION_NAME the version showed to the user that allows use letters and dots (example: "1.0.0");
• GAME_METADATA_SITE the website showed on the side menu;
• GAME_KEYSTORE_PASSWORD the keystore password, required when /game_certificate.key volume is filled and /run/secrets/game_keystore_password volume isn't filled;
• GAME_KEYSTORE_KEY_ALIAS the key alias in keystore, required when /game_certificate.key volume is filled and /run/secrets/game_keystore_key_alias volume isn't filled;
• GAME_KEYSTORE_KEY_PASSWORD the key password in keystore, required when /game_certificate.key volume is filled and /run/secrets/game_keystore_key_password volume isn't filled.