安裝環境

概述

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

Node.js

TypeScript

TypeScript代碼編輯器

HTTP服務器(可選)

Chrome(可選)

Egret

這篇文檔中,我們主要介紹在Mac環境中安裝Egret。其安裝步驟如下。

1.安裝Node.js

1.1下載Node.jsNode.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安裝TypeScript當 node.js安裝成功后,node 和 npm 命令就可以使用了。TypeScript的安裝可視直接使用npm命令直接安裝。詳細的安裝方法可以參考TypeScript官網

在終端中輸入如下命令:npm install -g typescript

npm install命令的作用是在開發者的系統中安裝指定的Node.js庫,typescript是庫的名稱,-g代表將這個庫安裝到全局路徑

MacOS用戶如果安裝失敗,請使用 sudo npm install -g typescript 命令確保權限

如果由于網絡問題導致的安裝速度很慢,請使用 npm install -g typescript --registry=http://r.cnpmjs.org 命令,訪問國內鏡像版進行安裝。

2.2驗證TypeScript安裝成功后,執行 tsc 命令,您應該看見如下界面

3.安裝TypeScript代碼編輯器

3.1選擇一個合適的代碼編輯器Egret可以使用任何支持腳本語言的代碼編輯器,包括:

WebStorm官方下載地址【官方推薦】

Microsoft Visual Studio 2012 + TypeScript插件

Sublime Text + TypeScript插件

詳細的編輯器安裝方法以及插件配置方法,可參考文檔中工具相關章節。

4.安裝一個HTTP服務器

4.1選擇一個合適的HTTP服務器Mac用戶可以使用系統自帶的服務器,Mac用戶推薦采用XMAPP

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

具體服務器軟件安裝,大家可以參考文檔中工具相關章節。

5.安裝Chrome瀏覽器

Egret可以運行在絕大多數的現代瀏覽器上,但是 Egret 目前推薦開發者使用 Chrome 作為主要的開發和調試環境。

打開Chrome瀏覽器

設置->工具->JavaScript控制臺

在JavaScript控制臺(右下角)設置(齒輪圖標)-> 常用 -> 禁用瀏覽器緩存

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

6.下載并安裝 Egret

6.1從官網中下載EgretEgret提供兩個下載渠道,一個是Egret官方下載,另外一個是Egret Github下載。

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

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

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

cd ${egret_folder}

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

進入該目錄后,我們執行安裝命令。

npm install -g

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

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

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

系統當前用戶是否有管理員權限,如果不是管理員權限,請執行sudo su命令。

6.3Egret工具驗證

安裝完成后,我們執行egret命令,來查看當前Egret是否安裝成功。如安裝成功,應出現如下圖所示。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容