Bauanleitung: NovaPhonic Windows Installer

Dieses Verzeichnis enthält das Tauri Projekt, das NovaPhonic als eigenständige Windows Anwendung mit NSIS Installer (.exe) verpackt, nach demselben Muster wie NovaImage. Der Installer selbst kann nicht in der Cloud Sandbox gebaut werden (Linux, kein Rust, keine Windows Build Werkzeuge, keine Root Rechte), sondern nur auf einem Windows Rechner oder per GitHub Actions.

Wichtiger Hinweis zum Rust Code

In der Umgebung, in der dieses Projekt erstellt wurde, gab es keinen Rust Compiler. src-tauri/src/main.rs wurde also nicht kompiliert, nur sorgfältig von Hand geschrieben und geprüft. Der erste Build (lokal oder per GitHub Actions) ist damit der erste echte Kompilier-Test. Zwei Stellen im Code sind mit Kommentaren markiert und sollten dabei besonders beachtet werden:

Die genauen Kommandozeilen-Optionen von deep-filter (Entrauschungs-Werkzeug). Der Code nimmt -o <Zieldatei> an, manche Versionen erwarten stattdessen einen Ausgabeordner. Mit deep-filter --help (oder binaries\deep-filter-x86_64-pc-windows-msvc.exe --help im PowerShell Fenster) lässt sich das direkt prüfen.
Ob auto-editor --no-open in der installierten Version noch so heißt.

Falls der Build fehlschlägt, bitte die Fehlermeldung schicken, dann wird gezielt nachgebessert.

Schritt 1: Sidecar Werkzeuge besorgen

NovaPhonic bringt auto-editor, DeepFilterNet (deep-filter) und FFmpeg direkt im Installer mit (sogenannte Sidecar Programme), damit niemand diese drei Werkzeuge selbst von Hand herunterladen und im PATH einrichten muss. Dafür müssen die drei Dateien vor dem Bauen einmalig in tauri-app/src-tauri/binaries/ liegen, mit dem Ziel-Tripel im Namen (auf einem normalen Windows PC ist das x86_64-pc-windows-msvc, zur Sicherheit mit rustc -vV prüfen, Zeile "host"):

tauri-app/src-tauri/binaries/auto-editor-x86_64-pc-windows-msvc.exe
tauri-app/src-tauri/binaries/ffmpeg-x86_64-pc-windows-msvc.exe
tauri-app/src-tauri/binaries/deep-filter-x86_64-pc-windows-msvc.exe

Diese PowerShell Befehle laden alle drei automatisch herunter und benennen sie richtig (im Ordner tauri-app ausführen):

New-Item -ItemType Directory -Force -Path "src-tauri\binaries" | Out-Null

# auto-editor (kennen wir schon vom Test)
Invoke-WebRequest -Uri "https://github.com/WyattBlue/auto-editor/releases/latest/download/auto-editor-windows-x86_64.exe" `
  -OutFile "src-tauri\binaries\auto-editor-x86_64-pc-windows-msvc.exe"

# FFmpeg (gyan.dev essentials build, gepackt als Zip)
Invoke-WebRequest -Uri "https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-essentials.zip" -OutFile "ffmpeg.zip"
Expand-Archive -Path "ffmpeg.zip" -DestinationPath "ffmpeg-extracted"
$ffmpegExe = Get-ChildItem -Path "ffmpeg-extracted" -Recurse -Filter "ffmpeg.exe" | Select-Object -First 1
Copy-Item $ffmpegExe.FullName "src-tauri\binaries\ffmpeg-x86_64-pc-windows-msvc.exe"
Remove-Item "ffmpeg.zip", "ffmpeg-extracted" -Recurse -Force

# DeepFilterNet: Release Seite oeffnen und die aktuelle Windows Datei manuell laden,
# da sich der genaue Dateiname von Version zu Version aendern kann:
# https://github.com/Rikorose/DeepFilterNet/releases/latest
# Danach die heruntergeladene Datei umbenennen/kopieren nach:
# src-tauri\binaries\deep-filter-x86_64-pc-windows-msvc.exe

Die GitHub Actions Pipeline (.github/workflows/build.yml) erledigt genau diese drei Downloads bereits automatisch bei jedem Cloud Build, inklusive einer automatischen Suche nach der aktuellen DeepFilterNet Windows Datei. Für einen lokalen Build auf dem eigenen Rechner müssen die Dateien wie oben einmalig von Hand besorgt werden.

Weg 1: Auf dem eigenen Windows Rechner bauen

Einmalige Voraussetzungen:

Node.js (LTS Version): https://nodejs.org
Rust über https://rustup.rs
Während/nach der Rust Installation: "Microsoft C++ Build Tools" (Komponente "Desktop development with C++" aus dem Visual Studio Installer).
WebView2 Runtime ist auf aktuellen Windows 10/11 Systemen normalerweise schon dabei.
Die drei Sidecar Dateien aus Schritt 1 liegen in src-tauri/binaries/.

cd tauri-app
npm install
npm run tauri build

Installer liegt danach unter:

src-tauri\target\release\bundle\nsis\NovaPhonic_<Version>_x64-setup.exe

Zum Testen ohne Installer, mit Live Neuladen: npm run tauri dev

Weg 2: Automatisch in der Cloud bauen (GitHub Actions)

Ist bereits eingerichtet unter .github/workflows/build.yml, inklusive dem automatischen Herunterladen der drei Sidecar Werkzeuge. Läuft automatisch bei jedem Push, der tauri-app/ verändert, und kann jederzeit manuell über "Run workflow" im Actions Tab gestartet werden. Ergebnis liegt dort als Artifact.

Ein echtes Release veröffentlichen (mit Versionsnummer)

Ohne Versions-Tag baut die Cloud nur ein Artifact, das nach 30 Tagen automatisch verschwindet. Für ein dauerhaftes, versioniertes GitHub Release:

Versionsnummer an drei Stellen anheben (muss überall gleich sein), z.B. von 0.1.0 auf 0.2.0:
- tauri-app/package.json -> "version"
- tauri-app/src-tauri/Cargo.toml -> version = "..."
- tauri-app/src-tauri/tauri.conf.json -> "version"
Änderungen committen wie gewohnt.
Einen Versions-Tag setzen und pushen:

git tag v0.2.0
git push origin v0.2.0

Der Tag-Push löst den Workflow erneut aus, baut den Installer und legt diesmal zusätzlich automatisch ein GitHub Release mit dem Namen des Tags an, der NSIS Installer (.exe) hängt als Download-Datei direkt am Release, dauerhaft, nicht nur 30 Tage.

Wie Updates beim Nutzer ankommen

Genau wie bei NovaImage prüft NovaPhonic beim Start automatisch, ob eine neue Version auf GitHub Releases liegt. Voraussetzung, damit das funktioniert:

Ein eigenes Signierschlüsselpaar erzeugen (Minisign):

npx @tauri-apps/cli signer generate

Den ausgegebenen öffentlichen Schlüssel in tauri-app/src-tauri/tauri.conf.json unter plugins.updater.pubkey eintragen, anstelle des Platzhaltertexts.
Den privaten Schlüssel als GitHub Actions Secrets hinterlegen (Repository -> Settings -> Secrets and variables -> Actions -> "New repository secret"):
- TAURI_SIGNING_PRIVATE_KEY: Inhalt der privaten Schlüsseldatei.
- TAURI_SIGNING_PRIVATE_KEY_PASSWORD: Passwort des Schlüssels (leer lassen, falls ohne Passwort erzeugt, das Secret dann mit leerem Wert anlegen).

Ohne diese beiden Secrets schlägt der Release-Build bei einem Versions-Tag fehl.

Deinstallieren

Ganz normal wie jedes andere Windows Programm, über Windows Einstellungen -> Apps -> Installierte Apps -> "NovaPhonic" suchen -> Deinstallieren.

Warum überhaupt eine eigene App

NovaPhonic bündelt drei separate Open Source Werkzeuge (auto-editor, DeepFilterNet, FFmpeg) hinter einer einzigen, einfachen Bedienoberfläche mit Fortschrittsanzeige, sodass niemand PowerShell Befehle von Hand eintippen muss.

6.8 KiB Raw Blame History