钉钉开发文档

开发小程序

更新时间: 2019-7-12

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

服务端开发

后端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值。

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

所需要的参数可通过如下方式获取:
在开发者后台中点击您创建的企业自建应用,可进入应用详情页面。如下图所示:
image.png

image.png
再点击"查看详情",可以获取应用的appKey和appSecret。
image.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.下载IDE并导入前端代码

参考小程序前端IDE使用
打开下载的demo文件夹地址,操作如下图所示:

3.修改demo中的配置项

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

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


4.模拟器预览应用

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

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

设置小程序

设置开发人员

在创建应用后,默认会把当前创建应用的操作者添加为开发人员,若应用有多个开发者,我们可以通过手机号码添加该应用的开发者。添加开发人员后,该开发人员可使用开发者工具进行应用开发。
image.png

设置安全域名

小程序需要事先设置一个或多个服务端安全域名(或IP),小程序前端只能通过这些安全域名(或IP)与服务端进行网络通信。

本质上,小程序前端与后端的网络通信是同普通的H5前后端一样的。因此在您做快速体验时,可以填写小程序前端所在环境能访问的任何域名/IP地址,比如可以是您自己的办公电脑本机地址或者局域网内地址。
您也可借助内网穿透工具映射一个可公网访问的临时地址,注意:内网穿透仅用于测试开发阶段。

image.png

以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!