钉钉开发文档

开发应用

更新时间: 2018-9-7

本文以获取用户免登身份为例,讲解E应用的前、后端开发步骤。

后端开发

后端demo以java语言进行讲解。

1.下载示例demo

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

2.代码导入IDE

进入到下载eapp-corp-quick-start目录里,将代码导入到eclipse或者IDE里。
eclipse:mvn clean install -Dmaven.test.skip eclipse:eclipse

3.修改demo中的配置项

1)更改com.config.Constant.java文件中的2个常量,换成自己创建应用的appKey和appSecret值。

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

所需要的参数请在开发者后台E应用详情获取,如下图所示:

image.png

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

创建应用8.png

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

QuickStart9.png

4.本地启动

1)该demo使用了springboot框架,直接运行Application.java即可。
2)访问 http://localhost:8080/welcome 地址,页面出现welcome,说明本地启动成功。

5.内网穿透

若您部署的服务端已经有公网ip地址,本小节可以跳过。
使用内网穿透是为了方便本地部署的服务,可以在互联网下访问,详细信息参考内网穿透

前端开发

1.下载示例demo

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

2.下载E应用开发IDE,导入前端代码

E应用前端IDE使用

打开刚下载的demo文件夹地址,操作如下截图:

image.png

3.修改demo中的配置项

需要修改文件是 eapp-corp-quick-start-fe/page/index/index.js。
IP端口为本机的IP和PORT,注意url中的IP或者域名必须是开发者后台台中设置的本应用的安全域名。

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

image.png

4.模拟器预览应用

在预览之前,先确保应用类型是企业内部应用,关联的应用是在开发者后台创建的E应用,且IDE已经用钉钉扫码登录了。如截图示意:

image.png

确保上面三个注意点做完后,接着就可以用模拟模拟了,示意如下截图:

image.png

到这里,我们就完成了一个企业内部E应用的前后端的开发,在模拟器里完成体验和测试后,接下来可以进行应用发布了,详情见发布应用