devTools/androidsdk/image/Dockerfile

-# IMPORTANT: this is the last debian version to support jdk8
-# As android studio *still* requires 8, be sure to continue using debian:stretch
-FROM node:14.11-stretch
+# This can potentially be further concised or optimized, but it works for now
+FROM node:buster
+
+# This way we can build with jdk-8 while on a newer image
+RUN apt install -y wget apt-transport-https
+RUN mkdir -p /etc/apt/keyrings
+RUN wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | tee /etc/apt/keyrings/adoptium.asc
+RUN echo "deb [signed-by=/etc/apt/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list
+RUN apt-get update
+RUN apt install -y temurin-8-jdk
+
 
 # Add backports to make it easier to install npm
 # RUN echo "deb http://deb.debian.org/debian buster-backports main" > /etc/apt/sources.list.d/buster-backports.list
@@ -8,7 +16,6 @@ RUN \
 apt-get update && \
 apt-get install -y --no-install-recommends \
     lib32stdc++6 lib32z1 \
-    openjdk-8-jdk-headless \
     gradle \
     unzip
 
@@ -30,4 +37,5 @@ COPY "cordova" "/cordovasrc"
 WORKDIR "/cordovasrc"
 RUN npm ci
 RUN npm run env -- cordova telemetry off
-RUN npm run build-debug-ci
\ No newline at end of file
+RUN npm run build-debug-ci
+

devTools/androidsdk/image/cordova/config.xml

 <?xml version='1.0' encoding='utf-8'?>
 <widget 
     id="dol" 
-    version="0.3.6.2" 
+    version="0.5.0.4" 
     xmlns="http://www.w3.org/ns/widgets" 
     xmlns:cdv="http://cordova.apache.org/ns/1.0"
     android-packageName="com.vrelnir.DegreesOfLewdity"

devTools/androidsdk/image/cordova/scripts/copyGameFiles.js

@@ -28,6 +28,6 @@ function copyFilesFromRoot() {
     }
 
     fs.ensureDirSync(paths.dest.android.img);
-    fs.copySync(paths.src.main, paths.dest.android.main);
+    fs.copySync(paths.src.main, paths.dest.android.main, {dereference: true});
     fs.copySync(paths.src.img, paths.dest.android.img);
-}
\ No newline at end of file
+}

devTools/apkbuilder/.gitignore

+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+.DS_Store
+
+# Generated by package manager
+node_modules/
+
+# Generated by Cordova
+/plugins/
+/platforms/
+
+# android sdk probably shouldn't go into our git
+/androidsdk/
+
+# generated apks
+/dist/*
+
+# temp folder
+/tmp/
+
+# generated automatically AND contains keystore's password, never include this into commits
+build.json
+# no idea what it's for
+package-lock.json
+
+# Generated by Cordova
+/plugins/
+/platforms/

devTools/apkbuilder/README-linux

+cordova apk builder for primarily DoL
+
+dependencies: (in parentheses are versions at the moment of writing)
+- nodejs stable (20.10.0), with npm and npx installed
+- gradle latest (8.5)
+- openjdk 17 (Temurin-17.0.8.1+1)
+- commandlinetools latest (10406996_latest) https://developer.android.com/studio#cmdline-tools scroll to the bottom of the page
+
+to create a building environment, install nodejs, gradle and openjdk with your favorite package manager, then unzip and place `bin/`, `lib/`, and `source.properties` from commandlinetools archive into `androidsdk/cmdline-tools/latest`, then run ./setup_deps.sh. this only needs to be done once per repository.
+
+debug builds are set up so they can be installed in parallel with release builds. to run debug build, run `./build_app_debug.sh`. compiled apk will be sent to the `../../dist/` directory.
+
+release builds require official dol.keystore to sign the resulting apk. using any other keystore will make the app incompatible with official release.
+in vast majority of cases, you'll be better off with a debug build, but if you're a mod dev and you really want your apk signed, then you can use the release build. first, you need to change `android-packageName` in `config.xml`, so it won't conflict with official app. second, generate a new keystore by running `keytool -genkey -v -keystore dol.keystore -alias dol -keyalg RSA -keysize 2048 -deststoretype pkcs12 -validity 9999` command, included with jdk. once done, place generated `dol.keystore` into `../../keys`.
+after that, you can run `./build_app_release.sh`. it will ask for password to keystore. once the build is successful, you can uncomment the line in `./build_app_release.sh` to stop it from further asking for passwords. like with debug builds, compiled apks are sent to `../../dist`.

devTools/apkbuilder/README-windows.txt

+cordova apk builder for primarily DOL
+
+# Installing dependencies
+## nodejs latest
+- download from https://nodejs.org/, ~25.4mb
+- doesn't matter if it's LTS or latest
+- options "npm package manager" and "Add to PATH" must be selected
+- "Automatically install the necessary tools" is optional
+
+## openjdk / temurin 17
+- download the latest version of .msi installer for windows from https://adoptium.net/temurin/releases/?version=17&package=jdk&arch=x64, ~171mb
+- when installing, choose to install "Set JAVA_HOME variable" option
+
+## android commandline-tools latest
+- download from https://developer.android.com/studio#cmdline-tools, links for tools-only are at the bottom of the page, ~146mb
+- in the folder with this README, open androidsdk\cmdline-tools\latest, and extract "bin", "lib", and "source.properties" from the downloaded archive from the previous step into it. there should be no other sub-folders
+
+## gradle 7.4.2
+- download from https://gradle.org/next-steps/?version=7.4.2&format=bin, ~110mb
+- extract the archive into `androidsdk/gradle`
+
+## the rest
+- once everything above is done, run `setup_deps.bat`
+
+# Building the apk
+## debug build
+debug builds require no additional steps and can be installed in parallel with official app.
+just run `build_app_debug.bat` batch file. compiled apk will appear in the dist folder.
+
+## release build
+if you have the official dol.keystore, run `build_app_debug.bat` batch file.
+if you don't have one, stick to debug builds, they're not any less good.

devTools/apkbuilder/androidsdk/cmdline-tools/latest/README.txt

+ bin/, lib/, source.properties, and NOTICE.txt from the cmdline-tools archive should go into this folder

devTools/apkbuilder/androidsdk/gradle/README.txt

+if you're on windows, extract the gradle archive's bin/, lib/, etc. here

devTools/apkbuilder/build_app_debug.bat

+@echo off
+SET "PATH=%CD%\androidsdk\commandline-tools\latest\bin;%CD%\androidsdk\gradle\bin;%PATH%"
+SET "ANDROID_HOME=%CD%\androidsdk"
+SET "ANDROID_SDK_ROOT=%ANDROID_HOME%"
+
+IF NOT EXIST "..\..\Degrees of Lewdity.html" (
+	IF EXIST "..\..\Degrees of Lewdity VERSION.html" (
+		copy "..\..\Degrees of Lewdity VERSION.html" "..\..\Degrees of Lewdity.html"
+	) ELSE (
+		echo game is not compiled. make sure to run compile.bat first
+		pause
+		exit
+	)
+)
+
+@echo on
+call node scripts/build_app.js
+
+pause

devTools/apkbuilder/build_app_debug.sh

+#!/bin/sh
+
+# set up the environment
+ANDROID_HOME="$PWD/androidsdk/" \
+ANDROID_SDK_ROOT="$ANDROID_HOME" \
+ANDROID_PATH="$ANDROID_HOME/cmdline-tools/latest/bin" \
+PATH="./androidsdk/cmdline-tools/latest/bin:$PATH" \
+node scripts/build_app.js

devTools/apkbuilder/build_app_release.bat

+@echo off
+SET "PATH=%CD%\androidsdk\commandline-tools\latest\bin;%CD%\androidsdk\gradle\bin;%PATH%"
+SET "ANDROID_HOME=%CD%\androidsdk"
+SET "ANDROID_SDK_ROOT=%ANDROID_HOME%"
+
+IF NOT EXIST "..\..\Degrees of Lewdity.html" (
+REM windows' compile.bat is dumb about versions
+	IF EXIST "..\..\Degrees of Lewdity VERSION.html" (
+		copy "..\..\Degrees of Lewdity VERSION.html" "..\..\Degrees of Lewdity.html"
+	) ELSE (
+		echo game is not compiled. make sure to run compile.bat first
+		pause
+		exit
+	)
+)
+
+REM uncomment the line below (remove "REM") to skip prompt for password when it's set correctly
+REM SET SKIP_PASSWORD=true
+
+SET BUILD_RELEASE=true
+@echo on
+call node scripts/build_app.js
+
+pause

devTools/apkbuilder/build_app_release.sh

+#!/bin/sh
+
+# uncomment this flag to skip asking for password if the correct one is already stored in build.json
+#export SKIP_PASSWORD=true
+
+ANDROID_HOME="$PWD/androidsdk/" \
+ANDROID_SDK_ROOT="$ANDROID_HOME" \
+ANDROID_PATH="$ANDROID_HOME/cmdline-tools/latest/bin" \
+PATH="./androidsdk/cmdline-tools/latest/bin:$PATH" \
+BUILD_RELEASE=true \
+node scripts/build_app.js

devTools/apkbuilder/config.xml

+<?xml version='1.0' encoding='utf-8'?>
+<widget android-packageName="com.vrelnir.dol" id="dol" version="0.5.3.7" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
+    <name short="DoL">Degrees of Lewdity</name>
+    <description>Degrees of Lewdity</description>
+    <author email="9096-Vrelnir@users.noreply.gitgud.io" href="https://gitgud.io/Vrelnir/degrees-of-lewdity">
+        Vrelnir
+    </author>
+    <content src="index.html" />
+    <allow-intent href="https:*" />
+    <platform name="android">
+        <hook src="scripts/prevent_unnecessary_deletes.js" type="before_prepare" />
+        <hook src="scripts/prepare_files.js" type="before_compile" />
+        <hook src="scripts/move_built_apks.js" type="after_compile" />
+        <preference name="AndroidWindowSplashScreenAnimatedIcon" value="res/splashscreen.png" />
+        <preference name="AndroidWindowSplashScreenBackground" value="#111111" />
+        <preference name="AndroidWindowSplashScreenIconBackgroundColor" value="#111111" />
+        <preference name="SplashScreenDelay" value="0" />
+        <preference name="loadUrlTimeoutValue" value="120000" />
+        <icon comment="36x36 px" density="ldpi" src="res/icon-ldpi.png" />
+        <icon comment="48x48 px" density="mdpi" src="res/icon-mdpi.png" />
+        <icon comment="72x72 px" density="hdpi" src="res/icon-hdpi.png" />
+        <icon comment="96x96 px" density="xhdpi" src="res/icon-xhdpi.png" />
+        <icon comment="144x144 px" density="xxhdpi" src="res/icon-xxhdpi.png" />
+        <icon comment="192x192 px" density="xxxhdpi" src="res/icon-xxxhdpi.png" />
+    </platform>
+</widget>

devTools/apkbuilder/package.json

+{
+  "name": "apk-builder",
+  "displayName": "built app",
+  "version": "1.0.0",
+  "description": "pack html games into a nice cordova app",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "ecosystem:cordova"
+  ],
+  "author": "majou",
+  "license": "you owe author a beer now.",
+  "dependencies": {
+    "cordova": "^12.0.0"
+  },
+  "cordova": {
+    "platforms": [
+      "android"
+    ],
+    "plugins": {
+      "cordova-plugin-save-dialog": {},
+      "cordova-plugin-rnk-toast": {}
+    }
+  },
+  "devDependencies": {
+    "cordova-android": "11.0.x",
+    "cordova-plugin-rnk-toast": "^0.0.3",
+    "cordova-plugin-save-dialog": "^2.0.1"
+  }
+}
\ No newline at end of file