Hébergement de contenu statique

Azure DevOps Services

Choisissez d’héberger du contenu statique pour votre extension, comme les fichiers HTML, CSS et JavaScript, sur votre propre service, sur un service d’hébergement tiers, comme Azure ou Heroku, ou sur Azure DevOps Services directement.

Important

Si votre extension doit créer une table personnalisée dans la base de données TFS, ne la créez pas à l’aide du schéma « dbo ». Au lieu de cela, les tables personnalisées doivent être créées dans un schéma distinct. Par exemple, « YourExtensionName ».

Conseil / Astuce

Pour obtenir les dernières instructions de développement d’extension, notamment les thèmes et la migration à partir de VSS. Sdk, consultez le portail du kit de développement logiciel (SDK) d’extension Azure DevOps.

Héberger sur Azure DevOps Services

Dans ce modèle, le contenu statique est empaqueté avec le fichier .vsix de votre extension et est servi à partir d’un point de terminaison public à l’adresse https://publisher.gallerycdn.vsassets.io.

Le contenu statique de votre extension est utile lorsque vous améliorez ou décorez des données à partir d’Azure DevOps Services. L’extension pub ne vous oblige pas, en tant qu’éditeur de l’extension, à configurer, gérer ou payer des services d’hébergement pour votre extension.

Étapes

  1. Dans votre fichier manifeste d’extension, spécifiez les fichiers que vous souhaitez inclure via la files propriété : 
    {
  "files": [
    {
        "path": "scripts", "addressable": true
    },
    {
        "path": "images/extra/icon1.png", "addressable": true
    }
  ]
}
  2. Supprimez la baseUri propriété (si définie) de votre manifeste d’extension.
  3. Empaqueter votre extension (étapes)
  4. Publier (ou republier) votre extension (étapes)
> [! IMPORTANT] > Veillez à incrémenter la version de votre extension lorsque vous apportez des modifications aux fichiers de contenu statiques inclus dans votre fichier .vsix.

Gardez à l’esprit :

  • La valeur spécifiée par l’attribut path peut être un dossier ou un fichier individuel. Si c'est un dossier, le dossier en entier (et tous les sous-dossiers) est inclus.
  • L’attribut addressable est important et indique à Visual Studio Codespaces de rendre l’URL adressable aux fichiers.
  • Toutes les requêtes de ressources addressable sont sensibles à la casse. Si la demande d’une ressource a un cas différent de celui de la ressource chargée, elle génère une erreur HTTP 404 (introuvable).
  • Ne pas spécifier de baseUri ou définir une valeur vide indique à Visual Studio Codespaces au moment de l’exécution de calculer l’URI de base comme si votre contenu statique est hébergé par Azure DevOps Services.

Héberger sur un service tiers

Dans ce modèle, le contenu statique est servi à partir de votre propre service et n’est pas inclus dans le fichier .vsix de votre extension.

Étapes

  1. Définissez la propriété baseUri dans votre manifeste d’extension. Par exemple, en supposant une valeur de https://myservice.net/extension et cette contribution de hub :
    "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 charge le contenu de ce hub lorsqu’il est affiché à l’adresse https://myservice.net/extension/hello-world.html.

Étape suivante

Empaqueter, publier et installer des extensions

  • Last updated on