mirror of https://github.com/axmolengine/axmol.git
163 lines
9.2 KiB
Markdown
163 lines
9.2 KiB
Markdown
<p align="center"><a href="https://axmolengine.github.io/axmol" target="_blank" rel="noopener noreferrer"><img width="160" src="docs/logo.png" alt="axmol logo"></a></p>
|
||
|
||
# Axmol引擎
|
||
|
||
## A Multi-platform Engine for Desktop, XBOX (UWP) and Mobile games. (A radical fork of Cocos2d-x-4.0)
|
||
|
||
[](https://github.com/axmolengine/axmol/releases)
|
||
[](https://github.com/axmolengine/axmol/blob/master/LICENSE)
|
||
[](https://www.codacy.com/gh/axmolengine/axmol/dashboard?utm_source=github.com&utm_medium=referral&utm_content=axmolengine/axmol&utm_campaign=Badge_Grade)
|
||
[](https://github.com/axmolengine/axmol/pulls)
|
||
|
||
|
||
**[English](README.md)**
|
||
|
||
## 支持平台列表
|
||
| Build | Status (github) |
|
||
|-------|-----------------|
|
||
| Windows(win32,winuwp,win32-clang)|[](https://github.com/axmolengine/axmol/actions/workflows/windows.yml)|
|
||
| Android | [](https://github.com/axmolengine/axmol/actions?query=workflow%3Aandroid)|
|
||
| iOS |[](https://github.com/axmolengine/axmol/actions?query=workflow%3Aios)|
|
||
| tvOS |[](https://github.com/axmolengine/axmol/actions?query=workflow%3Atvos)|
|
||
| Linux |[](https://github.com/axmolengine/axmol/actions?query=workflow%3Alinux)|
|
||
| macOS |[](https://github.com/axmolengine/axmol/actions?query=workflow%3Aosx)|
|
||
|
||
## 新的媒体播放器
|
||
|
||
新的媒体播放器`ui::MediaPlayer`(原命: `ui::VideoPlayer`) 将视频渲染为纹理，使得游戏对视频渲染控制更加灵活，就像普通UI一样，而无需考虑层级问题。这得益于重新升级的跨平台`MediaEngine`, 灵感来自微软的媒体基础库(Microsoft Media Foundation): `IMFMediaEngine`，目前已支持axmol引擎支持的所有平台。
|
||
|
||
| Target Platform | Video Compress Format | Video Pixel Format | Container Format | Backend |
|
||
|-----------------------|-----------------------|----------------------|----------------- |--------------------|
|
||
| Windows Desktop | H264, HEVC, VP90 | YUY2, NV12, RGB32 | .mp4,.mkv,.webm | IMFMediaSession |
|
||
| Windows UWP | H264, HEVC, VP90 | BGR32 | .mp4,.mkv,.webm | IMFMediaEngine |
|
||
| Apple macOS | H264, HEVC(hvc1) | NV12, BGR32 | .mp4 | AVFoundation |
|
||
| Apple tvOS | H264, HEVC(hvc1) | NV12, BGR32 | .mp4 | AVFoundation |
|
||
| Apple iOS | H264, HEVC(hvc1) | NV12, BGR32 | .mp4 | AVFoundation |
|
||
| Android | H264, HEVC | NV12 | .mp4,.mkv,.webm | ExoPlayer2 |
|
||
| Linux | H264, HEVC | NV12 | .mp4,.mkv,.webm | libVLC |
|
||
|
||
### 关于预编译库
|
||
|
||
- 所有预编译库均通过[buildware](https://github.com/axmolengine/buildware)使用GitHub Actions自动构建
|
||
- 预编译库支持架构
|
||
- windows: x86,x64
|
||
- linux: x64
|
||
- macos: x64, arm64(M1芯片)
|
||
- android: armv7, arm64, x86, x64
|
||
- ios: arm64, x64
|
||
- tvos: arm64, x64
|
||
|
||
### 宗旨:
|
||
* C++17/20
|
||
* 专注C++
|
||
* Fix bugs ASAP
|
||
* Review PR ASAP
|
||
|
||
### 主要特性:
|
||
|
||
* Windows UWP 支持，请参考: https://github.com/axmolengine/axmol/pull/1108
|
||
* 增加tvos支持
|
||
* 增强Windows下工作流，支持链接引擎预编译库, 用法请查看: [windows workflow guide](https://github.com/axmolengine/axmol/issues/564)
|
||
* Windows 视频播放支持
|
||
* Windows x64编译支持
|
||
* 基于yasio重构HttpClient以支持并发Http请求，不再需要sendImmidate接口
|
||
* 重构AudioEngine, 全平台OpenAL
|
||
* [openal-soft](https://github.com/kcat/openal-soft), pass -DAX_USE_ALSOFT=ON to cmake to force enable it
|
||
* [OpenAL.framework](https://opensource.apple.com/tarballs/OpenAL), if no and ```AX_USE_ALSOFT``` option specified, cmake script will choose it on osx/ios, even through it was mark as deprecated, but still avaiable.
|
||
* 重构UserDefault, 全平台基于内存映射文件 [mio](https://github.com/mandreyel/mio), 性能提升百倍
|
||
* 模块化所有引擎扩展库, 所有扩展库放到extensions目录下，如cocostudio, spine
|
||
* AudioEngine实现wav所有 ```openal-soft``` 支持的封装格式, 例如MS-ADPCM, ADPCM等
|
||
* 使用现代化的GL加载器glad代替glew
|
||
* 增加google angle渲染后端支持
|
||
* C++最低标准要求: C++17/20
|
||
* 设置ios下最低目标平台为ios9.0
|
||
* 使用更快的xml解析库pugixml代替tinyxml2
|
||
* Downloader全平台统一实现，均基于curl
|
||
* 全平台统一使用XML SAX解析plist文件, 移除Apple平台的实现
|
||
* Spine 3.8支持
|
||
* 新增FairyGUI支持
|
||
* 新增硬件压缩纹理格式ASTC 4x4/6x6/8x8支持，支持软解
|
||
* 新增硬件压缩纹理格式ETC2 RGB/RGBA支持，支持软解
|
||
* **ImGui集成，非常方便写游戏内嵌小工具，用法详见[ImGui](extensions/ImGui/README.md)**
|
||
* 完整改动列表，请查看[CHANGELOG](CHANGELOG)
|
||
|
||
### 快速开始
|
||
|
||
#### 必要工具 [python](https://www.python.org/downloads/)
|
||
* python-3.7+
|
||
|
||
#### 准备步骤
|
||
1. 进入引擎```axmol```根目录
|
||
3. 执行```python setup.py```后重启控制台
|
||
|
||
#### Windows
|
||
1. 安装CMake，要求3.22以上
|
||
2. 确保 Visual Studio 2019/2022 已正确安装
|
||
3. 执行下面的命令
|
||
- PC: ```cmake -S . -B build -G "Visual Studio 16 2019"```
|
||
|
||
- UWP: ```cmake -S . -B build -G "Visual Studio 17 2022" -A x64 -DCMAKE_SYSTEM_NAME=WindowsStore "-DCMAKE_SYSTEM_VERSION=10.0" "-DAX_VS_DEPLOYMENT_TARGET=10.0.17763.0"```
|
||
4. 之后就可以用vs打开```axmol/build/axmol.sln```启动cpp-tests等测试工程了
|
||
|
||
#### Android
|
||
1. 安装 Android Studio 2021.1.1+
|
||
2. 第一次启动Android Studio, 会引导安装一些工具，默认安装即可，如果不需要模拟器可以把```Virutal Device```勾选去掉
|
||
2. 启动 Android Studio并打开axmol\tests\cpp-tests\proj.android
|
||
3. 通过 [Tools][SdkManagers] 打开sdk管理工具，选择如下SDK Platforms和SDK Tools后， 点击按钮 ```Apply``` 一路跟着引导安装即可:
|
||
* Android SDK Platform 33 (在SDK Platforms页签)
|
||
* Android Gradle Plugin (AGP) 7.2.2
|
||
* Android SDK Build-Tools 30.0.3 和 AGP 版本对应
|
||
* Gradle 7.4.2
|
||
* NDK r23c+
|
||
* CMake 3.22.1+
|
||
|
||
5. 等待Gradle sync完成后，Build APKs，安装运行
|
||
6. 如果使用非sdk自动安装的CMake版本, 需要下载[ninja](https://github.com/ninja-build/ninja/releases)， 并且拷贝```ninja.exe```到CMake的bin目录
|
||
|
||
#### iOS
|
||
1. 确保已安装xcode12+和[cmake3.21+](https://github.com/Kitware/CMake/releases), 安装CMake命令行支持: ```sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install```
|
||
2. 执行如下命令确保cmake能成功生成xcode工程:
|
||
```sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer```
|
||
3. 生成xcode工程, 进入axmol根目录执行如下命令之一:
|
||
- for ios arm64:
|
||
```cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=$AX_ROOT/cmake/ios.toolchain.cmake -DPLATFORM=OS64```
|
||
- for ios armv7,arm64 combined:
|
||
```cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=$AX_ROOT/cmake/ios.toolchain.cmake -DPLATFORM=OS```
|
||
- for ios simulator x86_64:
|
||
```cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=$AX_ROOT/cmake/ios.toolchain.cmake -DPLATFORM=SIMULATOR64```
|
||
- for tvos arm64:
|
||
```cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=$AX_ROOT/cmake/ios.toolchain.cmake -DPLATFORM=TVOS```
|
||
- for tvos simulator x86_64:
|
||
```cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=$AX_ROOT/cmake/ios.toolchain.cmake -DPLATFORM=SIMULATOR_TVOS```
|
||
- for macos x86_64(Intel)
|
||
```cmake -S . -B build -GXcode -DCMAKE_OSX_ARCHITECTURES=x86_64```
|
||
- for macos arm64(M1)
|
||
```cmake -S . -B build -GXcode -DCMAKE_OSX_ARCHITECTURES=arm64```
|
||
|
||
4. 之后就可以用xcode打开, 选择cpp-tests编译运行
|
||
|
||
### 一些基于axmol有趣的项目
|
||
|
||
- https://github.com/solan-solan/HeightMap/tree/smooth_lod_passing
|
||
- https://github.com/wzhengsen/StarryX
|
||
- https://github.com/aismann/SimpleSnake
|
||
- https://github.com/EugenyN/TanksKombat
|
||
|
||
### 注意
|
||
* ThreadLocalStorage线程本地存储
|
||
- ios x86 simulator ios>=10 and axmol no longer provide x86 libraries
|
||
- ios x64 or devices arm64 ios sdk>=9.0
|
||
- the openal-soft maintained by kcat use TLS
|
||
|
||
### QQ交流群
|
||
|
||
点击链接加入群聊【axmol 交流群】：https://jq.qq.com/?_wv=1027&k=nvNmzOIY
|
||
|
||
### 参考链接
|
||
* official v4: https://gitee.com/mirrors/cocos2d-x
|
||
* Git快速手册: https://github.com/axmolengine/axmol/discussions/411
|
||
|
||
### axmol项目活跃状态
|
||
|
||
|