步骤一：创建应用

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

1. 使用钉钉开发者账号登录开发者后台。
   
   说明
   只有管理员和子管理员可登录开发者后台。
   
2. 在开发者后台页面，单击应用开发，然后选择企业内部开发 > 小程序，最后单击创建应用。
   
3. 在弹出的创建应用页面中填写基本信息，然后单击确定创建。

• • 应用类型：选择小程序。
    
  • 开发方式：选择企业自助开发。
    

1. 应用创建完成后，在凭证与基础信息页面，复制应用的AppKey和AppSecret备用。
   
2. 单击开发管理进入开发管理页面，然后单击修改，并根据以下内容配置开发信息。

• • 服务器出口IP：输入调用钉钉服务端API时使用的IP即企业服务器的公网IP，多个IP请以英文逗号","隔开，支持带一个*号通配符的IP格式。最多可设置20个，并且符合IPV4规则。
    
  • PC端首页地址（可选）：输入在PC端钉钉工作台上打开本应用的地址。链接地址必须以http或https开头。
    
  • 管理后台地址（可选）：输入组织管理员在钉钉管理后台访问该应用的地址。
    

1. 单击人员管理，然后单击添加人员添加开发人员。
   
   说明
   应用创建后，默认开发人员为应用创建者。只有在这里添加了开发人员，开发人员才可以在小程序IDE中关联这个应用。
   
2. 单击安全中心，然后单击添加添加一个HTTP安全域名。
   安全域名是后端服务部署的服务器的公网IP或域名。当小程序的前端与服务端需要进行网络通信时，需要设置安全域名。小程序前端只能通过已设置的安全域名（或IP）与服务端进行网络通信。当安全域名更新时，需要在小程序开发工具重新打包上传版本，设置的域名才会生效。
   
3. 单击权限管理进入权限管理页面，然后根据以下配置添加接口调用权限。说明权限管理主要包含基础权限、高级权限-微应用、高级权限-企业通讯录三个部分，还包括特殊权限申请。建议开发者自助按需申请接口权限，合理设置权限的范围。本教程中需要调用接口获取用户的姓名和userid，所以需要先添加通讯录接口权限。

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

步骤二：服务端开发

创建应用成功后，参考以下步骤完成服务端代码的配置部署：

1. 下载服务端代码。

git clone https://github.com/open-dingtalk/org-mini-program-tutorial-java.git

1. 导入服务端代码。

1. 1. 运行IntelliJ IDEA，然后在启动页面单击Open。
      
   2. 将下载好的服务端代码导入到项目工程。
      
   3. 单击OK，完成服务端的部署。
      

1. 配置服务端代码。修改src/main/java/com/dingtalk/constant/AppConstant.java文件中参数值。

• • AppKey：应用的唯一身份标识，填写创建应用时复制的AppKey。
    
  • AppSecret：对应的调用密钥，填写创建应用时复制的AppSecret。
    

1. 启动后端服务。
   打开src/main/java/com/dingtalk/Application.java文件，运行后端服务。
   
2. 在浏览器中访问http://localhost:8080/welcome检查服务是否启动成功。
   显示如下页面表示启动成功。
   

步骤三：前端开发

服务端代码配置部署成功后，参考以下步骤完成小程序前端代码的配置部署：

1. 下载前端代码。

git clone https://github.com/open-dingtalk/org-mini-program-tutorial-front-end.git

1. 导入前端代码。
   小程序IDE工具，然后选择已下载的小程序项目，项目类型选择钉钉 > 企业内部应用，点击完成。
   
2. 登陆IDE工具。
   打开钉钉APP，扫码页面上的二维码。
   
3. 关联已创建的小程序应用小程序Demo。
   
   说明
   如果无法关联小程序，登录开发者后台，检查开发人员是否已添加到应用的人员管理列表。
   
4. 配置前端代码。打开org-mini-program-tutorial-front-end/page/index/index.js文件修改配置信息。注意URL中的IP或者域名必须是开发者后台台中设置的本应用的安全域名。

• • domain：开发者后台设置的安全域名。
    
  • url：服务端接口访问路径。
    

1. 单击点击登录调试小程序，查看是否可以成功获取登录信息。
   

步骤四：上传发布小程序

前端代码配置部署成功后，参考以下步骤完成上传和发布小程序：

1. 单击上传，确认小程序版本，然后再次单击上传。
   
2. 上传成功后，打开开发者后台，在应用详情页面，单击版本管理与发布，然后选择已上传的版本，再单击发布。
   
3. 默认发布后企业内部成员可使用该版本的应用。您可以选择使用该应用的用户范围，然后单击保存修改。