Quell- und Build-Metadaten für Erweiterungen verfolgen

  • Artikel
Aktiviert für Öffentliche Vorschauversion Allgemeine Verfügbarkeit
Administrator*innen, Maker*innen, Marketingspezialist*innen oder Analyst*innen, automatisch 16. Aug. 2023 2. Okt. 2023

Geschäftswert

Um die Nachverfolgung von Erweiterungen zu erleichtern, die als Teil von DevOps-Pipelines erstellt werden, werden die Eigenschaften „Source“ und „Build“ im app.json-Manifest der Erweiterungen eingeführt. Dies ermöglicht ein einfaches Auffinden des relevanten Quell-Repositorys, der Commit-ID und des Build-Systems, die zum Erstellen der Erweiterung verwendet wurden.

Details zur Funktion

Das app.json-Manifest der Erweiterungen enthält jetzt zwei neue Eigenschaften: Source und Build. Diese können verwendet werden, um den Quellspeicherort und den Build-Kontext zu verfolgen.

Für „Source“ wird Folgendes unterstützt:

  • repositoryUrl: Dies ist die URL des Repositorys, in dem der Quellcode des Projekts zu finden ist.
  • commit: Dies ist eine ID des Quellcodes für die aktuelle Version des Projekts, die es ermöglicht, zu dem Commit zurückzukehren, der die Erstellung der Erweiterung ausgelöst hat.

Für „Build“ wird Folgendes unterstützt:

  • by: Dies ist nützlich, um den Build-Agent bzw. das Build-System zu verfolgen, der/das den Build orchestriert hat, z. B. AL-Go for GitHub.
  • url: Diese kann als URL zum Aufrufen des Build-Systems verwendet werden, in dem sich der Build befindet.

Sie können diese Werte direkt in app.json definieren. Aufgrund der dynamischen Natur besteht das übliche Szenario jedoch darin, diese als Teil von Build-Pipelines über Befehlszeilenparameter für die verwendete ausführbare Compilerdatei „alc.exe“ festzulegen. Die hier übergebenen Werte überschreiben alle Werte in der app.json-Quelldatei.

Bei Verwendung von BcContainerHelper übernehmen die Funktionen Compile-AppInBcContainer und Compile-AppWithCompilerFolder nun Parameter für „SourceRepositoryUrl“, „SourceCommit“, „BuildBy“ und „BuildUrl“. Diese werden jetzt festgelegt, wenn Sie AL:Go für GitHub zum Erstellen Ihrer Erweiterungen verwenden.

In dieser Version taucht noch keiner dieser Werte auf der Seite Erweiterungsverwaltung, im TAC oder über PowerShell-Befehle wie NAV-AppInfo auf. Wenn Sie die Werte lesen möchten, besteht derzeit die Möglichkeit, den BcContainerHelper „Extract-AppFileToFolder“ zu verwenden, der es ermöglicht, die app.json-Datei mit den Einstellungen abzurufen.

Im Folgenden sehen Sie ein Beispiel für Build- und Quellmetadaten in app.json. Dies wird normalerweise durch den Build-Prozess und nicht manuell festgelegt.

Beispiel für Build- und Quellmetadaten in app.json

Teilen Sie uns Ihre Meinung mit.

Helfen Sie uns, mit Ideen, Vorschlägen und Feedback Dynamics 365 Business Central zu verbessern. Nutzen Sie das Forum unter https://aka.ms/bcideas.

Siehe auch

JSON-Dateien (Dokumente)