打包并发布系统集成

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

在 Visual Studio Marketplace 上发布与 Azure DevOps 集成的工具、服务或产品。 市场是用户发现集成和扩展的中心中心。

先决条件

在发布到市场之前，必须满足以下要求列表。

还需要以下资产：

• 您的集成至少要有一个截图
• 用户的引导操作或入门 URL

创建发布商

每个扩展或集成（包括来自Microsoft的扩展或集成）都必须具有发布者。 任何人都可以创建发布者并在其下发布扩展。 还可以与其他用户（例如开发团队）共享发布者访问权限。

1. 登录到 Visual Studio Marketplace 发布门户。

2. 如果你不是现有发布者的一部分，请选择“ + 创建发布者”。
   输入发布者名称;根据条目自动填充 ID 字段。

   

   注释

   • 确保发布者名称在多字节字符的 16 个字符内。
   • 保存发布者 ID - 需要在扩展的清单文件中使用它。

   如果未提示创建发布者，请滚动到“相关网站”下的“发布扩展”。

   • 设置唯一的发布者标识符，例如 mycompany-myteam。 请在清单中的publisher属性中使用此值。
   • 设置显示名称，例如 My Team。

3. 查看 市场发布者协议，然后选择“ 创建”。

   

创建发布者后，可以管理项目，尽管发布前不会显示任何项目。

设置项目结构

创建以下目录布局：

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 自动递增补丁版本号。

发布到应用市场

打包扩展后，您可以在某个发布者名下将其上传到应用市场。 publisher 扩展清单文件中指定的标识符必须与上传扩展的发布者的标识符匹配。

1. 在 管理门户中，从页面顶部的下拉菜单中选择发布者。

2. 选择 “新建扩展>Azure DevOps”。

   

3. 拖放文件或将其选中以查找在上一个打包步骤中创建的 VSIX 文件，然后选择“ 上传”。

   

   快速验证后，扩展将显示在已发布的扩展列表中。 别担心，扩展仅对你可见。

   

此时，你的扩展对任何帐户都不可见。 若要使它对其他人可见，需要共享扩展。

共享集成

必须先与该组织共享集成，然后才能在 Azure DevOps 组织中安装集成。

1. 从显示的项列表中选择集成项目。
2. 选择共享。
3. 输入组织名称（例如， fabrikam-fiber-inc for dev.azure.com/fabrikam-fiber-inc）。

更新系统集成

若要更新已发布的扩展，请执行以下步骤：

1. 从显示的项列表中选择扩展。
2. 右键单击并选择更新以更新开发版本，例如publisher.extension-dev。
3. 验证扩展。
4. 对生产版本应用相同的更新，例如 publisher.extension。
5. 找到您扩展的 .vsix 文件并上传它。

Azure DevOps 会自动安装已具有扩展的所有帐户的更新版本。 新安装还会收到最新版本。

公开集成

若要使集成对所有市场用户可见，请在清单中将public 标志设置为true并重新发布。

有关公共列表所需的资格的详细信息，请参阅 公开扩展。

相关内容

• 扩展清单引用
• 打包和发布扩展
• Visual Studio Marketplace