概述

Egret基于TypeScript開發(fā)的，而TypeScript編譯工具tsc是基于Node.js開發(fā)的。所以在安裝過程中，我們先需要對于基礎支持工具進行安裝。需要安裝的軟件如下：

Node.jsTypeScript代碼編輯器HTTP服務器（可選）Chrome（可選）EgretJava

這篇文檔中，我們主要介紹在Mac環(huán)境中安裝Egret。其安裝步驟如下。

1.安裝Node.js

1.1下載Node.js

Node.js的安裝方法非常簡單，我們可以訪問Node.js官網(wǎng)，然后進點擊頁面中的INSTALL按鈕，可直接下載Node.js的pkg安裝文件包。

本教程撰寫時，Node.js版本為0.10.29，如果你的版本高于此版本，我們會提供相關(guān)的版本兼容說明。如未提供任何版本兼容說明，則表示你的版本適用于Egret。

雙擊pkg安裝包，我們開始安裝Node.js。安裝過程如圖：

下載后的Node.js安裝包

1.2安裝Node.js

開始安裝界面

許可證授權(quán)說明

同意許可證授權(quán)

安裝類型說明

提供管理員權(quán)限，這里your name是你的管理員賬戶名，同時提供賬戶密碼。

安裝過程

安裝完成界面，你的Node.js被安裝到 /usr/local/bin/node目錄下，同時該安裝包還會為你安裝npm工具。

1.3驗證Node.js

安裝完成后，請啟動你的終端，輸入node -v命令，來查看你當前的Node.js版本，同時驗證你的Nodejs是否安裝成功。如果安裝正確，則應出現(xiàn)效果如下圖。

如果出現(xiàn)node: command not found則表示安裝失敗，可以參考下面的Node.js安裝失敗解決方案或者在我們的[開發(fā)者社區(qū)中求助。

1.4驗證npm

在終端中執(zhí)行npm，出現(xiàn)如下圖內(nèi)容，標明你的npm安裝正確。

如果出現(xiàn)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插件

詳細的編輯器安裝方法以及插件配置方法，可參考文檔中工具相關(guān)章節(jié)。

3.安裝一個HTTP服務器

3.1選擇一個合適的HTTP服務器

Mac用戶可以使用系統(tǒng)自帶的服務器，Mac用戶推薦采用XMAPP

用戶也可以跳過這個步驟，使用Egret內(nèi)置的基于Node.js的簡單HTTP服務器。但為了保證更好的開發(fā)體驗，Egret建議用戶安裝上述較為成熟的HTTP服務器

具體服務器軟件安裝，大家可以參考文檔中工具相關(guān)章節(jié)。

4.安裝Chrome瀏覽器

Egret可以運行在絕大多數(shù)的現(xiàn)代瀏覽器上，但是 Egret 目前推薦開發(fā)者使用 Chrome 作為主要的開發(fā)和調(diào)試環(huán)境。

打開Chrome瀏覽器設置->工具->JavaScript控制臺在JavaScript控制臺（右下角）設置（齒輪圖標）-> 常用 -> 禁用瀏覽器緩存

當進行好上述設置之后，只要JavaScript控制臺處于打開狀態(tài)，就不會有瀏覽器緩存，方便調(diào)試。

5.下載并安裝

 Egret5.1從官網(wǎng)中下載Egret

Egret提供兩個下載渠道，一個是Egret官方下載，另外一個是Egret Github下載。

我們推薦大家從官方網(wǎng)站中下載，這里的版本是當前穩(wěn)定版本。如果你從github中下載引擎的開發(fā)版本，該版本非穩(wěn)定版，你可能在實際開發(fā)中遇到許多問題，這些問題通常不會在穩(wěn)定版中出現(xiàn)。

我們打開官方下載頁面，找到“Egret引擎”產(chǎn)品項目，點擊藍色的下載按鈕，下載最新版Egret引擎，如圖。

5.2安裝Egret

將下載后的Egret引擎壓縮包解壓到指定目錄，該目錄可以為任意磁盤中目錄。在終端中敲入命令進入解壓后的目錄。

cd ${egret_folder}

其中${egret_folder}為Egret引擎解壓的路徑。

進入該目錄后，我們執(zhí)行安裝命令。

npm install -g

如果安裝命令錯誤，請檢查如下三項，查看是否正確。

cd ${egret_folder}命令中的路徑是否正確。

當前目錄是否是 Egret目錄（該目錄下存在一個名為 package.json 的文件）

系統(tǒng)當前用戶是否有管理員權(quán)限,如果不是管理員權(quán)限，請執(zhí)行sudo su命令。

5.3Egret工具驗證

安裝完成后，我們執(zhí)行egret命令，來查看當前Egret是否安裝成功。如安裝成功，應出現(xiàn)如下圖所示。

6.Java

在Egret項目的發(fā)布階段需要使用Java 7以上環(huán)境，在打包成為Android APP時也會使用到。以下為大家演示Java的下載與安裝。

6.1下載

a.Java官網(wǎng)的JDK7下載地址

b.百度鏡像

6.2 安裝

a.確認一下，JAVA版本必須為7以上

b.雙擊掛載安裝包

c.雙擊圖標進行安裝

d.一路Next

e.注意授權(quán)

f.確認一下