創建雲函數目錄
首先,我們需要在uni-app項目文件夾下,創建一個雲函數目錄,路徑隨意,我這里是functions
。然后先隨便在里面放一些文件,這里以new_file.css
為例。(放文件的原因是:確保編譯成小程序后cloudfunctions文件夾存在。如果該文件夾下沒有文件,默認是不會在微信小程序開發平台中顯示該文件夾的。)
修改manifest.json
在uni-app根目錄下,修改manifest.json
中的微信小程序項,結構如下
"mp-weixin" : { /* 小程序特有相關 */ "appid" : "wxd7de467f6e6cf741", "cloudfunctionRoot": "./functions/", // 這一行就是標記雲函數目錄的字段 "setting" : { "urlCheck" : false }, "usingComponents" : true }
編寫vue.config.js
- 我們在項目根目錄創建
vue.config.js
文件 - 寫入以下內容(如路徑不一樣請做相應適配)
const path = require('path') const CopyWebpackPlugin = require('copy-webpack-plugin') module.exports = { configureWebpack: { plugins: [ new CopyWebpackPlugin([ { from: path.join(__dirname, 'functions'), to: path.join(__dirname, 'unpackage/dist', process.env.NODE_ENV === 'production' ? 'build' : 'dev', process.env.UNI_PLATFORM, 'functions') } ]) ] } }
-
編譯運行
發現提示如下內容
說明未安裝copy-webpack-plugin
插件,我們手動安裝一下。
然后編譯運行,發現微信開發者工具里面出現以下內容。
截止目前,已打通Hbuilder X到微信開發者工具的自動復制,即已解決本文的核心內容。以下為進一步測試。
創建雲函數
(在微信開發者工具操作)我們在雲函數根目錄上右鍵,在右鍵菜單中,可以選擇創建一個新的 Node.js 雲函數,我們將該雲函數命名為check。開發者工具在本地創建出雲函數目錄和入口 index.js 文件,同時在線上環境中創建出對應的雲函數。創建成功后,工具會提示是否立即本地安裝依賴,確定后工具會自動安裝 wx-server-sdk。我們會看到以下內容。
創建好后將其同步復制到uni-app項目,即可為以后自動同步行方便,又可避免在輸出文件夾中雲函數的意外丟失。至此,相關文件編寫工作轉至Hbuilder X
,雲函數上傳部署依舊在微信開發者工具。
編寫雲函數
默認的雲函數只是一個返回用戶基本數據的內容,我們將其修改至滿足我們的業務需求,以內容安全雲調用為例。
在雲函數文件中寫入以下內容
// 雲函數入口文件 const cloud = require('wx-server-sdk') cloud.init() // 雲函數入口函數 exports.main = async(event, context) => { try { console.log('待檢測文本:' + event.content); let result = await cloud.openapi.security.msgSecCheck({ content: event.content }) console.log('result:' + JSON.stringify(result)); if (result && result.errCode.toString() === '87014') { return { code: 300, msg: '內容含有違法違規內容', data: result } } else { return { code: 200, msg: 'ok', data: result } } } catch (err) { if (err.errCode.toString() === '87014') { return { code: 300, msg: '內容含有違法違規內容', data: err } } return { code: 400, msg: '調用security接口異常', data: err } } }
權限申明
在函數目錄下,創建一個config.json
,文檔說會自動創建,但是實際操作時可能不會自動創建。config.json
內容如下。
{ "permissions": { "openapi": [ "security.msgSecCheck" //接口名 ] } }
b
小程序調用雲函數
wx.cloud.init() //調用前需先調用init wx.cloud.callFunction({ name: 'check', data: { "content": this.contents.join() } }).then(res => { console.log(res.result) if (res.result.code == 300) { uni.showModal({ title: "溫馨提示", content: "你所輸入的內容可能含有違法違規內容,不支持進行下一步操作" }) return } else { ... // 你要進行的操作 } })
效果展示
如果第一次出現錯誤: invalid scope 沒有權限,請先開通雲服務
這是因為 小程序開發選擇了雲服務開發,但是沒有開通雲服務導致,點擊微信開發工具上方的 雲開發按鈕,開通雲開發。
新建雲函數(上床並部署后會自動出現)