diff --git a/AGENTS.md b/AGENTS.md index 18d264f..8bd421b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,15 +1,25 @@ # Hinweise für Agenten -## macOS-Testbuild veröffentlichen +## Website und Downloads -Beim Hochladen eines macOS-Builds auf den Webspace (programmschmiede.de): +- Die Rinkplanner-Seite liegt nur noch unter + `rinkplanner.programmschmiede.de/index.html`. `programmschmiede.de/rinkplanner.html` + leitet per Root-`.htaccess` (301) dorthin um; keine zweite Kopie anlegen. +- Builds liegen unter `programmschmiede.de/rinkplanner/download/`. + Die Download-Links in der Subdomain-Seite sind absolut + (`https://programmschmiede.de/rinkplanner/download/...`). +- Beim macOS-Build `rinkplanner.zip` und `start_rinkplanner.command` mit + hochladen. **Das Start-Skript nicht zippen** – es wird direkt als + `.command` abgelegt. (Stand 2026-10-31 so vom Nutzer gewünscht.) -- Neben der App-ZIP (`rinkplanner.zip`) auch `start_rinkplanner.command` mit - hochladen und auf der Startseite verlinken. -- **Das Start-Skript nicht zippen** – es wird direkt als `.command` abgelegt - und verlinkt. (Stand 2026-10-31 so vom Nutzer gewünscht.) -- Download-Links relativ zur `index.html` setzen, z. B. - `rinkplanner/download/rinkplanner.zip`. +## Windows-Installer + +- `./tools/setup_windows_installer.sh` richtet NSIS lokal unter + `~/.local/share/rinkplanner-toolchain` ein (kein Root). +- `./tools/export_windows_installer.sh` baut + `build/windows/rinkplanner-setup.exe`; `--no-export` nutzt die vorhandene + `rinkplanner.exe`. +- Der Installer ist per-user (kein Admin) und unsigniert (SmartScreen). ## Dateiformat und Release-Check diff --git a/docs/builds.md b/docs/builds.md index 14cfd31..5261cb9 100644 --- a/docs/builds.md +++ b/docs/builds.md @@ -11,6 +11,7 @@ nicht von Browser-Speicherlimits abhängt. | :--- | :--- | :--- | :--- | | Linux x86_64 | `Linux` | `build/linux/rinkplanner.x86_64` | 80 MB | | Windows x86_64 | `Windows` | `build/windows/rinkplanner.exe` | 116 MB | +| Windows-Installer | `Windows` | `build/windows/rinkplanner-setup.exe` | 35 MB | | macOS universal | `macOS` | `build/macos/rinkplanner.zip` | 67 MB | | Android arm64 | `Android` | `build/android/rinkplanner-debug.apk` | 31 MB | @@ -56,6 +57,32 @@ als `export/windows/rcedit` in die Godot-Editor-Settings ein. Die Werte selbst stehen im Preset unter `application/*` (Icon `app_icon.png`, Version `0.1.0.0`). +### Windows-Installer + +Der portable EXE bleibt der Standard. Zusätzlich gibt es einen +per-user-Installer, der ohne Administratorrechte auskommt: + +```bash +./tools/setup_windows_installer.sh # einmalig: NSIS lokal, ohne sudo +./tools/export_windows_installer.sh # EXE neu bauen + Installer +./tools/export_windows_installer.sh --no-export # nur Installer aus vorhandener EXE +``` + +Ausgabe: `build/windows/rinkplanner-setup.exe` (ca. 35 MB). + +- Installation nach `%LOCALAPPDATA%\Programs\Rinkplanner` +- Startmenü- und optionale Desktop-Verknüpfung +- Uninstaller in „Apps & Features“ (pro Benutzer, kein Admin) +- Kürdateien unter `%APPDATA%\Godot\app_userdata\Rinkplanner` bleiben bei + der Deinstallation erhalten +- `setup_windows_installer.sh` lädt die NSIS-Pakete per `apt-get download` + und entpackt sie nach `~/.local/share/rinkplanner-toolchain/nsis`; auf + Nicht-Debian-Systemen muss `makensis` manuell bereitstehen + +Ohne Authenticode-Signatur zeigt Windows weiterhin die SmartScreen-Warnung +(„Windows hat den PC geschützt“). Der Installer ist bequemer, aber nicht +signiert; das ist ein separater Schritt. + **macOS:** Das Bundle ist ad-hoc signiert, aber **nicht notarisiert**. Beim ersten Start auf einem Mac: @@ -194,6 +221,7 @@ auf `tools/sync_assets.sh --sync` ab. Für einen reinen Starttest ohne - Die Android-APK enthält nur `arm64-v8a`. - Die Windows-Ressourcen (Icon/Version) werden nur eingebettet, wenn `tools/setup_windows_export.sh` gelaufen ist. +- Der Windows-Installer ist nicht signiert (SmartScreen-Warnung). - macOS ist ad-hoc signiert, nicht notarisiert. ## Release-Builds @@ -201,7 +229,9 @@ auf `tools/sync_assets.sh --sync` ab. Für einen reinen Starttest ohne - **Android Release:** eigener Keystore nötig; im Preset `keystore/release*` setzen und `./tools/export_android.sh release` bauen. Der Debug-Keystore ist nur zum Testen. -- **Windows/macOS:** siehe Hinweise oben (rcedit, Codesign/Notarization). +- **Windows:** portable EXE oder `rinkplanner-setup.exe`; für eine + warnungsfreie Installation ist eine Authenticode-Signatur nötig. +- **macOS:** siehe Hinweise oben (Codesign/Notarization). ## Kontosync diff --git a/tools/export_windows_installer.sh b/tools/export_windows_installer.sh new file mode 100755 index 0000000..151128b --- /dev/null +++ b/tools/export_windows_installer.sh @@ -0,0 +1,64 @@ +#!/usr/bin/env bash +# Baut den Windows-Installer (per-user, ohne Administratorrechte). +# +# Aufruf: +# ./tools/export_windows_installer.sh # EXE neu bauen + Installer +# ./tools/export_windows_installer.sh --no-export # nur Installer aus vorhandener EXE +# +# Ausgabe: build/windows/rinkplanner-setup.exe +set -euo pipefail + +source "$(dirname "${BASH_SOURCE[0]}")/_export_common.sh" + +NO_EXPORT=0 +if [[ "${1:-}" == "--no-export" ]]; then + NO_EXPORT=1 +fi + +EXE="$REPO_ROOT/build/windows/rinkplanner.exe" +SETUP="$REPO_ROOT/build/windows/rinkplanner-setup.exe" +ICON="$REPO_ROOT/build/windows/rinkplanner.ico" + +if [[ "$NO_EXPORT" -eq 0 || ! -f "$EXE" ]]; then + "$REPO_ROOT/tools/export_windows.sh" +fi + +python3 "$REPO_ROOT/tools/make_windows_icon.py" + +MAKENSIS="${MAKENSIS:-}" +if [[ -z "$MAKENSIS" ]]; then + if command -v makensis >/dev/null; then + MAKENSIS="$(command -v makensis)" + elif [[ -x "$HOME/.local/share/rinkplanner-toolchain/makensis" ]]; then + MAKENSIS="$HOME/.local/share/rinkplanner-toolchain/makensis" + fi +fi +if [[ -z "$MAKENSIS" ]]; then + echo "makensis nicht gefunden. Zuerst ./tools/setup_windows_installer.sh ausführen." >&2 + exit 1 +fi + +# Version aus dem Windows-Export-Preset (application/product_version). +VERSION="$( + sed -n 's/^[[:space:]]*application\/product_version="\([^"]*\)"/\1/p' \ + "$PROJECT_DIR/export_presets.cfg" | head -1 +)" +VERSION="${VERSION:-0.1.0.0}" +if [[ "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then + VERSION="$VERSION.0" +fi + +"$MAKENSIS" -V2 -INPUTCHARSET UTF8 \ + -DAPP_VERSION="$VERSION" \ + -DSOURCE_EXE="$EXE" \ + -DOUT_FILE="$SETUP" \ + -DICON_FILE="$ICON" \ + "$REPO_ROOT/tools/windows_installer.nsi" + +if [[ ! -f "$SETUP" ]]; then + echo "Installer wurde nicht erzeugt: $SETUP" >&2 + exit 1 +fi + +ls -lh "$SETUP" +echo "Installer: $SETUP" diff --git a/tools/make_windows_icon.py b/tools/make_windows_icon.py new file mode 100755 index 0000000..3b0787d --- /dev/null +++ b/tools/make_windows_icon.py @@ -0,0 +1,31 @@ +#!/usr/bin/env python3 +"""Erzeugt das Windows-Installer-Icon aus dem App-Icon. + +Aufruf: + python3 tools/make_windows_icon.py + +Quelle: rinkplanner/assets/icons/app_icon.png +Ziel: build/windows/rinkplanner.ico +""" + +from pathlib import Path + +from PIL import Image + +REPO = Path(__file__).resolve().parent.parent +SOURCE = REPO / "rinkplanner" / "assets" / "icons" / "app_icon.png" +TARGET = REPO / "build" / "windows" / "rinkplanner.ico" +SIZES = [(16, 16), (24, 24), (32, 32), (48, 48), (64, 64), (128, 128), (256, 256)] + + +def main() -> None: + if not SOURCE.exists(): + raise SystemExit(f"App-Icon nicht gefunden: {SOURCE}") + image = Image.open(SOURCE).convert("RGBA") + TARGET.parent.mkdir(parents=True, exist_ok=True) + image.save(TARGET, format="ICO", sizes=SIZES) + print(f"Icon: {TARGET}") + + +if __name__ == "__main__": + main() diff --git a/tools/setup_windows_installer.sh b/tools/setup_windows_installer.sh new file mode 100755 index 0000000..2808161 --- /dev/null +++ b/tools/setup_windows_installer.sh @@ -0,0 +1,69 @@ +#!/usr/bin/env bash +# Richtet NSIS lokal ein (ohne Root), damit der Windows-Installer auf Linux +# gebaut werden kann. +# +# Aufruf: +# ./tools/setup_windows_installer.sh +# +# Danach: +# ./tools/export_windows_installer.sh +set -euo pipefail + +TOOLCHAIN="${TOOLCHAIN:-$HOME/.local/share/rinkplanner-toolchain}" +NSIS_ROOT="$TOOLCHAIN/nsis" +WRAPPER="$TOOLCHAIN/makensis" + +log() { printf '\n==> %s\n' "$*"; } + +if command -v makensis >/dev/null; then + log "System-NSIS gefunden: $(command -v makensis)" + "$(command -v makensis)" -VERSION + exit 0 +fi + +if [[ -x "$WRAPPER" ]]; then + log "Lokales NSIS vorhanden: $WRAPPER" + "$WRAPPER" -VERSION + exit 0 +fi + +command -v apt-get >/dev/null || { + echo "Fehlt: apt-get. NSIS bitte manuell installieren." >&2 + exit 1 +} +command -v dpkg-deb >/dev/null || { + echo "Fehlt: dpkg-deb." >&2 + exit 1 +} + +mkdir -p "$NSIS_ROOT/debs" "$NSIS_ROOT/root" + +log "Lade NSIS-Pakete (ohne Installation im System)" +( + cd "$NSIS_ROOT/debs" + apt-get download nsis nsis-common +) + +log "Entpacke NSIS nach $NSIS_ROOT/root" +dpkg-deb -x "$NSIS_ROOT"/debs/nsis_*.deb "$NSIS_ROOT/root" +dpkg-deb -x "$NSIS_ROOT"/debs/nsis-common_*.deb "$NSIS_ROOT/root" + +log "Schreibe Wrapper $WRAPPER" +cat > "$WRAPPER" <<'WRAPPER_SCRIPT' +#!/usr/bin/env bash +set -euo pipefail +TOOLCHAIN="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +export NSISDIR="$TOOLCHAIN/nsis/root/usr/share/nsis" +exec "$TOOLCHAIN/nsis/root/usr/bin/makensis" "$@" +WRAPPER_SCRIPT +chmod +x "$WRAPPER" + +"$WRAPPER" -VERSION + +log "Fertig" +cat <