小程序管理
小程序清單
功能目的
小程序開發者可以創建小程序項目，平臺同時也會提供新版IDE下載地址。
具體功能操作
- 創建小程序：許可權持有者可直接創建小程序，並且該類代碼資源歸屬用戶所在團隊。
- 篩選：可在頂部篩選框選擇所屬團隊來進一步篩選小程序清單。
- 編輯：許可權持有者可修改小程序基本的說明資訊。
- 上架/下架：變更小程序的上架中和已下架狀態，小程序下架後所有關聯應用將無法獲取對應服務，也無法發佈新版本，但仍可提交版本稽核。
- 詳情：許可權持有者可查看小程序的App ID（非常重要，請妥善保管此ID資訊），以及下載新版的IDE工具。
版本管理
功能目的
小程序開發者可以控制每個小程序的版本發版，此處發版會對該小程序所有關聯應用生效，請業務人員注意。
具體功能操作
- 創建小程序：許可權持有者可直接創建小程序，並且該類代碼資源歸屬用戶所在團隊。
- 篩選：可在頂部篩選框選擇所屬團隊來進一步篩選小程序清單。
- 版本概覽：展示當前小程序的線上版本、版本稽核進度、開發版本資訊。
- 稽核記錄：展示當前小程序過往版本發版的稽核記錄。
- 發佈上線：當稽核流程結束時，可由許可權持有者發版。
- 版本回退：將小程序線上版本回滾至此前已經發佈過的歷史版本，不支持連續回滾。
- 新增版本：利用代碼包形式，將Luffa Cloud IDE工具打包得出的文件上傳於此，用於新版本發佈。
- 提交版本稽核：將當前開發版本提交至應用管理員稽核。
- 配置體驗版：配置小程序打開頁面，採用相對地址配置。
灰度發佈
開發者可以在小程序新版本正式上線前，面向部分用戶灰度發佈小程序進入小程序平臺控制台，在版本管理>灰度發佈中，按一下新建灰度任務即可開始灰度發佈流程。
灰度任務設定
- 灰度版本：灰度發佈是小程序版本發佈上線的一種特殊形式，囙此灰度發佈的版本必須已通過小程序稽核、暫未上線且版本號高於線上版本。
- 灰度任務名稱：填寫灰度任務名稱以進行區分，不超過20個字。
- 灰度時間：選擇灰度進行的開始和結束時間，灰度的結束時間不能早於確認創建的時間點。
- 灰度數量：設定灰度投放用戶總量的限制。
- 灰度生效應用：從當前小程序所有的已關聯應用中進行選擇勾選一個應用後，下方可以輸入應用的版本號範圍限制（版本號範圍為空則不限制）。
- 灰度生效平臺：從Android和iOS平臺中進行選擇，勾選後可以填寫對應作業系統的始末版本號。
- 灰度對象：通過添加推送對象條件，將灰度版本投放給特定的用戶集當前支持GUID、自定義設備標識、用戶帳號三種條件開發者可以手動輸入推送對象資訊，也可以通過txt批量上傳對象白名單。
- 聯網管道：選擇是否在特定網路環境下拉去灰度版本。
TIP
多個灰度條件之間取交集，達到其中一個條件限制後就不再投放灰度版本。
灰度任務管理
灰度發佈頁上，清單中多個灰度任務將按照創建時間從晚到早排序每個灰度任務都有待投放、投放中、暫停中、已結束等狀態，任務在多種狀態間的流轉管道如下圖所示：
按一下灰度進展可以查看當前灰度任務的投放情况。
TIP
當開發者將一個小程序版本正式發佈上線時，同版本號或者更小版本號的灰度任務將會自動結束，所有用戶陞級到最新發佈的版本。
開發管理
功能目的
為小程序開發者提供功能變量名稱設定、敏感API許可權申請、實时日誌査詢功能。
具體功能
域名設定
新增功能變量名稱：小程序需要事先設定通訊功能變量名稱，且小程序只可以跟指定的功能變量名稱進行網路通信包括普通HTTPS請求（wx.request）、上傳文件（wx.uploadFile）、下載文件（wx.downloadFile）和WebSocket通信（wx.connectSocket），為便於開發者靈活配置小程序，平臺支持小程序內嵌網頁能力（業務功能變量名稱）。
跳過域名校驗
如果小程序的域名配置不便或會頻繁改動，開發者可以向應用方申請'跳過域名校驗'，待應用方審批通過之後，小程序則無需在控制台配置域名，即可向小程序的伺服器發起網絡請求。
TIP
小程序需要遵守功能變量名稱安全規範，服務請求不得包含任何惡意代碼、病毒或其他可能危害用戶設備或數據的內容。
接口權限
當小程序綁定的宿主應用設定了敏感API後，小程序開發者需要向宿主App申請調用敏感API的許可權，在宿主App的管理者或稽核許可權擁有者審批通過後，小程序才可以正常調用這些敏感API。
實时日誌
查詢準則：查詢準則包括時間、日誌等級維度（全部、info及以上、warn及以上、error及以上）、系統類型、 Guid、 頁面連結、filterMsg內容、基礎庫版本、用戶端版本。
密鑰管理
AppSecret（小程序金鑰）是小程序登入、付款等重要流程中鑑權所需，金鑰管理僅小程序團隊管理員有權限檢視和操作，可在金鑰管理處產生、重設、凍結金鑰。
操作：
- 產生
- 重置
- 凍結
訂閱訊息
前言
訊息能力是小程序能力中的重要組成，Super app 透過為小程序開發者提供訂閱訊息能力，以便實現小程序內的服務閉環，透過訊息訂閱和通知的能力，及時將小程序內的業務狀態變更推送給 Super app 的用戶。在使用訂閱訊息功能時，小程序開發者需要在控制台-小程序管理-訂閱訊息，從公共模板庫中選擇適用的訊息模板，配置推送的欄位後，新增為「我的模板」。
控制台操作
公共模版庫
開發者可在公共模版庫中，根據業務場景選擇需要使用的模版類型，透過模版名稱搜尋適用的模版。
訊息類型說明
一次性訂閱
一次性訂閱訊息用於解決用戶使用小程序後，後續服務環節的通知問題。
開發者在小程序中呼叫 requestSubscribeMessage 介面後，將向使用者展示彈窗，使用者可開啟自己想要接受的訊息開關。用戶訂閱後，開發者可不限時間地下發出對應的服務訊息。
長期訂閱
通常情況下，一次性訂閱訊息已經可滿足小程序的大部分服務場景需求，但線下公共服務領域存在一次性訂閱無法滿足的場景，如航班延誤，需根據航班實時動態來多次發送訊息提醒。為方便服務，我們提供了長期性訂閱訊息，用戶訂閱一次後，開發者可長期下發多則訊息。長期性訂閱訊息適用於政務、民生、醫療、交通、金融、教育等線下公共服務。
TIP
使用長期訂閱訊息可以多次給用戶發送訊息，但是頻繁發送訊息可能會對用戶造成困擾，因此，平台限制了每個長期訂閱模版訊息每日最多推送 5 次。
選用模板
在公共模板庫中，找到目標模板，按一下“選擇”，進入模板配置頁面。每個公共模版下會有多個關鍵字，開發者可從關鍵字清單中選擇 1 到 5 個關鍵字，最終在 App 上給使用者展示的彈窗內容請參考左側預覽效果，在已選擇清單中拖曳右側的排序按鈕可進行關鍵字順序排列。
TIP
使用同一個公開模版新增為「我的模版」時，關鍵字不可於已新增的「個人模版」重複。
我的模板
從公用模版庫中選擇並完成設定的模版會加入到「我的模版」清單中，開發者可使用「我的模版」中的訊息模版來完成訂閱訊息功能開發。
開發注意事項
- 一次性模版 id 和長期訂閱模版 id 不可同時使用。
- 一次呼叫最多可訂閱 3 則訊息。
- 用戶發生點擊行為後，才可調起訂閱訊息介面。
- 一次授權呼叫裡，每個 tmplId 對應的模板標題不能存在相同的，若出現相同的，只保留一個。
設定
功能目的
設定用戶隱私保護協定，可根據已提供模版直接做修改。
離線小程序
功能說明
離線小程序是內寘在宿主App內的小程序，需要將小程序包從控制台下載下來，導入到宿主App工程中，跟隨App一起打包在App使用過程中，用戶打開某個內寘的小程序，無需從後端拉取下載，即使在沒有網絡連接的情况下也能打開並運行的小程序。
具體功能操作
TIP
離線小程序命名規則：{miniAppId}_{miniAppVersion}.apkg
注意事項
- 離線小程序也需要走正常的小程序綁定應用和發佈流程，只有上線狀態的小程序才可下載離線包。
- 離線小程序適用新版發佈、版本回退、下架等版本管理邏輯，當線上版本與預置版本不一致時，用戶端會正常拉取線上版本。
- 當小程序被下架後，預置在App中的對應離線小程序也無法正常使用。