Script Lab 10:为Officejs开发配置VSCode环境(02)


【Office模板】

yoeman 其实是一个模板加载工具, 也叫生成器(generator),我们这里需在的是 Office 的模板,yoeman 还俱备查询功能,我们直接查询 Office 相关的模板。查到有两个跟Office相关的项目,我们得到了以下这条命令:

npm install -g generator-office

Script Lab 10:为Officejs开发配置VSCode环境(02)

默认会安装最新的Office模板@1.1.26,但是我推荐使用@1.1.5版本,俱备可以选择不建目录,最后还会有一个设置导航。


npm install -g generator-office@1.1.5

在知道原理后,我这里再提供一个更简单的安装方法,这里两个可以一并安装了:


npm install -g yo generator-office@1.1.5


【代码片段】

在 GitHubGist 上(https://gist.github.com/)组合搜索“yaml excel colorful”,其中 yaml 表示 Script Lab 代码片段,excel 表示这类插件,colorful 也可以替换所你感兴趣其它内容,以下为搜集结果:

Script Lab 10:为Officejs开发配置VSCode环境(02)

复制整个 yaml 格式的代码模板:

Script Lab 10:为Officejs开发配置VSCode环境(02)

【导出清单代码】

将刚才复制的代码导入到 Script Lab 中,通过导入命令,贴入完整代码即可:

Script Lab 10:为Officejs开发配置VSCode环境(02)

导出清单(manifest)和代码(html)


解压缩后得到,得到四个文件,新建一个目录,并将上面两个文件制复过去:


colorful-patterns.html
colorful-patterns--manifest.xml
colorful-patterns--snippet-data.yaml
README.md

【生成项目】

在 VSCODE 中,通过一句命令,来创建 Office Add-in 项目:


yo office

保留当前目录(Y),项目名称定一个(当前是:colorful-patterns),项目类型(Excel),创建项目代码,选择代码形式(TypeScript),项目生成后,选择项目引导(Y)。

Script Lab 10:为Officejs开发配置VSCode环境(02)

生成的文件目录结构如下:

Script Lab 10:为Officejs开发配置VSCode环境(02)



【替换关键文件】

以下是教程的最关键点,你可以将之前导出的文件(manifest+html),将其复制并粘贴到现有项目中,就可以轻松将Script Lab 转转换功能完备的web add-ins 插件项目了。

colorful-patterns--manifest.xml 复制到根目录(对应 colorful-patterns-manifest.xml 可删)

colorful-patterns.html 复制到 Scr 目录下(对应 index.html,可删)

【修改清单文件】

修改清单文件:colorful-patterns--manifest.xml

清单文件后面的课程中将会专题介绍,这里只提一下几个关键的修改点,最重要的一点是替换启动页面,将默认的index.html改为Script Lab 生成的页面:


<bt:Url id="Contoso.Taskpane.Url" DefaultValue="https://localhost:3000/colorful-patterns.html" />

清单文件中所有文字的地方,进行汉化或修改:

<DisplayName DefaultValue="对照汉化!" />
<Description DefaultValue="[对照汉化!]"/>
<bt:String id="Contoso.TaskpaneButton.Label" DefaultValue="对照汉化!" />
<bt:String id="Contoso.Group1Label" DefaultValue="对照汉化!" />
<bt:String id="Contoso.GetStarted.Title" DefaultValue="对照汉化!" />
<bt:String id="Contoso.TaskpaneButton.Tooltip" DefaultValue="对照汉化!" />
<bt:String id="Contoso.GetStarted.Description" DefaultValue="对照汉化!." />

【上传清单文件】

请按CTRL +`打开或返回集成终端。输入:

npm start

将在Chrome中打开您的项目。并可能会收到该站点不受信任的警告,单击“高级”并选择信任仍然/继续。或按照以下引导页进行认证主置,不在缀述:

Script Lab 10:为Officejs开发配置VSCode环境(02)

打开另一个选项卡,然后浏览到office365.com,登录帐户。在左上角的Office菜单上,单击Excel。在“插入”菜单上,单击“Office加载项”。在对话框的右上角,单击“上载我的加载项”。单击“浏览”,上传清单文件(colorful-patterns--manifest.xml)。的加载项现在将加载到“主页”选项卡上,切换到该选项卡,然后按“显示任务窗格”。

Script Lab 10:为Officejs开发配置VSCode环境(02)



以上步骤将向你展示如何将 Script Lab 转为一个完整的 Web Add-ins 加载项目,Office Online中测试它。

  1. 获取GIST代码片段;
  2. 导入Script Lab 并成生清单文件;
  3. 用 yeoman + Office 模板,生成空项目;
  4. 替换 manifest、html 文件
  5. 修改 manifest 文件
  6. 上传 Office Online

Script Lab 10:为Officejs开发配置VSCode环境(02)



上一篇:[20150527]bbed与数据块检查和2.txt


下一篇:MVC中,提交后界面Model值未能更新的原因及优化。