Zum Inhalt

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.

npm.cmd ci
npm.cmd run build:general

Für die Android-Synchronisierung wird verwendet:

npm.cmd run android:sync:general

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) oder local ([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:

Steady-1.0.0-alpha.25-debug-apk-general-audience-latest.apk

Der entsprechende direkte lokale Befehl lautet:

npm.cmd run android:build:general:windows

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.