Delen via

Hosting van statische inhoud

Azure DevOps Services

Kies ervoor om statische inhoud voor uw extensie te hosten, zoals HTML-, CSS- en JavaScript-bestanden, op uw eigen service, op een hostingservice van derden, zoals Azure of Heroku, of rechtstreeks op Azure DevOps Services.

Belangrijk

Als uw extensie een aangepaste tabel in de TFS-database moet maken, moet u deze niet maken met behulp van het schema 'dbo'. In plaats daarvan moeten aangepaste tabellen in een afzonderlijk schema worden gemaakt. Bijvoorbeeld 'YourExtensionName'.

Tip

Bekijk onze nieuwste documentatie over het ontwikkelen van extensies met behulp van de Azure DevOps Extension SDK.

Hosten op Azure DevOps Services

In dit model wordt statische inhoud verpakt met het VSIX-bestand van uw extensie en wordt deze geleverd vanaf een openbaar eindpunt op https://publisher.gallerycdn.vsassets.io.

De statische inhoud van uw extensie is handig wanneer u gegevens uit Azure DevOps Services verbetert of decoreert. Voor de extensie pub hoeft u (de uitgever van de extensie) geen hostingservices voor uw extensie in te stellen, te beheren of te betalen

Stappen

  1. Geef in het extensiemanifestbestand de bestanden op die u wilt opnemen via de files eigenschap :
    {
  "files": [
    {
        "path": "scripts", "addressable": true
    },
    {
        "path": "images/extra/icon1.png", "addressable": true
    }
  ]
}
  2. Verwijder de baseUri eigenschap (indien ingesteld) uit het extensiemanifest.
  3. Uw extensie verpakken (stappen)
  4. Uw extensie publiceren (of opnieuw publiceren) (stappen)
> [! BELANGRIJK] > Zorg ervoor dat u de versie van uw extensie verhoogd wanneer u wijzigingen aanbrengt in statische inhoudsbestanden die zijn opgenomen in uw .vsix.

Houd rekening met het volgende:

  • De waarde die is opgegeven door het path kenmerk kan een map of afzonderlijk bestand zijn. Als een map, wordt de hele map (en eventuele submappen) opgenomen.
  • Het addressable kenmerk is belangrijk en vertelt Visual Studio Codespaces om de bestand(en) URL adresseerbaar te maken.
  • Alle addressable assetaanvragen zijn hoofdlettergevoelig. Als de aanvraag voor een asset een andere case heeft dan de daadwerkelijk geüploade asset, resulteert dit in een HTTP 404-fout (niet gevonden).
  • Het niet opgeven van een baseUri of het instellen van een lege waarde vertelt Visual Studio Codespaces tijdens runtime om de basis-URI te berekenen alsof uw statische inhoud wordt gehost door Azure DevOps Services.

Host op uw eigen service (of een service van derden)

In dit model wordt statische inhoud geleverd vanuit uw eigen service en niet opgenomen in het vsix-bestand van uw extensie.

Stappen

  1. Stel de eigenschap in uw baseUri extensiemanifest in, bijvoorbeeld, uitgaande van een waarde van https://myservice.net/extension en deze hubbijdrage:
    "baseUri": "https://myservice.net/extension",
    "contributions": [
        {
             "id": "Fabrikam.HelloWorld",
             "type": "ms.vss-web.hub",
             "targets": [
                 "ms.vss-work-web.work-hub-group"
             ],
             "properties": {
                 "name": "Hello",
                 "uri": "hello-world.html"
             }
         }
    ]

Azure DevOps Services laadt de inhoud van deze hub wanneer deze wordt weergegeven op https://myservice.net/extension/hello-world.html.

Volgende stappen

Extensies verpakken, publiceren en installeren