开发H5微应用 （钉钉）历史文档备份 供参考

链接 开发H5微应用 - 钉钉开放平台

步骤一：创建和配置应用

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

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

   说明

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

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

   

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

   • 应用类型：选择H5微应用。

   • 应用名称：输入应用名称，长度在2-20个字符。

   • 应用描述：简要描述应用提供的产品或服务，最多200个字符。

   • 应用图标：上传应用图标，要求JPG/PNG格式、240*240px以上、1:1 、2MB 以内的无圆角图标。

   • 开发方式：选择企业自主开发。

   

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. 选择通讯录部门信息读权限和通讯录部门成员读权限，然后单击申请权限。

      

步骤二：开发H5应用

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

说明

• 在调用钉钉服务端接口进行应用开发时，需要先调用获取企业内部应用的accessToken接口获取应用授权。

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

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

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

   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. 在已下载的示例代码项目下，执行以下代码完成代码编译。

   1

   mvn clean package

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

   1

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

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

   

步骤三：发布H5微应用

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

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

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

   

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

   

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

   

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

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