Configure Development Environment

1.安装node.js开发环境：

Egret项目依赖于node.js环境。开发者请先下载并安装 nodejs环境

扩展阅读:什么是 node.js，为什么 Egret 需要它

• 在node.js官网下载并安装node.js
• 启动命令行，执行 node 您应该看见如下界面

>

如果您的命令行输出 找不到该命令 node，则表示安装失败，请参见下文 Node.js安装失败解决方案

• 执行 Ctrl + C 返回到命令行，执行 npm 您应该看见如下界面

Usage: npm <command>

where <command> is one of:
    add-user, adduser, apihelp, author, bin, bugs, c, cache,
    completion, config, ddp, dedupe, deprecate, docs, edit,
    explore, faq, find, find-dupes, get, help, help-search,
    home, i, info, init, install, isntall, issues, la, link,
    list, ll, ln, login, ls, outdated, owner, pack, prefix,
    prune, publish, r, rb, rebuild, remove, repo, restart, rm,
    root, run-script, s, se, search, set, show, shrinkwrap,
    star, stars, start, stop, submodule, tag, test, tst, un,
    uninstall, unlink, unpublish, unstar, up, update, version,
    view, whoami

npm <cmd> -h     quick help on <cmd>
npm -l           display full usage info
npm faq          commonly asked questions
npm help <term>  search for help on <term>
npm help npm     involved overview

如果您的命令行输出 找不到该命令 npm，则表示安装失败，请参见下文 Node.js安装失败解决方案

Node.js安装失败解决方案

• 部分MacOS 安装nodejs的pkg安装包时会显示安装失败，可以通过下载nodejs源代码手动编译解决
• 部分Windows安装完成后直接在cmd里输入node和npm，可能会提示找不到该命令。是由于新增的Path路径需要重启才能生效。重启或使用node和npm的绝对路径来运行命令即可。

2.安装TypeScript：

当 node.js安装成功后，node 和 npm 命令就可以使用了。

打开命令行，执行npm install -g typescript安装TypeScript，具体可以参见TypeScript官网

npm install命令的作用是在开发者的系统中安装指定的node.js库，typescript是库的名称，-g代表将这个库安装到全局路径

MacOS用户如果安装失败，请使用 sudo npm install -g typescript 命令确保权限

如果由于网络问题导致的安装速度很慢，请使用 npm install -g typescript --registry=http://r.cnpmjs.org 命令，访问国内镜像版进行安装

安装成功后，执行 tsc命令，您应该看见如下界面

Version 1.0.1.0
Syntax:   tsc [options] [file ..]

Examples: tsc hello.ts
          tsc --out foo.js foo.ts
          tsc @args.txt

3.准备一个TypeScript代码编辑器

Egret可以使用任何支持 TypeScript语言的编辑器，包括：

• WebStorm 官方下载地址 【官方推荐】
• Microsoft Visual Studio 2012 + TypeScript插件
• Sublime Text + TypeScript插件

4.安装一个HTTP服务器（可选）

MacOS用户可以使用系统自带的服务器，Windows用户推荐采用XMAPP

用户也可以跳过这个步骤，使用Egret内置的基于Node.js的简单HTTP服务器。但是为了保证更好的开发体验，Egret建议用户安装上述较为成熟的HTTP服务器

5.安装 Chrome 浏览器（可选）

Egret可以运行在绝大多数的现代浏览器上，但是 Egret 目前推荐开发者使用 Chrome 作为主要的开发和调试环境。

• 打开Chrome浏览器
• 设置->工具->JavaScript控制台
• 在JavaScript控制台（右下角）设置（齿轮图标）-> 常用 -> 禁用浏览器缓存

当进行好上述设置之后，只要JavaScript控制台处于打开状态，就不会有浏览器缓存，方便调试

6.下载并安装 Egret

• 将Egret下载并解压至操作系统中的任意位置，启动一个命令行终端，输入以下命令

cd ${egret_folder}
npm install -g 

如果上述命令执行失败，请先查看

• 当前目录是否是 Egret目录（该目录下存在一个名为 package.json 的文件）
• 系统当前用户是否有管理员权限

• 安装成功后，执行 egret命令，如果能显示以下信息，则表示安装成功

用法: egret <command> [-v]
command 列表:
    build                         构建指定项目,编译指定项目的 TypeScript 文件
    create                        创建新项目
    startserver                   启动HttpServer,并在默认浏览器中打开指定项目
参数列表:
    -v                            打印详细日志
使用 egret help <command> 了解各个 command 的细节

7.创建新项目

当上述步骤全部完成时，表示 Egret 已经安装成功！您可以访问这里创建您的第一个 Egret 游戏项目！