准备工作
1、需要成为钉钉开发者,详情请参考open.dingtalk.com/document/or…
2、需要下载安装小程序开发工具,地址:open.dingtalk.com/document/re…
3、HBuilderx,地址:www.dcloud.io/hbuilderx.h…
后面会介绍如何利用HBuilderx与小程序开发工具一起调试开发钉钉小程序
步骤一:创建企业内部应用-小程序
登录钉钉开发者后台,地址:oa.dingtalk.com/#/welcome 找到工作台》应用管理》创建应用,由于是自主研发,我们选择“通过开放接口与钉钉深度融合”,点击开始》创建应用:
我们选择小程序,填写名称、描述后,选择自主开发,最后确定创建即可,当然,在应用信息页面,我们还可以拿到Appkey,AppSecret等信息
步骤二:使用HBuilderx、小程序开发工具进行项目创建和关联应用
使用HBuilderx,创建uni-app项目,如果项目没有package.json文件,则需要创建,并在文件中,添加如图配置:
这样点击运行后就会出现“钉钉小程序”选项(注意:我们应该提前在Settings.json文件中,设置好支付宝开发者工具路径,也就是文章开头提到的小程序开发者工具安装路径,因为HBuilderx没有单独设置钉钉小程序配置,但是设置支付宝小程序开发者工具路径效果相同)
打开小程序开发工具后,我们需要手动打开工程项目,也就是这个地址:
否则,编译器会报错,找不到app.json
如上图,项目类型,我们选择企业内部应用,点击完成,就可以在工具中进行调试:
步骤三:发布
将上图左上角设置成后台创建的小程序,在右上角的上传版本,点击上传即可。 然后我们回到钉钉开发者后台open-dev.dingtalk.com/fe/app#/cor…
单击应用开发,进入创建的小程序主页,然后点击左侧菜单版本管理与发布:
在这里我们就可以发布我们的小程序。发布成功后,我们就可以在钉钉中看到小程序啦:
与H5微应用的区别
H5微应用的创建过程与小程序类似,只是,H5微应用需要在后台,应用开发》开发管理中配置应用地址首页:
如果配置PC端首页地址,那么在钉钉PC端打开应用后,就会访问该地址,如果不配置,就会提示让移动端打开此应用
而小程序也可以配置pc端首页地址,但是在pc端打开后,进入的不是小程序本身,而是该地址,所以开发前要考虑清楚,是做H5微应用还是小程序!!!
小程序:
- 如果发布时选择仅支持移动端,那么PC端无法打开该应用,如果配置PC端首页地址,则可以跳转该地址
- 如果发布时选择移动端PC端都支持,那么在PC端可以打开小程序,但是操作区域的宽高受限,如果配置PC端首页地址,则可以跳转该地址,如果删除PC端首页地址,则PC端无法打开
H5微应用:
- 必须配置应用首页地址
- 如果配置PC端首页地址,那么PC端打开应用就可以跳转该地址
- 如果不配置PC端首页地址,那么PC端无法打开该应用