《钉钉应用开发者速成手册》之“钉钉应用开发入门——H5微应用”

步骤一：创建应用

参考以下步骤，在钉钉开放平台上创建企业内部H5微应用，并完成基础配置：

1. 使用钉钉开发者账号登录 开发者后台

   。

   说明

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

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

   

3. 在弹出的创建应用页面中填写基本信息，然后单击确定创建。

• • 应用类型：选择H5微应用。
  • 开发方式：选择企业自助开发。

1. 应用创建完成后，在凭证与基础信息页面，复制应用的AgentId、AppKey和AppSecret备用。

   

2. 单击开发管理进入开发管理页面，然后单击修改，并根据以下内容配置开发信息。

• • 开发模式：选择开发应用。

    注意

    如果选择了快捷链接，创建完应用以后不会生成AppKey，也意味着创建的应用无法调用钉钉的服务端接口，也无法调用钉钉的前端接口。

  • 服务器出口IP：输入调用钉钉服务端API时使用的IP即企业服务器的公网IP，多个IP请以英文逗号","隔开，支持带一个*号通配符的IP格式。最多可以设置20个，符合IPV4规则。
  • 应用首页地址：输入应用首页URL，在移动端工作台点击应用图标会跳转到此页面。可输入后端服务部署的服务器的IP或域名。

1. 单击权限管理进入权限管理页面，然后根据以下配置添加接口调用权限。说明权限管理主要包含基础权限、高级权限-微应用、高级权限-企业通讯录三个部分，还包括特殊权限申请。建议开发者自助按需申请接口权限，合理设置权限的范围。

1. 1. 权限范围选择全部员工，然后单击添加接口权限。
   2. 选择通讯录权限，单击确认。

      

步骤二：开发H5微应用

创建应用成功后，参考以下操作完成服务部署：

1. 下载服务端代码。

git clone https://github.com/open-dingtalk/org-H5-application-tutorial.git      

1. 导入服务端代码。

1. 1. 运行IntelliJ IDEA，然后在启动页面单击Open。

      

   2. 将下载好的服务端代码导入到项目工程。

      

   3. 单击OK，完成服务端的部署。

1. 配置服务端代码。修改

   backend/src/main/resources/application.properties

   文件中的参数值。

   

• • dingtalk.app_key：应用的唯一身份标识，填写创建应用时复制的AppKey。
  • dingtalk.app_secret：对应的调用密钥，填写创建应用时复制的AppSecret。
  • dingtalk.agent_id：微应用ID，填写创建应用时复制的AgentId。
  • dingtalk.corp_id：应用所属的CorpId。CorpId可以在 首页获取。

1. 启动后端服务。

   打开

   backend/src/main/java/com/dingtalk/Application.java

   文件，运行后端服务。

   

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

   

步骤三：发布H5微应用

后端服务启动成功后，参考以下步骤完成测试并发布H5微应用。

1. 登录 ，单击已创建的H5微应用。

   

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

   

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

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

   

2. 发布应用

   完成测试后，登录

   ，在应用详情页单击版本管理与发布，然后单击确认发布。应用发布后，该应用将会出现在钉钉的工作台上，企业组织内部的用户将会看到该应用。