Veröffentlichen über die Befehlszeile

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

Sie können die plattformübergreifende CLI für Azure DevOps (tfx-cli) verwenden, um Ihre Erweiterung im Visual Studio Marketplace zu veröffentlichen.

Weitere Informationen finden Sie in der Übersicht über die Veröffentlichung, Installation und Freigabe.

Voraussetzungen

Rufen Sie die TFX CLI von Node Paket-Manager ab und generieren Sie ein persönliches Zugriffstoken (PAT). Wenn Noch nicht geschehen, richten Sie außerdem einen Publisher im Katalog ein.

Erwerben der plattformübergreifenden CLI für Azure DevOps

1. Wenn Sie dies nicht haben, laden Sie NodeJS herunter, und installieren Sie es. Stellen Sie während der Einrichtung sicher, dass Sie "Zu PATH hinzufügen" ausgewählt lassen.

2. Öffnen Sie eine Eingabeaufforderung, und geben Sie ein npm i -g tfx-cli.

Wenn Sie die TFX CLI bereits installiert haben, können Sie auf die neueste Version aktualisieren, indem Sie diese ausführen npm up -g tfx-cli.

Erstellen eines persönlichen Zugriffstokens

1. Melden Sie sich bei Ihrem organization (https:dev.azure.com/{organization}) an.

2. Öffnen Sie auf Ihrer Startseite das Symbol "Benutzereinstellungen", und wählen Sie dann "Profil" aus.

   

3. Wählen Sie unter "Sicherheit" "Persönliche Zugriffstoken" und dann "Neues Token" aus.

   

4. Füllen Sie das Formular aus:

   • Benennen Des Tokens
   • Wählen Sie "Alle barrierefreien Organisationen" aus, was der einzige Wert ist, der bei der Veröffentlichung über CLI funktioniert. Wenn Sie nur eine Organisation auswählen, führt dies zu einem Fehler, auch wenn der PAT gültig ist.
   • Wählen Sie einen Ablaufzeitrahmen für Ihr Token aus. Dies ist erforderlich, da die Visual Studio Marketplace-Veröffentlichungs-APIs außerhalb des Kontexts einer Organisation funktionieren.
   • Legen Sie den Bereich des Zugriffs fest, der diesem Token zugeordnet ist. Stellen Sie sicher, dass Sie den Marketplace-Bereich (Veröffentlichen) auswählen. Dieser Bereich beschränkt das Token auf die Möglichkeit, Erweiterungen nur auf dem Marketplace zu veröffentlichen.
   • Klicken Sie auf Erstellen

   

5. Kopieren Sie Ihr generiertes persönliches Zugriffstoken. Stellen Sie sicher, dass Sie es geheim halten.

   

Veröffentlichen über die Befehlszeile

Sobald TFX CLI installiert ist und Sie ihren PAT haben, können Sie das Tool verwenden, um Ihre Erweiterung zu packen und zu veröffentlichen.

1. Öffnen Sie eine Eingabeaufforderung im Stammverzeichnis Ihrer Erweiterung.
2. Führen Sie den folgenden Befehl aus, um Die Erweiterung zu veröffentlichen. Wenn Sie dazu aufgefordert werden, geben Sie Ihr persönliches Zugriffstoken ein, um sich zu authentifizieren.

tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

Möglicherweise erhalten Sie die folgende Fehlermeldung, wenn Ihre Erweiterung bereits veröffentlicht wurde:

Failed Request: Internal Server Error(500) - Version number must increase each time an extension is published. Extension: fabrikam.my-extension  Current version: 0.1.9  Updated version: 0.1.9

Sie können das --rev-version Flag hinzufügen, um die Patchversion Ihrer Erweiterung automatisch zu erhöhen. Dadurch wird auch die neue Version in Ihrem Manifest gespeichert.

Hinweis

Alle verfügbaren create Optionen sind für den publish Befehl verfügbar.

Beispiel

C:\vso-team-calendar>tfx extension publish --publisher publishFabrikam --manifest-js fabrikam.config.js --share-with fabrikam --rev-version
Copyright Microsoft Corporation
> Personal access token:
Checking if this extension is already published
It is, update the extension
Waiting for server to validate extension package...
Sharing extension with fabrikam.

=== Completed operation: publish extension ===
 - Packaging: C:\vso-team-calendar\fabrikam.team-calendar-0.2.6.vsix
 - Publishing: success
 - Sharing: shared with fabrikam