Office Add-in 示例项目教程

项目介绍

Office Add-in 示例项目是一个由 Microsoft OfficeDev 团队维护的开源项目，旨在帮助开发者学习和构建 Office 插件。该项目提供了丰富的代码示例，涵盖了从简单的“Hello World”插件到复杂的业务逻辑实现。通过这些示例，开发者可以快速理解 Office Add-in 的基本组件和开发流程，并将其应用于实际项目中。

项目快速启动

1. 克隆项目仓库

首先，克隆 Office Add-in 示例项目的 GitHub 仓库到本地：

git clone https://github.com/OfficeDev/Office-Add-in-samples.git

2. 安装依赖

进入项目目录并安装所需的依赖：

cd Office-Add-in-samples
npm install

3. 运行示例

选择一个示例项目，例如 excel-hello-world，进入该目录并运行本地服务器：

cd excel-hello-world
npm start

4. 加载插件

在 Excel 中，通过“插入”选项卡中的“我的加载项”按钮，选择“从文件上传”，然后选择 manifest.xml 文件来加载插件。

应用案例和最佳实践

1. 数据类型浏览器

该示例展示了如何在 Excel 中创建和探索数据类型。数据类型允许开发者将复杂的数据结构组织为对象，如格式化的数值、网络图像和实体值。

2. 自定义上下文选项卡

该示例展示了如何在 Office UI 中创建自定义上下文选项卡。当用户将焦点移动到表格内部时，自定义选项卡会显示；当用户移出表格时，选项卡会隐藏。

3. 使用键盘快捷键

该示例展示了如何设置一个基本的 Excel 插件项目，使其利用键盘快捷键。

典型生态项目

1. Blazor WebAssembly

该项目展示了如何使用 .NET Blazor WebAssembly 技术构建 Office Web 插件。开发者可以将大部分代码保留在 C# 和 Visual Studio 中。

2. 单点登录 (SSO)

该项目展示了如何使用 Office 的 SSO 功能来访问用户的 Microsoft Graph 数据。通过 SSO，插件可以无缝地访问用户的 OneDrive 文件等信息。

3. 共享运行时

该项目展示了如何设置一个基本项目，使用共享运行时在单个浏览器运行时中运行代码，包括功能区按钮、任务窗格和自定义函数。

通过这些示例和生态项目，开发者可以深入了解 Office Add-in 的开发和应用，从而构建出功能强大且用户友好的 Office 插件。