步骤一：创建应用
参考以下步骤，在钉钉开放平台上创建企业内部H5微应用，并完成基础配置：
- 使用钉钉开发者账号登录开发者后台。
说明
只有管理员和子管理员可登录开发者后台。 - 在开发者后台页面，单击应用开发，然后选择企业内部开发 > H5微应用，最后单击创建应用。
- 在弹出的创建应用页面中填写基本信息，然后单击确定创建。
- 应用类型：选择H5微应用。
- 开发方式：选择企业自助开发。
- 应用创建完成后，在凭证与基础信息页面，复制应用的AgentId、AppKey和AppSecret备用。
- 单击开发管理进入开发管理页面，然后单击修改，并根据以下内容配置开发信息。
- 开发模式：选择开发应用。
注意
如果选择了快捷链接，创建完应用以后不会生成AppKey，也意味着创建的应用无法调用钉钉的服务端接口，也无法调用钉钉的前端接口。 - 服务器出口IP：输入调用钉钉服务端API时使用的IP即企业服务器的公网IP，多个IP请以英文逗号","隔开，支持带一个*号通配符的IP格式。最多可以设置20个，符合IPV4规则。
- 应用首页地址：输入应用首页URL，在移动端工作台点击应用图标会跳转到此页面。可输入后端服务部署的服务器的IP或域名。
- 单击权限管理进入权限管理页面，然后根据以下配置添加接口调用权限。说明权限管理主要包含基础权限、高级权限-微应用、高级权限-企业通讯录三个部分，还包括特殊权限申请。建议开发者自助按需申请接口权限，合理设置权限的范围。
- 权限范围选择全部员工，然后单击添加接口权限。
- 选择通讯录权限，单击确认。
步骤二：开发H5微应用
创建应用成功后，参考以下操作完成服务部署：
- 下载服务端代码。
git clone https://github.com/open-dingtalk/org-H5-application-tutorial.git
- 导入服务端代码。
- 运行IntelliJ IDEA，然后在启动页面单击Open。
- 将下载好的服务端代码导入到项目工程。
- 单击OK，完成服务端的部署。
- 配置服务端代码。修改
backend/src/main/resources/application.properties文件中的参数值。
- dingtalk.app_key：应用的唯一身份标识，填写创建应用时复制的AppKey。
- dingtalk.app_secret：对应的调用密钥，填写创建应用时复制的AppSecret。
- dingtalk.agent_id：微应用ID，填写创建应用时复制的AgentId。
- dingtalk.corp_id：应用所属的CorpId。CorpId可以在开发者后台首页获取。
- 启动后端服务。
打开backend/src/main/java/com/dingtalk/Application.java文件，运行后端服务。
- 在浏览器中访问http://localhost:8080/welcome检查服务是否启动成功。显示如下页面表示启动成功。
步骤三：发布H5微应用
后端服务启动成功后，参考以下步骤完成测试并发布H5微应用。
- 登录开发者后台，单击已创建的H5微应用。
- 在应用详情页，单击版本管理与发布，然后单击添加添加可测试微应用的人员。
- 在钉钉手机客户端打开工作台，切换到应用的所属组织，然后打开创建的H5微应用。
- 能够正常显示当前用户的部门信息（如下图所示），表示微应用已成功部署。
- 发布应用
完成测试后，登录开发者后台，在应用详情页单击版本管理与发布，然后单击确认发布。应用发布后，该应用将会出现在钉钉的工作台上，企业组织内部的用户将会看到该应用。
