快速开发钉钉H5微应用

以获取当前用户的部门信息的H5微应用为例，帮助您快速了解钉钉H5微应用的开发流程。

介绍内容：

• H5微应用的开发、发布流程

• 如何实现应用内免登

• 如何获取用户的通讯录信息

 

准备工作

• 注册了钉钉管理员账号。若未注册，单击这里完成注册。

• 本教程中的示例Demo使用Java开发，确保您已经安装了Java开发环境（安装JDK）以及Java项目构建工具Maven。

步骤一：创建和配置应用

参考以下操作，创建一个应用：

1. 登录钉钉开发者后台。

   说明 

   只有管理员和子管理员可登录开发者后台。

2. 在应用开发页面，选择企业内部开发 > H5微应用，然后单击创建应用。

   

3. 填写应用的基本信息，然后单击确定创建。

   1. 应用类型：选择H5微应用。

   2. 开发方式：选择企业自助开发。

      

4. 在应用信息页面，单击开发管理，然后单击修改。

   

5. 根据以下信息配置开发信息，然后单击保存。

   • 开发模式：本教程中选择开发应用。

     • 开发应用：开发一个完整的H5应用。

     • 快捷链接：已有可接入的H5应用时，选择该方式。详情请参考创建快捷链接。

   • 服务器出口IP：输入调用钉钉服务端API时使用的IP即企业服务器的公网IP，多个IP请以","隔开，支持带一个*号通配符的IP格式。

     本教程中输入127.0.0.1。

   • 应用首页地址：输入应用首页URL，在移动端工作台点击应用图标会跳转到此页面。可输入后端服务部署的服务器的IP或域名。例如：http://公网IP:8080。

   • PC端首页地址（可选）：输入在PC端钉钉工作台上打开本应用的地址。链接地址必须以http或https开头。

     说明 

     如果未填写，在钉钉PC端工作台点击应用图标时，会提示“电脑版暂不支持显示，请用手机钉钉扫描下方二维码查看”。只能在手机钉钉客户端使用该应用。

   • 管理后台地址（可选）：输入管理后台地址。组织管理员可以在钉钉管理后台通过该链接进行应用配置。

     

6. 单击凭证与基础信息获取应用的AppKey和AppSecret。

   

7. 本教程中的示例需要获取通讯录权限，参考以下操作添加接口权限：

   1. 在应用信息页面，单击权限管理。

   2. 权限范围选择全部员工，然后单击添加接口权限。

      

   3. 选择通讯录只读权限，然后单击确认。

      

步骤二：开发H5应用

为方便开发者快速体验，可直接使用钉钉提供的代码示例。

说明

 

• 在调用钉钉服务端接口进行应用开发时，需要先调用获取access_token接口获取应用授权。

• 此外，应用创建后默认只开放登录和消息通知接口的调用权限，您需要根据开发需要，添加对应的接口使用权限。

参考以下操作，下载示例代码并完成服务部署：

1. 执行以下命令，下载服务端代码。

   git clone https://github.com/open-dingtalk/h5app-corp-quickstart.git

2. 打开下载的代码工程，在backend/src/main/resources/application.properties文件中提供以下参数值：

   • dingtalk.app_key：已创建应用的AppKey。

   • dingtalk.app_secret：已创建应用的AppSecret。

   • dingtalk.agent_id：已创建应用的AgentId。

     在开发者后台的应用详情—凭证与基础信息页面查看AppKey、AppSecret和AgentId。

     

   • dingtalk.corp_id：应用所属的CorpId。CorpId可以在开发者后台首页获取。

     

3. 在已下载的示例代码项目下，执行以下代码完成代码编译。

   mvn clean package

4. 执行以下命令，启动后端服务。

   java -jar backend/target/backend-1.0.0-SNAPSHOT.jar

   在浏览器中访问http://localhost:8080/welcome检查服务是否启动成功。显示如下页面表示启动成功。

   

步骤三：发布H5微应用

参考以下操作，体验和发布H5微应用：

1. 登录钉钉开发者后台，单击已创建的H5微应用。

   

2. 在应用详情页，单击版本管理与发布，然后单击添加添加可测试微应用的人员。

   

3. 在钉钉手机客户端打开工作台，切换到应用的所属组织，然后打开创建的H5微应用。

   

4. 能够正常显示当前用户的部门信息（如下图所示），表示微应用已成功部署。

   

5. 完成测试后，登录钉钉开发者后台，在应用详情页单击版本管理与发布，然后单击确认发布。

   应用发布后，该应用将会出现在钉钉的工作台上，企业组织内部的用户将会看到该应用。

 

附：

钉钉开放平台官网

钉钉开发文档

钉钉开发者后台