详解Office Add-in 清单文件

作者：陈希章 发表于2017年12月8日

前言

我们都知道，一个Office Add-in，最主要是由两个部分组成的：清单文件（manifest）和真正要用来执行的网站。

清单文件其实是一个标准的XML文件，它有固定的Schema。目前来说，最新版本的清单文件必须指定“http://schemas.microsoft.com/office/appforoffice/1.1”作为Schema，否则某些功能可能不能正常工作。当然，指定Schema这件事情你可能不太会需要手工去做，毕竟不管你是用Visual Studio的项目模板，还是用其他开发工具（例如Visual Studio Code），清单文件都是自动生成的，而且默认就已经指定了1.1这个版本。下面两篇文章介绍了如何在不同工具开始office Add-in的开发。

• 在Visual Studio 中开发Office Add-in
• 在Visual Studio Code中开发Office Add-in

一个典型的清单文件看起来是下面这样的

在Visual Studio中，有时候会用可视化界面，取代纯文本的XML编辑界面，例如下面这样

平胸而论，Visual Studio 提供了对于清单文件的最佳编辑体验，因为它会自动根据Schema提供智能感知，甚至如你刚才看到的那样，它甚至提供了可视化界面，我爱死这个功能了。

下面我会从三个方面分别对清单文件进行详细介绍

1. 基本属性定义
2. 通过清单文件自定义Ribbon和快捷菜单
3. 通过清单文件是实现多语言支持

基本属性定义

清单文件中的根元素是OfficeApp，这里会指定几个namespace，但同时会有一个至关重要的属性：xsi:type，目前我们支持三种不同类型的Office Add-in，分别是

1. ContentApp，这是内容应用，主要是在Excel和PowerPoint中能用。通过这类Add-in，可以为宿主程序添加自定义的内容元素，例如一个自定义地图之类的。
2. TaskPaneApp，这是应用最广的类型。通过这类Add-in，可以为宿主程序添加自定义的功能，例如通过一个自定义菜单，执行某些操作。
3. MailApp，这是专用于Outlook的Add-in。

除此之外，OfficeApp这个根元素，还需要包含如下的基本元素

1. Id，唯一的编号（一个GUID）
2. Version，这个版本信息在你更新时可能需要修改
3. ProviderName，作者及公司信息
4. DefaultLocale，默认的语言，格式是类似于en-US这样的。我在下面还会介绍多语言支持的功