mirror of https://github.com/axmolengine/axmol.git
5.3 KiB
5.3 KiB
adxe
这是另外一个基于 Cocos2d-x-4.0 持续维护的分支, 全平台基于OpenAL, c++14/17...
宗旨:
- C++14/17
- Focus on native game dev only
- Fix bugs ASAP
- Review PR ASAP
- Excellent PRs from any guys are welcome, we will review & merge ASAP
主要特性:
- 重构AudioEngine, 全平台OpenAL
- openal-soft, pass -DBUILD_EXT_ALSOFT=ON to cmake to force enable it
- OpenAL.framework, if no and
BUILD_EXT_ALSOFT
option specified, cmake script will choose it on osx/ios, even through it was mark as deprecated, but still avaiable.
- 重构UserDefault, 全平台基于内存映射文件 mio, 性能提升百倍
- 模块化所有引擎扩展库, 所有扩展库放到extensions目录下,如cocostudio, spine
- AudioEngine实现wav所有
openal-soft
支持的封装格式, 例如MS-ADPCM, ADPCM等 - 使用现代化的GL加载器glad代替glew
- 增加google angle渲染后端支持
- 设置默认C++标准为C++14
- 设置ios下最低目标平台为ios9.0
- 使用更快的xml解析库pugixml代替tinyxml2
- HttpClient, Downloader全平台统一实现,均基于curl
- 全平台统一使用XML SAX解析plist文件, 移除Apple平台的实现
- Spine 3.8支持
- 新增FairyGUI支持
- 新增硬件压缩纹理格式ASTC 4x4/6x6/8x8支持,支持软解
- 新增硬件压缩纹理格式ETC2 RGB/RGBA支持,支持软解
- ImGui集成,非常方便写游戏内嵌小工具,用法详见ImGuiEXT
Roadmap
快速开始
必要工具 python
- python-2.7.17+, python-3.7+都可以
准备步骤
- 进入引擎
adxe
根目录 - 执行
python setup.py
后重启控制台
Windows
- 安装CMake,要求3.14以上
- 确保 Visual Studio 2019 已正确安装
- 执行下面的命令
cd adxe
cmake -S . -B build -G "Visual Studio 16 2019" -A Win32
- 之后就可以用vs打开
adxe/build/adxe.sln
启动cpp-tests等测试工程了
Android
-
安装 Android Studio 4.2或更高版本
-
第一次启动Android Studio, 会引导安装一些工具,默认安装即可,如果不需要模拟器可以把
Virutal Device
勾选去掉 -
启动 Android Studio并打开engine-x\tests\cpp-tests\proj.android
-
通过 [Tools][SdkManagers] 打开sdk管理工具,选择如下SDK Platforms和SDK Tools后, 点击按钮
Apply
一路跟着引导安装即可:- Android SDK Platform 29 r5 (在SDK Platforms页签)
- Android SDK Build-Tools 29.0.2
- NDK r19c+
- CMake 3.10+
-
等待Gradle sync完成后,Build APKs,安装运行
-
如果使用非sdk自动安装的CMake版本, 需要下载ninja, 并且拷贝
ninja.exe
到CMake的bin目录
iOS
-
确保已安装xcode11+和cmake3.14+, 安装CMake命令行支持:
sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install
-
执行如下命令确保cmake能成功生成xcode工程:
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
-
生成xcode工程, 进入engine-x根目录执行如下命令之一:
- for any device:
cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/ios.mini.cmake
- for arm64:
cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/ios.mini.cmake -DCMAKE_OSX_ARCHITECTURES=arm64
- for simulator x86_64:
cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/ios.mini.cmake -DCMAKE_OSX_SYSROOT=iphonesimulator -DCMAKE_OSX_ARCHITECTURES=x86_64
- for any device:
-
之后就可以用xcode打开, 选择cpp-tests编译运行
注意
- ThreadLocalStorage线程本地存储
- ios x86 simulator ios>=10 and adxe no longer provide x86 libraries
- ios x64 or devices(armv7,arm64) ios sdk>=9.0
- the openal-soft maintained by kcat use TLS
QQ交流群
点击链接加入群聊【Adxe 交流群】:https://jq.qq.com/?_wv=1027&k=nvNmzOIY
参考链接
- official v4: https://gitee.com/mirrors/cocos2d-x
- Git快速手册: https://github.com/adxeproject/adxe/wiki/Git-Guides