文章目录
文章目录
应用管理
钉钉端开发小程序/微应用,实现钉钉与LCP平台的深度集成
运行环境
当前存在两套钉钉环境
环境名称 | 适用范围 | 描述 | 备注 |
---|---|---|---|
风神测试 | DEV/SIT | 包含全套组织架构,包含信息技术部员工,少量其它部门参与测试的员工 | 可将公司员工手机号作替换,实现无工号人员正常使用本环境 |
风神物流 | UAT/PROD | 包含全套组织架构,包含公司所有员工,外部员工 |
应用类型
钉钉开放平台支持小程序和H5微应用两种类型的应用开发。
- 小程序是指使用钉钉自有语法,使用专用工具开发移动端应用。小程序暂不支持PC端部署。
- 微应用是指传统的H5方式开发的移动端应用。
- 原则上选择微应用,即H5原生开发。自行展开H5开发具备最大的开发灵活性。
对比项 | 小程序 | 微应用 |
---|---|---|
加载性能 | 首次使用略慢,后续加载快 | 受到很多因素影响,优化不够好,容易慢 |
使用体验 | 非常顺滑,接近 Native | 容易卡顿 |
页面跳转,返回 | 和 Native 的效果一样 | 做不到和 Native 一样的体验 |
开发环境搭建 | 提供 IDE,快速创建项目 | 成本高 |
调试 | 提供 IDE,可以在电脑上调试大部分功能 | 在电脑上只能调 UI,涉及到钉钉的 jsapi,必须真机调试 |
使用开源 UI 组件 | 目前不支持 | 支持 |
使用 npm 包 | 支持 | 支持 |
模块化组织代码 | 支持 小程序 特有的模块化 | 使用 vue, React 等框架可以轻松获得模块化支持 |
灰度发布 | 钉钉提供 | 需要自己实现 |
CDN | 小程序包默认在CDN | 需要开发者自己购买相关服务 |
开发个人应用 | 支持 | 不支持 |
应用离线化 | 支持 | 不支持 |
编程模式
当前存在两套编程模式
名称 | 运行环境 | 用途 | 调用方式 |
---|---|---|---|
前端API | 钉钉客户端 | 从客户端发出对钉钉服务器的各类请求,构建客户端界面,调用设备API | 小程序API,在钉钉iOS客户端、Android客户端均可正常使 \ H5微应用API,使用script标签引入JSAPI,不同的方法有不同的使用范围(Android,IOS,PC) |
服务端API | 后台环境 | 从服务端后台发出对钉钉服务器的各类请求,同步应用数据,实现后台管理等 | 支持Java,PHP,.Net,Python后台运行环境。 |
前端API
容器 | 弹窗 | 摇一摇 | 设备 | 日期&月历 |
导航栏 | UI控件 | 获取免登授权码 | 扫码 | 存储 |
地图 | 业务 | 文件 | 图片 | 打开新页面 |
电话 | 发钉 | 通讯录选人 | 外部联系人 | 自定义联系人 |
会话 | 钉盘 | 音频接口 | 支付 | 数据加解密 |
旋转屏幕 | 统一跳转协议 | 页面事件监听 |
后台API
身份验证 | 通讯录管理 | 消息通知 | 智能工作流 | 考勤 |
智能人事 | 日志 | Ding日程 | 签到 | 公告 |
钉钉运动 | 应用管理 | 群机器人 | 文件存储 | 业务事件回调 |
风神工作台
在每个人的钉钉工作台,显示 风神工作台
应用图标
- 在PC端点击后,免密进入PC端统一门户页面
- 手机端点击后,免密进入移动端待办面板页面
进入钉钉工作台管理后台,创建微应用。选择企业内部自主开发,开发模式选择开发应用,开发应用类型选择微应用,录入名称与Logo,应用首页链接输入移动端待办面板页面链接,PC端首页地址输入PC端统一门户页面,最后录入服务器出口IP,之后发布至所有用户即可。
默认情况下,新加入的应用显示在钉钉工作台最下端。管理员可通过移动端管理工作台功能,调整显示分组与顺序。
基础应用信息
属性 | 描述 |
---|---|
应用名称 | 应用的名字 |
应用类型 | 开发应用-微应用:微应用开发类型 \ 开发应用-小程序:小程序开发类型 \ 快捷链接:仅作地址跳转 |
应用logo | 应用的图标 |
应用简介 | 应用的简单描述 |
应用首页地址 | 用户在手机端钉钉工作台上打开这个应用并显示该链接内容。 |
PC端管理地址 | 用户在PC版钉钉工作台上打开这个应用并显示该链接内容。 |
可使用范围 | 能够使用本应用的员工范围 |
AgentId | 在创建应用时,系统会自动生成一个AgentId,可用于发送企业会话消息等场景。 |
服务器出口IP | 为支撑前端应用而布署的服务器授予访问权限 |
AppKey | 在创建应用时,系统会自动分配一对AppKey和AppSecret,该AppKey是应用开发过程中的唯一性标识。 |
AppSecret | AppSecret和上面AppKey一同生成,使用AppKey和AppSecret来换取access_token。 |
不同环境,出口IP与各页面地址配置如下。内网需要同步作Nginx配置,将外网域名请求转发到正确的内网服务器端口上
环境 | 出口IP | 应用首页链接 | PC端首页地址 |
---|---|---|---|
DEV | 219.135.191.*,218.107.3.* | https://dingtest.fslgz.com/自定义路径 | https://dingtest.fslgz.com/自定义路径 |
SIT | 219.135.191.*,218.107.3.* | https://dingtest.fslgz.com/portal/activiti/system_task_collect.html | h |