概述
Egret基於TypeScript開發的,而TypeScript編譯工具tsc是基於Node.js開發的。所以在安裝過程中,我們先需要對於基礎支援工具進行安裝。需要安裝的軟體如下:
Node.jsTypeScript代碼編輯器HTTP伺服器(可選)Chrome(可選)EgretJava
這篇文檔中,我們主要介紹在Mac環境中安裝Egret。其安裝步驟如下。
1.安裝Node.js
1.1下載Node.js
Node.js的安裝方法非常簡單,我們可以訪問Node.js官網,然後進點擊頁面中的INSTALL按鈕,可直接下載Node.js的pkg安裝檔案包。
本教程撰寫時,Node.js版本為0.10.29,如果你的版本高於此版本,我們會提供相關的版本相容說明。如未提供任何版本相容說明,則表示你的版本適用於Egret。
雙擊pkg安裝包,我們開始安裝Node.js。安裝過程如圖:
下載後的Node.js安裝包
1.2安裝Node.js
開始安裝介面
許可證授權說明
同意許可證授權
安裝類型說明
提供管理員權限,這裡your name是你的管理員賬戶名,同時提供賬戶密碼。
安裝過程
安裝完成介面,你的Node.js被安裝到 /usr/local/bin/node
目錄下,同時該安裝包還會為你安裝npm工具。
1.3驗證Node.js
安裝完成後,請啟動你的終端,輸入node -v
命令,來查看你當前的Node.js版本,同時驗證你的Nodejs是否安裝成功。如果安裝正確,則應出現效果如下圖。
如果出現node: command not found
則表示安裝失敗,可以參考下面的Node.js安裝失敗解決方案或者在我們的[開發人員社區中求助。
1.4驗證npm
在終端中執行npm
,出現如下圖內容,標明你的npm安裝正確。
如果出現npm: command not found
則表示安裝失敗,可以參考下面的Node.js安裝失敗解決方案。
1.5Node.js安裝失敗解決方案
部分MacOS 安裝nodejs的pkg安裝包時會顯示安裝失敗,可以通過下載nodejs原始碼手動編譯解決。
2.安裝TypeScript代碼編輯器
2.1選擇一個合適的代碼編輯器
Egret可以使用任何支援指令碼語言的代碼編輯器,包括:
WebStorm 官方下載地址
【官方推薦】Microsoft Visual Studio 2012 + TypeScript外掛程式Sublime Text + TypeScript外掛程式
詳細的編輯器安裝方法以及外掛程式配置方法,可參考文檔中工具相關章節。
3.安裝一個HTTP伺服器
3.1選擇一個合適的HTTP伺服器
Mac使用者可以使用系統內建的伺服器,Mac使用者推薦採用XMAPP
使用者也可以跳過這個步驟,使用Egret內建的基於Node.js的簡單HTTP伺服器。但為了保證更好的開發體驗,Egret建議使用者安裝上述較為成熟的HTTP伺服器
具體伺服器軟體安裝,大家可以參考文檔中工具相關章節。
4.安裝Chrome瀏覽器
Egret可以運行在絕大多數的現代瀏覽器上,但是 Egret 目前推薦開發人員使用 Chrome 作為主要的開發和調試環境。
開啟Chrome瀏覽器設定->工具->JavaScript控制台在JavaScript控制台(右下角)設定(齒輪表徵圖)-> 常用 -> 禁用瀏覽器緩衝
當進行好上述設定之後,只要JavaScript控制台處於開啟狀態,就不會有瀏覽器緩衝,方便調試。
5.下載並安裝
Egret5.1從官網中下載Egret
Egret提供兩個下載渠道,一個是Egret官方下載,另外一個是Egret Github下載。
我們推薦大家從官方網站中下載,這裡的版本是當前穩定版本。如果你從github中下載引擎的開發版本,該版本非穩定版,你可能在實際開發中遇到許多問題,這些問題通常不會在穩定版中出現。
我們開啟官方下載頁面,找到“Egret引擎”產品項目,點擊藍色的下載按鈕,下載最新版Egret引擎,如圖。
5.2安裝Egret
將下載後的Egret引擎壓縮包解壓到指定目錄,該目錄可以為任意磁碟中目錄。在終端中敲入命令進入解壓後的目錄。
cd ${egret_folder}
其中${egret_folder}
為Egret引擎解壓的路徑。
進入該目錄後,我們執行安裝命令。
npm install -g
如果安裝命令錯誤,請檢查如下三項,查看是否正確。
cd ${egret_folder}
命令中的路徑是否正確。
目前的目錄是否是 Egret目錄(該目錄下存在一個名為 package.json
的檔案)
系統目前使用者是否有管理員權限,如果不是管理員權限,請執行sudo su
命令。
5.3Egret工具驗證
安裝完成後,我們執行egret
命令,來查看當前Egret是否安裝成功。如安裝成功,應出現如下圖所示。
6.Java
在Egret項目的發布階段需要使用Java 7以上環境,在打包成為Android APP時也會使用到。以下為大家示範Java的下載與安裝。
6.1下載
a.Java官網的JDK7下載地址
b.百度鏡像
6.2 安裝
a.確認一下,JAVA版本必須為7以上
b.雙擊掛載安裝包
c.雙擊表徵圖進行安裝
d.一路Next
e.注意授權
f.確認一下