2021-05-19 08:14:17 +08:00
# adxe
2020-11-15 17:56:03 +08:00
2021-12-28 21:28:04 +08:00
[![dev ](https://img.shields.io/badge/v1.0.0-beta5-yellow.svg )](https://github.com/adxeproject/adxe/releases)
2021-05-18 16:51:46 +08:00
[![LICENSE ](https://img.shields.io/badge/license-MIT-blue.svg )](https://github.com/adxeproject/adxe/blob/master/LICENSE)
2021-12-28 21:50:41 +08:00
[![Codacy Badge ](https://api.codacy.com/project/badge/Grade/1c5628dea478449ea0c6e1b0e30c3be9 )](https://app.codacy.com/gh/adxeproject/adxe?utm_source=github.com& utm_medium=referral& utm_content=adxeproject/adxe& utm_campaign=Badge_Grade_Settings)
2021-12-28 21:32:25 +08:00
[![PRs Welcome ](https://img.shields.io/badge/PRs-welcome-blue.svg )](https://github.com/adxeproject/adxe/pulls)
2020-11-15 17:56:03 +08:00
2021-08-27 13:27:04 +08:00
[![Windows Build Status ](https://github.com/adxeproject/adxe/actions/workflows/windows-ci.yml/badge.svg )](https://github.com/adxeproject/adxe/actions/workflows/windows-ci.yml)
2021-05-18 16:51:46 +08:00
[![Android Build Status ](https://github.com/adxeproject/adxe/workflows/android/badge.svg )](https://github.com/adxeproject/adxe/actions?query=workflow%3Aandroid)
[![iOS Build Status ](https://github.com/adxeproject/adxe/workflows/ios/badge.svg )](https://github.com/adxeproject/adxe/actions?query=workflow%3Aios)
[![Linux Build Status ](https://github.com/adxeproject/adxe/workflows/linux/badge.svg )](https://github.com/adxeproject/adxe/actions?query=workflow%3Alinux)
[![macOS Build Status ](https://github.com/adxeproject/adxe/workflows/osx/badge.svg )](https://github.com/adxeproject/adxe/actions?query=workflow%3Aosx)
2020-10-24 18:41:20 +08:00
2020-08-03 19:12:07 +08:00
2021-12-28 21:28:04 +08:00
**这是另外一个基于 *Cocos2d-x-4.0* 持续维护的分支, 全平台基于OpenAL, c++17...**
2020-08-03 19:12:07 +08:00
2020-08-03 19:17:26 +08:00
**[English](README.md)**
2020-08-03 19:12:07 +08:00
2020-08-04 16:48:47 +08:00
### 宗旨:
2021-12-28 21:32:25 +08:00
* C++17
2020-10-22 15:35:02 +08:00
* Focus on native game dev only
2020-08-04 16:48:47 +08:00
* Fix bugs ASAP
* Review PR ASAP
### 主要特性:
2021-08-27 12:45:03 +08:00
* Windows x64编译支持
2021-06-26 17:13:05 +08:00
* 基于yasio重构HttpClient以支持并发Http请求, 不再需要sendImmidate接口
2020-08-15 18:17:03 +08:00
* 重构AudioEngine, 全平台OpenAL
2021-07-09 10:31:04 +08:00
* [openal-soft ](https://github.com/kcat/openal-soft ), pass -DBUILD_DEP_ALSOFT=ON to cmake to force enable it
2021-07-08 22:55:33 +08:00
* [OpenAL.framework ](https://opensource.apple.com/tarballs/OpenAL ), if no and ```BUILD_DEP_ALSOFT``` option specified, cmake script will choose it on osx/ios, even through it was mark as deprecated, but still avaiable.
2020-08-04 16:48:47 +08:00
* 重构UserDefault, 全平台基于内存映射文件 [mio ](https://github.com/mandreyel/mio ), 性能提升百倍
* 模块化所有引擎扩展库, 所有扩展库放到extensions目录下, 如cocostudio, spine
* AudioEngine实现wav所有 ```openal-soft``` 支持的封装格式, 例如MS-ADPCM, ADPCM等
* 使用现代化的GL加载器glad代替glew
* 增加google angle渲染后端支持
2021-12-28 21:28:04 +08:00
* C++最低标准要求: C++17
2020-08-04 16:48:47 +08:00
* 设置ios下最低目标平台为ios9.0
* 使用更快的xml解析库pugixml代替tinyxml2
2021-07-17 16:14:16 +08:00
* Downloader全平台统一实现, 均基于curl
2020-08-04 16:48:47 +08:00
* 全平台统一使用XML SAX解析plist文件, 移除Apple平台的实现
2020-08-05 18:11:52 +08:00
* Spine 3.8支持
2020-08-05 18:45:21 +08:00
* 新增FairyGUI支持
2020-09-08 15:53:56 +08:00
* 新增硬件压缩纹理格式ASTC 4x4/6x6/8x8支持, 支持软解
2020-08-31 15:56:50 +08:00
* 新增硬件压缩纹理格式ETC2 RGB/RGBA支持, 支持软解
2020-09-08 15:55:16 +08:00
* **ImGui集成, 非常方便写游戏内嵌小工具, 用法详见[ImGuiEXT](extensions/ImGuiEXT/README.md)**
2020-08-04 16:48:47 +08:00
2021-05-18 16:51:46 +08:00
### [Roadmap](https://github.com/adxeproject/adxe/issues/1)
2020-08-04 16:48:47 +08:00
2020-08-03 19:12:07 +08:00
### 快速开始
2020-08-05 18:31:24 +08:00
#### 必要工具 [python](https://www.python.org/downloads/)
* python-2.7.17+, python-3.7+都可以
2020-10-22 16:58:56 +08:00
#### 准备步骤
2021-05-18 16:51:46 +08:00
1. 进入引擎```adxe```根目录
2020-10-22 16:53:28 +08:00
3. 执行```python setup.py```后重启控制台
2020-08-03 19:12:07 +08:00
#### Windows
2020-10-22 11:35:52 +08:00
1. 安装CMake, 要求3.14以上
2020-12-01 12:17:09 +08:00
2. 确保 Visual Studio 2019 已正确安装
2020-08-03 19:12:07 +08:00
3. 执行下面的命令
```bat
2021-05-18 16:51:46 +08:00
cd adxe
2020-08-03 19:17:26 +08:00
cmake -S . -B build -G "Visual Studio 16 2019" -A Win32
2020-08-03 19:12:07 +08:00
```
2021-05-18 16:51:46 +08:00
4. 之后就可以用vs打开```adxe/build/adxe.sln```启动cpp-tests等测试工程了
2020-08-03 19:12:07 +08:00
#### Android
2021-05-14 12:15:38 +08:00
1. 安装 Android Studio 4.2或更高版本
2020-08-06 15:45:59 +08:00
2. 第一次启动Android Studio, 会引导安装一些工具,默认安装即可,如果不需要模拟器可以把```Virutal Device```勾选去掉
2021-07-09 10:42:36 +08:00
2. 启动 Android Studio并打开adxe\tests\cpp-tests\proj.android
2020-08-10 15:04:12 +08:00
3. 通过 [Tools][SdkManagers] 打开sdk管理工具, 选择如下SDK Platforms和SDK Tools后, 点击按钮 ```Apply``` 一路跟着引导安装即可:
2020-10-25 19:12:13 +08:00
* Android SDK Platform 29 r5 (在SDK Platforms页签)
2020-08-17 19:09:54 +08:00
* Android SDK Build-Tools 29.0.2
2021-04-28 17:59:39 +08:00
* NDK r19c+
2020-10-25 19:12:13 +08:00
* CMake 3.10+
2020-08-03 19:12:07 +08:00
2020-08-06 15:45:59 +08:00
5. 等待Gradle sync完成后, Build APKs, 安装运行
2021-05-18 20:23:43 +08:00
6. 如果使用非sdk自动安装的CMake版本, 需要下载[ninja](https://github.com/ninja-build/ninja/releases), 并且拷贝```ninja.exe```到CMake的bin目录
2020-08-03 19:12:07 +08:00
#### iOS
2021-09-14 12:53:22 +08:00
1. 确保已安装xcode11+和[cmake3.21+](https://github.com/Kitware/CMake/releases), 安装CMake命令行支持: ```sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install```
2020-08-27 12:51:35 +08:00
2. 执行如下命令确保cmake能成功生成xcode工程:
2020-08-03 19:12:07 +08:00
```sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer```
2021-07-09 10:42:36 +08:00
3. 生成xcode工程, 进入adxe根目录执行如下命令之一:
2020-12-03 12:45:06 +08:00
- 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```
2021-06-08 21:53:18 +08:00
- for armv7,arm64 combined:
```cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/ios.mini.cmake "-DCMAKE_OSX_ARCHITECTURES=armv7;arm64"```
2020-12-03 12:45:06 +08:00
- for simulator x86_64:
2021-06-08 21:53:18 +08:00
```cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/ios.mini.cmake -DCMAKE_OSX_ARCHITECTURES=x86_64```
2020-08-24 16:26:12 +08:00
2020-08-27 12:51:35 +08:00
4. 之后就可以用xcode打开, 选择cpp-tests编译运行
2020-08-03 19:12:07 +08:00
### 注意
* ThreadLocalStorage线程本地存储
2021-05-18 16:51:46 +08:00
- ios x86 simulator ios>=10 and adxe no longer provide x86 libraries
2020-08-03 19:12:07 +08:00
- ios x64 or devices(armv7,arm64) ios sdk>=9.0
- the openal-soft maintained by kcat use TLS
### QQ交流群
2021-05-18 20:24:21 +08:00
点击链接加入群聊【Adxe 交流群】: https://jq.qq.com/?_wv=1027& k=nvNmzOIY
2020-08-03 19:12:07 +08:00
### 参考链接
2020-08-30 00:28:20 +08:00
* official v4: https://gitee.com/mirrors/cocos2d-x
2021-05-18 16:51:46 +08:00
* Git快速手册: https://github.com/adxeproject/adxe/wiki/Git-Guides
2021-05-26 14:46:15 +08:00
2021-06-26 17:13:05 +08:00
### adxe项目的活跃贡献者
2021-05-26 14:46:15 +08:00
- @halx99
- @rh101
- @aismann
- @weiwest