我的第一个钉钉小程序_应用将会被添加至当前组织工作台「未分组」中,所有人都能看到

一.准备工作

1.完成了钉钉开发者的注册与激活并拥有了子管理员和开发者权限,参考以下链接成为钉钉开发者（即完成实名认证与授权）https://developers.dingtalk.com/document/app/become-a-dingtalk-developer?spm=ding_open_doc.document.0.0.60984cc4CXkL34#topic-2024337

2.安装了Java开发环境，访问oracle官网下载（jdk安装与配置）https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html?spm=ding_open_doc.document.0.0.60984cc4ECkEbP

3.安装了Java项目构建工具Maven（eclipse、idea等工具自带maven，可忽略），也可自行安装

http://maven.apache.org/index.html?spm=ding_open_doc.document.0.0.60984cc4ECkEbP

4.安装了项目管理工具Git（eclipse、idea等工具自带，可忽略），也可自行安装

https://git-scm.com/downloads?spm=ding_open_doc.document.0.0.60984cc4ECkEbP（官方）

https://www.liaoxuefeng.com/wiki/896043488029600/896067074338496（推荐）

5.下载并安装了IntelliJ IDEA开发工具，安装可参考官方https://www.jetbrains.com/idea/download/?spm=ding_open_doc.document.0.0.60984cc4ECkEbP#section=windows

6.下载并安装小程序开发者工具IDE，可参考官方https://developers.dingtalk.com/document/resourcedownload/miniapp-tool?spm=ding_open_doc.document.0.0.60984cc4ECkEbP#topic-2625633

二.创建应用

1.登录钉钉开发者后台（需要管理员权限）https://open-dev.dingtalk.com/?spm=ding_open_doc.document.0.0.60984cc4ECkEbP#/

2.找到导航菜单【应用开发】，然后选择其子导航菜单【企业内部】开发进入钉钉应用，再选择右上角【创建应用】，弹出创建对话框，选择“小程序”，并填写*内容，开发方式选择“企业自助开发”即可；

3.在【开发管理】中配置服务器出口IP（本地ip公网地址，若配127.0.0.1可能出现白名单问题），pc端首页地址（https://ding-doc.dingtalk.com/），管理后台地址(https://www.dingtalk.com)

4.在【人员管理】中添加人员，点击【添加人员】按钮在弹出框中选择人员（应用创建后，默认开发人员为应用创建者。只有在这里添加了开发人员，开发人员才可以在小程序IDE中关联这个应用。）

5.在【安全中心】，添加http安全域名

当小程序的前端与服务端需要进行网络通信时，需要设置安全域名。小程序前端只能通过已设置的安全域名（或IP）与服务端进行网络通信。当安全域名更新时，需要在小程序开发工具重新打包上传版本，设置的域名才会生效。

安全域名是后端服务部署的服务器的公网IP或域名，本教程输入127.0.0.1

6.在【权限管理】中配置添加接口调用权限

在实例中需要调用接口获取用户的姓名和userid，所以需要先添加通讯录接口权限。也可根据需求勾选权限申请。

1. 权限范围选择全部员工，然后选择通讯录管理。

2. 选择通讯录部门信息读权限和通讯录部门成员读权限，然后单击申请权限

三.开发和部署后端服务

1.执行以下命令，下载服务端代码，IDEA工具操作如下图

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

或者如下操作

2.打开项目，找到src/main/java/com/dingtalk/constant/AppConstant.java文件，填写创建应用时的AppKey与AppSecret

3.打开src/main/java/com/dingtalk/Application.java文件，运行后端服务

4.在浏览器中访问http://localhost:8080/welcome检查服务是否启动成功。出现welcome即成功。

8080端口可修改，方法如下图，修改后需重启服务，修改端口访问http://localhost:port/welcome

四.配置内网穿透

使用钉钉内网穿透工具生成一个公网域名用于教程测试。
1.打开命令行工具，执行以下命令，下载内网穿透工具。（这里可能会花点时间）
git clone https://github.com/open-dingtalk/pierced.git

2.执行以下命令，启动内网穿透。（切换到内网穿透工具对应系统的目录，启动服务）

Windows执行以下命令：
cd windows_64
ding -config=ding.cfg -subdomain=testdddemo1 8081

MAC执行以下命令：
cd mac_64
chmod 777 ./ding
./ding -config=./ding.cfg -subdomain=testdddemo1 8081

成功启动

说明：windows_64、mac_64为不同系统切换的目录，testdddemo1 项目访问域名路径，不可重复，8081即服务端口号

3.访问http://testdddemo1.vaiwan.com/welcome都会映射到http://127.0.0.1:8081/welcome

4.成功访问后，在安全中心添加安全域名

五.开发小程序前端

1.下载小程序前端项目

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

2.打开小程序工具

钉钉--》企业内部应用--》打开选择下载本地项目

3.关联小程序应用

4.打开文件修改应用的域名，并预览效果（登录获取个人信息）

六.上传发布小程序

七.发现小程序（切换至当前组织）

工作台--》全部--》未分组应用--》管理（选择小程序添加至工作台）

工作台--》我的（现在就可以看见我们的小程序了）

参考官方文档https://developers.dingtalk.com/document/tutorial/develop-mini-programs