4.7 KiB
cocos-re - Cocos2dx Refine
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, etc.
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:
- Refactor AudioEngine, OpenAL for all platforms
- openal-soft, pass -DBUILD_EXT_ALSOFT=ON to cmake to force enable it
- OpenAL.framework, if no
BUILD_EXT_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
(instead of glew) - Add google angle renderer backend support
- C++14 standard
- IOS SDK 9.0 as minimal deployment
- Use fast pugixml
- Using curl for transferring data with URL syntax
- Use SAX parser for all plist file
- Spine-3.8 support
- Add engine extension
FairyGUI
support - Add ASTC 4x4/6x6/8x8 support, if hardware decoder not present, use software decoder
- Add ETC2 RGB/RGBA support, if hardware decoder not present, use software decoder
- ImGui integrated, easy to write game embedded tools, very ease to use, please read ImGuiEXT
Roadmap
Quick Start
Common Requirement python
- python-2.7.17+, python-3.7+
Windows
- Install CMake 3.6+
- Install Visual Studio 2019 build(we strong recommend you use this version)
- Execute follow command at command line(Console, Window Terminal or Powershell)
cd cocos-re\
cmake -S . -B build -G "Visual Studio 16 2019" -A Win32
Android
-
Install Android Studio 4.0+
-
When first start Android Studio, It will guide you to install sdk and other tools, just install them
-
Start Android and choose [Open an existing Android Studio Project] to open
cocos-re\tests\cpp-tests\proj.android
-
Start Android Studio and Open [Tools][SDKManager], then switch to
SDK Tools
, check theShow Package Details
, choose follow tools and click the buttonApply
to install them:- Android SDK Platform 28 r3
- Android SDK Build-Tools 29.0.2
- NDK r16b+
- CMake 3.6
-
Waiting for
Gradle sync
finish. -
Remark: If you use non-sdk provided CMake edition, you need download
ninja
from https://github.com/ninja-build/ninja/releases, and copyninja.exe
to cmake's bin directory
iOS
- Ensure xcode11+ & cmake3.6+ installed, install cmake command line support:
sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install
- Execute follow command
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
- Generate xcode project
# for device arm64
cmake -S . -B build -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/ios.mini.cmake
# for device combined armv7,arm64
# 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_SYSROOT=iphonesimulator
-
After cmake generate finish, you can open xcode project at
build
folder and run cpp-tests or other test targets. -
Notes
a. The code sign required to run ios app on device, just change bundle identifier until the auto manage siging solved
b. cocos-re only provide armv7,arm64,x86_64 prebuilt libraries for ios
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
Reference links
- cocos-re: https://github.com/c4games/cocos-re-3rd
- official v4: https://github.com/cocos2d/cocos2d-x