浙政钉小程序开发指南
使用uni-app开发浙政钉小程序指南
写在前面:本篇文章为浙政钉小程序开发流程,非H5微应用。
本文参考自博主@晓峰666的文章https://blog.csdn.net/qq_44766377/article/details/120953452,本文针对一些常见问题进行补充,方便后续查阅。
主要开发流程
1.让公司的专有钉钉超级管理员给开发人员权限
2.使用uniapp创建项目
3.下载开发工具(小程序开发者工具,专有钉钉App) 配置专有钉钉开发环境
4.实现免登(开发前期可先通过手动登录,写完业务逻辑后再写免登)
5.根据业务开发
6.专有钉钉上线(开发环境)
7.配置专有钉钉工作台(这个需要公司专有钉钉超管来配置)使用者可在专有钉钉App工作台看见该小程序
8.上线浙政钉,填写上线材料 交给业主 让业主去提交内网工单
9.工单通过会有专门的人员联系业主或者开发人员 将正式的appke 和一些 参数给到开发人员
10.配置浙政钉开发环境 (让业主在他们的系统里面给你创建一个浙政钉账号 ,或者叫业主单位给你一个他们部门闲置的账号)
11.将正式环境的参数替换,埋点
12.浙政钉上线
接下来我将分3个部分来写,分别是 专有钉钉开发上线阶段、正式上线浙政钉阶段、常见问题
专有钉钉开发上线阶段
一.首先你得有一个 专有钉钉的账号
叫你们公司的开放平台的管理员给你注册一个你的账号,你再去拿着你的注册的手机号和你的姓名去激活(注册成功会发短信提醒你)在短信链接里面去下载专有钉钉 进行激活(还有就是,你开发中用到什么权限,记得叫管理员给你授权)
专有钉钉下App载地址
https://dg-work.cn/download/?spm=a2q2b.13441934.0.0.26d86fbaf4kgen
专有钉钉门户地址
二.超管给开发人员添加权限
按照文档操作即可,不再过多赘述
三.在专有钉钉 创建你要的项目
登录专有钉钉门户
创建应用,应用类型选择小程序
创建完毕后如下图所示
然后把一起开发的小伙伴也拉进来
四.下载开发工具和配置文件 创建小程序
这个配置文件是有用的,先下载下来。
1.开发uni-app需要使用Hbuilder X编辑器,请自行下载
2.创建一个uni-app项目,以下两种方式都可以
tip:题外话,如果开发的是H5微应用,请用方式二vue-cli创建
方式一:使用Hbuilder X
方式二:使用vue-cli创建
//使用vue-cli创建,我用的是vue2开发,命令如下
vue create -p dcloudio/uni-preset-vue my-project
3.运行项目
首先设置Hbuilder X的运行配置,把刚刚下载的小程序开发者工具的安装路径写上去
工具->设置->运行配置
运行->运行到小程序模拟器->支付宝小程序开发者工具
选mPaas->小程序
登录
把刚才下载的配置文件上传上去
4.白名单配置(不配置就无法真机调试)
让公司专有钉钉超级管理员查看一下你的UID
如果要添加多个UID 请用,隔开(英文的半角逗号)
五.免登录
专有钉钉API地址其中H5微应用和小程序的API是通用的
先安装专有钉钉的API
npm install gdt-jsapi
调用免登API
import * as dd from 'gdt-jsapi'
...
dd.getLocation().then(ret => {
console.log(ret)
}).catch(err => {
console.error(err)
})
六.根据业务开发
根据业务开发小程序的功能
七.专有钉钉上线
开发完成后上传版本
上传完后,在专有钉钉开放平台将项目上线
八.配置专有钉钉工作台
让管公司钉钉超级理员登录下面链接
统一登录中心
https://console.dg-work.cn/console/home#/dashboard
点击应用管理
将应用添加上去
然后回到刚才工作台 点击配置
保存好以后就可以了
打开手机专有钉钉
点击工作台
左上角点击切换工作台(切换到你应用在那个工作台上线就切换到那个)
然后就能看见你的应用了。
到此专有钉钉开发流程结束
浙政钉开发上线阶段
上线需要提交一些材料,让对接的同事去做就行了。
一.配置浙政钉开发环境
配置文件就是登录时用到的那个,上线浙政钉需要用正式环境的配置文件,让对接的同事去要一下
上传配置文件
此时登录二维码变成浙政钉扫码登录(需要业主给你浙政钉账号或者让业主来扫码)
问业主要他们的UID,把UID填入白名单,这里的UID要业主的(开发流程第十条)关联应用
二.项目改造 埋点
项目改造就是你用到的 钉钉api使用的appkey 什么参数之类的都得替换为正式环境的
埋点网上教程很多,可参考下面这篇博客
https://blog.csdn.net/qq_21113235/article/details/126641979
三.浙政钉上线
用浙政钉登录,关联应用后将代码上传
上传完成后 找到 浙政钉对接人
把 应用标识给他 请他上架一下项目 后续更新项目也是如此
到此差不多就完成了,埋点是否成功得每周一才能看你(找对接人给你地址自己查)
常见问题
FAQ
Q1:小程序模拟器上使用该api报错:[API_getAuthCode_error] 无效参数?
A1:目前模拟器暂不支持该api的调试,请使用IDE右上角的真机调试。
Q2:为什么我找不到设置白名单的地方
A2:左上角选择mPaas
Q3:为什么真机调试构建失败了
A3:可能是没有配置白名单
Q4:为什么真机调试手机上一直在loading或者转圈
A4:真机调试编译前先点开项目详情,把启用小程序基础库2.0构建的勾去掉
Q5:真机调试或项目上线后,底部的tabBar导航栏不见了
A5:
Q6:真机调试或项目上线后,安卓机部分页面(一般是非tabBar页面)顶部的navigationBarTitleText变成了ip网址(ios正常)
A6:目前不知道什么原因,我通过以下方式解决
onShow(){ uni.setNavigationBarTitle({ title: '页面标题' }); }
Q7:为什么我给顶部导航栏设置背景色(navigationBarBackgroundColor)后在ios上还是显示白色背景,安卓机却正常显示
A7:经测试ios自定义导航栏背景颜色在专有钉钉无法正确显示,建议使用默认的颜色。
补充:专有钉钉小程序不支持自定义导航栏,有这个想法的建议放弃。
Q8:为什么扫码登陆后关联不了应用
A8:不管什么环境,都需要应用管理员来扫码,专有钉钉环境可在专有钉钉门户的后台添加应用管理员。浙政钉环境只能去找浙政钉环境的应用管理员扫码了。