Egret入门第一步——Windows 系统下安装
集成开发包地址:http://www.egret-labs.org/egretengine概述
Egret基于TypeScript开发的,而TypeScript编译工具tsc是基于Node.js开发的。所以在安装过程中,我们先需要对于基础支持工具进行安装。 需要安装的软件如下:
[*]Node.js
[*]TypeScript
[*]TypeScript代码编辑器
[*]HTTP服务器(可选)
[*]Chrome(可选)
[*]Egret
这篇文档中,我们主要介绍在Windows环境中安装Egret。其安装步骤如下。
1.安装Node.js1.1下载Node.jsNode.js的安装方法非常简单,我们可以访问Node.js官网,然后进点击页面中的INSTALL按钮,可直接下载Node.js的msi安装文件包。
http://docs.egret-labs.org/assets/img/egretinstallwin1.png
本教程撰写时,Node.js版本为0.10.29,如果你的版本高于此版本,我们会提供相关的版本兼容说明。如未提供任何版本兼容说明,则表示你的版本适用于Egret。
双击msi安装包,我们开始安装Node.js。安装过程如图:
http://docs.egret-labs.org/assets/img/egretinstallwin3.png
下载后的Node.js安装包
1.2安装Node.js
http://docs.egret-labs.org/assets/img/egretinstallwin7.png
开始安装界面
http://docs.egret-labs.org/assets/img/egretinstallwin8.png
许可证授权说明
http://docs.egret-labs.org/assets/img/egretinstallwin9.png
选择安装目录,我们保持默认选项
http://docs.egret-labs.org/assets/img/egretinstallwin10.png
选择安装内容,我们将所有工具包全部安装
http://docs.egret-labs.org/assets/img/egretinstallwin11.png
确认安装,点击“Install”按钮
http://docs.egret-labs.org/assets/img/egretinstallwin12.png
安装过程
http://docs.egret-labs.org/assets/img/egretinstallwin13.png
安装完成界面,你的Node.js被安装到 C:\Program Files\nodejs\目录下,同时该安装包还会为你安装npm工具。
1.3验证Node.js安装完成后,请启动你的命令行工具,输入node -v命令,来查看你当前的Node.js版本,同时验证你的Nodejs是否安装成功。如果安装正确,则应出现效果如下图。
http://docs.egret-labs.org/assets/img/egretinstallwin5.png
在开始——>搜索中输入cmd即可运行命令行工具。
http://docs.egret-labs.org/assets/img/egretinstallwin6.png
http://docs.egret-labs.org/assets/img/egretinstallwin14.png
如果出现node 不是内部或外部命令,也不是可运行的程序或批处理文件则表示安装失败,可以参考下面的Node.js安装失败解决方案或者在我们的开发者社区中求助。
1.4验证npm在命令行工具中执行npm,出现如下图内容,标明你的npm安装正确。
http://docs.egret-labs.org/assets/img/egretinstallwin15.png
如果出现npm 不是内部或外部命令,也不是可运行的程序或批处理文件则表示安装失败,可以参考下面的Node.js安装失败解决方案或者在我们的开发者社区中求助。
1.5Node.js安装失败解决方案
[*]部分Windows安装完成后直接在cmd里输入node和npm,可能会提示找不到该命令。是由于新增的Path路径需要重启才能生效。重启或使用node和npm的绝对路径来运行命令即可。
2.安装TypeScript2.1安装TypeScript当 node.js安装成功后,node 和 npm 命令就可以使用了。TypeScript的安装可视直接使用npm命令直接安装。详细的安装方法可以参考TypeScript官网。
在终端中输入如下命令:npm install -g typescript
npm install命令的作用是在开发者的系统中安装指定的Node.js库,typescript是库的名称,-g代表将这个库安装到全局路径
http://docs.egret-labs.org/assets/img/egretinstallwin16.png
如果由于网络问题导致的安装速度很慢,请使用 npm install -g typescript --registry=http://r.cnpmjs.org 命令,访问国内镜像版进行安装。
2.2验证TypeScript安装成功后,执行 tsc 命令,您应该看见如下界面
http://docs.egret-labs.org/assets/img/egretinstallwin17.png
3.安装TypeScript代码编辑器3.1选择一个合适的代码编辑器Egret可以使用任何支持脚本语言的代码编辑器,包括:
[*]WebStorm 官方下载地址【官方推荐】
[*]Microsoft Visual Studio 2012 + TypeScript插件
[*]Sublime Text + TypeScript插件
详细的编辑器安装方法以及插件配置方法,可参考文档中工具相关章节。
4.安装一个HTTP服务器4.1选择一个合适的HTTP服务器Windows用户推荐采用XMAPP
用户也可以跳过这个步骤,使用Egret内置的基于Node.js的简单HTTP服务器。但为了保证更好的开发体验,Egret建议用户安装上述较为成熟的HTTP服务器
具体服务器软件安装,大家可以参考文档中工具相关章节。
5.安装Chrome浏览器Egret可以运行在绝大多数的现代浏览器上,但是 Egret 目前推荐开发者使用 Chrome 作为主要的开发和调试环境。
[*]打开Chrome浏览器
[*]设置->工具->JavaScript控制台
[*]在JavaScript控制台(右下角)设置(齿轮图标)-> 常用 -> 禁用浏览器缓存
当进行好上述设置之后,只要JavaScript控制台处于打开状态,就不会有浏览器缓存,方便调试。
6.下载并安装 Egret6.1从官网中下载EgretEgret提供两个下载渠道,一个是Egret官方下载,另外一个是Egret Github下载。
我们推荐大家从官方网站中下载,这里的版本是当前稳定版本。如果你从github中下载引擎的开发版本,该版本非稳定版,你可能在实际开发中遇到许多问题,这些问题通常不会在稳定版中出现。
我们打开官方下载页面,找到“Egret引擎”产品项目,点击蓝色的下载按钮,下载最新版Egret引擎,如图。
http://docs.egret-labs.org/assets/img/egretinstallwin2.png
6.2安装Egret将下载后的Egret引擎压缩包解压到指定目录,该目录可以为任意磁盘中目录,如图:
http://docs.egret-labs.org/assets/img/egretinstallwin4.png
http://docs.egret-labs.org/assets/img/egretinstallwin18.png
在命令行工具中敲入命令进入解压后的目录。由于我们将解压后的文件放置于F:盘,因此我们先进入F盘,命令如下:
f:
http://docs.egret-labs.org/assets/img/egretinstallwin19.png
随后我们进入对应的目录中,如图
http://docs.egret-labs.org/assets/img/egretinstallwin21.png
进入该目录后,我们执行安装命令。
npm install -g
http://docs.egret-labs.org/assets/img/egretinstallwin23.png
如果安装命令错误,请检查如下三项,查看是否正确。
[*]命令中的当前的路径是否正确。
[*]当前目录是否是Egret目录(该目录下存在一个名为 package.json 的文件)
[*]系统当前用户是否有管理员权限,如果将Egret解压到C盘,可能会出现此问题。
6.3Egret工具验证安装完成后,我们执行egret命令,来查看当前Egret是否安装成功。如安装成功,应出现如下图所示。
http://docs.egret-labs.org/assets/img/egretinstallwin24.png
如果安装失败,请在我们的开发者社区中寻求帮助。
转自:http://docs.egret-labs.org/post/quitestart/install/installwin.html
页:
[1]