浙政钉小程序开发指南
使用uni-app开发浙政钉小程序指南
写在前面：本篇文章为浙政钉小程序开发流程，非H5微应用
应用开发简易教程https://open-portal.on-premises.dingtalk.com/portal/#/helpdoc?apiType=QUICK_START&docKey=3355321
主要开发流程
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
专有钉钉门户地址
https://openplatform-portal.dg-work.cn/portal/?spm=a2q2b.13441934.0.0.6e7d6fbao4SMsZ#/helpdoc?apiType=QUICK_START&docKey=3355321
二.超管给开发人员添加权限
按照文档操作即可，不再过多赘述
三.在专有钉钉 创建你要的项目
登录专有钉钉门户
创建应用，应用类型选择小程序
创建完毕后如下图所示
然后把一起开发的小伙伴也拉进来
四.下载开发工具和配置文件 创建小程序
这个配置文件是有用的，先下载下来。
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-project3.运行项目
首先设置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：不管什么环境，都需要应用管理员来扫码，专有钉钉环境可在专有钉钉门户的后台添加应用管理员。浙政钉环境只能去找浙政钉环境的应用管理员扫码了。