首页
/ AndEngine 技术文档

AndEngine 技术文档

2024-12-23 14:25:03作者:冯爽妲Honey

1. 安装指南

环境要求

  • Eclipse: 需要 ADT-17 或更高版本。
  • IntelliJ IDEA: 需要手动添加 BuildConfig 类。

安装步骤

  1. 克隆项目:
    git clone https://github.com/nicolasgramlich/AndEngine.git
    
  2. 导入项目:
    • 在 Eclipse 中,选择 File -> Import -> Existing Projects into Workspace,然后选择克隆的项目目录。
    • 在 IntelliJ IDEA 中,选择 File -> New -> Project from Existing Sources,然后选择克隆的项目目录。
  3. 配置 BuildConfig(仅适用于 IntelliJ IDEA):
    • 在项目根包 org.andengine 下手动添加以下类:
      package org.andengine;
      
      public final class BuildConfig { 
          public final static boolean DEBUG = true;
      }
      

2. 项目的使用说明

分支说明

  • OpenGL ES 2:
    • GLES2-AnchorCenter: 活跃开发中,支持最新的功能,坐标系统在左下角,支持强大的 AnchorCenter 系统。
    • GLES2: 不再活跃开发,支持的功能较少。
  • OpenGL ES 1:
    • master: 不再活跃开发,支持几乎所有 Android 设备。

示例项目

  • AndEngineExamples: 包含多个示例项目,帮助用户快速上手。
  • AndEngineRobotiumExtensionExample: 包含 Robotium 扩展的示例。

测试项目

  • AndEngineTest: 包含项目的单元测试。
  • AndEngineRobotiumExtensionExampleTest: 包含 Robotium 扩展的单元测试。

扩展项目

  • AndEngineAugmentedRealityExtension: 增强现实扩展。
  • AndEngineLiveWallpaperExtension: 动态壁纸扩展。
  • AndEngineMODPlayerExtension: MOD 播放器扩展。
  • AndEngineMultiplayerExtension: 多人游戏扩展。
  • AndEngineMultiTouchExtension: 多点触控扩展。
  • AndEnginePhysicsBox2DExtension: Box2D 物理引擎扩展。
  • AndEngineRobotiumExtension: Robotium 测试框架扩展。
  • AndEngineScriptingExtension: 脚本扩展。
  • AndEngineScriptingExtensionGenerator: 脚本扩展生成器。
  • AndEngineSVGTextureRegionExtension: SVG 纹理区域扩展。
  • AndEngineTexturePackerExtension: 纹理打包器扩展。
  • AndEngineTMXTiledMapExtension: TMX 瓦片地图扩展。

3. 项目API使用文档

主要API

  • Scene: 场景管理,用于管理游戏中的各个场景。
  • Entity: 游戏对象的基类,所有游戏对象都继承自该类。
  • Sprite: 用于显示2D图像的类。
  • Camera: 用于管理游戏视角的类。
  • PhysicsWorld: 用于管理物理世界的类,通常与 Box2D 扩展一起使用。

示例代码

// 创建一个场景
Scene scene = new Scene();

// 创建一个精灵
Sprite sprite = new Sprite(0, 0, textureRegion, vertexBufferObjectManager);

// 将精灵添加到场景中
scene.attachChild(sprite);

// 创建一个物理世界
PhysicsWorld physicsWorld = new PhysicsWorld(new Vector2(0, SensorManager.GRAVITY_EARTH), false);

// 将物理世界添加到场景中
scene.registerUpdateHandler(physicsWorld);

4. 项目安装方式

通过 Eclipse 安装

  1. 确保已安装 ADT-17 或更高版本。
  2. 导入项目到 Eclipse 中。
  3. 配置项目依赖。

通过 IntelliJ IDEA 安装

  1. 导入项目到 IntelliJ IDEA 中。
  2. 手动添加 BuildConfig 类。
  3. 配置项目依赖。

通过命令行安装

  1. 克隆项目到本地。
  2. 使用 Gradle 或 Maven 构建项目。
# 使用 Gradle 构建项目
./gradlew build

# 使用 Maven 构建项目
mvn clean install

通过以上步骤,您可以成功安装并使用 AndEngine 项目。

热门项目推荐
相关项目推荐

项目优选

收起
Python-100-DaysPython-100-Days
Python - 100天从新手到大师
Python
373
72
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
276
72
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
200
47
xzs-mysqlxzs-mysql
学之思开源考试系统是一款 java + vue 的前后端分离的考试系统。主要优点是开发、部署简单快捷、界面设计友好、代码结构清晰。支持web端和微信小程序,能覆盖到pc机和手机等设备。 支持多种部署方式:集成部署、前后端分离部署、docker部署
HTML
5
1
LangChatLangChat
LangChat: Java LLMs/AI Project, Supports Multi AI Providers( Gitee AI/ 智谱清言 / 阿里通义 / 百度千帆 / DeepSeek / 抖音豆包 / 零一万物 / 讯飞星火 / OpenAI / Gemini / Ollama / Azure / Claude 等大模型), Java生态下AI大模型产品解决方案,快速构建企业级AI知识库、AI机器人应用
Java
11
3
gin-vue-admingin-vue-admin
🚀Vite+Vue3+Gin的开发基础平台,支持TS和JS混用。它集成了JWT鉴权、权限管理、动态路由、显隐可控组件、分页封装、多点登录拦截、资源权限、上传下载、代码生成器【可AI辅助】、表单生成器和可配置的导入导出等开发必备功能。
Go
16
3
source-vuesource-vue
🔥 一直想做一款追求极致用户体验的快速开发平台,看了很多优秀的开源项目但是发现没有合适的。于是利用空闲休息时间对若依框架进行扩展写了一套快速开发系统。如此有了开源字节快速开发平台。该平台基于 Spring Boot + MyBatis + Vue & Element ,包含微信小程序 & Uniapp, Web 报表、可视化大屏、三方登录、支付、短信、邮件、OSS...
Java
24
2
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
898
0
madongmadong
基于Webman的权限管理系统
PHP
4
0
cool-admin-javacool-admin-java
🔥 cool-admin(java版)一个很酷的后台权限管理框架,Ai编码、流程编排、模块化、插件化、CRUD极速开发,永久开源免费,基于springboot3、typescript、vue3、vite、element-ui等构建
Java
18
2