⭐【浙政钉】微信-专有钉钉小程序-开发踩坑实记

最近有个需求，要将微信小程序转为浙政钉小程序进行开发。一开始的思路是先将微信小程序转为钉钉小程序。（至于为什么，我只能说钉钉的开发文档写的要比专有钉钉的详尽多了）本是采用插件，想一步到位，但是转化后的产物并不理想。并且钉钉小程序开发工具，似乎不能很精准的定位错误，很容易造成系统崩溃（not found xxxxx），即找不到该页面，这一点，极大地提升了找bug的难度。因此，决定直接手改。

提一句，在我们修改bug之前，存在两个IDE供我们选择，

其一，是政务钉钉开发工具。 【传送门】

该开发工具，在编译速度上不及钉钉，但是离我们的最终需求是最贴近的

其二，是钉钉开发工具，官网最显眼的是这个IDE 但，在开发中，我们发现，这边钉钉小程序的样式跟转到专有钉钉的小程序样式出入很大，后来，我们选择组件开发的这款 IDE 该IDE比起上面编译要快很多。

⭐ 创建项目

这边我们采用的开发策略是： 先在第二款IDE中，将微信小程序大致改好，然后在政务钉钉的开发工具中进行功能测试和微调，当然，也可以直接在政务钉钉的开发工具中进行开发。。 下面进入开发阶段：

打开开发工具，选择专有钉钉，然后一直下一步就可。

接下来就是转化阶段，关于微信和钉钉 具体可参考其开发文档。下文有提及。

⭐ 转化方案

钉钉转专有钉钉

这是官方给出的方案 ，其实不用这么麻烦：

关于钉钉和专有钉钉，其实最大区别就在于 接口调用， 专有钉钉的api调用是 my.xxxx 与支付宝几乎一致，在开发中可参考 支付宝开发文档， 而钉钉的api调用是 dd.xxxx 。只需安装一个依赖 jsapi 即可：

在项目根目录下执行

npm install gdt-jsapi

二者接口转换格式参照如下（官网）

// 方式一 
import dd from 'gdt-jsapi'
dd.getLocation().then(ret => {
  console.log(ret)
}).catch(err => {
  console.error(err)
})

// 方式二，不需要引入，直接使用 my 进行调用
my.getLocation({
  success (ret) {
    console.log(ret)
  },
  fail (err) {
    console.error(err)  
  }
})

详见官网文档

下面列几个特殊的写法

① wxs & sjs

微信 ：

<wxs src="/utils/xxxx.wxs" module="filter"></wxs>

专有钉钉

<import-sjs from="/utils/xxxx.sjs" name='filter' />

② 自定义导航栏

微信： navigationStyle:custom 采用自定义导航栏

// xxx.json
{
  "navigationStyle":"custom",
  "navigationBarTextStyle": "white"
}

专有钉钉： transparentTitle 这个属性控制导航栏透明度

// app.json 
"window": {
    "defaultTitle": "",
    "titleBarColor": "#ffffff",
    "pullRefresh": false,
    "transparentTitle": "always",
    "titlePenetrate": "YES"
  }

// xxx.json 想要采用原生导航栏
{
  "defaultTitle": "我的评论",
  "transparentTitle": "no",
  "pullRefresh": true // 若要实现下拉刷新，必须开启这个属性
}

③ 底部导航栏

微信

"tabBar": {
    "custom": true
}

专有钉钉

暂时还没找到解决方案，目前采用的是：在 app.json直接不写 tabbar 属性

④ 存储获取

微信

wx.setStorageSync('openid', res.data.user.openid)

let openid=wx.getStorageSync('openid')?wx.getStorageSync('openid'):getApp().globalData.openid;

专有钉钉

// ddInfo: {openid:xxxx}
 dd.setStorageSync({
     key: "ddInfo",
     data: res.data.data
 });

let openid = my.getStorageSync({
      key: 'ddInfo'
    }).data ?  my.getStorageSync({
      key: 'ddInfo'
    }).data.openid : app.globalData.openid;

⑤ 网络请求

微信

wx.request({
    method: type,
    dataType: 'json',
    url: getApp().globalData.Url + url,
    data:param,
    header: {
    'content-type': 'application/json',
    },
    success: function (res) {
    callback(res.data);
    }
 })

专有钉钉

my.httpRequest({
    method: type,
    url: app.globalData.Url + url,
    data: param,
    success: function (res) {
        callback(res.data);
    },
    fail: function (err) {
        console.log(err)
    }
})

⑥ 分享 传参

微信

onShareAppMessage:function (res) {
    let news_=this.data.news;
    let title=news_.gj_title;
    let imgurl=news_.tb_img;
    let newsId=news_.news_id;
    let openid=wx.getStorageSync('openid')?	         wx.getStorageSync('openid'):getApp().globalData.openid;
      return {
        title: title,
        path: '/pages/xxxx/xxxx?id='+newsId+'&oid='+openid,
        imageUrl: imgurl,
        success: (res) => {
        console.log("转发成功", res);
        },
        fail: (res) => {
        console.log("转发失败", res);
        }
       }
  }

专有钉钉 注意 %3F 是?的url编码，官网给出的例子，似乎跑不通

onShareAppMessage() {
    let news_=this.data.news;
    console.log(news_)
    let title=news_.gj_title;
    let imgurl=news_.tb_img;
    let newsId=news_.news_id;
    let openid = my.getStorageSync({       
      key: 'ddInfo'     
    }).data ?  my.getStorageSync({       
      key: 'ddInfo'     
    }).data.openid : getApp().globalData.openid;

    return {
      title: title,
      path: 'pages/xxxx/xxxx%3Fid='+newsId + '&oid=' + openid,
      imageUrl: imgurl,
      success: (res) => {
        console.log("转发成功", res);
      },
      fail: (err) => {
        console.log("转发失败", err);
      }
    }

⑦ 点击事件、for循环等

微信

bindchange、bindtap、 bindxxxxx
wx:for="{{ xxxxx }}" wx:for-item="item" wx:key="index"

钉钉

onChange、onTap、 onXxxxx
a:for="{{xxxxx}}" a:key="index" a:for-index="index"

⑧ 画布canvas

微信 canvas-id

<canvas class="hide" canvas-id="share" style="width:480px;height:854px;"></canvas>

专有钉钉 id

<canvas class="hide" id="share" style="width:480px;height:854px;"></canvas>

⑨ 交互showToast等

详见文档

⭐ 政务钉钉调试

关于 政务钉钉调试，需设置白名单，才能进行真机调试、预览等

⭐ 上传发布

点击详情

进行应用发布， 还需管理员在工作台管理页面，将其审核添加。

另有一个巨坑， 还得在控制台上设置一下

不然发布了，在工作台也找不到该应用。

关于专有钉钉小程序的官方开发文档，着实有点乱。

这篇记录暂且到这里，后续再补充。

【转载请放链接】https://www.cnblogs.com/Jlay/p/dd_notes.html