Del via

Spor kilde og bygg metadata på utvidelser

  • Artikkel

Viktig

Dette innholdet er arkivert og oppdateres ikke. Gå til Hva er nytt eller endret i Business Central for den nyeste dokumentasjonen. Gå til Lanseringsplaner for Dynamics 365, Power Platform og Cloud for Industry for å finne de nyeste lanseringsplanene.

Aktivert for Forhåndsversjon Tilgjengelig
Administratorer, utviklere, markedsførere eller analytikere, automatisk 16. aug. 2023 2. okt. 2023

Forretningsverdi

For å hjelpe med å spore utvidelser som er opprettet som en del av DevOps-kanaler, introduserer vi Source- og Build-egenskaper i app.json-manifestet for utvidelser. Dette gjør det enkelt å finne det relevante kilderepositoriet, utførings-IDen og byggesystemet som brukes til å opprette utvidelsen.

Funksjonsdetaljer

App.json-manifestet for utvidelser inneholder nå to nye egenskaper, Source og Build. Disse kan brukes til å spore kildeplassering og byggekontekst.

For source støtter vi:

  • repositoryUrl, som er nettadressen til repositoriet der kildekoden til prosjektet finnes.
  • commit, som er en ID for kildekoden for gjeldende versjon av prosjektet, som gjør det mulig å komme tilbake til commit-handlingen som utløste byggingen av utvidelsen.

For build støtter vi:

  • by, som er nyttig for å spore byggeagenten/systemet som organiserte bygget, for eksempel AL-Go for GitHub.
  • url, som kan brukes for nettadressen til aktivering av byggesystemet der bygget finnes.

Du kan definere disse verdiene direkte i app.json, men på grunn av den dynamikk, vil det vanlige scenariet være å angi disse som en del av byggepipelines via kommandolinjeparametere for den kjørbare alc.exe-kompilatoren. Verdiene som sendes her, vil overskrive eventuelle verdier i app.json-kildefilen.

Hvis du bruker BcContainerHelper, vil funksjonene Compile-AppInBcContainer og Compile-AppWithCompilerFolder nå ta parametere for SourceRepositoryUrl, SourceCommit, BuildBy og BuildUrl. Disse blir nå satt hvis du bruker AL:Go for GitHub til å bygge utvidelsene dine.

I denne utgivelsen vises ennå ikke noen av disse verdiene på siden Administrasjon av utvidelse, i TAC eller via PowerShell-kommandoer, som NAV-AppInfo. Hvis du vil lese verdiene, er alternativet for øyeblikket å bruke BcContainerHelper Extract-AppFileToFolder, som vil tillate å hente app.json-filen med innstillingene.

Her er et eksempel på bygge- og kildemetadata i app.json. Dette angis vanligvis av byggeprosessen og ikke manuelt.

Eksempel på bygge- og kildemetadata i app.json

Fortell oss hva du synes

Hjelp oss å forbedre Dynamics 365 Business Central ved å diskutere og komme med forslag og gi tilbakemelding. Bruk forumet på https://aka.ms/bcideas.

Se også

JSON-filer (docs)