Skip to content

EXPORTFORMAT.md

Latest commit

 

History

History
82 lines (67 loc) · 2.45 KB

EXPORTFORMAT.md

File metadata and controls

82 lines (67 loc) · 2.45 KB
Raw

Exportformat softwarecenter-profile-v1.json

Stand: 2026-05-24

Zweck

Das Austauschformat softwarecenter-profile-v1.json beschreibt ein SoftwareCenter-Profil portabel für:

  • Desktop-zu-Desktop-Übernahmen zwischen Windows, macOS und Linux
  • einen späteren Web/PWA-Companion als reine Profilansicht
  • Backups und manuelle Profilmigrationen ohne direkten Zugriff auf QSettings

Der Export kopiert keine lokalen Dateien und enthält keine Credentials.

JSON-Schema

{
  "format": "softwarecenter-profile-v1",
  "format_version": 1,
  "app_version": "1.0.0",
  "source_platform": "win32",
  "exported_at": "2026-05-24T08:00:00Z",
  "current_tab": 0,
  "tabs": [
    {
      "name": "Werkzeuge",
      "view_mode": "tiles",
      "entries": [
        {
          "label": "Editor",
          "path": "C:/Tools/Editor.exe",
          "kind": "file",
          "notes": null
        }
      ]
    }
  ]
}

Feldregeln

Feld Typ Pflicht Bedeutung
format String Ja Fester Formatname softwarecenter-profile-v1
format_version Integer Ja Aktuell 1
app_version String Ja SoftwareCenter-Version beim Export
source_platform String Ja Ursprungsplattform wie win32, darwin, linux
exported_at String Ja UTC-Zeitstempel im ISO-8601-Format
current_tab Integer Ja Aktiver Tab beim Export
tabs Liste Ja Profilinhalt
tabs[].name String Ja Sichtbarer Tabname
tabs[].view_mode String Ja tiles oder list
tabs[].entries Liste Ja Launcher-Einträge des Tabs
entries[].label String Ja Sichtbares Label im UI
entries[].path String Ja Referenzierter lokaler Pfad
entries[].kind String Ja Eintragstyp
entries[].notes String oder null Nein Optionale Notiz für Companion- oder Migrationshinweise

kind-Werte

  • file
  • windows_shortcut
  • mac_app
  • linux_desktop
  • script
  • url
  • unknown

Importverhalten

  • Der Import ersetzt das aktuell geladene Profil.
  • Fehlende lokale Pfade bleiben als Referenz sichtbar und werden nicht stillschweigend verworfen.
  • Beim Öffnen eines fehlenden Pfads zeigt SoftwareCenter weiter eine Warnung an.
  • Alte QSettings ohne entries_json bleiben lesbar; dann werden nur die bisherigen Pfadlisten übernommen.

UI-Zugriff

  • Datei -> Profil exportieren
  • Datei -> Profil importieren
  • dieselben Aktionen zusätzlich in der Toolbar