VSIX 清单设计器

修改 VSIX 包清单文件，该文件设置 Visual Studio 扩展的安装行为。

VSIX 清单设计器映射到基础 VSIX 架构。 可以使用设计器中的相应控件来设置架构中的每个元素。 有关架构的详细信息，请参阅 VSIX 扩展架构 2.0 参考。

若要打开 VSIX 清单设计器，请在 解决方案资源管理器 中找到 source.extension.vsixmanifest 文件，然后打开该文件。 如果文件不包含有效的 XML，则清单设计器不会打开。

注意

生成 包时，source.extension.vsixmanifest 文件将输出到 extension.vsixmanifest 。

UIElement 列表

VSIX 清单设计器包含四个部分，这些部分对应于架构的这些顶级元素：

• 元数据
• 安装目标
• 资产
• 依赖项

标题区域包含以下控件：

• 产品名称描述扩展名称。
• 产品 ID 指定此包的唯一标识信息。
• 作者 指定扩展的作者的名称。
• 版本 指定扩展的版本号。

“ 元数据 ”选项卡包含以下控件：

• 说明提供要显示在扩展管理器中的扩展的文本说明。
• 语言 指定包的默认语言，该语言对应于清单中的文本数据。 该 Language 属性遵循资源程序集的公共语言运行时（CLR）区域设置代码约定，例如 en-us、en、fr-fr。 默认情况下，该值为中性值，这意味着包将在 Visual Studio 的任何语言版本上运行。
• 许可证 指定包含用户许可证的文本文件（如果存在）。
• 图标指定图形文件（.png、.bmp、.jpeg、.ico），其中包含在扩展管理器中显示的图标（如果存在图标）。 图标图像必须为 32x32 像素，或调整为这些尺寸的大小。 如果未指定任何图标， 则扩展管理器 使用默认图标。
• 预览图像指定要在扩展管理器中显示的预览图像（.png、.bmp、.jpeg、.ico）的图形文件（如果存在预览图像）。 预览图像必须为 200x200 像素。 如果未指定预览映像， 扩展管理器 将使用默认映像。
• 标记 添加要用于搜索提示的文本标记。
• 发行说明 指定包含发行说明的文件（.txt、 .rtf）。 还采用显示发行说明的网站 URL。
• 入门指南 指定文件 （.txt， .rtf），其中包含有关如何使用 VSIX 包中的扩展或内容的信息。 扩展安装完成后会显示本指南。 还采用显示指南的网站 URL。
• 详细信息 URL 指定包含有关产品的其他信息的网站的 URL。

“ 安装目标 ”选项卡包含以下控件：

• 安装 类型将 Visual Studio 扩展 和 扩展 SDK 列为目标安装类型。 选项因所选类型而异。

  • Visual Studio 扩展 列出了 InstallationTarget 元素，这些元素描述如何安装和安装此扩展的 Visual Studio 产品。 每个产品分别按名称和版本范围进行标识。 可以将产品添加到列表、修改和删除。 产品的名称和版本对应于关联的 InstallationTarget 元素的 ID 和 Version 属性。

    • 版本范围 为 [12.0， 14.0] 并使用以下表示法：
      • [ - 最低版本（非独占）
      • ] - 最大版本（非独占）
      • ( - 最低版本独占
      • ) - 最大版本独占
      • 单一版本 # - 仅指定版本

  • 扩展 SDK 指定不限定于特定产品和版本的全局安装。 目标平台标识符 是面向的平台，例如“Windows”。 目标平台版本 是目标平台的 8.0 版本。 SDK 名称和 SDK 版本 分别是 SDK 的名称和版本号。

• 此 VSIX 是针对所有用户安装的（需要安装时提升）。 如果选中此检查框，则为所有用户安装扩展;否则，它仅为当前用户安装。

• 此 VSIX 由 Windows Installer 安装。 如果选中此检查框，则扩展由 Windows Installer （.msi 文件）安装;否则，它安装为典型的 VSIX 包（.vsix 文件）。

“ 资产 ”选项卡包含以下控件：

• 资产 列表列出了描述此包显示扩展或内容元素的资产元素。 每个扩展或内容元素分别按源、类型和路径列出。 扩展和内容元素可以添加到列表、修改和删除。 扩展或内容元素的类型和路径对应于Type关联的Asset元素的和Path属性。 以下是已知的类型：

  • Microsoft.VisualStudio.Package
  • Microsoft.VisualStudio.MefComponent
  • Microsoft.VisualStudio.ToolboxControl
  • Microsoft.VisualStudio.Samples
  • Microsoft.VisualStudio.ProjectTemplate
  • Microsoft.VisualStudio.ItemTemplate
  • Microsoft.VisualStudio.Assembly
  • Microsoft.ExtensionSDK

  若要添加或编辑资产，必须指定资产类型、资产是当前解决方案中的项目还是文件系统中的文件，以及项目的名称。 还可以指定要在其中嵌入的文件夹的名称。

  还可以创建自己的类型，并为其提供唯一的名称。

“ 依赖项 ”选项卡包含以下控件：

• 名称、源和版本范围 列出了此包的依赖项元素，这些元素是此包所依赖的其他包。 如果指定了依赖项包，则必须在安装此包之前安装它;否则，此包必须安装它。

  依赖项包由标识符、名称、版本范围、源以及依赖项解析方式指定。 每个依赖项包按名称、版本和源单独列出。 依赖项包可以添加到列表、修改和删除。

  标识符必须与依赖项包元数据的属性匹配 ID 。 源可以是当前解决方案中的项目、当前安装的扩展或文件。 依赖项解析方式设置可以是嵌套包的相对路径或依赖项下载位置的 URL。 依赖项包的 ID、版本和解析对应于Id关联Dependency元素的 IDVersion、版本和Location解析。

另请参阅

• VSIX 扩展架构 2.0 参考
• VSIX 包剖析