# Egret-Engine
**Repository Path**: game-related-classes/Egret-Engine
## Basic Information
- **Project Name**: Egret-Engine
- **Description**: Egret Framework是一款使用JavaScript(TypeScript)编写的HTML5开源免费游戏框架
- **Primary Language**: TypeScript
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 21
- **Created**: 2022-05-17
- **Last Updated**: 2024-06-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[EN](README.md) / [CN](README_CN.md)
# Egret Engine
Egret Engine包含了白鹭时代研发的遵循HTML5标准的游戏引擎，他包括 2D / 3D 渲染核心、EUI体系、音频管理、资源管理等游戏引擎的常用模块。
通过使用白鹭引擎，开发者可以尽可能的不用关注浏览器的底层实现，解决HTML5游戏性能问题及碎片化问题，灵活地满足开发者开发2D或3D游戏的需求。
## 引擎覆盖平台
### 移动端
### PC端
# 安装
首先获得 Egret Engine
* 首先 [下载](https://egret.com/products) Egret Engine 管理器
* 下载成功后进行 [安装与部署](http://developer.egret.com/cn/github/egret-docs/Engine2D/projectConfig/installation/index.html)
安装好后以后我们可以方便的管理 Egret 引擎和工具了。
# 开始
#### TypeScript
Egret 项目使用 TypeScirpt 语言来开发。TypeScript 是 JavaScript 的超集，具体内容可以参考 [TyptScript语言手册](http://bbs.egret.com/thread-1441-1-1.html)。Egret 的 API 和 AS3 有很多相似之处，如果您熟悉的话肯定容易上手。
#### 使用命令行创建项目
你可以使用如下命令创建游戏的默认项目
egret create HelloWorld
如果有特殊需要可以加入参数--type empty|game|gui|eui 来指定不同的项目。创建游戏后可以看到一个名为'HelloWorld'的文件夹。
#### 编写第一行代码
游戏项目的入口类默认在src/Main.ts里面。下面编写我们的项目的第一行代码,在默认的代码中找到createGameScene()函数，添加console.log("Hello World");。
变成了下面的样子：
private createGameScene():void {
//插入 log
console.log("Hello World");
var sky:egret.Bitmap = this.createBitmapByName("bgImage");
this.addChild(sky);
var stageW:number = this.stage.stageWidth;
var stageH:number = this.stage.stageHeight;
sky.width = stageW;
sky.height = stageH;
//以下省略
}
这里我们调用了一条常用的调试命令，console.log("需要显示的log内容")将在浏览器的开发者工具下显示出来我们的log。
我们推荐使用 Chrome 来调试 Egret 项目。
我们使用如下命令构建项目：
egret build
然后使用如下命令行来运行项目：
egret startserver
完成。
更多内容请参考学习模块查看文档学习。
# 演示 Demo
守卫我的塔Demo
在线体验地址请点击：[演示地址](http://developer.egret.com/cn/article/index/id/1074)
查看更多 2D/3D 示例，请点击：[示例中心](http://developer.egret.com/cn/list/example/id/190)
# 游戏案例
更多案例请访问 [案例中心](https://egret.com/case)
# 学习
* 访问 [使用文档](http://developer.egret.com/cn/github/egret-docs/Engine2D/index.html?home=1) 获取 引擎 使用文档
* 访问 [Example](http://developer.egret.com/cn/example/egret2d/index.html#010-disp-basic) 学习示例源码
* 访问 [API](http://developer.egret.com/cn/apidoc/) 获取 API 使用文档
* 访问 [Video](http://developer.egret.com/cn/list/video/) 获取教程视频和直播视频
* 访问 [Community](http://bbs.egret.com/portal.php) 和其他开发者线上交流
# 工具
* 访问 [Egret Engine](http://www.egret.com/products/engine.html) 获取 Egret 引擎的启动器
* 访问 [Egret Wing](http://www.egret.com/products/wing.html) 获取 Egret IDE
* 访问 [Dragonbones Pro](http://dragonbones.com/cn/index.html) 获取 Egret 骨骼动画工具
* 访问 [更多工具](http://www.egret.com/products)
# 第三方库
* 使用 [base64texture](https://github.com/egret-labs/egret-game-library/tree/master/base64texture) 把 base64 字符串转换为 egert Texture
* 使用 [dcagent](https://github.com/egret-labs/egret-game-library/tree/master/dcagent) DataEye SDK for Egret
* 使用 [ecs](https://github.com/egret-labs/egret-game-library/tree/master/ecs) 实体组件系统支持库
* 使用 [euiextension](https://github.com/egret-labs/egret-game-library/tree/master/euiextension) EUI 扩展库
* 使用 [gesture](https://github.com/egret-labs/egret-game-library/tree/master/gesture) 手势库
* 使用 [keyboard](https://github.com/egret-labs/egret-game-library/tree/master/keyboard) 键盘事件监听库
* 使用 [Greensock](https://github.com/egret-labs/egret-game-library/tree/master/greensock) Greensock 动画库
* 使用 [jszip](https://github.com/egret-labs/egret-game-library/tree/master/jszip) jszip 压缩库
* 使用 [md5](https://github.com/egret-labs/egret-game-library/tree/master/md5) 一个简单的md5库
* 使用 [mouse](https://github.com/egret-labs/egret-game-library/tree/master/mouse) pc鼠标支持库
* 使用 [particle](https://github.com/egret-labs/egret-game-library/tree/master/particle) 粒子系统
* 使用 [physics](https://github.com/egret-labs/egret-game-library/tree/master/physics) p2物理引擎，当前使用的版本为0.7.0
* 使用 [socket](https://github.com/egret-labs/egret-game-library/tree/master/socket.io) socket.io
* 使用 [tiled](https://github.com/egret-labs/egret-game-library/tree/master/tiled) tiledmap 支持库
* 使用 [weixinapi](https://github.com/egret-labs/egret-game-library/tree/master/weixinapi) 微信API
* 更多第三方库请访问 [第三方库](https://github.com/egret-labs/egret-game-library)
# 贡献
一个好的问题是参与开源社区的第一步，你可以先提[Issues](https://github.com/egret-labs/egret-core/issues)。
我们鼓励你到[官方社区](http://bbs.egret.com/portal.php)进行提问和回答问题，也能够帮助后来者更高效的解决问题。
# License
This content is released under the (https://opensource.org/licenses/BSD-2-Clause) BSD License.
