Spore kilde og bygge metadata på udvidelser
Vigtigt
Dette indhold er arkiveret og opdateres ikke. Du kan få den nyeste dokumentation i Nyheder eller ændringer i Business Central. Du kan få vist de seneste udgivelsesplaner i Udgivelsesplaner til Dynamics 365, Power Platform og Cloud for Industry.
| Aktiveret for | Offentlig forhåndsversion | Generel tilgængelighed |
|---|---|---|
| Administratorer, udviklere, marketingmedarbejdere eller analytikere automatisk |  16. aug. 2023 |
2. okt. 2023 |
Forretningsværdi
Vi introducerer egenskaberne Source og Build i app.json-manifestet for udvidelser for at hjælpe med at spore udvidelser, der er oprettet som en del af DevOps-pipelines. Det gør det nemt at finde den relevante kilde-repo, commit-id og byggesystem, der bruges til at oprette udvidelsen.
Funktionsdetaljer
App.json-manifestet af udvidelser indeholder nu to nye egenskaber, Source og Build. Disse kan bruges til at spore kildeplacering og byggekontekst.
Til kilde understøtter vi:
- repositoryUrl, som er URL-adressen til det lager, hvor kildekoden til projektet kan findes.
- commit, som er et id for kildekoden for den aktuelle version af projektet, der gør det muligt at komme tilbage til den commit, der udløste bygningen af udvidelsen.
Til build understøtter vi:
- by, som er nyttig til at spore den build-agent/det build-system, der orkestrerede buildet; f.eks., AL-Go for GitHub.
- url, som kan bruges til URL-adressen til build-systemet, hvor buildet kan findes.
Du kan definere disse værdier direkte i app.json, men i betragtning af den dynamiske natur ville det sædvanlige scenarie være at indstille disse som del af build-pipelines via kommandolinjeparametre for den brugte alc.exe-kompiler eksekverbare. De værdier, der sendes her, vil overskrive alle værdier i app.json-kildefilen.
Hvis du bruger BcContainerHelper, tager funktionerne Compile-AppInBcContainer og Compile-AppWithCompilerFolder nu parametre for "SourceRepositoryUrl", "SourceCommit", "BuildBy" og "BuildUrl". Disse bliver nu indstillet, hvis du bruger AL:Go for GitHub til at bygge dine udvidelser.
I denne udgivelse vises ingen af disse værdier endnu på siden Udvidelsesstyring, i TAC eller via PowerShell-kommandoer som NAV-AppInfo. Hvis du vil læse værdierne, er muligheden i øjeblikket at bruge BcContainerHelper "Extract-AppFileToFolder", som gør det muligt at hente app.json-filen med indstillingerne.
Her er et eksempel på bygge- og kildemetadata i app.json. Dette indstilles normalt af byggeprocessen og ikke manuelt.
Fortæl os, hvad du synes
Hjælp os med at forbedre Dynamics 365 Business Central ved at diskutere idéer, komme med forslag og give feedback. Bruge forummet på https://aka.ms/bcideas.
Se også
JSON-filer (dokumentation)