钉钉小程序 企业内部应用开发

1. 综述
   1. 什么是钉钉小程序

小程序是一种全新的开发模式，是一种不需要安装即可使用的应用。钉钉小程序以办公社交app钉钉为载体，支持iOS、安卓等多种操作系统部署。

钉钉小程序开发使用AXML（钉钉修改过的HTML）、ACSS（基本等同于CSS）和JavaScript编写。小程序本质上属于系统的前端部分，需要通过HTTP协议与后端的服务器配合使用。

1. 1. 什么是企业内部应用

钉钉为企业和组织提供了很多基础办公应用例如审批、日志、视频会议等。企业可基于钉钉开放平台的能力，根据实际需要定制开发企业应用。

企业内部应用是企业基于钉钉的开放能力，开发个性化的办公应用供企业内部使用，例如将企业内部的HR、CRM、业务管理等系统接入钉钉。企业内部应用发布后，企业内部用户可以直接从钉钉工作台中打开、使用该应用。

企业内部应用可以由企业内部开发人员自主开发，也可以委托给服务商进行应用开发。

1. 创建应用
   1. 创建企业

打开钉钉，单击“工作台”，点击左上方的企业名（如果没有则为空），单击“创建/加入团队”，即可创建一个类似QQ群的企业团队，并成为管理员。管理员可以登录后台创建应用。

1. 1. 创建应用

在开始开发企业内部应用前，首先需要创建一个内部应用并完成基础配置。

1. 登录钉钉开发者后台。只有管理员和子管理员可登录开发者后台。
2. 在应用开发页面，选择企业内部开发，然后单击创建应用。

1. 填写应用的基本信息，然后单击确定创建。应用创建后，无法修改应用的开发方式。

应用创建后，在基础信息页可获取AppKey和AppSecret，服务器需要这两项参数来验证HTTP请求的合法性。

1. 1. 配置应用

钉钉为小程序对外发送的HTTP请求采取白名单过滤的机制。因此，在开发前，需要在开发者后台配置服务器出口IP、应用首页等。

1. 1. 1. 配置服务器出口IP
2. 登录开发者后台，单击目标应用。
3. 在应用详情页，单击开发管理。
4. 单击界面右上方的“修改”按钮。

开发阶段可以将服务器出口IP设置成本机（127.0.0.1）。后台服务器开发完成，打成jar包上传到公网（如阿里云ECS）后，应将其更改为服务器公网IP。

1. 1. 1. 配置HTTP安全域名

若小程序前端需要进行网络通信，开发者需要事先设置一个或多个安全域名（或IP），且小程序前端只能通过已设置的安全域名（或IP）与服务端进行网络通信。

当安全域名更新时，需要在小程序开发工具重新打包上传版本，设置的域名才会生效。

1. 开发小程序
   1. 创建小程序前端工程

1. 要开始编写小程序前端代码，需要从钉钉开发者官网下载小程序开发者工具IDE。
2. 打开IDE，选择新建工程，类别选为企业内部应用，填写项目的名称，选择存储路径，即可创建一个新项目。
   1. 配置基本信息

在工程的根目录下，有app.acss、app.js和app.json三个文件，分别用于配置应用的全局样式表、全局变量和方法以及页面路径等信息。

推荐在开发前，在app.js中设置全局变量：corpId（企业ID）、userId（用户ID）、userName（用户名）和domain（后台服务器IP和端口号，例：http://12.34.56.78:80）。

1. 1. 部署后端服务

钉钉推荐使用Spring Boot作为后端的服务器框架。后端开发前，应确保电脑已安装Java开发的IDE（如Intellij IDEA）并已配置JDK和Maven开发环境。

1. 开发者需在钉钉开发者平台上下载一个服务器示例代码，里面包含钉钉用户免密登录、验证身份的jar包和对应方法。
2. 打开项目，打开src/main/java/com/config文件夹下的Constant类，将两个常量APP_KEY和APP_SECRET修改成自己项目的对应字符串。

也可以复制项目下的jar包和类到自己创建的Java项目下运行。运行服务端代码，打开小程序前端，就可以get到当前登录用户的相关信息了。

1. 1. 编写代码

小程序的每个页面都会对应前端项目下的一个文件夹。每个文件夹下包含axml、acss和js三个文件，用于编写页面的元素布局、样式表和动作。大多数编写方法都与Web前端相同。钉钉也提供了很多自己的UI、组件和方法，可以参考钉钉开发者网站相关文档进行学习，这里不对具体组件和方法做详细的介绍。

开发过程中，IDE右侧会显示一个界面，模拟手机打开这个小程序时的显示画面，可以用鼠标模拟手指对手机屏幕进行单击、长按等操作。开发者可以选择手机的型号，如iPhone 12、iPhone 12 Pro、iPhone 8等，以方便查看自己的小程序能否适配不同大小的手机屏幕。开发者每次按Ctrl+S保存代码，IDE都会自动刷新模拟手机界面的显示内容。

1. 发布程序
   1. 上传小程序

小程序开发完成后，单击右上角的“上传版本”，即可把当前版本上传到钉钉。管理员登录开发者后台，在“版本管理与发布”界面中审批和发布版本。

1. 1. 使用小程序

发布完成后，企业人员打开钉钉app的工作台，在企业页面中单击“搜索”，输入小程序名称就可以打开并使用了。