浙政钉小程序开发指南

使用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

专有钉钉门户地址

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-project

3.运行项目

首先设置Hbuilder X的运行配置，把刚刚下载的小程序开发者工具的安装路径写上去

工具->设置->运行配置

运行->运行到小程序模拟器->支付宝小程序开发者工具

选mPaas->小程序

登录

把刚才下载的配置文件上传上去

img

4.白名单配置（不配置就无法真机调试）

让公司专有钉钉超级管理员查看一下你的UID

img

如果要添加多个UID 请用,隔开（英文的半角逗号）

img

五.免登录

专有钉钉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)
})

六.根据业务开发

根据业务开发小程序的功能

七.专有钉钉上线

开发完成后上传版本

img

上传完后，在专有钉钉开放平台将项目上线

img

八.配置专有钉钉工作台

让管公司钉钉超级理员登录下面链接

统一登录中心

https://console.dg-work.cn/console/home#/dashboard

img

点击应用管理

img

将应用添加上去

img

然后回到刚才工作台 点击配置

img

保存好以后就可以了

打开手机专有钉钉

点击工作台

左上角点击切换工作台（切换到你应用在那个工作台上线就切换到那个）

然后就能看见你的应用了。

到此专有钉钉开发流程结束

浙政钉开发上线阶段

上线需要提交一些材料，让对接的同事去做就行了。

一.配置浙政钉开发环境

配置文件就是登录时用到的那个，上线浙政钉需要用正式环境的配置文件，让对接的同事去要一下

img

上传配置文件

此时登录二维码变成浙政钉扫码登录（需要业主给你浙政钉账号或者让业主来扫码）

问业主要他们的UID，把UID填入白名单，这里的UID要业主的（开发流程第十条）关联应用

二.项目改造 埋点

项目改造就是你用到的 钉钉api使用的appkey 什么参数之类的都得替换为正式环境的

埋点网上教程很多，可参考下面这篇博客

https://blog.csdn.net/qq_21113235/article/details/126641979

三.浙政钉上线

用浙政钉登录，关联应用后将代码上传

img

上传完成后 找到 浙政钉对接人

把 应用标识给他 请他上架一下项目 后续更新项目也是如此

到此差不多就完成了，埋点是否成功得每周一才能看你（找对接人给你地址自己查）

常见问题

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：不管什么环境，都需要应用管理员来扫码，专有钉钉环境可在专有钉钉门户的后台添加应用管理员。浙政钉环境只能去找浙政钉环境的应用管理员扫码了。

posted @ 2023-03-06 13:43  X1nChenH  阅读(3016)  评论(0)  编辑  收藏  举报