⭐【浙政釘】微信-專有釘釘小程序-開發踩坑實記
最近有個需求，要將微信小程序轉為浙政釘小程序進行開發。一開始的思路是先將微信小程序轉為釘釘小程序。（至於為什么，我只能說釘釘的開發文檔寫的要比專有釘釘的詳盡多了）本是采用插件，想一步到位，但是轉化后的產物並不理想。並且釘釘小程序開發工具，似乎不能很精准的定位錯誤，很容易造成系統崩潰（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等
⭐ 政務釘釘調試
關於 政務釘釘調試，需設置白名單，才能進行真機調試、預覽等
⭐ 上傳發布
點擊詳情
進行應用發布， 還需管理員在工作台管理頁面，將其審核添加。
另有一個巨坑， 還得在控制台上設置一下
不然發布了，在工作台也找不到該應用。
關於專有釘釘小程序的官方開發文檔，着實有點亂。
這篇記錄暫且到這里，后續再補充。