統合をパッケージ化して発行する

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

Visual Studio Marketplace で Azure DevOps と統合するツール、サービス、または製品を発行します。 Marketplace は、ユーザーが統合と拡張機能を検出するための中心的なハブです。

[前提条件]

Marketplace に発行する前に、次の要件の一覧を満たす必要があります。

また、次の資産も必要です。

• 統合の少なくとも 1 つのスクリーンショット
• ユーザーに行動を促すまたは開始する URL

パブリッシャーを作成する

Microsoft からの拡張機能や統合を含め、すべての拡張機能または統合には発行元が必要です。 誰でもパブリッシャーを作成し、その下に拡張機能を発行できます。 また、開発チームなどの他のユーザーとパブリッシャー アクセスを共有することもできます。

1. Visual Studio Marketplace 発行ポータルにサインインします。

2. 既存のパブリッシャーの一部でない場合は、[ + 発行元の作成] を選択します。
   発行元名を入力します。ID フィールドは、入力に基づいて自動入力されます。

   

   注

   • 発行元名がマルチバイト文字の場合は 16 文字以内であることを確認します。
   • 発行元 ID を保存します。これは拡張機能のマニフェスト ファイルに必要です。

   発行元の作成を求めるメッセージが表示されない場合は、[関連サイト] の下の [拡張機能の発行] までスクロールします。

   • mycompany-myteamなど、一意の発行元識別子を設定します。 マニフェストの publisher 属性にこの値を使用します。
   • My Teamなどの表示名を設定します。

3. Marketplace パブリッシャー契約を確認し、[作成] を選択します。

   

発行元を作成した後は、アイテムを管理できますが、発行するまでアイテムは表示されません。

プロジェクト構造を設定する

次のディレクトリ レイアウトを作成します。

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

マニフェストを作成する

次の内容で vss-integration.json を作成し、統合の値を更新します。

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

次の参照を使用してフィールドを更新します。

次のプロパティが必要です。

次の省略可能なプロパティは、ユーザーが拡張機能を検出して学習するのに役立ちます。

統合をパッケージ化する

1. まだインストールしていない場合は、パッケージ化ツールをインストールします。

   npm install -g tfx-cli
   

2. 統合を .vsix ファイルにパッケージ化します。

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

   ヒント

   --rev-versionを使用して、パッチのバージョン番号を自動的にインクリメントします。

Marketplace に発行する

拡張機能がパッケージ化されたら、パブリッシャーの下の Marketplace にアップロードできます。 publisherで指定された識別子は、拡張機能がアップロードされる発行元の識別子と一致する必要があります。

1. 管理ポータルから、ページの上部にあるドロップダウン メニューから発行元を選択します。

2. [ 新しい拡張機能>Azure DevOps] を選択します。

   

3. ファイルをドラッグ アンド ドロップするか選択して、前のパッケージ化手順で作成した VSIX ファイルを見つけて、[ アップロード] を選択します。

   

   クイック検証の後、公開されている拡張機能の一覧に拡張機能が表示されます。 心配しないでください。拡張機能はユーザーにのみ表示されます。

   

この時点で、拡張機能はどのアカウントにも表示されません。 他のユーザーに表示できるようにするには、拡張機能を共有する必要があります。

統合を共有する

Azure DevOps 組織に統合をインストールする前に、その組織と統合を共有する必要があります。

1. 表示される項目の一覧から統合を選択します。
2. 共有を選択します。
3. 組織名を入力します（例: fabrikam-fiber-inc の場合、dev.azure.com/fabrikam-fiber-inc）。

統合を更新する

既に発行した拡張機能を更新するには、次の手順を実行します。

1. 表示される項目の一覧から拡張機能を選択します。
2. など、開発バージョンのpublisher.extension-devを右クリックして選択します。
3. 拡張機能を検証します。
4. publisher.extensionなど、運用環境のバージョンに同じ更新プログラムを適用します。
5. 拡張機能の .vsix ファイルを参照してアップロードします。

Azure DevOps は、既に拡張機能を持つすべてのアカウントの更新されたバージョンを自動的にインストールします。 新しいインストールも最新バージョンを受け取ります。

統合をパブリックにする

統合をすべての Marketplace ユーザーに表示するには、マニフェストで フラグを となるように設定し、再発行します。

公開リストに必要な資格の詳細については、「 拡張機能を公開する」を参照してください。

関連するコンテンツ

• 拡張機能マニフェスト参照
• パッケージ化と公開の拡張機能
• Visual Studio Marketplace