《钉钉应用开发者速成手册》之“钉钉应用开发入门——小程序”

步骤一:创建应用

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

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

    说明
    只有管理员和子管理员可登录开发者后台。
  2. 开发者后台页面,单击应用开发,然后选择企业内部开发 > 小程序,最后单击创建应用
    《钉钉应用开发者速成手册》之“钉钉应用开发入门——小程序”
  3. 在弹出的创建应用页面中填写基本信息,然后单击确定创建
    • 应用类型:选择小程序
    • 开发方式:选择企业自助开发

《钉钉应用开发者速成手册》之“钉钉应用开发入门——小程序”

  1. 应用创建完成后,在凭证与基础信息页面,复制应用的AppKeyAppSecret备用。
    《钉钉应用开发者速成手册》之“钉钉应用开发入门——小程序”
  2. 单击开发管理进入开发管理页面,然后单击修改,并根据以下内容配置开发信息。
    • 服务器出口IP:输入调用钉钉服务端API时使用的IP即企业服务器的公网IP,多个IP请以英文逗号","隔开,支持带一个*号通配符的IP格式。最多可设置20个,并且符合IPV4规则。
    • PC端首页地址(可选):输入在PC端钉钉工作台上打开本应用的地址。链接地址必须以http或https开头。
    • 管理后台地址(可选):输入组织管理员在钉钉管理后台访问该应用的地址。

《钉钉应用开发者速成手册》之“钉钉应用开发入门——小程序”

  1. 单击人员管理,然后单击添加人员添加开发人员。

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

《钉钉应用开发者速成手册》之“钉钉应用开发入门——小程序”

步骤二:服务端开发

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

  1. 下载服务端代码。
git clone https://github.com/open-dingtalk/org-mini-program-tutorial-java.git
  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. 默认发布后企业内部成员可使用该版本的应用。您可以选择使用该应用的用户范围,然后单击保存修改
    《钉钉应用开发者速成手册》之“钉钉应用开发入门——小程序”
上一篇:Exchange 2013 ECP 查看个别用户属性时报错


下一篇:使用Java带你打造一款简单的外卖系统