Axmol Engine – A Multi-platform Engine for Desktop, XBOX (UWP) and Mobile games. (A radical fork of Cocos2d-x-4.0)
Go to file
rh101 615fbd5088 More %ld to %d changes 2021-09-02 17:54:13 +10:00
.github Update bug_report.md 2021-08-30 10:47:45 +08:00
cmake Add win64 angle dlls 2021-09-01 10:28:37 +08:00
cocos Change %ld to %d for 32bit data types 2021-09-02 17:46:22 +10:00
docs For doxgen happy 2021-07-06 15:22:07 +08:00
extensions Change %ld to %d for 32bit data types 2021-09-02 17:46:22 +10:00
templates Fix xcode build warnings 2021-08-12 15:54:16 +08:00
tests More %ld to %d changes 2021-09-02 17:54:13 +10:00
tools Fix part of #487 2021-09-02 11:43:27 +08:00
.appveyor.yml Merge: f36866a99b 313a2ac09b 2020-08-27 17:37:49 +08:00
.clang-format Fix comment typo and do clang-format [skip ci] 2021-08-28 20:22:01 +08:00
.gitattributes Restore prebuilt libs from git lfs storage 2021-06-06 10:16:44 +08:00
.gitignore Add missing libs 2021-08-23 20:41:30 +08:00
.travis.yml Use pyenv manage python version for travis-ci (#229) 2020-10-07 22:45:05 +08:00
AUTHORS Init Commit 2019-11-23 20:27:39 +08:00
CHANGELOG Update changelog 2021-08-30 17:55:00 +08:00
CMakeLists.txt Fix xcode ci 2021-08-12 11:25:01 +08:00
CONTRIBUTING.md Init Commit 2019-11-23 20:27:39 +08:00
LICENSE Merge: 2aa2d69151 b7506fed0c 2021-04-23 00:01:47 +10:00
README.md Update README.md 2021-08-27 10:43:35 +02:00
README_CN.md Merge: cbeeb8d8ab 3990cc765d 2021-08-27 07:49:17 +02:00
install-deps-linux.sh Merge: 71ebb455a6 2dd4051cbb 2021-05-18 18:09:06 +08:00
setup.py Renaming refactor (#353) [ci build] 2021-05-18 16:40:30 +08:00

README.md

adxe

Codacy Badge dev LICENSE

Windows Build Status Android Build Status iOS Build Status Linux Build Status macOS Build Status

This is another more radical fork of Cocos2d-x-4.0, use OpenAL for all platforms, single texture multi GPU texture handler, C++ 14/17 and some more (see 'Highlight Features' for more info).

View with vscode online: https://github1s.com/adxeproject/adxe

简体中文

Purpose Summary

  • C++ 14/17
  • Focus on native game dev (quick starting, easy to use, fast)
  • Bugfixes ASAP
  • Usefull PRs from you are welcome (review/merge ASAP)

Highlight Features

  • Windows x64 build support
  • Reimplement HttpClient based on yasio for process http request concorrently.
  • More clearly third-party libs 'Upstream-Version-License' for easy to publish your commercial apps based on adxe
  • Refactor AudioEngine, OpenAL for all platforms
    • OpenAL Soft, pass -DBUILD_DEP_ALSOFT=ON to cmake to force enable it
    • OpenAL.framework, if no BUILD_DEP_ALSOFT option specified, cmake script will choose it on osx/ios, even through it was mark as deprecated, but still available.
  • Refactor UserDefault with mio
  • Modularize all optional extension, move from engine core to folder extensions
  • Implement all .wav formats supported by OpenAL Soft, such as MS-ADPCM, ADPCM, ...
  • Use modern GL loader Glad
  • Google angle renderer backend support
  • C++ 14 standard
  • IOS SDK 9.0 as minimal deployment
  • Use fast pugixml
  • Use curl for transferring data with URL syntax
  • Use SAX parser for all plist file
  • Spine-3.8 support
  • Extension FairyGUI support
  • ASTC 4x4/6x6/8x8 support (if hardware decoder not present, use software decoder)
  • ETC2 RGB/RGBA support (if hardware decoder not present, use software decoder)
  • Supported 2D physics engines:
    • Box2D
    • Box2D-optimized
    • Chipmunk2D
  • Supported 3D physics engines:
    • Bullet Physics SDK
  • ImGui integrated, easy to write game embedded tools, very ease to use, please read ImGuiEXT

Open Wiki for additional information and see Milestones for planed feature too.

Quick Start

Common Requirement Python

  • Python-2.7.17+, Python-3.7+

Prerequisites

  1. Enter adxe root directory
  2. Run python setup.py, restart console after finish

Windows (64/32 bit)

  1. Install CMake 3.14+
  2. Install Visual Studio 2019 build (it's strong recommend you use this version)
  3. Execute follow command at command line (Console, Window Terminal or Powershell):

64bit:

cd adxe\
cmake -S . -B build -G "Visual Studio 16 2019" -A x64

32bit:

cd adxe\
cmake -S . -B build -G "Visual Studio 16 2019" -A Win32

Android

  1. Install Android Studio 4.2+
  2. When first start Android Studio, It will guide you to install sdk and other tools, just install them
  3. Start Android and choose [Open an existing Android Studio Project] to open adxe\tests\cpp-tests\proj.android
  4. Start Android Studio and Open [Tools][SDKManager], then switch to SDK Tools, check the Show Package Details, choose follow tools and click the button Apply to install them:
    • Android SDK Platform 29 r5
    • Android SDK Build-Tools 29.0.2
    • NDK r19c+
    • CMake 3.10+
  5. Waiting for Gradle sync finish.
  6. Remark: If you use non-sdk provided CMake edition, you need download ninja from https://github.com/ninja-build/ninja/releases, and copy ninja.exe to cmake's bin directory

iOS

  1. Ensure xcode11+ & cmake3.14+ installed, install cmake command line support: sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install

  2. Execute follow command
    sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer

  3. Generate xcode project

    • 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 armv7,arm64 combined:
      cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/ios.mini.cmake "-DCMAKE_OSX_ARCHITECTURES=armv7;arm64"
    • for simulator x86_64:
      cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/ios.mini.cmake -DCMAKE_OSX_ARCHITECTURES=x86_64
  4. After cmake generate finish, you can open xcode project at build folder and run cpp-tests or other test targets.

  5. Notes

    • The code sign required to run ios app on device, just change bundle identifier until the auto manage signing solved
    • adxe only provide armv7, arm64, x86_64 prebuilt libraries for ios

Notes

  • ThreadLocalStorage (TLS)
    • 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

Contributing guide

https://github.com/adxeproject/adxe/discussions/411

The adxe Active Contributors

  • @halx99
  • @rh101
  • @aismann
  • @weiwest