Paketera och publicera en integrering

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Publicera ditt verktyg, din tjänst eller produkt som integreras med Azure DevOps på Visual Studio Marketplace. Marketplace är den centrala hubben för användare att identifiera integreringar och tillägg.

Förutsättningar

Följande lista med krav måste uppfyllas innan du publicerar på Marketplace.

Du behöver också följande tillgångar:

• Minst en skärmbild av din integrering
• En uppmaning till handling- eller start-URL för användare

Skapa en utgivare

Varje tillägg eller integrering, inklusive de från Microsoft, måste ha en utgivare. Vem som helst kan skapa en utgivare och publicera tillägg under denne. Du kan också dela utgivaråtkomst med andra användare, till exempel ditt utvecklingsteam.

1. Logga in på Visual Studio Marketplace-publiceringsportalen.

2. Om du inte är en del av en befintlig utgivare väljer du + Skapa en utgivare.
   Ange ett utgivarnamn. ID-fältet fylls i automatiskt baserat på din inmatning.

   

   Anmärkning

   • Kontrollera att utgivarnamnet är inom 16 tecken för flerabytestecken.
   • Spara utgivar-ID:t – du behöver det i tilläggets manifestfil.

   Om du inte uppmanas att skapa en utgivare bläddrar du till Publicera tillägg under Relaterade webbplatser.

   • Ange en unik utgivaridentifierare, till exempel mycompany-myteam. Använd det här värdet för publisher attributet i manifestet.
   • Ange ett visningsnamn, till exempel My Team.

3. Granska Marketplace Publisher-avtalet och välj sedan Skapa.

   

När du har skapat utgivaren kan du hantera objekt, även om inga objekt visas förrän du publicerar.

Konfigurera projektstruktur

Skapa följande kataloglayout:

home/
├── images/
│   ├── integration-logo.png    (128×128 px minimum)
│   └── screenshot.png          (1366×768 px)
├── overview.md
└── vss-integration.json

Skapa manifestet

Skapa vss-integration.json med följande innehåll och uppdatera sedan värdena för din integrering:

{
    "manifestVersion": 1,
    "id": "myservice",
    "version": "1.0.0",
    "name": "My Service",
    "publisher": "mycompany",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ],    
    "icons": {
        "default": "images/service-logo.png"
    },
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "screenshots": [
        {
            "path": "images/screen1.png"
        },
        {
            "path": "images/screen2.png"
        }
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "fabrikam-license-terms.md"
        }
    },
    "links": {
        "getstarted": {
            "uri": "https://www.mycompany.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.mycompany.com/features"
        },
        "support": {
            "uri": "https://www.mycompany.com/support"
        }
    },
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    }
}

Uppdatera fält med hjälp av följande referenser:

Följande egenskaper krävs:

Följande valfria egenskaper hjälper användarna att identifiera och lära sig mer om ditt tillägg:

Paketera integreringen

1. Installera förpackningsverktyget om du inte redan har gjort det:

   npm install -g tfx-cli
   

2. Paketera integrationen i en .vsix-fil:

   tfx extension create --manifest-globs vss-integration.json
   

   Tips/Råd

   Använd --rev-version för att automatiskt öka versionsnumret för korrigeringen.

Publicera på Marketplace

När tillägget har paketerats kan du ladda upp det till Marketplace under en utgivare. Identifieraren publisher som anges i tilläggets manifestfil måste matcha identifieraren för utgivaren som tillägget laddas upp under.

1. Från hanteringsportalen väljer du utgivaren från den nedrullningsbara menyn överst på sidan.

2. Välj Nytt tillägg>Azure DevOps.

   

3. Dra och släpp filen eller välj den för att hitta VSIX-filen, som du skapade i föregående paketeringssteg, och välj sedan Ladda upp.

   

   Efter snabb validering visas tillägget i listan över publicerade tillägg. Oroa dig inte, tillägget är bara synligt för dig.

   

Ditt tillägg är i det här läget inte synligt för några konton. För att göra det synligt för andra måste du dela tillägget.

Dela integreringen

Innan du kan installera en integrering i en Azure DevOps-organisation måste du dela den med den organisationen.

1. Välj din integrering i listan över objekt som visas.
2. Välj Dela.
3. Ange organisationsnamnet (till exempel fabrikam-fiber-inc för dev.azure.com/fabrikam-fiber-inc).

Uppdatera integreringen

Gör följande för att uppdatera ett tillägg som du redan har publicerat:

1. Välj ditt tillägg i listan över objekt som visas.
2. Högerklicka och välj Uppdatera för utvecklingsversionen, till exempel publisher.extension-dev.
3. Bekräfta ditt tillägg.
4. Tillämpa samma uppdateringar på produktionsversionen, till exempel publisher.extension.
5. Bläddra till .vsix-filen för tillägget och ladda upp det.

Azure DevOps installerar automatiskt den uppdaterade versionen för alla konton som redan har tillägget. Nya installationer får också den senaste versionen.

Göra integrationen offentlig

Om du vill göra din integrering synlig för alla Marketplace-användare anger du public flaggan till true i manifestet och publicerar om den.

Mer information om de kvalifikationer som krävs för offentliga listor finns i Göra ditt tillägg offentligt.

Relaterat innehåll

• Tilläggsmanifest referens
• Paketera och publicera tillägg
• Visual Studio Marketplace