CodeNomad/docs/help/de/updates.md
Pascal André 414e2d29ea
chore(release): prepare CodeNomad 1.1.0 (#1394)
## Summary

Prepare **CodeNomad 1.1.0** on dev `689f73b62`. Align the root, all five
workspaces, npm lock entries, Tauri configuration and Cargo package/lock
version. The npm lock differs only in seven release-version fields;
dependency versions and metadata are unchanged.

Set the separately published UI's **minimum server to 1.1.0**. This is a
consumed API boundary: its Missions store uses `POST
/api/workspaces/:id/missions/panel-page` for inventory and task pages,
absent from v1.0.1. Older servers retain their cached/bundled UI instead
of downloading the incompatible 1.1 UI. Test 1.0.0, 1.0.1, 1.1.0 and
future-server behavior; document the contract and update all ten help
locales.

## Validation

- Stable 1.1.0 and preview-family versioning plus clean offline
workspace installation/local remote-tunnel linking pass.
- Tauri/Cargo alignment and the remote UI server floor are checked.
- UI compatibility and release-PR-note contracts: **7/7** passed.
- Help checks: **31/31** passed across ten locales.
- Workspace typechecks and server/UI/native plugin build pass.
- npm package dry-run confirms `@neuralnomads/codenomad@1.1.0` and its
shipped CLI/Missions/pruning/memory entrypoints.
- Strict lockfile metadata comparison and whitespace checks pass.

## Publication boundary

This preparation creates no stable release or tag and changes no signing
or publishing credentials. After merge, prepare a **draft dev → main**
release PR whose body is the public release notes. Merging that separate
PR publishes GitHub/npm/UI/updater assets and requires explicit
publication approval. Existing nightly dev previews retain their normal
schedule and will use the new base version. Production Windows signing
remains disabled in current repository configuration.
2026-11-08 18:25:34 +01:00

6.8 KiB

Updates

Release-Kanal wählen

  1. Öffnen Sie Einstellungen → Info → Updates.
  2. Setzen Sie Update-Kanal auf Stabile Releases oder Vorschau- und stabile Releases.
  3. Aktualisieren/prüfen Sie auf Updates und lesen Sie das angebotene Release vor Annahme einer Installation.

Der Kanal wird in CodeNomads Serverkonfiguration gespeichert und ändert nur angebotene Releases. Er ändert weder Desktop-Datenprofile, Entwürfe, Fenster, OpenCode-Sitzungen noch Dienstkonfiguration. Ohne explizite Auswahl verwenden als Vorschau gekennzeichnete Builds standardmäßig Vorschauen, andere Builds stabile Releases.

Stabil wählt das neueste endgültige Release. Vorschau folgt der Veröffentlichungsreihenfolge, da Entwicklungs-Builds eine Basisversionsnummer teilen können; vergleichen Sie nicht nur numerische Versionen. Ein Vorschau-Release wird erst angeboten, wenn alle seine Builds veröffentlicht sind. Vorschaupakete sind für Nutzer gedacht, die Vorabverhalten testen möchten; lesen Sie Release-Hinweise und schützen Sie wichtige Entwürfe vor Neustarts.

Desktop-Installation aktualisieren

  1. Verwenden Sie Hilfe → Nach Updates suchen…, die Update-Benachrichtigung oder die Schaltfläche unter Einstellungen → Info → Updates.
  2. Folgen Sie unter Electron der Release-Seite und laden Sie Archiv/Paket für verwendeten Host und Plattform.
  3. Prüfen Sie bei geeigneten lokalen Tauri-Installationen das native Angebot und wählen Sie ausdrücklich Installieren und neu starten.
  4. Sichern Sie vor Installation/Neustart wichtige Arbeit in jedem Fenster und prüfen Sie nach erneutem Start Info.
Tauri-Installation Eignung für In-App-Installation
Windows-x64-NSIS-Installation Mit eingebettetem Updater-Schlüssel und signierten Release-Daten unterstützt.
macOS-x64-/arm64-Anwendung Mit eingebettetem Updater-Schlüssel und signierten .app.tar.gz-Daten unterstützt.
Linux-x64-AppImage Erfordert AppImage-Bundle-Markierung und nicht leeren APPIMAGE-Pfad sowie Unterstützung signierter Updates. APPRUN allein genügt nicht.
Debian/RPM, lose Windows-Programmdatei, unsignierter/schlüsselloser Build Öffnet Release-Seite statt In-App-Installation.

In Tauri-Anwendungsfenstern und nativen Einstellungen-Fenstern zeigt die Updates-Karte Update installieren, wenn ein Release angeboten wird. Sie prüft den ausgewählten Kanal und bietet Installieren und neu starten an, wenn ein In-App-Update verfügbar ist; andernfalls öffnet sie die auf der Karte angezeigte Release-Seite. Electron-, Web- und Remote-Fenster zeigen stattdessen den Link Update herunterladen, ohne native Updater-Prüfung.

Das Tauri-Menü Hilfe → Nach Updates suchen… führt den Update-Ablauf im fokussierten Anwendungsfenster aus. Aus den Einstellungen oder einem Remote-Fenster bringt es das zuletzt verwendete Anwendungsfenster in den Vordergrund, um die Prüfung auszuführen; es installiert nicht über das Remote-Fenster. Wenn kein Anwendungsfenster die Aktion empfangen kann, auch wenn das Zielfenster eine Lade-, Anmelde- oder Kopplungsseite zeigt, öffnet das Menü stattdessen die Release-Seite.

Tauri installiert nur Releases mit veröffentlichtem Update-Manifest für gewählten Kanal/Ziel. Kann ein angekündigtes Release noch nicht installiert werden, öffnet die Benachrichtigung stattdessen dessen Release-Seite. Vor Installation ist native Signaturprüfung erforderlich. Updater-Signaturen unterscheiden sich von OS-Notarisierung/Code-Signaturzusicherungen.

Installation sichert den Zustand aller Anwendungsfenster und stoppt das zugehörige CodeNomad-Backend vor Ersetzen/Neustart der App. Der unabhängig verwaltete OpenCode-Daemon gehört nicht zu diesem Herunterfahren. CodeNomad zu schließen entfernt dennoch Backend-abhängige Funktionen bis zur Rückkehr; schließen Sie aus einer weiterlaufenden OpenCode-Sitzung nicht auf ununterbrochene UI-Dienste.

Ist eine Prüfung beschäftigt, warten Sie den Vorgang des anderen Fensters ab. Lesen Sie bei Download-, Validierungs- oder Herunterfahrfehlern den Fehler und prüfen Sie neu; eine alte Benachrichtigung erlaubt keine Neuinstallation veralteter Bytes. Eine fehlgeschlagene Installation kann Backend und Fenster wiederherstellen und wiederholt die Installation nicht automatisch. Ist native Installation nicht verfügbar, nutzen Sie die Release-Seite für das passende Paket; siehe Installation.

Eigenständigen Server aktualisieren

Die Oberfläche 1.1 benötigt für ihre Missions-APIs einen CodeNomad-Server ab 1.1.0. Server der Reihe 1.0.x behalten ihre zwischengespeicherte oder mitgelieferte Oberfläche, statt die inkompatible Oberfläche herunterzuladen.

  1. Ermitteln Sie, wie CodeNomad gestartet wurde, und sichern Sie Backend-abhängige Arbeit.
  2. Stoppen Sie diesen CodeNomad-Serverprozess über dessen normale Prozess-/Dienststeuerung.
  3. Aktualisieren Sie dieselbe Paketinstallation und starten Sie mit vorgesehener Konfiguration und Flags neu.
Start-/Installationsmethode Update-Befehl
Einmaliger stabiler npm-Start npx @neuralnomads/codenomad@latest mit Ihren normalen Flags
Globale stabile Installation npm install -g @neuralnomads/codenomad@latest
Lokale stabile Installation npm install @neuralnomads/codenomad@latest in diesem Paketverzeichnis
Einmaliger Vorschaustart npx @neuralnomads/codenomad-dev@latest mit Ihren normalen Flags
Globale/lokale Vorschauinstallation @neuralnomads/codenomad-dev@latest mit derselben globalen/lokalen npm-Form installieren

Ein bereits laufender Prozess übernimmt neuen Code nicht allein durch npm-Installation. Behalten Sie bewusst denselben Konfigurationspfad; Kanalauswahl in Einstellungen ersetzt kein npm-Paket und wechselt nicht automatisch stabile/Vorschau-Paketnamen. Bewahren Sie beim Neustart Authentifizierungs-/TLS-Flags; siehe Server.

OpenCode-Wartung getrennt halten

CodeNomad zu aktualisieren aktualisiert nicht die ausgewählte OpenCode-CLI. Diese CLI zu aktualisieren startet nicht den laufenden gemeinsamen Daemon neu. Native Konfiguration neu zu laden ist ein weiterer expliziter Vorgang mit eigenen Auswirkungen auf geladene Locations und Anfragen.

Desktop-Laufzeiten werden mit der Anwendung aktualisiert: Electron nutzt sein integriertes Node, Tauri bündelt Node, und beide enthalten npm. System-Node/npm, Plattform-Webview und OpenCode-Dienst werden unabhängig verwaltet.

Verwenden Sie Einstellungen → OpenCode für Laufzeitauswahl, Installation/Update und explizite Dienststeuerung. Prüfen Sie vor Neustart/Neuladen die OpenCode-Einrichtung, besonders bei geteiltem Daemon mit anderen Fenstern/Nutzern oder Missionen. Wiederholen Sie niemals einen ungewissen Prompt/eine Änderung allein wegen abgeschlossenem Update/Wiederverbinden.