Developers Manual > Cocos2d-JS > Release Notes and Upgrade Guides for Cocos2d-JS > Release Notes for Cocos2d-JS v30Final

Cocos2d-JS v3.0 Final release note

Cocos2d-JS is Cocos2d-x engine's JavaScript version that includes Cocos2d-html5 and Cocos2d-x JavaScript Bindings. It equips your game with cross-browser and cross-platform abilities, accompanied by full Cocos2d-x features and simplified JavaScript friendly APIs.

Cocos2d-JS reinvented workflows for all platforms in v3.0, it provides a consistent development experience for whichever platform you want to distribute to, no matter web and native. "Code once, run everywhere" is incredibly easy and natural in Cocos2d-JS. With one single JavaScript code base, you can run your game on all web browsers and native platforms including Mac OS, Windows, iOS and Android. This will bring your game great opportunities in almost all channels of distribution. On the other hand, if you are only interested in casual games on the web, you can embed directly in your web page the Cocos2d-JS Lite Version which is extremely easy to use and light as a feather.

Furthermore, JavaScript friendly APIs make your game development experience a breeze - easy to code, test and distribute. In the meantime, Cocos2d-JS v3.0 is super powerful along with all these cool new features: Editors Support, Assets Manager, Object Pool, JS to Objective-C/JAVA reflection, etc.


  • Cross platforms developers can use Cocos Console to create projects, boost their development with web version engine and deploy games onto all native platforms and all browsers with Cocos Console.

  • Casual web game developers can download the Lite Version and start to develop just like using other web frameworks (e.g. jQuery).



  • One code base, run everywhere with unified Cocos2d-JS API.
  • JavaScript style API refactorations: new construction, property APIs, simplified action APIs.
  • Assets manager for assets and scripts hot update.
  • Added new event manager to allow all kinds of objects to observe all event types.
  • Added JavaScript to JAVA/Objective-C reflection support.
  • Added Spine animations support.


For JSB build, there are some restrictions :

  • [Android build] NDK version must be r9d
  • [iOS build] Xcode version must be 5.1.1 +


More information

Read more about all the features and bug fixes

About Cocos2d family

  • Cocos2d-JS v3.0 uses Cocos2d-x 3.2 final as base of JSB solution
  • Cocos2d-JS v3.0 is compatible with Cocos Code IDE v1.0.0 RC2+
  • Cocos2d-JS v3.0 is compatible with Cocos Studio v1.2 - v1.5.0.1

With any problems you might have, our communities are happy to help:


Cocos2d-JS have greatly simplified cross platform development. For the next step, we will focus on improving performance on mobile web, toolchain enhancement and completing documentation. Here is a list of main tasks we consider to accomplish in v3.1 :

  • The research for performance improvement on Web engine have already made great progress, the new renderer for canvas render mode is ready and will be merged in v3.1. The performance is upto 50% better than v3.0 based on various tests.
  • Facebook SDK for Cocos2d-JS will be released with v3.1, developers can use all Facebook features on iOS/Android/Web with the same JavaScript code.
  • Continue the research of memory model in JSB, improve the stability and simplify the usage.
  • Complete the Cocos2d-JS Programming Guide document to cover all important aspects about Cocos2d-JS development.

workflows.jpg - workflow (159.2 kB) linshun, 2014-12-06 10:18

Sign up for our newsletter to keep up with the latest developments, releases and updates for Cocos2d-x.