開發一個小程序通常包括以下步驟:
下載 IDE
下載小程序開發者工具(IDE):
創建小程序
下載并安裝小程序 IDE 后,打開 IDE,在左側列表中單擊 小程序 ,并單擊右側的 + 打開創建頁面,單擊 mPaaS,選擇模板。
在創建項目頁面輸入 項目名稱 并指定 項目路徑,單擊 完成 即可創建小程序項目。
uniapp 模板建議使用 v18 以下的 node 版本。因為 uniapp 模板可能與較新版本的 node 存在兼容性問題,因此建議使用較舊的 node 版本來避免潛在的問題。
使用 yarn 進行依賴安裝,操作如下:
打開命令行工具,進入項目所在的根目錄。
運行
yarn install
命令。
通過以上操作,將成功安裝所需依賴并啟動開發環境,即可開始進行 uniapp 項目的開發和測試。
下載配置文件
每創建一個新的環境,都需要上傳從控制臺下載的對應小程序的 IDE 配置文件。
前往 mPaaS 控制臺 > 小程序 > 小程序發布 > 配置管理,進入下載配置文件頁面,在 IDE 配置管理 中單擊 下載配置文件,下載小程序 IDE 配置文件。
說明該 IDE 配置文件 不同于 mPaaS 應用的配置文件。
單擊 下載配置文件 后,會彈出 下載配置文件 窗口,您需要在 動態密碼 中輸入一個密碼,該密碼就是之后登錄 IDE 時所使用的登錄密碼。
說明下載的配置文件默認名稱為
config.json
。
登錄小程序 IDE
登錄小程序 IDE 支持兩種方式:
動態密碼登錄方式
在小程序 IDE 中,單擊左上方的 登錄。
若未創建過登錄環境,會彈出添加環境窗口;若已創建過登錄環境,則會彈出登錄窗口。
如果您是 第一次創建登錄環境,則在當前窗口輸入環境名稱,并上傳從 mPaaS 控制臺下載的 小程序 IDE 配置文件(
config.json
文件)。如果您 已創建過登錄環境,則單擊窗口頂部的環境選擇菜單,并選擇菜單底部的 + 添加環境,并輸入環境名稱,上傳從 mPaaS 控制臺下載的 小程序 IDE 配置文件(
config.json
文件)。
單擊 確定,即可創建新的登錄環境。
成功新增登錄環境后,在登錄窗口中,輸入賬號密碼登錄。
賬號是登錄阿里云控制臺的用戶名。
密碼是在 下載配置文件 時設置的 動態密碼。
Aliyun AccessKey 登錄方式
使用 Aliyun AccessKey 登錄方式需 升級 mPaaS 小程序 IDE 至 2.9 及以上版本。
鼠標懸浮于阿里云控制臺右上角頭像,單擊 AccessKey 管理,開啟 Aliyun AccessKey。
重要可以使用云賬號的 AccessKey 進行 API 調用,也可使用 RAM 用戶的 AccessKey 進行 API 調用。
如果使用云賬號的 AccessKey 進行 API 調用,需先 獲取AccessKey。
由于 RAM 用戶權限可控、方便管理,更建議使用 RAM 用戶(而不是云賬號)的 AccessKey 進行 API 調用。
單擊 開始使用子用戶 AccessKey(即使用 RAM 用戶的 AccessKey 進行 API 調用為例)。
單擊 創建用戶,打開 創建用戶 頁面。
輸入 登錄名稱 和 顯示名稱,勾選 Open API 調用訪問,單擊 確定,創建子賬號用戶。
復制并妥善保管好生成的 AccessKey ID 以及 AccessKey Secret(如果未復制,可以再次生成)。
單擊用戶操作列的 添加權限,打開 添加權限 頁面。
選擇權限搜索框中輸入 MpaaSFullAccess,選擇 AliyunMpaaSFullAccess,單擊 確定。為創建的用戶添加 mPaaS 權限 。
使用編輯器打開前面下載的 配置文件,并填入以下內容保存。
{ // 原配置文件內容, "openapi": { "type": "aliyun", "accessKeyId": "步驟 5 生成的 AccessKey ID", "accessKeySecret": "步驟 5 生成的 AccessKey Secret", "endpoint": "mpaas.cn-hangzhou.aliyuncs.com", "userId": "步驟 5 輸入的用戶名" } }
在 mPaaS 小程序 IDE 中單擊 登錄,打開 登錄 界面。
單擊 + 添加環境,打開 新增登錄環境 頁面。
輸入 環境名稱、上傳步驟 8 中配置好的 配置文件,單擊 確定。
登錄框中配置文件類型顯示為 Aliyun AccessKey,單擊 登錄,即可。
選擇關聯小程序
登錄 IDE 后,在界面左上方,單擊 選擇關聯小程序,在下拉菜單中選擇在控制臺中創建的小程序。
編輯代碼
選擇關聯小程序后,您就可以開始編輯小程序代碼了。
上傳小程序
完成代碼編輯后,單擊 IDE 界面右上方的 上傳,即可將小程序上傳至 mPaaS 控制臺。