12月28日微信迎來更新，正式上線小遊戲，並開放了小遊戲開發文件和開發者工具。在微信釋出新版本後，白鷺引擎立即添加了對於微信小遊戲開發的支援，開發者只需要使用白鷺引擎的最新版本，通過使用白鷺引擎完整工具流，就可以快速建立、開發與釋出微信小遊戲，而無需過多的關注底層技術細節。

1.如何建立微信小遊戲專案

（1）建立微信小遊戲專案需要您需要下載白鷺引擎最新版本，首先建立一個新的白鷺引擎專案。

（2）建立專案之後，點選專案設定按鈕，將釋出平臺設定為微信小遊戲，並下載白鷺引擎提供的微信小遊戲支援庫 。

（3）最後在專案配置中填寫 appid,projectname等內容後，點擊發布，即可將您的遊戲釋出到微信開發者工具中。

（4）在釋出之後，您可以在到微信開發者工具中預覽及除錯您的遊戲。

2.如何將現有白鷺引擎專案遷移至微信小遊戲

由於微信小遊戲與傳統的HTML5遊戲的底層機制有較大差異，所以使用白鷺引擎開發的 HTML5 遊戲需要一定的開發工作量才能移植為一款微信小遊戲。整體步驟分為三步：

• 將一款白鷺引擎遊戲升級至 5.1.1 版本；
• 將該遊戲的釋出目標設定為微信小遊戲；
• 進行適配性修改。

具體這三步的處理方式如下：

（1）將一款白鷺引擎遊戲升級至 5.1.1 版本

白鷺引擎 5.1 目前暫不支援使用 egret upgrade 命令進行升級，請您下載 5.1 版本後，建立一個 5.1 新專案，然後將現有遊戲邏輯和資源拷貝至新專案中。後續無論是 HTML5 版本，iOS / Android 版本還是小遊戲版本，均使用這個新專案進行後續開發。

如果您的專案使用了 EUI，請將 EUI 的釋出模式設定為 commonjs，並修改您的 ThemeAdapter.ts的實現，具體可以參考 5.1.1 版本建立的新專案的實現方式。
升級至 5.1.1 這一步驟可能佔用您大約兩小時至兩天時間。主要風險在於引擎升級後，也許存在一些渲染錯誤的 BUG，經過了一個多月的內部測試以及多個開發者團隊的反饋，我們已經解決了已知的所有問題，穩定性可以基本保障。但是如果您發現了問題，請及時與白鷺引擎團隊聯絡，並提供可以復現的 Demo，白鷺引擎官方團隊會第一時間處理。

（2）將遊戲釋出目標設定為微信小遊戲

在執行這一步驟前，建議開發者首先建立一個新專案，並將新專案的釋出目標設定為微信小遊戲，將其釋出並確保可以在微信IDE里正確預覽，這樣您會對整個專案結構更加熟悉。

通過白鷺最新的 Egret Launcher ，您可以直接將遊戲釋出目標設定為微信小遊戲，如果您更偏愛命令列的呼叫方式，可以採用如下的呼叫方式：

執行上述步驟之後，您可以使用微信開發者工具開啟專案，就可以看到您的專案了。

（3）進行適配性修改

上述步驟均完成後，您就可以將您的專案遷入微信小遊戲中，為了給終端使用者提供更好的使用者體驗，微信小遊戲對您的遊戲存在一些技術限制，針對微信小遊戲現在公佈的製作標準其進行改造可能佔用您一天至一個星期。具體限制如下：

• 禁止 eval , new Function 等動態程式碼載入機制，白鷺引擎的 EUI 使用了這種方式，已經通過將主題檔案的釋出策略改為 commonjs 進行了規避，如果您的專案採用了上述動態程式碼機制，需要採用其他方式實現。
• 微信小遊戲沒有直接執行 JavaScript 檔案的介面，都是通過 require() 方式進行載入，除了禁止動態載入外，require 由於是基於CommonJS 的模組機制，所以不支援全域性物件，如果您的專案中存在了全域性物件的跨檔案訪問，需要設定 window.object1 = object1 這樣的方式強制將特定物件轉為全域性物件。由於白鷺引擎的專案會將您的專案所有檔案編譯為一個檔案，所以這種問題主要出現在 main.js 檔案與其他第三方庫檔案之間的全域性呼叫上。
• 遊戲總體積不得大於 4M，目前引擎的體積佔用為 800k 左右，目前比較大的佔用是生成的 commonjs 格式的面板檔案，如果您的面板檔案過大導致體積過大，請等待白鷺引擎後續版本的持續迭代優化
• 如果您的遊戲資源大於4M，可以使用動態載入的機制，動態載入檔案的快取不得大於 50M，如果您的資源總體積可以控制在 50M 以內，只需要將部分資原始檔不放置到專案中即可，但是如果總體積大於 50M，您需要設計資源的快取儲存和釋放策略。再次強調，程式碼檔案必須放在遊戲包中，不可以動態載入。
• 需要對接微信相關介面，如使用者資訊、社交關係等，具體請參見微信提供的 API 文件與示例。

3.後續路線圖

微信小遊戲上線或將為HTML5行業帶來重要利好，為行業帶來機遇與挑戰，後續發展有待行業從業者共同探索。白鷺科技作為HTML5引擎研發商致力於為開發者提供更為便捷的開發，白鷺引擎後續會與微信團隊進行進一步的技術合作，完善使用白鷺引擎開發微信小遊戲的開發體驗。主要包含：

• 將微信的檔案讀寫 API 與白鷺引擎資源管理器進行更緊密的整合。
• 開發效率與工作流優化。