微信小程序工具 第三方平臺

概述

---

同開發(fā)普通的小程序不同，開發(fā)第三方平臺小程序具有一定的復(fù)雜性，首先需要確認(rèn)三個概念

• open3rd：第三方平臺，是小程序官方認(rèn)可的第三方開發(fā)商 詳情
• 3rdMiniProgramAppid：第三方平臺申請的并綁定在該平臺上的小程序，用于開發(fā)小程序模板
• extAppid：授權(quán)給第三方平臺的小程序

因為以上的這些不同，第三方平臺相關(guān)的小程序開發(fā)需要做一些特殊的處理

• 小程序模板的開發(fā)
• 小程序模板結(jié)合 extAppid 的開發(fā)調(diào)試

最新版本的開發(fā)工具支持第三方平臺小程序的開發(fā)和預(yù)覽。

創(chuàng)建項目

---

與開發(fā)普通小程序一致，第三方平臺開發(fā)者填入相關(guān)的 3rdMiniProgramAppid ，設(shè)定項目名稱和選擇項目目錄即可創(chuàng)建項目。

對于第三方平臺小程序，可以在項目頁卡查看到相關(guān)的 open3rd 信息以及當(dāng)前的第三方的 3rdMiniProgramAppid ，如若項目配置了相關(guān)的 extAppid ，那么項目頁卡中也會有相關(guān)信息。

小程序模板開發(fā)

---

與開發(fā)普通小程序一致，開發(fā)者在開發(fā)工具上開發(fā)好相關(guān)的業(yè)務(wù)邏輯之后，在項目頁卡中提交預(yù)覽既可以在微信中查看小程序的真實表現(xiàn)，

有所不同的是，第三方平臺小程序的提交上傳是上傳至該第三方平臺的 open 帳號下的模板草稿箱中，該平臺的管理員需要自行對該模板進(jìn)行相應(yīng)的設(shè)置，更多請參考 open平臺的文檔 。

extAppid 的開發(fā)調(diào)試

---

為了方便第三方平臺的開發(fā)者引入 extAppid 的開發(fā)調(diào)試工作，需要引入ext.json的概念。

ext.json是一個配置文件，放置在小程序項目的根目錄下。

以下是一個包含了所有配置選項的ext.json：

{
  "extEnable": true,
  "extAppid": "wxf9c4501a76931b33",
  "ext": {
    "name": "wechat",
    "attr": {
      "host": "open.weixin.qq.com",
      "users": [
        "user_1",
        "user_2"
      ]
    }
  },
  "extPages": {
    "pages/logs/logs": {
      "navigationBarTitleText": "logs"
    }
  },
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "Demo",
    "navigationBarTextStyle":"black"
  },
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首頁"
    }, {
      "pagePath": "pages/logs/logs",
      "text": "日志"
    }]
  },
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  }
}

ext.json中的配置字段分為兩種

• 特有的字段
• 同app.json相同的字段

特有的字段

extEnable

extEnable是一個Boolean類型的字段，用于規(guī)定當(dāng)前的ext.json文件是否生效，開發(fā)者可以通過修改這個字段來開啟和關(guān)閉 extAppid 的結(jié)合開發(fā)。

extAppid

extAppid是授權(quán)調(diào)試的AppID，例如開發(fā)者在此處填寫的是wxf9c4501a76931b33那么在extEnable為真的情況下，后續(xù)的開發(fā)邏輯都會基于wxf9c4501a76931b33來運行。

ext

ext字段是開發(fā)自定義的數(shù)據(jù)字段，在小程序中可以通過 wx.getExtConfigSync 或者 wx.getExtConfig 獲取到這些配置信息。

例如上面的例子中，通過wx.getExtConfigSync就可以獲得ext字段的所有配置

{
  "name": "wechat",
  "attr": {
    "host": "open.weixin.qq.com",
    "users": [
      "user_1",
      "user_2"
    ]
  }
}

extPages

extPages是一個對象，對象中的每個key應(yīng)該是該小程序模板app.json中定義的頁面，每個key對應(yīng)的value是 page.json 中所規(guī)定的各項配置。

當(dāng)開發(fā)者設(shè)置這個配置以后，小程序框架會對應(yīng)的修改相對應(yīng)的page的配置信息。

同app.json相同的字段

當(dāng)ext.json中的字段同app.json中一致時，ext.json的字段會覆蓋app.json中的對應(yīng)字段，例如以下的ext.json

{
  ········
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "ext navigationBarTitleText",
    "navigationBarTextStyle":"black"
  }
}

那么該小程序最終的navigationBarTitleText應(yīng)該是ext navigationBarTitleText。