钉钉开发文档

JAVA版QuickStart

更新时间: 2018-9-9

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

1.创建应用

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

2.服务端开发

E应用服务端代码下载

git clone https://github.com/opendingtalk/eapp-corp-quick-start-java.git

导入服务端代码,并修改配置

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

    /**
     * 开发者后台->企业自建应用->选择您创建的E应用->查看->AppKey
     */
    public static final String APP_KEY = "***";
    /**
     * 开发者后台->企业自建应用->选择您创建的E应用->查看->AppSecret
     */
    public static final String APP_SECRET="***";

所需要的参数请在开发者后台企业自建E应用详情获取

进入左侧E应用菜单

image.png

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

创建应用8.png

进入下图所示,找到appKey和appSecret

QuickStart9.png

更改application.properties(非必要)

#服务启动端口号,钉钉云ECS目前只开放80和22端口
server.port=8080

代码打包编译

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

mvn clean compile -U

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

mvn clean package -Dmaven.test.skip=true

QuickStart1.png

启动服务端程序

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

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

程序启动成功如下图所示

QuickStart2.png

检查启动成功页面

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

QuickStart3.png

3.前端开发

E应用前端代码下载

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

下载E应用IDE开发工具,导入前端代码

E应用IDE开发工具下载链接:https://open-doc.dingtalk.com/microapp/debug/ide

打开E应用前端IDE,打开项目,选择项目路径,设置项目类型为企业内部应用。

1.png

2.png

修改E应用前端配置

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

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

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

//替换成开发者后台设置的安全域名
let domain = "http://********";
//修改成java的login地址
let url = domain + '/login';

模拟器体验

完成上述域名修改,扫码登陆后,选择关联应用与服务端设置E应用一致,可以直接使用IDE进行模拟器体验,如下图所示:

5.png

版本上传

点击上传按钮进行版本上传。

6.png

祝贺您已经成功体验本QuickStart!