第一次運行egret項目

Egret Engine文檔地址：https://docs.egret.com/engine/docs/installation/installation

1、引擎安裝     

• windows系統下：下載地址  https://docs.egret.com/engine

• 通過 Launcher 安裝引擎和工具

打開 EgretLauncher ，選擇“引擎”，如下圖。

選擇“工具”，可下載和安裝開發工具

• • Egret Wing 代碼和界面制作工具
  • DragonBones 龍骨動畫制作工具
  • TextureMerger 圖片資源合並工具
  • Res Depot 資源管理工具
  • Egret Feather 粒子制作工具

2、項目構建

1、安裝編譯器

1. 安裝 Egret Launcher 1.2.0 或更高版本
2. 點擊【工具】選項卡，下載【EgretCompiler】
3. 確定 scripts/plugins/webpack-plugin.ts中采用了快速安裝

require('./npm').installFromLauncher(['@egret/egret-webpack-bundler']);
// require('./npm').installDependencies(["@egret/egret-webpack-bundler"]);

4. 執行 egret build 命令,構建腳本會自動在 scripts/plugins/node_modules 中創建相關軟連接

 3、命令行手冊

• create--創建新項目

用法：egret create project_name [--type core|eui]

參數說明：

關鍵字	描述
project_name	項目名稱，按照操作系統的命名規范命名
--type	要創建的項目類型 core 或 eui，默認值為core

舉例：

1、創建名為【HelloWorld】的一個空項目
egret create HelloWorld
2、創建名為【HelloWorld】的一個eui項目
egret create HelloWorld --type eui

• create_lib--創建新第三方庫項目

用法：egret create_lib lib_name

參數說明：

關鍵字	描述
lib_name	第三方庫名稱，按照操作系統的命名規范命名

• build--構建指定項目

用法：egret build [project_name] [--target wxgame|bricks|ios|android]

參數說明：

關鍵字	描述
project_name	項目名稱，按照操作系統的命名規范命名
--target	編譯的目標版本，可選參數有 wxgame：微信小游戲；bricks：玩一玩；android：安卓項目；iOS：iOS項目

                  如果是在項目文件夾下執行命令，可以不加項目名稱

舉例：

1、編譯【HelloWorld】
egret build HelloWorld
2、編譯【HelloWorld】的同時編譯引擎
egret build HelloWorld -e
3、編譯【HelloWorld】的同時編譯微信小游戲項目
egret build HelloWorld --target wxgame　　

• publish--發布項目

用法：egret publish [project_name] [--version [version]] [--target wxgame|bricks|ios|android]

參數說明：

關鍵字	描述
project_name	項目名稱，按照操作系統的命名規范命名
--version	設置發布之后的版本號，可以不設置
--target	編譯的目標版本，可選參數有 wxgame：微信小游戲；bricks：玩一玩；android：安卓項目；iOS：iOS項目

　　　　　　如果是在項目文件夾下執行命令，可以不加項目名稱

舉例：

發布【HelloWorld】到微信小游戲
egret publish HelloWorld --version 0.03 --target wxgame

• run--啟動本地服務器，並在默認瀏覽器中運行指定項目

用法： egret run [project_name] [--port 3000]

參數說明：

關鍵字	描述
project_name	項目名稱，按照操作系統的命名規范命名
--port	指定端口號

　　　　　　如果是在項目文件夾下執行命令，可以不加項目名稱

舉例：

在指定端口下運行【HelloWorld】項目
egret startserver HelloWorld --port 3002

• clean--重置項目中的引擎代碼

 

用法：egret clean [project_name]

參數說明：如果是在項目文件夾下執行命令，可以不加項目名稱

關鍵字	描述
project_name	項目名稱，按照操作系統的命名規范命名

 

• upgrade--升級項目代碼

Egret Launcher v1.0 之后的 upgrade

用法：egret upgrade [project_name] --egretversion [target version]

參數說明：

關鍵字	描述
project_name	項目名稱，按照操作系統的命名規范命名
target version	要切換的目標版本號

　　　　如果是在項目文件夾下執行命令，可以不加項目名稱

舉例：

升級當前目錄下項目到 5.1.0
egret upgrade --egretversion 5.1.0

　　

Egret Launcher v1.0之前的 upgrade

用法：egret upgrade [project_name]

參數說明：

關鍵字	描述
project_name	項目名稱，按照操作系統的命名規范命名

　　　　如果是在項目文件夾下執行命令，可以不加項目名稱

舉例：

升級【HelloWorld】項目
egret upgrade HelloWorld

　　

關於 Egret Launcher v1.0 中項目降版本的說明

1. 修改項目根目錄下的配置文件 'egretProperties.json' 中的 'egret_version' 字段下的版本號
2. 執行 egret clean 后項目降到目標版本

• make--修改引擎源碼后，編譯引擎源碼。如果沒有特殊需求，不建議普通用戶使用

用法：egret make

• info--獲得Egret信息，如當前Egret版本，以及安裝路徑

用法：egret info

• help--了解各個 command 的細節

用法：egret help [command]