WinGet-Manifeste authorieren
Laufzeit
Dumplings-Modulbefehle und hostseitige Skill-Skripte mit PowerShell 7.4 oder höher (pwsh) ausführen. Windows PowerShell 5.1 wird nicht unterstützt, sofern kein spezifischer, in sich geschlossener Gast-Collector etwas anderes angibt.
Arbeitsablauf
Die für die aktuelle Phase benötigten Referenzen lesen.
- Paketauswahl: Identität, Quellindex-Dublettensuche, Offizielle Quellenermittlung, Artefaktauswahl und Veröffentlichungsdatum-Evidenz.
- Manifesterstellung: Modell und Dateien, Installer-Felder, Abhängigkeiten, Standardwerte und Rückgabecodes, Apps und Features sowie Formatierung und Validierung.
- Lokalisierung: Gebietsschema-Modell, Gebietsschema-Identität und Gebietsschema-Inhalt und Versionshinweise.
- Abschluss: Einreichung und Validierungslogs aus PR-Prüfungen.
- Gemeinsame Helfer-APIs:
$use-dumplings-functionsfür Quellenabruf, Weiterleitungen, Antwortdecodierung, temporäre Dateien, HTML- oder Markdown-Verarbeitung, YAML und Browser-Evidenz verwenden. - Installer-Familienleitfaden: Mit der Installer-Familien-Routentabelle des Analysators beginnen, dann den ausgewählten Familien-Workflow für statische Parser-Befehle, Schalter, ARP-Eigentümerschaft und VM-Ausnahmen öffnen.
- Große Arbeitsdatensätze: Transiente Evidenz.
$analyze-winget-installer für Installer-Evidenz und $author-dumplings-task nach Annahme der ersten Paketversion oder mit einem explizit konfigurierten vertrauenswürdigen Referenz für ausstehende Pakete verwenden, während dessen erster PR auf Merge wartet.
Inkrementelles Authoring
Ein funktionierendes mehrteiliges Manifest erstellen und speichern, sobald die Kennung, Version, das Standard-Gebietsschema und die erforderlichen Installer-Felder bekannt sind. Bei einem vorhandenen Paket dessen logisches Modell verwenden, um das neue Versionsblatt zu erstellen. Die Forschung und VM-Validierung anhand dieses Entwurfs fortsetzen.
Das Manifest als Artefaktauswahl, Parsing, Gebietsschema-Recherche, Versionshinweise und VM-Validierung speichern, sobald neue Fakten ermittelt werden. Das aktuelle logische Modell vor jeder Bearbeitung lesen und das Diff inspizieren. Ungeklärte optionale Felder auslassen. Bei der Bearbeitung eines Batches den Entwurf jedes Pakets während seiner Recherche beibehalten. Den vollständigen Satz nach dem ersten Speichern und strukturellen Änderungen formatieren und validieren, dann vor der Einreichung eine strenge Endkontrolle durchführen.
Unverhandelbare Regeln
Offizielle Herausgeberquellen verwenden. Keine Download-Aggregatoren, Spiegel, Neuverpacker oder Download-Seiten für Suchergebnisse nutzen. Websites und Repositorys vor dem Vertrauen gegenseitig überprüfen.
Niemals einen unbekannten Installer auf dem Host ausführen. Vor dem Finalisieren oder Einreichen eines Eintrags die VM-Validierung mit dem genauen Artefakt und den erstellten Schaltern abschließen. Anhalten, wenn der einzige Link eine Anmeldung erfordert, per E-Mail zugestellt wird, inoffiziell oder verdächtig ist oder sitzungsgebunden ohne stabilen Fallback ist. Installer ablehnen, die nicht unbeaufsichtigt ausgeführt werden können, einschließlich solcher, die durch einen Windows-Sicherheitstreiber-Herausgeber-Zustimmungsdialog blockiert werden.
Wenn die Host- oder VM-Sicherheitssoftware eine ausführbare Datei als Virus oder Schadsoftware meldet, den betroffenen Paket-Workflow sofort stoppen und den Benutzer warnen. Stopp bei Malware-Warnungen befolgen.
Keine Herausgeberidentitäten, juristischen Namen, URLs, Versionshinweise, Versionen, Registry-Metadaten oder Schalter erfinden. Alle wahrscheinlichen autoritativen Quellen durchsuchen, bevor ein anwendbares optionales Feld ausgelassen wird.
Das aktuelle Authoring verwendet Schema 1.12.0 und die festen Dumplings-Header.
Moniker nicht automatisch hinzufügen. Derzeit UnsupportedOSArchitectures nicht authorieren. Bekannte Installer-Schalter, Modi und Rückgabecodes auslassen, wenn sie den WinGet-Standardwerten entsprechen.
Ausgabedisziplin
Das vollständige logische Modell während des gesamten Authorings verwenden. Jede evidenzgestützte Revision mit Save-WinGetManifest oder den dokumentierten Modell-APIs speichern, dann offline validieren. Format-WinGetManifest nur für isolierte Dokumente reservieren. Es kann nicht dokumentenübergreifend optimieren oder fehlende Evidenz nachtragen.
Vollständige Quellen-, Installer-, VM- und Validierungsaufzeichnungen im transienten Evidenzbaum aufbewahren. Nur die Entscheidungen, ungelösten Diagnosen und den Evidenzpfad in der Aufgabe melden.