- 06-微信小程序-注冊程序
文章目錄
- 注冊小程序
- 參數 Object object
- 案例代碼
- 場景值
- 場景值作用
- 場景值列表
- 案例代碼
注冊小程序
每個小程序都需要在 app.js
中調用 App
方法注冊小程序實例,綁定生命周期回調函數、錯誤監聽和頁面不存在監聽函數等。
詳細的參數含義和使用請參考 App 參考文檔 。
注冊小程序。接受一個 Object
參數,其指定小程序的生命周期回調等。
App() 必須在 app.js
中調用,必須調用且只能調用一次。不然會出現無法預期的后果。
參數 Object object
屬性 | 類型 | 默認值 | 必填 | 說明 | 最低版本 |
---|---|---|---|---|---|
onLaunch | function | 否 | 生命周期回調——監聽小程序初始化。 | ||
onShow | function | 否 | 生命周期回調——監聽小程序啟動或切前臺。 | ||
onHide | function | 否 | 生命周期回調——監聽小程序切后臺。 | ||
onError | function | 否 | 錯誤監聽函數。 | ||
onPageNotFound | function | 否 | 頁面不存在監聽函數。 | 1.9.90 | |
onUnhandledRejection | function | 否 | 未處理的 Promise 拒絕事件監聽函數。 | 2.10.0 | |
onThemeChange | function | 否 | 監聽系統主題變化 | 2.11.0 | |
其他 | any | 否 | 開發者可以添加任意的函數或數據變量到 Object 參數中,用 this 可以訪問 |
前臺、后臺定義: 當用戶點擊左上角關閉,或者按了設備 Home 鍵離開微信,小程序并沒有直接銷毀,而是 進入了后臺;當再次進入微信或再次打開小程序,又會從后臺進入前臺。需要注意的是:只有當小程序進入 后臺一定時間,或者系統資源占用過高,才會被真正的銷毀。
案例代碼
App({onLaunch(options) {// Do something initial when launch.console.log("小程序加載成功");},onShow(options) {// Do something when show.console.log("小程序顯示");},onHide() {// Do something when hide.console.log("小程序隱藏");},onError(msg) {console.log(msg)},globalData: 'I am global data'})
App({onLaunch() {// 展示本地存儲能力const logs = wx.getStorageSync('logs') || []logs.unshift(Date.now())wx.setStorageSync('logs', logs)// 登錄wx.login({success: res => {// 發送 res.code 到后臺換取 openId, sessionKey, unionId}})},globalData: {userInfo: null}
})
- 效果
當使用真機調試,手機按下home鍵,顯示小程序隱藏
場景值
場景值作用
場景值在高級小程序開發中扮演重要角色,它可以幫助我們優化用戶體驗,提升程序性能。通過合理設置場景值,我們可以在不同場景下提供定制化的功能體驗,實現流暢的交互效果。同時,場景值還可以幫助我們收集用戶行為數據,為后續開發提供寶貴的反饋信息。
場景值列表
關于場景值的詳細說明和獲取方式請參考 指南-場景值
場景值ID | 說明 | 圖例 |
---|---|---|
1000 | 其他 | / |
1001 | 發現頁小程序「最近使用」列表(基礎庫2.2.4-2.29.0版本包含「我的小程序」列表,2.29.1版本起僅為「最近使用」列表) | / |
1005 | 微信首頁頂部搜索框的搜索結果頁 | 查看 |
1006 | 發現欄小程序主入口搜索框的搜索結果頁 | 查看 |
1007 | 單人聊天會話中的小程序消息卡片 | 查看 |
1008 | 群聊會話中的小程序消息卡片 | 查看 |
1010 | 收藏夾 | 查看 |
1011 | 掃描二維碼 | 查看 |
1012 | 長按圖片識別二維碼 | 查看 |
1013 | 掃描手機相冊中選取的二維碼 | 查看 |
1014 | 小程序訂閱消息(與1107相同) | 查看 |
1017 | 前往小程序體驗版的入口頁 | 查看 |
1019 | 微信錢包(微信客戶端7.0.0版本改為支付入口) | 查看 |
1020 | 公眾號 profile 頁相關小程序列表(已廢棄) | 查看 |
1022 | 聊天頂部置頂小程序入口(微信客戶端6.6.1版本起廢棄) | / |
1023 | 安卓系統桌面圖標 | 查看 |
1024 | 小程序 profile 頁 | 查看 |
1025 | 掃描一維碼 | 查看 |
1026 | 發現欄小程序主入口,「附近的小程序」列表 | 查看 |
1027 | 微信首頁頂部搜索框搜索結果頁「使用過的小程序」列表 | 查看 |
1028 | 我的卡包 | 查看 |
1029 | 小程序中的卡券詳情頁 | 查看 |
1030 | 自動化測試下打開小程序 | / |
1031 | 長按圖片識別一維碼 | 查看 |
1032 | 掃描手機相冊中選取的一維碼 | 查看 |
1034 | 微信支付完成頁 | 查看 |
1035 | 公眾號自定義菜單 | 查看 |
1036 | App 分享消息卡片 | 查看 |
1037 | 小程序打開小程序 | 查看 |
1038 | 從另一個小程序返回 | 查看 |
1039 | 搖電視 | 查看 |
1042 | 添加好友搜索框的搜索結果頁 | 查看 |
1043 | 公眾號模板消息 | 查看 |
1044 | 帶 shareTicket 的小程序消息卡片 詳情 | 查看 |
1045 | 朋友圈廣告 | 查看 |
1046 | 朋友圈廣告詳情頁 | 查看 |
1047 | 掃描小程序碼 | 查看 |
1048 | 長按圖片識別小程序碼 | 查看 |
1049 | 掃描手機相冊中選取的小程序碼 | 查看 |
1052 | 卡券的適用門店列表 | 查看 |
1053 | 搜一搜的結果頁 | 查看 |
1054 | 頂部搜索框小程序快捷入口(微信客戶端版本6.7.4起廢棄) | / |
1056 | 聊天頂部音樂播放器右上角菜單 | 查看 |
1057 | 錢包中的銀行卡詳情頁 | 查看 |
1058 | 公眾號文章 | 查看 |
1059 | 體驗版小程序綁定邀請頁 | / |
1060 | 微信支付完成頁(與1034相同) | / |
1064 | 微信首頁連Wi-Fi狀態欄 | 查看 |
1065 | URL scheme 詳情 | / |
1067 | 公眾號文章廣告 | 查看 |
1068 | 附近小程序列表廣告(已廢棄) | / |
1069 | 移動應用通過openSDK進入微信,打開小程序 | 查看 |
1071 | 錢包中的銀行卡列表頁 | 查看 |
1072 | 二維碼收款頁面 | 查看 |
1073 | 客服消息列表下發的小程序消息卡片 | 查看 |
1074 | 公眾號會話下發的小程序消息卡片 | 查看 |
1077 | 搖周邊 | 查看 |
1078 | 微信連Wi-Fi成功提示頁 | 查看 |
1079 | 微信游戲中心 | 查看 |
1081 | 客服消息下發的文字鏈 | 查看 |
1082 | 公眾號會話下發的文字鏈 | 查看 |
1084 | 朋友圈廣告原生頁 | 查看 |
1088 | 會話中查看系統消息,打開小程序 | / |
1089 | 微信聊天主界面下拉,「最近使用」欄(基礎庫2.2.4-2.29.0版本包含「我的小程序」欄,2.29.1版本起僅為「最近使用」欄 | 查看 |
1090 | 長按小程序右上角菜單喚出最近使用歷史 | 查看 |
1091 | 公眾號文章商品卡片 | 查看 |
1092 | 城市服務入口 | 查看 |
1095 | 小程序廣告組件 | 查看 |
1096 | 聊天記錄,打開小程序 | 查看 |
1097 | 微信支付簽約原生頁,打開小程序 | 查看 |
1099 | 頁面內嵌插件 | / |
1100 | 紅包封面詳情頁打開小程序 | 查看 |
1101 | 遠程調試熱更新(開發者工具中,預覽 -> 自動預覽 -> 編譯并預覽) | 查看 |
1102 | 公眾號 profile 頁服務預覽 | 查看 |
1103 | 發現頁小程序「我的小程序」列表(基礎庫2.2.4-2.29.0版本廢棄,2.29.1版本起生效) | / |
1104 | 微信聊天主界面下拉,「我的小程序」欄(基礎庫2.2.4-2.29.0版本廢棄,2.29.1版本起生效) | / |
1106 | 聊天主界面下拉,從頂部搜索結果頁,打開小程序 | / |
1107 | 訂閱消息,打開小程序 | / |
1113 | 安卓手機負一屏,打開小程序(三星) | / |
1114 | 安卓手機側邊欄,打開小程序(三星) | / |
1119 | 【企業微信】工作臺內打開小程序 | 查看 |
1120 | 【企業微信】個人資料頁內打開小程序 | 查看 |
1121 | 【企業微信】聊天加號附件框內打開小程序 | 查看 |
1124 | 掃“一物一碼”打開小程序 | / |
1125 | 長按圖片識別“一物一碼” | / |
1126 | 掃描手機相冊中選取的“一物一碼” | / |
1129 | 微信爬蟲訪問 詳情 | / |
1131 | 浮窗(8.0版本起僅包含被動浮窗) | / |
1133 | 硬件設備打開小程序 詳情 | / |
1135 | 小程序profile頁相關小程序列表,打開小程序 | 查看 |
1144 | 公眾號文章 - 視頻貼片 | 查看 |
1145 | 發現欄 - 發現小程序 | 查看 |
1146 | 地理位置信息打開出行類小程序 | 查看 |
1148 | 卡包-交通卡,打開小程序 | / |
1150 | 掃一掃商品條碼結果頁打開小程序 | 查看 |
1151 | 發現欄 - 我的訂單 | 查看 |
1152 | 訂閱號視頻打開小程序 | 查看 |
1153 | “識物”結果頁打開小程序 | 查看 |
1154 | 朋友圈內打開“單頁模式” | 查看 |
1155 | “單頁模式”打開小程序 | 查看 |
1157 | 服務號會話頁打開小程序 | 查看 |
1158 | 群工具打開小程序 | 查看 |
1160 | 群待辦 | 查看 |
1167 | H5 通過開放標簽打開小程序 詳情 | / |
1168 | 移動/網站應用直接運行小程序 | / |
1169 | 發現欄小程序主入口,各個生活服務入口(例如快遞服務、出行服務等) | 查看 |
1171 | 微信運動記錄(僅安卓) | 查看 |
1173 | 聊天素材用小程序打開 詳情 | 查看 |
1175 | 視頻號主頁商店入口 | 查看 |
1176 | 視頻號直播間主播打開小程序 | 查看 |
1177 | 視頻號直播商品 | 查看 |
1178 | 在電腦打開手機上打開的小程序 | 查看 |
1179 | #話題頁打開小程序 | 查看 |
1181 | 網站應用打開PC小程序 | / |
1183 | PC微信 - 小程序面板 - 發現小程序 - 搜索 | 查看 |
1184 | 視頻號鏈接打開小程序 | 查看 |
1185 | 群公告 | 查看 |
1186 | 收藏 - 筆記 | 查看 |
1187 | 浮窗(8.0版本起) | 查看 |
1189 | 表情雨廣告 | 查看 |
1191 | 視頻號活動 | 查看 |
1192 | 企業微信聯系人profile頁 | 查看 |
1193 | 視頻號主頁服務菜單打開小程序 | 查看 |
1194 | URL Link 詳情 | / |
1195 | 視頻號主頁商品tab | 查看 |
1196 | 個人狀態打開小程序 | 查看 |
1197 | 視頻號主播從直播間返回小游戲 | 查看 |
1198 | 視頻號開播界面打開小游戲 | 查看 |
1200 | 視頻號廣告打開小程序 | 查看 |
1201 | 視頻號廣告詳情頁打開小程序 | 查看 |
1202 | 企微客服號會話打開小程序卡片 | 查看 |
1203 | 微信小程序壓測工具的請求 | / |
1206 | 視頻號小游戲直播間打開小游戲 | 查看 |
1207 | 企微客服號會話打開小程序文字鏈 | 查看 |
1208 | 聊天打開商品卡片 | 查看 |
1212 | 青少年模式申請頁打開小程序 | 查看 |
1215 | 廣告預約打開小程序 | / |
1216 | 視頻號訂單中心打開小程序 | 查看 |
1223 | 安卓桌面Widget打開小程序 | 查看 |
1228 | 視頻號原生廣告組件打開小程序 | 查看 |
1230 | 訂閱號H5廣告進入小程序 | 查看 |
1231 | 動態消息提醒入口打開小程序 | 查看 |
1242 | 小程序發現頁門店快送模塊頻道頁進入小程序 | 查看 |
1245 | 小程序發現頁門店快送搜索結果頁進入小程序 | 查看 |
1248 | 通過小程序帳號遷移進入小程序 | / |
1252 | 搜一搜小程序搜索頁「小功能」模塊進入小程序 | 查看 |
案例代碼
App({onLaunch(options) {// Do something initial when launch.console.log("小程序加載成功,場景->"+options.scene);},onShow(options) {// Do something when show.console.log("小程序顯示");},onHide() {// Do something when hide.console.log("小程序隱藏");},onError(msg) {console.log(msg)},globalData: 'I am global data'})
- 模擬器
- 真機調試
下一章節 微信小程序-注冊頁面-模塊化