如果想要使用预览版本的SharePoint Framework打包和部署client-side web part,你需要有开启First Release的Office 365环境。
注册Office365环境
如果你已经有Office 365的环境,请见如何创建App Catalog站点,请确保你的环境已经开启了
First Release。如果你没有Office 365环境,请去
Office Developer Program注册,你将会收到一个欢迎注册使用的邮件。微软会提供一个免费一年的Office 365 Developer Tenant,并且默认已经开启了First Release。
注意:
1,在你注册之前,请确保你已经从其它的Office 365 tenants中退出。
3,经过本人测试,已有的Office 365 tenant在开启First Release之后,上传到AppCatalog中的App包无法正常识别,所以建议还是申请Developer tenant环境。
创建App Catalog站点
你需要创建一个app catalog站点用于上传app包并且deploy web parts,如果你已经创建了App Catalog站点请参见创建
Developer站点。
通过下面的URL进入SharePoint 管理中心,需要把
yourtenantprefix替换成自己的Office 365 Developer Tenant的前缀
https://yourtenantprefix-admin.sharepoint.com
在左侧的餐单中点击apps
之后选择App Catalog,点击OK键用于创建App Catalog 站点,在页面中输入如下信息:
- 标题:站点的标题,例如输入App Catalog
- 站点URL后缀:输入apps
- 管理员:输入站点的管理员
点击OK之后就会创建App Ctatalog站点
创建Developer站点
你同时需要创建一个Developer站点,如果你已经有Developer站点,那面请见配置Document Library
通过下面的URL进入SharePoint 管理中心,需要把
yourtenantprefix替换成自己的Office 365 Developer Tenant的前缀
https://yourtenantprefix-admin.sharepoint.com
在弹出的页面中输入如下信息:
Title:站点的标题,例如:Developer
站点URL后缀:例如:Developer
Template Selection:选择Developer site
Administrator:输入站点的管理员
点击OK会为你创建对应的site collection。
配置Document Library
你需要在Developer站点中使用SharePoint Workbench去测试你的webpart,SharePoint Workbench是开发人员设计界面,用于不需要部署到站点的时候,快速预览和测试webpart。这个过程需要使用站点中的一个默认的文档库Documents。
- 下载workbench.aspx到本机
- 上传这个文件到Documents中
排错处理
如果你使用self-service creation的站点作为测试站点会得到一个错误,我们推荐使用Developer站点进行测试,如果你上传workbanch.aspx的时候遇到如下错误:
"The requested operation is part of an experimental feature that is not supported in the current environment. The requested operation is part of an experimental feature that is not supported in the current environment."
那么是因为你的Office 365环境没有开启First Release,当你需要部署client-side webpart的时候“Custom Script” feature也需要在对应的网站集中开启。
注意:SharePoint Framework目前正处于Preview阶段,随时会进行一些更改。SharePoint Framework Client-side web parts在Office 365的生产环境中暂时不支持。