feat: Windows-Installer-Pipeline (NSIS, per-user)

- tools/setup_windows_installer.sh richtet NSIS lokal ohne Root ein
- tools/export_windows_installer.sh baut die EXE und
  build/windows/rinkplanner-setup.exe; --no-export nutzt die vorhandene EXE
- tools/windows_installer.nsi: per-user Installation nach
  %LOCALAPPDATA%\Programs\Rinkplanner, Startmenü-/Desktop-Verknüpfung,
  Uninstaller, keine Adminrechte
- tools/make_windows_icon.py erzeugt das Installer-Icon aus app_icon.png
- docs/builds.md und AGENTS.md dokumentieren Pipeline und aktuelle
  Website-Struktur (Subdomain als einzige Seite)
This commit is contained in:
torsten 2026-11-10 17:09:11 +01:00
parent 6f22350934
commit e28f8976f2
6 changed files with 353 additions and 9 deletions

View file

@ -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

View file

@ -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

View file

@ -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"

31
tools/make_windows_icon.py Executable file
View file

@ -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()

View file

@ -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 <<EOF
NSIS: $WRAPPER
Installer: ./tools/export_windows_installer.sh
Nur Installer: ./tools/export_windows_installer.sh --no-export
EOF

140
tools/windows_installer.nsi Normal file
View file

@ -0,0 +1,140 @@
; Rinkplanner Windows-Installer (per-user, ohne Administratorrechte).
;
; Aufruf über tools/export_windows_installer.sh. Erwartet:
; -DAPP_VERSION=0.1.0.0
; -DSOURCE_EXE=/pfad/zu/rinkplanner.exe
; -DOUT_FILE=/pfad/zu/rinkplanner-setup.exe
; -DICON_FILE=/pfad/zu/rinkplanner.ico
!ifndef APP_VERSION
!define APP_VERSION "0.1.0.0"
!endif
!ifndef SOURCE_EXE
!error "SOURCE_EXE fehlt (Pfad zur rinkplanner.exe)."
!endif
!ifndef OUT_FILE
!define OUT_FILE "rinkplanner-setup.exe"
!endif
Unicode true
RequestExecutionLevel user
Name "Rinkplanner"
Caption "Rinkplanner ${APP_VERSION}"
OutFile "${OUT_FILE}"
InstallDir "$LOCALAPPDATA\Programs\Rinkplanner"
InstallDirRegKey HKCU "Software\Rinkplanner" "InstallDir"
BrandingText "Rinkplanner - Kürplaner für Eiskunstlauf"
ShowInstDetails nevershow
ShowUninstDetails nevershow
SetCompressor /SOLID lzma
SetCompressorDictSize 64
CRCCheck on
XPStyle on
VIProductVersion "${APP_VERSION}"
VIAddVersionKey /LANG=1031 "ProductName" "Rinkplanner"
VIAddVersionKey /LANG=1031 "FileDescription" "Rinkplanner Installer"
VIAddVersionKey /LANG=1031 "FileVersion" "${APP_VERSION}"
VIAddVersionKey /LANG=1031 "ProductVersion" "${APP_VERSION}"
VIAddVersionKey /LANG=1031 "CompanyName" "programmschmiede.de"
VIAddVersionKey /LANG=1031 "LegalCopyright" "Copyright (C) 2026 programmschmiede.de"
!include "MUI2.nsh"
!include "LogicLib.nsh"
!include "FileFunc.nsh"
!include "x64.nsh"
!include "WinVer.nsh"
!ifdef ICON_FILE
!define MUI_ICON "${ICON_FILE}"
!define MUI_UNICON "${ICON_FILE}"
!endif
!define MUI_ABORTWARNING
!define MUI_WELCOMEPAGE_TITLE "Rinkplanner installieren"
!define MUI_WELCOMEPAGE_TEXT "Dieser Assistent installiert Rinkplanner für den aktuellen Benutzer. Administratorrechte sind nicht nötig.$\r$\n$\r$\nRinkplanner ist ein Kürplaner für den Eiskunstlauf: Elemente setzen, Timings planen, 3D-Vorschau und Cloud-Sync über das eigene Dropbox-Konto."
!define MUI_DIRECTORYPAGE_TEXT_TOP "Rinkplanner wird in den folgenden Ordner installiert. Der Ordner kann frei gewählt werden."
!define MUI_FINISHPAGE_RUN "$INSTDIR\rinkplanner.exe"
!define MUI_FINISHPAGE_RUN_TEXT "Rinkplanner jetzt starten"
!define MUI_FINISHPAGE_LINK "rinkplanner.programmschmiede.de"
!define MUI_FINISHPAGE_LINK_LOCATION "https://rinkplanner.programmschmiede.de/"
!insertmacro MUI_PAGE_WELCOME
!insertmacro MUI_PAGE_COMPONENTS
!insertmacro MUI_PAGE_DIRECTORY
!insertmacro MUI_PAGE_INSTFILES
!insertmacro MUI_PAGE_FINISH
!insertmacro MUI_UNPAGE_CONFIRM
!insertmacro MUI_UNPAGE_INSTFILES
!insertmacro MUI_LANGUAGE "German"
Section "Rinkplanner" SEC_MAIN
SectionIn RO
SetShellVarContext current
SetOutPath "$INSTDIR"
File "/oname=rinkplanner.exe" "${SOURCE_EXE}"
WriteUninstaller "$INSTDIR\Uninstall.exe"
CreateDirectory "$SMPROGRAMS\Rinkplanner"
CreateShortCut "$SMPROGRAMS\Rinkplanner\Rinkplanner.lnk" "$INSTDIR\rinkplanner.exe"
CreateShortCut "$SMPROGRAMS\Rinkplanner\Rinkplanner deinstallieren.lnk" "$INSTDIR\Uninstall.exe"
WriteRegStr HKCU "Software\Rinkplanner" "InstallDir" "$INSTDIR"
WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "DisplayName" "Rinkplanner"
WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "DisplayVersion" "${APP_VERSION}"
WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "Publisher" "programmschmiede.de"
WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "URLInfoAbout" "https://rinkplanner.programmschmiede.de/"
WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "DisplayIcon" "$INSTDIR\rinkplanner.exe"
WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "InstallLocation" "$INSTDIR"
WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "UninstallString" '"$INSTDIR\Uninstall.exe"'
WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "QuietUninstallString" '"$INSTDIR\Uninstall.exe" /S'
WriteRegDWORD HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "NoModify" 1
WriteRegDWORD HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "NoRepair" 1
${GetSize} "$INSTDIR" "/S=0K" $0 $1 $2
IntFmt $0 "0x%08X" $0
WriteRegDWORD HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner" "EstimatedSize" "$0"
SectionEnd
Section "Desktop-Verknüpfung" SEC_DESKTOP
SetShellVarContext current
CreateShortCut "$DESKTOP\Rinkplanner.lnk" "$INSTDIR\rinkplanner.exe"
SectionEnd
!insertmacro MUI_FUNCTION_DESCRIPTION_BEGIN
!insertmacro MUI_DESCRIPTION_TEXT ${SEC_MAIN} "Rinkplanner und die nötigen Dateien."
!insertmacro MUI_DESCRIPTION_TEXT ${SEC_DESKTOP} "Verknüpfung auf dem Desktop anlegen."
!insertmacro MUI_FUNCTION_DESCRIPTION_END
Section "Uninstall"
SetShellVarContext current
Delete "$INSTDIR\rinkplanner.exe"
Delete "$INSTDIR\Uninstall.exe"
RMDir "$INSTDIR"
Delete "$SMPROGRAMS\Rinkplanner\Rinkplanner.lnk"
Delete "$SMPROGRAMS\Rinkplanner\Rinkplanner deinstallieren.lnk"
RMDir "$SMPROGRAMS\Rinkplanner"
Delete "$DESKTOP\Rinkplanner.lnk"
DeleteRegKey HKCU "Software\Microsoft\Windows\CurrentVersion\Uninstall\Rinkplanner"
DeleteRegKey HKCU "Software\Rinkplanner"
SectionEnd
Function .onInit
SetShellVarContext current
${IfNot} ${RunningX64}
MessageBox MB_ICONSTOP "Rinkplanner benötigt ein 64-Bit-Windows."
Abort
${EndIf}
${IfNot} ${AtLeastWin10}
MessageBox MB_ICONSTOP "Rinkplanner benötigt Windows 10 oder neuer."
Abort
${EndIf}
FunctionEnd
Function un.onInit
SetShellVarContext current
FunctionEnd