multiplatform-gaming

This is short presentation showcasing usage of cocos2d-x for development of multiplatform games. It works on Android 2.3+, iOS, Mac and Web (including Firefox OS). It should be very easy to have it workin in Windows and Linux but I haven't tried it yet.

Run it

You can try the HTML5 version on the demo site. It will load slowly since it's not packaged.

• cocos2d-x is having a major refactoring that includes lots of file renaming/moving. I work off the develop branch, prone to change. I've included below checkouts to the specific commit IDs I used for this project. Checkout to those versions if it doesn't compile/work with a later one, but I aim to work with the latest develop commit.

git clone https://github.com/osuka/multiplatform-gaming.git

git clone https://github.com/cocos2d/cocos2d-x.git
cd cocos2d-x
#OPTIONAL git checkout da24b6a7d8643493328a3eda1752532e024f1bf9
git submodule init
git submodule update
cd ..

git clone https://github.com/cocos2d/cocos2d-html5.git
cd cocos2d-html5
#OPTIONAL git checkout Cocos2d-html5-v2.2.1
git submodule init
git submodule update
cd ..

• The presentation uses an on-screen joystick that can be used to enable/disable physics debug mode, jump and going forward and backwards (press button + joystick left).

For Android (Eclipse, Android NDK and Android SDK required)

• Launch Eclipse, import projects (Import -> Existing Android Code into Workspace):
  • multiplatform-gaming/multiplatform-presentation/proj.android
  • cocos2d-x/cocos/2d/platform/android/java
• Compile native part:
  • multiplatform-gaming/multiplatform-presentation/proj.android/build_native.py
  • Optionally, add more architectures to jni/Application.mk (like armeabi armeabi-v7a)
• Launch the project:
  • From Eclipse (usual way)
  • From command line: ant -Dsdk.dir=<<YOUR_PATH_TO_ANDROID_SDK>> debug install

For Mac and iOS (XCode required)

Simply open project multiplatform-gaming/multiplatform-presentation/proj.ios_mac. Then select the target you want to run, from ios or mac and build/run as usual.

For Web/HTML5 version

The normal web version can be run by just publishing the contents of proj.web folder into a web server, or if you just want to try it, do.

cd multiplatform-gaming/multiplatform-presentation/proj.web
python -m SimpleHTTPServer

Then go to http://localhost:8000 to try it locally.

For Firefox OS

Simply package everything inside multiplatform-gaming/multiplatform-presentation/proj.web into a zip file and push it to the device/simulator.

Note: I'm using lots of symlinks inside proj.web that may not work properly on Windows systems. I do this so I don't have to keep updating the files, instead taking them directly from cocos2d-html5. If they break for you, just copy the corresponding files from cocos2d-html5 distribution.

For Windows and Windows Phone

I haven't been able to even try running it yet, but the theory is that all you might need is renaming some files under proj.win32 and updating some paths. Feel free to open a PR if you do.

Development Notes

Notes on creating the base project

I use the develop branch of cocos2d-x in github (3.0), which is under heavy development.

Initial base project created like this:

cd cocos2d-x/tools/project-creator
./create_project.py -p multiplatform-presentation -k com.gatillos.multiplatformpresentation -l javascript

After creating the project, I moved the resulting sample project from cocos2d-x/projects/multiplatform-presentation to a separate folder, and did quite a few path updates, see below.

Folder structure required

• cocos2d-x
• cocos2d-html5
• multiplatform-gaming
  • multiplatform-presentation

There are symbolic links in the repo that expect this structure. If you have things differently, just update the symlinks or copy files there instead.

iOS and Mac project creation notes

It's very important to understand the XCode structure:

• In particular the Build Settings, with the "Levels" view, from right to left:
  • There's settings for the system (default)
  • Settings for project
  • Settings for target (iOS, Mac)
  • Resolved (combined) settings

If you move the project around or its dependencies, you'll have to tweak settings taking into account each target and the shared components.

Particular to my case, because I want to have the project in a separate folder, I have all paths relative to that directory I had to update the following files in the project to point to the correct location (simply click on them in XCode and clicking on the Folder icon in the Location view in the right panel):

• jsb_cocos2d_gui.js
• jsb_cocos2d_studio.js
• cocos2d_libs.xcodeproj
• Repeat for all files inside the JS Common directory.

Also, had to update in the XCode project, in project / Build Settings / Header Search Paths all the $(SRCROOT)/../../../XXXXX to be $(SRCROOT)/../../../cocos2d-x/XXXXX. Then do the same for the individual targets (ios and mac).

Finally, on the iOS Target I had to remove and re-add OpenGLES.framework, UIKit.framework as they were pointing to different versions, and manually add libchipmunk iOS.a, libcocos2dx iOS.a, libcocos2dx-extensions iOS.a, libCocosDenshion iOS.a, libjsbindings iOS.a. Do the same for the Mac version (with corresponding Mac.a libraries).

Android project creation Notes

• Native part:

  • I edited build_native.py to fix path names:
    • Replaced the two occurrences of ../../../XXXX with ../../../cocos2d- x/XXXX
  • Added some new sources to the LOCAL_SRC_FILES tag in Android.mk.
  • If we need to use a library, for instance network, add:
    • LOCAL_WHOLE_STATIC_LIBRARIES += jsb_network_static
    • $(call import-module,scripting/javascript/bindings/network)
    • To know the static library name, just take a look at the Android.mkfile of the module you want to include.

• Eclipse part

  • Go to Import / Existing Android Code into Workspace and Browse to cocos2d-x/cocos/2d/platform to import libcocos2dx
  • Go to project properties, Android, select a Build Target that is installed in our system and Add a refernce to libcocos2dx
  • Note that android:configChanges="orientation|screenSize|smallestScreenSize doesn't seem to be supported in android-10, so I removed it.

• If using Eclipse for C++ compilation, defined in Preferences/C/C++/Build/Build Variables:

  • NDK_ROOT=/Users/osuka/Documents/code/android/ndk
  • COCOS2DX_ROOT=/Users/osuka/Documents/code/cocos2d-x
  • In environment defined them to export them as system variables
    • NDK_ROOT=${NDK_ROOT}
    • COCOS2DX_ROOT=${COCOS2DX_ROOT}