钉钉开发文档

QuickStart

更新时间: 2018-8-31

本quick start为个人E应用接入钉钉示例,用于满足开发者20分钟快速体验钉钉开发。在此demo中,您会获取到用户信息。
服务端语言为java,您要具备java开发环境(安装JDK)以及java项目构建工具maven。

1.下载代码

E应用服务端代码下载

git clone https://github.com/open-dingtalk/eapp-personal-quick-start.git

E应用前端代码下载

git clone https://github.com/opendingtalk/eapp-personal-quick-start-fe.git

2.创建应用

请到创建应用小节了解如何在开发者后台创建应用,并创建。

3.修改配置

更改服务端java代码com.config.Constant.java文件

修改以下2个常量的数值

/**
 * 个人E应用的AppKey,登录开发者后台,点击E应用管理,进入个人应用详情可见
 */
public static final String APP_ID="";
/**
 * 个人E应用的AppSecret,登录开发者后台,点击E应用管理,进入个人应用详情可见
 */
public static final String APP_SECRET="";

所需要的参数请在开发者后台个人应用详情获取。

进入左侧E应用菜单

image.png

在应用列表中点击右侧齿轮设置图片,进入下图所示,再点击查看详情

image.png

进入下图所示,找到AppId和AppSecret

image.png

更改application.properties(非必要)

#服务启动端口号
server.port=8080

4.代码打包编译

进入项目文件路径,代码编译

mvn clean compile -U

代码打包,生成可运行的jar文件

mvn clean package -Dmaven.test.skip=true

image.png

5.启动程序

执行java命令启动程序(jar文件执行路径请根据您所在目录酌情选择)

java -jar target/eapp-personal-quick-start-1.0.0.jar

程序启动成功如下图所示

image.png

6.检查启动成功页面

访问 http://localhost:8080/welcome 地址。打开页面如下图

image.png

7.下载E应用IDE,导入前端代码

E应用前端IDE使用
打开小程序开发者工具IDE选择打开项目。
注意:如果开发者已经打开并登录IDE,请关闭重新打开。初次打开IDE才可以选择打开新工程。

image.png

选择要打开的项目并修改项目类型为第三方个人应用

image.png

8.修改E应用前端配置

1.修改文件eapp-personal-quick-start-fe/page/index/index.js。

IP端口为本机的IP和PORT,注意url中的IP或者域名必须是开发者后台台中设置的本应用的安全域名。

E应用前端发起网络请求时是直连安全域名或IP的,因此假如您的前端demo和服务端demo都在一个办公环境内(比如都在您的PC电脑上),是可以直接互通的,因此可以设置任何您的前端所在环境能连接到的域名或IP为安全域名。
您也可以通过钉钉提供的内网穿透工具生成一个临时二级域名设置为安全域名,用于测试应用。

let url = "http://30.xxx.xx.54:8080";

2.修改本地工程对应的关联应用(需要与服务端com.config.Constant.java中配置E应用保持一致)。

image.png

此时您就可以通过模拟器预览应用了:

image.png

祝贺您!