步骤一:创建应用
参考以下步骤,在钉钉开放平台上创建企业内部小程序,并完成基础配置:
- 使用钉钉开发者账号登录开发者后台。
说明
只有管理员和子管理员可登录开发者后台。 - 在开发者后台页面,单击应用开发,然后选择企业内部开发 > 小程序,最后单击创建应用。
- 在弹出的创建应用页面中填写基本信息,然后单击确定创建。
- 应用类型:选择小程序。
- 开发方式:选择企业自助开发。
- 应用创建完成后,在凭证与基础信息页面,复制应用的AppKey和AppSecret备用。
- 单击开发管理进入开发管理页面,然后单击修改,并根据以下内容配置开发信息。
- 服务器出口IP:输入调用钉钉服务端API时使用的IP即企业服务器的公网IP,多个IP请以英文逗号","隔开,支持带一个*号通配符的IP格式。最多可设置20个,并且符合IPV4规则。
- PC端首页地址(可选):输入在PC端钉钉工作台上打开本应用的地址。链接地址必须以http或https开头。
- 管理后台地址(可选):输入组织管理员在钉钉管理后台访问该应用的地址。
- 单击人员管理,然后单击添加人员添加开发人员。
说明
应用创建后,默认开发人员为应用创建者。只有在这里添加了开发人员,开发人员才可以在小程序IDE中关联这个应用。 - 单击安全中心,然后单击添加添加一个HTTP安全域名。
安全域名是后端服务部署的服务器的公网IP或域名。当小程序的前端与服务端需要进行网络通信时,需要设置安全域名。小程序前端只能通过已设置的安全域名(或IP)与服务端进行网络通信。当安全域名更新时,需要在小程序开发工具重新打包上传版本,设置的域名才会生效。 - 单击权限管理进入权限管理页面,然后根据以下配置添加接口调用权限。说明权限管理主要包含基础权限、高级权限-微应用、高级权限-企业通讯录三个部分,还包括特殊权限申请。建议开发者自助按需申请接口权限,合理设置权限的范围。本教程中需要调用接口获取用户的姓名和userid,所以需要先添加通讯录接口权限。
- 权限范围选择全部员工,然后单击添加接口权限。
- 选择通讯录 > 通讯录只读权限,单击确认。
步骤二:服务端开发
创建应用成功后,参考以下步骤完成服务端代码的配置部署:
- 下载服务端代码。
git clone https://github.com/open-dingtalk/org-mini-program-tutorial-java.git
- 导入服务端代码。
- 运行IntelliJ IDEA,然后在启动页面单击Open。
- 将下载好的服务端代码导入到项目工程。
- 单击OK,完成服务端的部署。
- 配置服务端代码。修改
src/main/java/com/dingtalk/constant/AppConstant.java
文件中参数值。
- AppKey:应用的唯一身份标识,填写创建应用时复制的AppKey。
- AppSecret:对应的调用密钥,填写创建应用时复制的AppSecret。
- 启动后端服务。
打开src/main/java/com/dingtalk/Application.java
文件,运行后端服务。 - 在浏览器中访问http://localhost:8080/welcome检查服务是否启动成功。
显示如下页面表示启动成功。
步骤三:前端开发
服务端代码配置部署成功后,参考以下步骤完成小程序前端代码的配置部署:
- 下载前端代码。
git clone https://github.com/open-dingtalk/org-mini-program-tutorial-front-end.git
- 导入前端代码。
小程序IDE工具,然后选择已下载的小程序项目,项目类型选择钉钉 > 企业内部应用,点击完成。 - 登陆IDE工具。
打开钉钉APP,扫码页面上的二维码。 - 关联已创建的小程序应用小程序Demo。
说明
如果无法关联小程序,登录开发者后台,检查开发人员是否已添加到应用的人员管理列表。 - 配置前端代码。打开
org-mini-program-tutorial-front-end/page/index/index.js
文件修改配置信息。注意URL中的IP或者域名必须是开发者后台台中设置的本应用的安全域名。
- domain:开发者后台设置的安全域名。
- url:服务端接口访问路径。
- 单击点击登录调试小程序,查看是否可以成功获取登录信息。
步骤四:上传发布小程序
前端代码配置部署成功后,参考以下步骤完成上传和发布小程序:
- 单击上传,确认小程序版本,然后再次单击上传。
- 上传成功后,打开开发者后台,在应用详情页面,单击版本管理与发布,然后选择已上传的版本,再单击发布。
- 默认发布后企业内部成员可使用该版本的应用。您可以选择使用该应用的用户范围,然后单击保存修改。