Axmol Engine – A Multi-platform Engine for Desktop, XBOX (UWP) and Mobile games. (A radical fork of Cocos2d-x-4.0)
Go to file
halx99 8531a1914d Add extension fairygui support 2020-08-04 12:31:33 +08:00
cmake Huge changes, move spine,dragonbones,cocostudio to extensions folder, future make all extensions pluginable 2020-08-03 17:51:40 +08:00
cocos Add ENGINEX_VERSION and improve ABI compatiable 2020-08-04 12:11:36 +08:00
docs update error link 2019-12-12 23:55:05 +08:00
extensions Add extension fairygui support 2020-08-04 12:31:33 +08:00
external Update deps to v56 2020-08-03 17:54:07 +08:00
licenses Remove license files. 2019-12-12 23:53:27 +08:00
templates set xcode installation path to (#20402) 2020-01-18 20:40:21 +08:00
tests Huge changes, move spine,dragonbones,cocostudio to extensions folder, future make all extensions pluginable 2020-08-03 17:51:40 +08:00
tools Set CC_USE_ALSOFT_ON_APPLE=ON at travis build script 2020-07-31 15:11:13 +08:00
.appveyor.yml Don't build android at appveyor 2020-05-19 13:36:51 +08:00
.gitattributes fix line end in windows 2013-09-20 22:23:13 +08:00
.gitignore Optimize link, remove -Wl,--whole-archive for linking 3rd libs. 2020-07-29 18:55:45 +08:00
.gitmodules Remove jsb/h5 (#19621) 2019-04-18 23:56:12 -07:00
.travis.yml disable other jobs exclude android & ios 2020-02-07 16:41:34 +08:00
AUTHORS Update AUTHORS 2016-07-26 21:55:06 +08:00
CHANGELOG [ci skip]Release note (#20234) 2019-10-24 14:34:48 +08:00
CMakeLists.txt fix android build issues 2020-08-03 20:31:47 +08:00
CONTRIBUTING.md rename contribute.md to contributing.md 2015-08-28 14:10:41 +08:00
README.md Add roadmap link [skip appveyor][skip travis] 2020-08-03 19:22:44 +08:00
README_CN.md Add roadmap link [skip appveyor][skip travis] 2020-08-03 19:22:44 +08:00
download-deps.py fix folder error if path is not start with v (#19328) 2019-01-21 11:47:15 +08:00
install-deps-linux.sh fix issue that can not run release mode with lua projects (#20291) 2019-11-05 10:19:27 +08:00
issue_template.md Fix minor typo in issue_template (#16672) 2016-10-11 09:30:18 +08:00
setup.py delete ANT check on setup.py (#19042) 2018-09-14 14:24:07 +08:00

README.md

engine-x

Build Status Windows Build Status

This is another more radical fork of cocos2d-x v4, use opanal for all platforms, single texture multi gpu texture handler, c++14/17...

简体中文

Goals summary:

  1. C++14/17
  2. forcus on native game dev only
  3. Remove unnecessary sources
  4. Fix bugs ASAP
  5. Review PR ASAP
  6. If you have any other excellent goals, welcome
  7. Excellent PRs from any guys are welcome, I will review & merge ASAP

Roadmap

Quick Start

Windows

  1. Install CMake 3.6+
  2. Install Visual Studio 2019 build(we strong recommand you install this version)
  3. Execute follow command at command line(Console, Window Terminal or Powershell)
cd engine-x\
cmake -S . -B build -G "Visual Studio 16 2019" -A Win32

Android

  1. Install Android Studio 3.5.3+

  2. Start Android and choose [Open an existing Android Studio Project] to open engine-x\tests\cpp-tests\proj.android

  3. Start Android Studio and Open [Tools][SDKManager] and install sdk tools:
    LLDB 3.1+
    CMake 3.10.2+
    NDK 20.1+

  4. Waiting for Gradle sync finish.

  5. Remark: If missing Ninja, could be download from https://github.com/ninja-build/ninja/releases, then copy Ninja.exe to Cmake's bin directory

iOS

  1. Ensure xcode11+ installed
  2. Install brew: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    when finish, install follow tools:
    brew update
    brew install git
    brew install cmake
    brew install autoconf
    brew install automake
    brew install libtool
  1. Execute follow command
    sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
  2. Generate xcode project
  mkdir engine-x/build
  cd engine-x/build
  cmake .. -GXcode -DCMAKE_SYSTEM_NAME=iOS -DCMAKE_OSX_SYSROOT=iphonesimulator
  # for simulator64
  # cmake .. -G Xcode -DCMAKE_TOOLCHAIN_FILE=../cmake/ios.toolchain.cmake -DPLATFORM=SIMULATOR64 -DENABLE_ARC=0 -DENABLE_BITCODE=0
  # for (armv7, armv7s, arm64)
  # cmake .. -G Xcode -DCMAKE_TOOLCHAIN_FILE=../cmake/ios.toolchain.cmake -DPLATFORM=OS -DENABLE_ARC=0 -DENABLE_BITCODE=0
  # for device 64
  # cmake .. -G Xcode -DCMAKE_TOOLCHAIN_FILE=../cmake/ios.toolchain.cmake -DPLATFORM=OS64 -DENABLE_ARC=0 -DENABLE_BITCODE=0
  1. After cmake generate finish, you can open xcode project at build folder and run cpp-tests or other test targets.

Pitfalls

  • ThreadLocalStorage(TLS)
    • ios x86 simulator ios>=10
    • ios x64 or devices(armv7,arm64) ios sdk>=9.0
    • the openal-soft maintained by kcat use TLS