钉钉开发文档

真机预览

更新时间: 2018-9-19

发布版本

打开钉钉应用开发工具IDE,参考IDE使用提交一个开发版本,在开发者后台应用的版本管理里面可以看到一个版本列表。

image.png

灰度

可以按照企业维度进行版本灰度,配置需要灰度的企业的corpId即可。只有在灰度企业名单里面的企业才能通过授权开通预览该灰度版本应用。

发布

版本发布之后,所有该应用的开通企业均可以看到该版本的应用。

授权开通

在版本管理点击添加体验组织,或者在左侧菜单栏直接点击体验账号管理进入管理页面,添加一个体验组织,并选择该企业开通应用(注意添加体验组织是创建一个全新的测试类型的组织,而不是关联已有的组织变为体验组织)。如果您希望为体验组织添加成员,请登录钉钉管理后台,为体验组织添加成员,添加方法见注册账号

注意:正式应用创建时填写的回调地址能够正常接收和处理推送,才能成功开通微应用,具体详情查看回调接口。测试应用可暂时忽略回调处理,也可正常开通

image.png

体验组织管理页面

image.png

授权开通应用型

image.png

真机体验应用

真机体验有三种形式:

1 IDE扫码预览:

IDE上选择好已经开通应用的组织生成二维码,并通过手机扫码体验,此预览为当前代码打包的实时效果。
参考IDE扫码

2 开发者后台扫码体验版预览:

在IDE里上传版本后设置为体验版,在体验组织记录里点击二维码扫码,此预览为上传版本的效果。
如下图所示,先选择您的开发组织,再选择您开发的应用,点击上传。

image.png

设置体验版,点击体验二维码扫码

image.png

3 工作台体验:

通过手机工作台,选择已经开通本应用的组织,点击应用图标真机体验。此时的版本必须是给此测试组织设置了灰度,或者是已经正式发布了线上的版本。(灰度版优先级高于线上版,也就是说一旦设置了灰度,您体验到的是灰度版本)

打开钉钉手机客户端,切换到开通应用的应用企业下面,可以看到自己开发的应用。

IMG_0907(1).PNG

打开自己开发的应用进行预览

IMG_0908.PNG

请注意:如果您开发的前端代码访问的URL的Host是一个非公网IP,且真机与和应用服务端没有处于相同网络环境中(比如手机在4G网络),扫码打开应用,由于前端无法连接到应用服务端,会导致无法看到预期效果。

E应用前端向服务端发起网络请求时是直连安全域名或IP的,因此假如您的前端和服务端都在一个办公环境内(比如都在您的PC电脑上),是可以直接互通的,因此可以设置任何您的前端所在环境能连接到的域名或IP为安全域名。
您也可以通过钉钉提供的内网穿透工具生成一个临时二级域名给测试应用使用。