新聞中心
初始化
在小程序端開始使用云能力前,需先調(diào)用 wx.cloud.init 方法完成云能力初始化(注意小程序需先開通云服務,開通的方法是點擊工具欄左上角的 “控制臺” 按鈕)。因此,如果要使用云能力,通常我們在小程序初始化時即調(diào)用這個方法。

創(chuàng)新互聯(lián)建站-專業(yè)網(wǎng)站定制、快速模板網(wǎng)站建設、高性價比革吉網(wǎng)站開發(fā)、企業(yè)建站全套包干低至880元,成熟完善的模板庫,直接使用。一站式革吉網(wǎng)站制作公司更省心,省錢,快速模板網(wǎng)站建設找我們,業(yè)務覆蓋革吉地區(qū)。費用合理售后完善,十載實體公司更值得信賴。
wx.cloud.init 方法的定義如下:
function init(options): void
wx.cloud.init 方法接受一個可選的 options 參數(shù),方法沒有返回值。
options 參數(shù)定義了云開發(fā)的默認配置,該配置會作為之后調(diào)用其他所有云 API 的默認配置,options 提供的可選配置如下:
| 字段 | 數(shù)據(jù)類型 | 必填 | 默認值 | 說明 |
|---|---|---|---|---|
| env | string | object | 否 | default | 默認環(huán)境配置,傳入字符串形式的環(huán)境 ID 可以指定所有服務的默認環(huán)境,傳入對象可以分別指定各個服務的默認環(huán)境,見下方詳細定義 |
| traceUser | boolean | 否 | false | 是否在將用戶訪問記錄到用戶管理中,在控制臺中可見 |
當 env 傳入?yún)?shù)為對象時,可以指定各個服務的默認環(huán)境,可選字段如下:
| 字段 | 數(shù)據(jù)類型 | 必填 | 默認值 | 說明 |
|---|---|---|---|---|
| database | string | 否 | default | 數(shù)據(jù)庫 API 默認環(huán)境配置 |
| storage | string | 否 | default | 存儲 API 默認環(huán)境配置 |
| functions | string | 否 | default | 云函數(shù) API 默認環(huán)境配置 |
示例代碼:
wx.cloud.init({
env: 'test-x1dzi'
})
云函數(shù)端初始化
cloud.init 方法的定義如下:
function init(options): void
cloud.init 方法接受一個可選的 options 參數(shù),方法沒有返回值。方法只能調(diào)用一次,多次調(diào)用時只有第一次調(diào)用生效。
options 參數(shù)定義了云開發(fā)的默認配置,該配置會作為之后調(diào)用其他所有云 API 的默認配置,options 提供的可選配置如下:
| 字段 | 數(shù)據(jù)類型 | 必填 | 默認值 | 說明 |
|---|---|---|---|---|
| env | string | object | 是 | 后續(xù) API 調(diào)用的默認環(huán)境配置,傳入字符串形式的環(huán)境 ID 或傳入 cloud.DYNAMIC_CURRENT_ENV 可以指定所有服務的默認環(huán)境,傳入對象可以分別指定各個服務的默認環(huán)境,見下方詳細定義 |
當 env 傳入?yún)?shù)為對象時,可以指定各個服務的默認環(huán)境,可選字段如下:
| 字段 | 數(shù)據(jù)類型 | 必填 | 默認值 | 說明 |
|---|---|---|---|---|
| database | string | 否 | default | 數(shù)據(jù)庫 API 默認環(huán)境配置 |
| storage | string | 否 | default | 存儲 API 默認環(huán)境配置 |
| functions | string | 否 | default | 云函數(shù) API 默認環(huán)境配置 |
| default | string | 否 | 空 | 缺省時 API 默認環(huán)境配置 |
注意:env 設置只會決定本次云函數(shù) API 調(diào)用的云環(huán)境,并不會決定接下來其他被調(diào)云函數(shù)中的 API 調(diào)用的環(huán)境,在其他被調(diào)云函數(shù)中需要通過 init 方法重新設置環(huán)境。
建議:在設置 env 時指定 cloud.DYNAMIC_CURRENT_ENV 常量 (需 SDK v1.1.0 或以上) ,這樣云函數(shù)內(nèi)發(fā)起數(shù)據(jù)庫請求、存儲請求或調(diào)用其他云函數(shù)的時候,默認請求的云環(huán)境就是云函數(shù)當前所在的環(huán)境:
const cloud = require('wx-server-sdk')
cloud.init({
env: cloud.DYNAMIC_CURRENT_ENV
})
exports.main = async (event) => {
const { ENV, OPENID, APPID } = cloud.getWXContext()
// 如果云函數(shù)所在環(huán)境為 abc,則下面的調(diào)用就會請求到 abc 環(huán)境的數(shù)據(jù)庫
const dbResult = await cloud.database().collection('test').get()
return {
dbResult,
ENV,
OPENID,
APPID,
}
}
注:上述代碼中的 env 參數(shù)的值不能用 cloud.getWXContext().ENV 替代,因為在 exports.main 外部調(diào)用的 getWXContext() 無法獲取到當前環(huán)境
API 風格
云開發(fā)的 API 風格與框架組件和 API 風格一致,但同時支持回調(diào)風格和Promise風格。在傳入 API 的 Object 參數(shù)中,如果傳入了 success、fail、complete 字段,則我們認為是采用回調(diào)風格,API 方法調(diào)用不返回 Promise。如果傳入 API 的 Object 參數(shù)中 success、fail、complete 這三個字段都不存在,則我們認為是采用Promise風格,API 方法調(diào)用返回一個 Promise,Promise resolve 的結(jié)果同傳入 success 回調(diào)的參數(shù),reject 的結(jié)果同傳入 fail 的參數(shù)。
注意事項
- 如果 init 時不傳 env 參數(shù),后續(xù) API 調(diào)用將默認請求到第一個創(chuàng)建的環(huán)境,但這種方式并不總是預期的,因此這種方式已廢棄,請務必明確傳入 env 參數(shù)
文章題目:創(chuàng)新互聯(lián)小程序教程:微信小程序云開發(fā)初始化
路徑分享:http://fisionsoft.com.cn/article/djijihh.html


咨詢
建站咨詢
