egret-docs-master/tools/EgretVS/manual
guofei 4fe0162b34 fist commit 2024-06-19 13:32:32 +08:00
..
1.png fist commit 2024-06-19 13:32:32 +08:00
2.png fist commit 2024-06-19 13:32:32 +08:00
3.png fist commit 2024-06-19 13:32:32 +08:00
4.png fist commit 2024-06-19 13:32:32 +08:00
5.png fist commit 2024-06-19 13:32:32 +08:00
6.png fist commit 2024-06-19 13:32:32 +08:00
7.png fist commit 2024-06-19 13:32:32 +08:00
8.png fist commit 2024-06-19 13:32:32 +08:00
9.png fist commit 2024-06-19 13:32:32 +08:00
10.png fist commit 2024-06-19 13:32:32 +08:00
11.png fist commit 2024-06-19 13:32:32 +08:00
12.png fist commit 2024-06-19 13:32:32 +08:00
13.png fist commit 2024-06-19 13:32:32 +08:00
14.png fist commit 2024-06-19 13:32:32 +08:00
15.png fist commit 2024-06-19 13:32:32 +08:00
16.png fist commit 2024-06-19 13:32:32 +08:00
17.png fist commit 2024-06-19 13:32:32 +08:00
18.png fist commit 2024-06-19 13:32:32 +08:00
README.md fist commit 2024-06-19 13:32:32 +08:00

README.md

简介

EgretVS是为Egret Framework用户开发的一款Visual Studio插件使VS用户可以方便的创建调试Egret项目借助VS强大的TypeScript支持获得良好的Egret开发体验。

下载地址

安装

安装环境

Visual Studio 2012 + TypeScript Tools

Visual Studio 2013 Update 3+

安装方法

双击EgretVS.vsix选择需要安装的VS版本安装。 使用IE下载的开发者 如果你下载到的文件是 EgretVS-v.版本号.zip 而不是 vsix请手动修改扩展名为vsix,或使用其他浏览器下载,谢谢。

image

创建项目

EgretVS中包含了三种Egret项目模板您可以根据需要选择要创建的项目 在新建项目窗口中左侧依次选择“其他语言>TypeScript”就能看到三种Egret项目模板

image

三个模板分别为

  • Egret Empty Project 空的Egret项目只包含基本的类库没有示例代码
  • Egret Game Project Egret 游戏示例项目,包含基本类库和示例代码
  • Egret GUI Project Egret GUI项目包含基本类库和egret.gui类库并包含gui示例代码

本文中选择GUI项目点击OK创建项目。 项目创建完成后EgretVS会默认打开Main.ts文件。

image

项目编译

直接使用VS的编译命令来编译Egret项目

image

同时EgretVS提供了一个菜单来实现Egret项目特有的编译参数

image

三个命令分别为

  • Build 编译项目ts文件
  • Build Engine 编译Egret Engine到本地目录这个命令一般用于修改了egretProperties.json中的modules或其他需要重新编译引擎代码的情形
  • Publish Game 发布Egret项目这个命令会打包压缩所有的ts 和 js文件实现最小的网络传输

项目发布

右击需要发布的项目点击Egret > Publish Game

image

发布完成后会自动打开发布后的文件夹

image

项目调试VS集成调试

借助VS自带的TS调试功能我们能够很方便的调试我们的TS代码 在TS编辑器左侧添加一个断点

image

选择Internet Explore作为调试浏览器VS只能够附加到IE中实现JS调试功能

image

点击绿色箭头或按F5开始调试

image

点击按钮,会看到断点被激活。

image

我们可以在下方的窗口中看到局部变量和调用栈

image

使用相关按钮或快捷键即可进行单步调试

image

其他浏览器调试

在解决方案资源管理器中找到 Launcher\index.html右击鼠标选择“在浏览器中查看”

image

浏览器窗口弹出后你就可以在熟悉的浏览器中调试了。

image

ActionScript转TypeScript

EgretVS提供了ActionScript到TypeScript的转换功能使您可以方便的倒入现有AS项目。

先创建一个Egret项目然后在电脑中打开现有AS项目的目录选择需要转换的文件或文件夹复制。

image

在VS的解决方案资源管理器中选择放置代码的目录本文中选择的是src目录右击粘贴或Ctrl-V

image

根据转换文件的数量转换的时间会有所不同转换完成后就能看到转换之后的ts代码

image

转换之后的TS文件中可能会有一些语法错误您可能需要自己修复编译时发生的错误。