Developers Manual¶

• Developers Manual
  • 1. About
  • 2. Basic Concepts
  • 3. Cocos2d-x
  • 4. Cocos2d-html5
• Contribution
• Support & Help
• Release Notes
• Tips
  • Comment

1. About¶

• About Us: Cocos2d-x, Cocos2d-html5
• Relationships in Cocos2d Family
• Supported Platforms and Programming Languages
• Easy to Learn - API Style
• Architecture and Directory Structure

2. Basic Concepts¶

• Director, Scene, Layer and Sprite
• Coordinate System
• Scheduler and Timer Callback
• Actions
• Animations
• Skeletal animation
• Transitions
• Effects
• Particles
• TileMap

3. Cocos2d-x¶

• Setting up development environments
  • Android Environment Setup
  • Bada Environment Setup
  • BlackBerry Environment Setup
  • iOS Environment Setup
  • Linux Environment Setup
  • Mac OS X Environment Setup
  • Native Client Environment Setup
  • Windows Phone 8 Environment Setup
  • Windows 8 Metro Environment Setup
  • Windows 7 Environment Setup

• Step by Step Cocos2dxSimpleGame Series
  • Chapter 1 - How to Create a New cocos2d-x project on multi-platforms
  • Chapter 2 - How to Add a sprite
  • Chapter 3 - How to Move a sprite
  • Chapter 4 - How to Fire some Bullets
  • Chapter 5 - How to Detect the Collisions
  • Chapter 6 - How to Play Music and Sound Effect
  • Chapter 7 - Some Icing on the Cake

• Features
  • Audio
    • Audio formats supported by CocosDenshion on different platforms
    • Use OpenSL ES to play effect on Android
  • Data Structures
    • CCArray
    • CCDictionary
    • CCString
  • Memory Management
    • Reference Count and AutoReleasePool in Cocos2d-x
    • Texture Cache
  • Graphic
    • Device Orientation
    • Multi resolution support
    • Max size of textures in cocos2d-x depends on each platform
    • SpriteSheet Animation and Bone Animation
    • How to save a screenshot
  • Handling User Input
    • How to Enable Multi-Touch
    • Target Touch Delegate and Standard Touch Delegate
    • Priority Settings of TouchDelegates
  • File I/O
    • How does CCFileUtils::fullPathFromRelativePath work
    • How to read and write file on different platforms
    • Mechanism of Loading Resources
  • GUI
    • Menu and MenuItems
    • Text Labels
    • EditBox
    • CCControlExtension
  • Network
    • How to use CCHttpClient
    • How to compile libcurl
  • Threading
    • How to use pthread
  • Debugging
    • How to debug cocos2d-x games
    • How to simulate Android behaviors on windows desktop
    • How to debug games for iPad Retina on low-resolution PC
    • How to use CCLOG
  • Physics
    • Chipmunk
    • Box2D
  • Tools and Editors
    • CocosBuilder
    • TexturePacker

• Upgrade Guides
  • v2.x
    • About Static Constructor API changes in cocos2d-x v2.0
    • API Change List from v1.x to 2.x
    • Cocos2d-x v2.0 migration guide
  • v1.x
    • Methods deprecated in 1.0.1
    • Methods deprecated in cocos2d-1.0.1-x-0.9.1
  • v0.x
    • How to upgrade your game from 0.7.2 to 0.8.0
    • How to upgrade your game from 0.7.1 to 0.7.2

• Optimizations
  • Benchmark Reports
  • How to optimise memory usage
  • How to optimise runtime performance
  • Best Practice of cross-platform games

• Scripting and Translating between Programming Languages
  • EasyNDK
    • How to work on iOS - C++/Objective-C
    • How to work on Android - C++/Java
  • For C++ Programmers
    • Moving From Objective-C to C++
    • How to bind Java to C++
    • How to bind Objective-C to C++
    • Case Study - How to integrate with 3rd SDK
  • Javascript Binding
    • How to bind C++ to Javascript
  • Lua Binding
    • How to bind C++ to Lua
    • How to bind Java to Lua
  • Emscripten
    • Usage

4. Cocos2d-html5¶

• Getting Started with Cocos2d-html5
• Multi Scene Resources Loading
• How to custom the loading logo
• Cocos2d-html5 Release Mode
• Obfuscate Javascript code with Google Closure Compiler

Contribution¶

Cocos2d-x, Cocos2d-html5 and Cocos2d-xna are provided to you free of charge. However, if you want to contribute to the project, here's a list of things you could do to help with the development

• How To Participate in Cocos2d-x Project
• If you find a bug!
  • please kindly report the bug on our forum , post it on the correct subforum for your platform. Details on how to make the bug appear would be very helpful.
• If you fix a bug!
  • please fork our repository on http://github.com/cocos2d/cocos2d-x/, and commit your fixed code
  • or you can post your fix code on the forum, we will commit it to github
• I would like to add a port to another platform!
  • please contact us via email/twitter/forum, etc. It would be our pleasure to add a subproject on this website for you!
  • coding style: please reference to Cocos Coding Style
• Show cocos2d-x logo in your game
  • We highly appreciated if you can show cocos2d-x logo in your splash screen or credit, get the logo image from Logo Resources of Cocos2d-x

Support & Help¶

• Forum: http://forum.cocos2d-x.org/
• Twitter: http://www.twitter.com/cocos2dx/
• Weibo: http://weibo.com/cocos2dx/
• conatct: wangzhe (at) cocos2d-x.org

Release Notes¶

2.1.3

Tips¶

link error on ubuntu 64bit