Office Add-ins 项目教程
1. 项目的目录结构及介绍
/office-add-ins
├── src
│ ├── index.html
│ ├── app.js
│ ├── styles.css
├── config
│ ├── manifest.xml
├── package.json
├── README.md
- src: 包含项目的主要源代码文件。
- index.html: 项目的主页面。
- app.js: 项目的主要JavaScript文件。
- styles.css: 项目的样式文件。
- config: 包含项目的配置文件。
- manifest.xml: 项目的清单文件,用于定义加载项的属性和功能。
- package.json: 项目的依赖和脚本配置文件。
- README.md: 项目的说明文档。
2. 项目的启动文件介绍
项目的启动文件是 src/index.html
,它包含了加载项的初始界面和必要的资源引用。以下是 index.html
的基本结构:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<title>Office Add-ins</title>
<link rel="stylesheet" href="styles.css" />
</head>
<body>
<h1>欢迎使用 Office Add-ins</h1>
<script src="app.js"></script>
</body>
</html>
<head>
部分包含了字符编码声明和样式文件的引用。<body>
部分包含了页面的主要内容和脚本文件的引用。
3. 项目的配置文件介绍
项目的配置文件主要位于 config
目录下,其中最重要的是 manifest.xml
。以下是 manifest.xml
的基本结构:
<?xml version="1.0" encoding="UTF-8"?>
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="TaskPaneApp">
<Id>your-app-id</Id>
<Version>1.0.0.0</Version>
<ProviderName>your-provider-name</ProviderName>
<DefaultLocale>zh-CN</DefaultLocale>
<DisplayName DefaultValue="Office Add-ins" />
<Description DefaultValue="A sample Office Add-ins" />
<IconUrl DefaultValue="https://your-icon-url.com/icon.png" />
<SupportUrl DefaultValue="https://your-support-url.com" />
<AppDomains>
<AppDomain>https://your-app-domain.com</AppDomain>
</AppDomains>
<Hosts>
<Host Name="Document" />
</Hosts>
<DefaultSettings>
<SourceLocation DefaultValue="https://your-app-url.com/index.html" />
</DefaultSettings>
<Permissions>ReadWriteDocument</Permissions>
</OfficeApp>
<Id>
: 加载项的唯一标识符。<Version>
: 加载项的版本号。<ProviderName>
: 加载项的提供者名称。<DefaultLocale>
: 加载项的默认语言。<DisplayName>
: 加载项的显示名称。<Description>
: 加载项的描述。<IconUrl>
: 加载项的图标URL。<SupportUrl>
: 加载项的支持URL。<AppDomains>
: 加载项的域名列表。<Hosts>
: 加载项支持的主机类型。<DefaultSettings>
: 加载项的默认设置,包括源文件位置。<Permissions>
: 加载项的权限设置。