https://github.com/carlsonsantana/openbor-android-builder-docker
This project allows you to build OpenBOR games for Android using Docker.
https://github.com/carlsonsantana/openbor-android-builder-docker
android docker openbor standalone-game
Last synced: 4 months ago
JSON representation
This project allows you to build OpenBOR games for Android using Docker.
- Host: GitHub
- URL: https://github.com/carlsonsantana/openbor-android-builder-docker
- Owner: carlsonsantana
- License: mit
- Created: 2023-10-20T23:19:04.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-10T00:45:49.000Z (4 months ago)
- Last Synced: 2026-02-10T05:55:50.460Z (4 months ago)
- Topics: android, docker, openbor, standalone-game
- Language: Shell
- Homepage: https://hub.docker.com/r/carlsonsantana/openbor-android-builder
- Size: 83 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OpenBOR Android Builder on Docker
This project allows you to build **OpenBOR** games for **Android** using **Docker**.
## Install
To install this **Docker image**, you must have **Docker** installed on your machine and in the terminal execute the following command:
```sh
docker pull carlsonsantana/openbor-android-builder:latest
```
Or build it yourself executing the following command on the terminal:
```sh
docker build -t openbor-android-builder
```
### 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](https://developer.android.com/build/building-cmdline#sign_manually) and [sign the `.aab` file](https://learn.microsoft.com/en-us/power-apps/maker/common/wrap/code-sign-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](https://developer.android.com/build/configure-app-module#set-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.