安裝開發工具
有了《微信小遊戲 - 理論介紹 - 賬號註冊 - 開發前準備》小程序帳號之後,需要一個開發工具來進行開發小程序/遊戲。前往 開發者工具下載頁面 ,根據自己的操作系統下載對應的安裝包進行安裝。有關開發者工具更詳細的介紹可以查看 《開發者工具介紹》 。
最新版本下載地址 (1.02.1810250):Windows 64位 / Windows 32位 / Mac OS
Windows 僅支持 Windows 7 及以上版本。
安裝非常簡單,與普通軟件安裝一致,安裝完成後如下所示:
第一個小遊戲
小遊戲官方開發文檔:https://developers.weixin.qq.com/minigame/dev/index.html?t=18110719
安裝成功後,雙擊圖標運行 “微信開發者工具” ,如下左圖所示,需要管理員或者其它具有開發者權限的微信用戶使用微信掃碼登錄。登錄之後如下右圖所示,選擇 “小程序項目”。
接着點擊如下左圖所示的“+”號新建項目:
項目目錄:需要選擇一個空目錄,或者選擇的非空目錄下存在 app.json
或者 project.config.json
。當選擇空目錄時,可以選擇是否在該目錄下生成一個簡單的項目。如上所示 E:\tencent\yy2048 是一個空目錄,yy2048 目錄會作爲一個項目目錄。
AppID:如果已經成功註冊了小程序(遊戲)賬號,則可以在 “設置-開發設置”,獲取 AppID 信息;也可以前往 小遊戲註冊 通過註冊小遊戲帳號來獲得 AppId;也可以如圖所示選擇申請使用測試號。
項目名稱:建議與“項目目錄”最後一級目錄名稱相同即可,也可以自己重新定義。
建立遊戲快速啓動模板:如果勾選此項,則應用新建之後會自帶微信默認的 Demo 小遊戲—打飛機。不勾選則會新建一個空項目。
點擊“確定”按鈕之後,如下所示應用創建成功:
1)點擊頂部菜單 “編譯” 就可以在 IDE 中預覽小遊戲:
2)點擊工具上的 "編譯" 按鈕,可以在工具的左側模擬器界面看到這個小遊戲的表現。點擊 "預覽" 按鈕,通過微信的掃一掃在手機上可以真機體驗小遊戲。
應用文件結構
小遊戲只有以下兩個必要文件:
├── game.js —— 小遊戲入口文件
└── game.json —— 配置文件,小遊戲開發者通過在根目錄編寫一個 game.json
文件進行配置,詳情請參見小遊戲配置文檔
1)代碼包大小限制:每個小遊戲允許上傳的代碼包總大小爲 4MB。
2)wx API:只能使用 JavaScript 來編寫小遊戲,小遊戲的運行環境是一個綁定了一些方法的 JavaScript VM。不同於瀏覽器,這個運行環境沒有 BOM 和 DOM API,只有 wx API。接下來將介紹如何用 wx API 來完成創建畫布、繪製圖形、顯示圖片以及響應用戶交互等基礎功能。
3)從 js 文件內容可以看出:微信小遊戲默認採用 ECMA Script 6(簡稱ES6)JavaScript 版本進行編寫。雖然使用 ES 5 版本的 JavaScript 編寫也能正常運行,但是不推薦。建議採用 ES 6 風格進行編碼。