Packen und Veröffentlichen einer Integration

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

Veröffentlichen Sie Ihr Tool, Ihren Dienst oder Ihr Produkt, das in Azure DevOps auf dem Visual Studio Marketplace integriert ist. Der Marketplace ist der zentrale Hub für Benutzer, um Integrationen und Erweiterungen zu entdecken.

Voraussetzungen

Die folgende Liste der Anforderungen muss erfüllt sein, bevor Sie auf dem Marketplace veröffentlichen.

Außerdem benötigen Sie die folgenden Ressourcen:

• Mindestens ein Screenshot Ihrer Integration
• Eine Handlungsaufforderungs- oder Starte-jetzt-URL für Benutzer

Erstellen eines Herausgebers

Jede Erweiterung oder Integration, einschließlich derjenigen von Microsoft, muss über einen Herausgeber verfügen. Jeder kann einen Verlag gründen und Erweiterungen veröffentlichen. Sie können auch den Herausgeberzugriff für andere Benutzer freigeben, z. B. Ihr Entwicklungsteam.

1. Melden Sie sich beim Visual Studio Marketplace-Veröffentlichungsportal an.

2. Wenn Sie nicht Mitglied eines bestehenden Herausgebers sind, wählen Sie + Herausgeber erstellen.
   Geben Sie einen Herausgebernamen ein; Das FELD "ID" wird basierend auf Ihrem Eintrag automatisch ausgefüllt.

   

   Hinweis

   • Stellen Sie sicher, dass der Herausgebername innerhalb von 16 Zeichen für Multibyte-Zeichen liegt.
   • Speichern Sie die Herausgeber-ID– Sie benötigen sie in der Manifestdatei Ihrer Erweiterung.

   Wenn Sie nicht aufgefordert werden, einen Herausgeber zu erstellen, scrollen Sie zu "Erweiterungen veröffentlichen " unter "Verwandte Websites".

   • Legen Sie einen eindeutigen Herausgeberbezeichner fest, wie zum Beispiel mycompany-myteam. Verwenden Sie diesen Wert für das publisher Attribut in Ihrem Manifest.
   • Legen Sie einen Anzeigenamen fest, wie z. B. My Team.

3. Überprüfen Sie die Marketplace-Herausgebervereinbarung, und wählen Sie dann "Erstellen" aus.

   

Nachdem Sie den Herausgeber erstellt haben, können Sie Elemente verwalten, obwohl Elemente erst erscheinen, nachdem Sie veröffentlicht haben.

Einrichten der Projektstruktur

Erstellen Sie das folgende Verzeichnislayout:

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

Erstellen des Manifests

Erstellen Sie vss-integration.json mit dem folgenden Inhalt und aktualisieren Sie anschließend die Werte für Ihre Integration.

{
    "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"
    }
}

Aktualisieren Sie Felder mithilfe der folgenden Verweise:

Die folgenden Eigenschaften sind erforderlich:

Die folgenden optionalen Eigenschaften helfen Benutzern, Ihre Erweiterung zu entdecken und zu erfahren:

Verpacken der Integration

1. Installieren Sie das Pakettool, falls noch nicht geschehen:

   npm install -g tfx-cli
   

2. Packen Sie Ihre Integration in eine VSIX-Datei:

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

   Tipp

   Verwenden Sie --rev-version, um die Patchversionsnummer automatisch zu erhöhen.

Veröffentlichen auf dem Marktplatz

Nachdem Ihre Erweiterung gepackt wurde, können Sie sie unter einem Herausgeber in den Marketplace hochladen. Der publisher in der Manifestdatei Ihrer Erweiterung angegebene Bezeichner muss mit dem Bezeichner des Herausgebers übereinstimmen, unter dem die Erweiterung hochgeladen wird.

1. Wählen Sie im Verwaltungsportal ihren Herausgeber im Dropdownmenü oben auf der Seite aus.

2. Wählen Sie "Neue Erweiterung>" in Azure DevOps aus.

   

3. Datei ziehen und ablegen oder darauf klicken, um nach der VSIX-Datei zu suchen, die Sie im vorherigen Verpackungsschritt erstellt haben, und wählen Sie dann "Hochladen" aus.

   

   Nach der schnellen Überprüfung wird Ihre Erweiterung in der Liste der veröffentlichten Erweiterungen angezeigt. Keine Sorge, die Erweiterung ist nur für Sie sichtbar.

   

An diesem Punkt ist Ihre Erweiterung für keine Konten sichtbar. Um sie für andere sichtbar zu machen, müssen Sie die Erweiterung freigeben.

Integration teilen

Bevor Sie eine Integration in einer Azure DevOps-Organisation installieren können, müssen Sie sie für diese Organisation freigeben.

1. Wählen Sie Ihre Integration aus der Liste der angezeigten Elemente aus.
2. Wählen Sie Freigeben.
3. Geben Sie den Organisationsnamen ein (z. B fabrikam-fiber-inc . für dev.azure.com/fabrikam-fiber-inc).

Aktualisieren der Integration

Führen Sie die folgenden Schritte aus, um eine bereits veröffentlichte Erweiterung zu aktualisieren:

1. Wählen Sie Ihre Erweiterung aus der Liste der angezeigten Elemente aus.
2. Klicken Sie mit der rechten Maustaste, und wählen Sie "Aktualisieren" für die Entwicklungsversion aus, wie publisher.extension-dev.
3. Überprüfen Sie Ihre Erweiterung.
4. Wenden Sie dieselben Updates auf die Produktionsversion an, wie publisher.extension.
5. Navigieren Sie zur VSIX-Datei für Ihre Erweiterung, und laden Sie sie hoch.

Azure DevOps installiert automatisch die aktualisierte Version für alle Konten, die bereits über die Erweiterung verfügen. Neue Installationen erhalten auch die neueste Version.

Mach die Integration öffentlich

Um Ihre Integration für alle Marketplace-Benutzer sichtbar zu machen, legen Sie die Kennzeichnung in Ihrem Manifest fest und veröffentlichen Sie sie erneut.

Weitere Informationen zu den für öffentliche Einträgen erforderlichen Qualifikationen finden Sie unter "Veröffentlichen Ihrer Erweiterung".

Verwandte Inhalte

• Erweiterungsmanifestreferenz
• Erweiterungen verpacken und veröffentlichen
• Visual Studio Marketplace