Build und Tests¶
Diese Seite dokumentiert ausschließlich die vorhandenen General-Audience-Buildpfade für veröffentlichte Android-Artefakte. Ein eigener General-Audience-Workflow ist nicht nötig: Beide etablierten Android-Workflows bieten den Input product_variant an.
Voraussetzungen¶
| Werkzeug | Version / Aufgabe |
|---|---|
| Node.js | 24 |
| npm | Installation der Abhängigkeiten und Skripte |
| JDK | 21 für Android-Builds |
| Android SDK | API 36 und Build-Tools 36.0.0 |
| Python | Erzeugung der Badge-Assets |
| Pillow | fest gepinnt in tools/badges/requirements.txt |
Debug-Builds laufen standardmäßig in der GitHub-Cloud (ubuntu-latest); runner=local wählt ausdrücklich den Self-Hosted-Windows-Worker mit [self-hosted, windows, x64]. Closed-Trial-Releases und vollständige Tests bleiben lokal.
General-Audience-Web-Assets¶
Der Vite-Modus general setzt beim Build VITE_PRODUCT_VARIANT=general-audience.
Für die Android-Synchronisierung wird verwendet:
Danach darf kein gewöhnliches android:sync laufen: Es ersetzt die kopierten Web-Assets wieder durch die vollständige Recovery-Variante.
Debug-APK¶
Verwende den vorhandenen Workflow:
- Workflow:
Build Android debug APK - Datei:
.github/workflows/android-debug-apk.yml - Runner:
cloud(Standard,ubuntu-latest) oderlocal([self-hosted, windows, x64]) - Produktvariante:
general-audience
Der Cloud-Job installiert Node.js-, Python-/Pillow- und Android-Abhängigkeiten, prüft Release-Metadaten und die General-Audience-Bundle-Ausschlüsse, synchronisiert die Web-Assets und baut ausschließlich die Debug-APK. Er startet keine vollständige Testsuite, Test-APK oder Emulatorprüfung. Der lokale Job behält Smoke-, UI- und Release-Metadaten-Tests. Ein optionaler geschützter Update-Signierschlüssel wird in beiden Pfaden verwendet, wenn er eingerichtet ist.
Beide Runner laden die APK sieben Tage als GitHub-Artefakt Steady-1.0.0-alpha.25-debug-apk-general-audience hoch. Lokale Builds speichern sie zusätzlich auf dem Worker unter C:\SteadyBuilds\debug, darunter eine nummerierte Datei und:
Der entsprechende direkte lokale Befehl lautet:
Signierter Closed-Trial-Release¶
Verwende den vorhandenen Workflow:
- Workflow:
Build signed closed-trial release - Datei:
.github/workflows/android-closed-trial.yml - Runner:
[self-hosted, windows, x64] - Produktvariante:
general-audience
Der Release-Job benötigt die geschützten Signing-Secrets, führt Audit und vollständige Tests aus, synchronisiert die General-Audience-Web-Assets, baut die signierte APK und das AAB, prüft den minimierten LiteRT-JNI-Vertrag, verifiziert die APK-Signatur und schreibt SHA-256-Prüfsummen.
Die Artefakte landen unter C:\SteadyBuilds\release mit der Variante im Dateinamen, darunter:
Steady-1.0.0-alpha.25-signed-closed-trial-general-audience-latest.apk
Steady-1.0.0-alpha.25-signed-closed-trial-general-audience-latest.aab
Steady-1.0.0-alpha.25-signed-closed-trial-general-audience-latest-SHA256SUMS.txt
Validierungsgrenze¶
Die General-Audience-Version entfernt die eingebauten Profile für Alkohol und Pornografie/zwanghaftes Sexualverhalten, den SPAA-Bereich, Inventar, Lieblingstexte und 12-Schritte-Ressourcen. Das allgemeine Veränderungstracking, eigene Veränderungsbereiche, Counter, Analytics, Toolbox, Abzeichen und Companion bleiben enthalten. CI prüft, dass die Feature-Marker der Programmressourcen im erzeugten JavaScript-Bundle fehlen.
Beide Produktvarianten verwenden derzeit dieselbe Android-applicationId; die Installation einer Variante ersetzt die andere, während kompatible lokale Daten erhalten bleiben.
Workflow-Regel¶
Verwende zuerst diese beiden etablierten Workflows. Ein neuer Workflow ist nur für einen klar getrennten, dauerhaft eigenständigen Build-Anwendungsfall gerechtfertigt, den keiner der vorhandenen Workflows sinnvoll abbilden kann. Diese Lücke muss vor dem Anlegen dokumentiert werden.
Direkte APK-Releases¶
Lokale und Cloud-Debug-Builds auf main veröffentlichen einen Alpha-Debug-Testbuild unter GitHub Releases, mit dem Tag v<version>. Steady-<version>-debug-<variant>.apk wird direkt heruntergeladen; eine ZIP muss nicht entpackt werden. Beide Runner laden zusätzlich das Actions-Artefakt mit sieben Tagen Aufbewahrung hoch. Lokale Builds behalten außerdem ihre Kopien unter C:\SteadyBuilds\debug. Dadurch wird der Build nicht zu einem produktiven Closed-Trial-Release.
Für einen ausdrücklich nur lokalen Build wird [skip ci] in die gepushte Commit-Nachricht aufgenommen und der Debug-Workflow auf main manuell mit runner=local gestartet. So entfallen die automatischen Push-Workflows und ein doppelter Cloud-APK-Build; der manuelle Start läuft weiterhin. Gewöhnliche Pushes behalten ihren Cloud-Standard. Der Runner lädt Build-Ergebnisse hoch, keine Quellcodeänderungen.
Jede veröffentlichte App- oder Build-Workflow-Änderung erhöht Alpha-Version und Android-versionCode gemeinsam. CI weist die Wiederverwendung einer Version für einen anderen Commit bereits vor dem Build zurück und erhält vorhandene APK-Dateien bei Wiederholungen. Ein unterbrochener Upload hinterlässt einen unveröffentlichten Entwurf.