Mac OS X 系统下安装和部署Egret引擎开发环境

概述

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.确认一下