Documente Academic
Documente Profesional
Documente Cultură
DOCTYPE html>
<html lang="en" class=" is-copy-enabled">
<head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# object: http://og
p.me/ns/object# article: http://ogp.me/ns/article# profile: http://ogp.me/ns/pro
file#">
<meta charset='utf-8'>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta http-equiv="Content-Language" content="en">
<meta name="viewport" content="width=1020">
<title>cocos2d-x/RELEASE_NOTES.md at v3 cocos2d/cocos2d-x GitHub</title>
<link rel="search" type="application/opensearchdescription+xml" href="/opens
earch.xml" title="GitHub">
<link rel="fluid-icon" href="https://github.com/fluidicon.png" title="GitHub
">
<link rel="apple-touch-icon" sizes="57x57" href="/apple-touch-icon-114.png">
<link rel="apple-touch-icon" sizes="114x114" href="/apple-touch-icon-114.png
">
<link rel="apple-touch-icon" sizes="72x72" href="/apple-touch-icon-144.png">
<link rel="apple-touch-icon" sizes="144x144" href="/apple-touch-icon-144.png
">
<meta property="fb:app_id" content="1401488693436528">
<meta content="@github" name="twitter:site" /><meta content="summary" name
="twitter:card" /><meta content="cocos2d/cocos2d-x" name="twitter:title" /><meta
content="cocos2d-x for C++" name="twitter:description" /><meta content="https:/
/avatars0.githubusercontent.com/u/234324?v=3&s=400" name="twitter:image:src"
/>
<meta content="GitHub" property="og:site_name" /><meta content="object" pr
operty="og:type" /><meta content="https://avatars0.githubusercontent.com/u/23432
4?v=3&s=400" property="og:image" /><meta content="cocos2d/cocos2d-x" propert
y="og:title" /><meta content="https://github.com/cocos2d/cocos2d-x" property="og
:url" /><meta content="cocos2d-x for C++" property="og:description" />
<meta name="browser-stats-url" content="https://api.github.com/_private/br
owser/stats">
<meta name="browser-errors-url" content="https://api.github.com/_private/bro
wser/errors">
<link rel="assets" href="https://assets-cdn.github.com/">
<meta name="pjax-timeout" content="1000">
<meta name="msapplication-TileImage" content="/windows-tile.png">
<meta name="msapplication-TileColor" content="#ffffff">
<meta name="selected-link" value="repo_source" data-pjax-transient>
<meta name="google-site-verification" content="KT5gs8h0wvaagLKAVWq8bbeNwnZZK
1r1XQysX3xurLU">
<meta name="google-analytics" content="UA-3769691-2">
<meta content="collector.githubapp.com" name="octolytics-host" /><meta conte
nt="collector-cdn.github.com" name="octolytics-script-host" /><meta content="git
hub" name="octolytics-app-id" /><meta content="7371CB06:345D:281C7AB:55E3E0FB" n
ame="octolytics-dimension-request_id" />
<meta content="Rails, view, blob#show" data-pjax-transient="true" name="anal
ytics-event" />
<meta class="js-ga-set" name="dimension1" content="Logged Out">
<meta class="js-ga-set" name="dimension4" content="Current repo nav">
<meta name="is-dotcom" content="true">
<meta name="hostname" content="github.com">
<meta name="user-login" content="">
<link rel="icon" sizes="any" mask href="https://assets-cdn.github.com/pinn
ed-octocat.svg">
<meta name="theme-color" content="#4078c0">
<link rel="icon" type="image/x-icon" href="https://assets-cdn.github.com/f
avicon.ico">
<!-- </textarea> --><!-- '"` --><meta content="authenticity_token" name="csr
f-param" />
<meta content="lYoqHyaB2Rp8G2bE9nIJ5PyNmIEqVXLhgi670OCIEYUHqr4ntisfpnNL5hY/gufag
NR1W6iZSCwfY+DLt5ctow==" name="csrf-token" />
<link crossorigin="anonymous" href="https://assets-cdn.github.com/assets/git
hub/index-ebd09ebc92d1048dd7af5cd68484181a6a6a0260b3df1e7349053db235e6c53a.css"
media="all" rel="stylesheet" />
<link crossorigin="anonymous" href="https://assets-cdn.github.com/assets/git
hub2/index-f20fa2d1dc1467ff8e2f823d0c693c4aba5668d5b740a4c567afc32f85422020.css"
media="all" rel="stylesheet" />
</div>
</div>
<span class="js-pull-replace-counter"></span>
<img alt="" class="mini-loader" height="16" src="https://assets-cdn.gi
thub.com/images/spinners/octocat-spinner-32.gif" width="16" />
</a>
</li>
<li class="tooltipped tooltipped-w" aria-label="Wiki">
<a href="/cocos2d/cocos2d-x/wiki" aria-label="Wiki" class="js-selected-n
avigation-item sunken-menu-item" data-hotkey="g w" data-selected-links="repo_wik
i /cocos2d/cocos2d-x/wiki">
<span class="octicon octicon-book"></span> <span class="full-word">Wik
i</span>
<img alt="" class="mini-loader" height="16" src="https://assets-cdn.gi
thub.com/images/spinners/octocat-spinner-32.gif" width="16" />
</a>
</li>
</ul>
<div class="sunken-menu-separator"></div>
<ul class="sunken-menu-group">
<li class="tooltipped tooltipped-w" aria-label="Pulse">
<a href="/cocos2d/cocos2d-x/pulse" aria-label="Pulse" class="js-selected-n
avigation-item sunken-menu-item" data-selected-links="pulse /cocos2d/cocos2d-x/p
ulse">
<span class="octicon octicon-pulse"></span> <span class="full-word">Puls
e</span>
<img alt="" class="mini-loader" height="16" src="https://assets-cdn.gith
ub.com/images/spinners/octocat-spinner-32.gif" width="16" />
</a>
</li>
<li class="tooltipped tooltipped-w" aria-label="Graphs">
<a href="/cocos2d/cocos2d-x/graphs" aria-label="Graphs" class="js-selected
-navigation-item sunken-menu-item" data-selected-links="repo_graphs repo_contrib
utors /cocos2d/cocos2d-x/graphs">
<span class="octicon octicon-graph"></span> <span class="full-word">Grap
hs</span>
<img alt="" class="mini-loader" height="16" src="https://assets-cdn.gith
ub.com/images/spinners/octocat-spinner-32.gif" width="16" />
</a>
</li>
</ul>
</nav>
<div class="only-with-full-nav">
<div class="js-clone-url clone-url open"
data-protocol-type="http">
<h3><span class="text-emphasized">HTTPS</span> clone URL</h3>
<div class="input-group js-zeroclipboard-container">
<input type="text" class="input-mini input-monospace js-url-field js-zerocli
pboard-target"
value="https://github.com/cocos2d/cocos2d-x.git" readonly="readonly"
aria-label="HTTPS clone URL">
<span class="input-group-button">
<button aria-label="Copy to clipboard" class="js-zeroclipboard btn btn-sm
zeroclipboard-button tooltipped tooltipped-s" data-copied-hint="Copied!" type="b
utton"><span class="octicon octicon-clippy"></span></button>
</span>
</div>
</div>
</div>
<div id="js-repo-pjax-container" class="repository-content context-loade
r-container" data-pjax-container>
<a href="/cocos2d/cocos2d-x/blob/20d7abe6f308009babb27ca001d80695fe997a65/docs/R
ELEASE_NOTES.md" class="hidden js-permalink-shortcut" data-hotkey="y">Permalink<
/a>
<!-- blob contrib key: blob_contributors:v21:3077b58c92a3c2afc7e7967d7e310edc ->
<div class="file-navigation js-zeroclipboard-container">
<div class="select-menu js-menu-container js-select-menu left">
<span class="btn btn-sm select-menu-button js-menu-target css-truncate" data-h
otkey="w"
data-ref="v3"
title="v3"
role="button" aria-label="Switch branches or tags" tabindex="0" aria-haspopu
p="true">
<i>Branch:</i>
<span class="js-select-button css-truncate-target">v3</span>
</span>
<div class="select-menu-modal-holder js-menu-content js-navigation-container"
data-pjax aria-hidden="true">
<div class="select-menu-modal">
<div class="select-menu-header">
<span class="select-menu-title">Switch branches/tags</span>
<span class="octicon octicon-x js-menu-close" role="button" aria-label="
Close"></span>
</div>
<div class="select-menu-filters">
<div class="select-menu-text-filter">
<input type="text" aria-label="Filter branches/tags" id="context-commi
tish-filter-field" class="js-filterable-field js-navigation-enable" placeholder=
"Filter branches/tags">
</div>
<div class="select-menu-tabs">
<ul>
<li class="select-menu-tab">
<a href="#" data-tab-filter="branches" data-filter-placeholder="Fi
lter branches/tags" class="js-select-menu-tab" role="tab">Branches</a>
</li>
<li class="select-menu-tab">
<a href="#" data-tab-filter="tags" data-filter-placeholder="Find a
tag " class="js-select-menu-tab" role="tab">Tags</a>
</li>
</ul>
</div>
</div>
<div class="select-menu-list select-menu-tab-bucket js-select-menu-tab-buc
ket" data-tab-filter="branches" role="menu">
<div data-filterable-for="context-commitish-filter-field" data-filterabl
e-type="substring">
<a class="select-menu-item js-navigation-item js-navigation-open "
href="/cocos2d/cocos2d-x/blob/v1/docs/RELEASE_NOTES.md"
data-name="v1"
data-skip-pjax="true"
rel="nofollow">
<span class="select-menu-item-icon octicon octicon-check"></span>
<span class="select-menu-item-text css-truncate-target" title="v1"
>
v1
</span>
</a>
<a class="select-menu-item js-navigation-item js-navigation-open "
href="/cocos2d/cocos2d-x/blob/v2/docs/RELEASE_NOTES.md"
data-name="v2"
data-skip-pjax="true"
rel="nofollow">
<span class="select-menu-item-icon octicon octicon-check"></span>
<span class="select-menu-item-text css-truncate-target" title="v2"
>
v2
</span>
</a>
<a class="select-menu-item js-navigation-item js-navigation-open sel
ected"
href="/cocos2d/cocos2d-x/blob/v3/docs/RELEASE_NOTES.md"
data-name="v3"
data-skip-pjax="true"
rel="nofollow">
<span class="select-menu-item-icon octicon octicon-check"></span>
<span class="select-menu-item-text css-truncate-target" title="v3"
>
v3
</span>
</a>
<a class="select-menu-item js-navigation-item js-navigation-open "
href="/cocos2d/cocos2d-x/blob/v3.8/docs/RELEASE_NOTES.md"
data-name="v3.8"
data-skip-pjax="true"
rel="nofollow">
<span class="select-menu-item-icon octicon octicon-check"></span>
<span class="select-menu-item-text css-truncate-target" title="v3.
8">
v3.8
</span>
</a>
<a class="select-menu-item js-navigation-item js-navigation-open "
href="/cocos2d/cocos2d-x/blob/v3-doc/docs/RELEASE_NOTES.md"
data-name="v3-doc"
data-skip-pjax="true"
rel="nofollow">
<span class="select-menu-item-icon octicon octicon-check"></span>
<span class="select-menu-item-text css-truncate-target" title="v3doc">
v3-doc
</span>
</a>
<a class="select-menu-item js-navigation-item js-navigation-open "
href="/cocos2d/cocos2d-x/blob/v4-develop/docs/RELEASE_NOTES.md"
data-name="v4-develop"
data-skip-pjax="true"
rel="nofollow">
<span class="select-menu-item-icon octicon octicon-check"></span>
<span class="select-menu-item-text css-truncate-target" title="v4develop">
v4-develop
</span>
</a>
<a class="select-menu-item js-navigation-item js-navigation-open "
href="/cocos2d/cocos2d-x/blob/v35-for-tizen/docs/RELEASE_NOTES.md
"
data-name="v35-for-tizen"
data-skip-pjax="true"
rel="nofollow">
<span class="select-menu-item-icon octicon octicon-check"></span>
<span class="select-menu-item-text css-truncate-target" title="v35
-for-tizen">
v35-for-tizen
</span>
</a>
</div>
<div class="select-menu-no-results">Nothing to show</div>
</div>
<div class="select-menu-list select-menu-tab-bucket js-select-menu-tab-buc
ket" data-tab-filter="tags">
<div data-filterable-for="context-commitish-filter-field" data-filterabl
e-type="substring">
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-4.0alpha1/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-4.0alpha1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-4.0alpha1">cocos2d-x-4.0alpha1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-4.0alpha0/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-4.0alpha0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-4.0alpha0">cocos2d-x-4.0alpha0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.8rc0/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.8rc0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.8rc0">cocos2d-x-3.8rc0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.8beta0/docs/RELEASE_N
OTES.md"
data-name="cocos2d-x-3.8beta0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.8beta0">cocos2d-x-3.8beta0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.7rc1/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.7rc1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.7rc1">cocos2d-x-3.7rc1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.7rc0/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.7rc0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.7rc0">cocos2d-x-3.7rc0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.7beta0/docs/RELEASE_N
OTES.md"
data-name="cocos2d-x-3.7beta0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.7beta0">cocos2d-x-3.7beta0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.7.1/docs/RELEASE_NOTE
S.md"
data-name="cocos2d-x-3.7.1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.7.1">cocos2d-x-3.7.1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.7/docs/RELEASE_NOTES.
md"
data-name="cocos2d-x-3.7"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.7">cocos2d-x-3.7</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.6beta0/docs/RELEASE_N
OTES.md"
data-name="cocos2d-x-3.6beta0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.6beta0">cocos2d-x-3.6beta0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.6alpha0/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-3.6alpha0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.6alpha0">cocos2d-x-3.6alpha0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.6/docs/RELEASE_NOTES.
md"
data-name="cocos2d-x-3.6"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.6">cocos2d-x-3.6</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.5-tizen/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-3.5-tizen"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.5-tizen">cocos2d-x-3.5-tizen</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.5rc0/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.5rc0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.5rc0">cocos2d-x-3.5rc0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.5beta0/docs/RELEASE_N
OTES.md"
data-name="cocos2d-x-3.5beta0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.5beta0">cocos2d-x-3.5beta0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.5/docs/RELEASE_NOTES.
md"
data-name="cocos2d-x-3.5"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.5">cocos2d-x-3.5</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.4rc1/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.4rc1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.4rc1">cocos2d-x-3.4rc1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.4rc0/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.4rc0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.4rc0">cocos2d-x-3.4rc0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.4beta0/docs/RELEASE_N
OTES.md"
data-name="cocos2d-x-3.4beta0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.4beta0">cocos2d-x-3.4beta0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.4/docs/RELEASE_NOTES.
md"
data-name="cocos2d-x-3.4"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.4">cocos2d-x-3.4</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.3rc2/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.3rc2"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.3rc2">cocos2d-x-3.3rc2</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.3rc1/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.3rc1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.3rc1">cocos2d-x-3.3rc1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.3rc0/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.3rc0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.3rc0">cocos2d-x-3.3rc0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.3beta0/docs/RELEASE_N
OTES.md"
data-name="cocos2d-x-3.3beta0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.3beta0">cocos2d-x-3.3beta0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.3alpha0/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-3.3alpha0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.3alpha0">cocos2d-x-3.3alpha0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.3/docs/RELEASE_NOTES.
md"
data-name="cocos2d-x-3.3"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.3">cocos2d-x-3.3</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.2rc0/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.2rc0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.2rc0">cocos2d-x-3.2rc0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.2alpha0/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-3.2alpha0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.2alpha0">cocos2d-x-3.2alpha0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.2/docs/RELEASE_NOTES.
md"
data-name="cocos2d-x-3.2"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.2">cocos2d-x-3.2</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.1rc0/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.1rc0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.1rc0">cocos2d-x-3.1rc0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.1alpha1/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-3.1alpha1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.1alpha1">cocos2d-x-3.1alpha1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.1alpha0/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-3.1alpha0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.1alpha0">cocos2d-x-3.1alpha0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.1.1/docs/RELEASE_NOTE
S.md"
data-name="cocos2d-x-3.1.1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.1.1">cocos2d-x-3.1.1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.1/docs/RELEASE_NOTES.
md"
data-name="cocos2d-x-3.1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.1">cocos2d-x-3.1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.0rc2/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.0rc2"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.0rc2">cocos2d-x-3.0rc2</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.0rc1/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.0rc1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.0rc1">cocos2d-x-3.0rc1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.0rc0/docs/RELEASE_NOT
ES.md"
data-name="cocos2d-x-3.0rc0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.0rc0">cocos2d-x-3.0rc0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.0rc/docs/RELEASE_NOTE
S.md"
data-name="cocos2d-x-3.0rc"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.0rc">cocos2d-x-3.0rc</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.0beta2/docs/RELEASE_N
OTES.md"
data-name="cocos2d-x-3.0beta2"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.0beta2">cocos2d-x-3.0beta2</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.0beta/docs/RELEASE_NO
TES.md"
data-name="cocos2d-x-3.0beta"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-3.0beta">cocos2d-x-3.0beta</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-3.0alpha1/docs/RELEASE_
NOTES.md"
data-name="cocos2d-x-3.0alpha1"
data-skip-pjax="true"
rel="nofollow"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-2.1.5">cocos2d-x-2.1.5</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-x-2.1.4/docs/RELEASE_NOTE
S.md"
data-name="cocos2d-x-2.1.4"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-x-2.1.4">cocos2d-x-2.1.4</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-2.1rc0-x-2.1.3/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-2.1rc0-x-2.1.3"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-2.1rc0-x-2.1.3">cocos2d-2.1rc0-x-2.1.3</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-2.1rc0-x-2.1.2/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-2.1rc0-x-2.1.2"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-2.1rc0-x-2.1.2">cocos2d-2.1rc0-x-2.1.2</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-2.1beta3-x-2.1.1/docs/REL
EASE_NOTES.md"
data-name="cocos2d-2.1beta3-x-2.1.1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-2.1beta3-x-2.1.1">cocos2d-2.1beta3-x-2.1.1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-2.1beta3-x-2.1.0/docs/REL
EASE_NOTES.md"
data-name="cocos2d-2.1beta3-x-2.1.0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-2.1beta3-x-2.1.0">cocos2d-2.1beta3-x-2.1.0</a>
</div>
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-1.0.1-x-0.13.0-beta">cocos2d-1.0.1-x-0.13.0-beta
</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-1.0.1-x-0.12.0/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-1.0.1-x-0.12.0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-1.0.1-x-0.12.0">cocos2d-1.0.1-x-0.12.0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-1.0.1-x-0.11.0/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-1.0.1-x-0.11.0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-1.0.1-x-0.11.0">cocos2d-1.0.1-x-0.11.0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-1.0.1-x-0.10.0/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-1.0.1-x-0.10.0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-1.0.1-x-0.10.0">cocos2d-1.0.1-x-0.10.0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-1.0.1-x-0.9.2/docs/RELEAS
E_NOTES.md"
data-name="cocos2d-1.0.1-x-0.9.2"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-1.0.1-x-0.9.2">cocos2d-1.0.1-x-0.9.2</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-1.0.1-x-0.9.1/docs/RELEAS
E_NOTES.md"
data-name="cocos2d-1.0.1-x-0.9.1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-1.0.1-x-0.9.1">cocos2d-1.0.1-x-0.9.1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-1.0.0-x-0.9.0/docs/RELEAS
E_NOTES.md"
data-name="cocos2d-1.0.0-x-0.9.0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-1.0.0-x-0.9.0">cocos2d-1.0.0-x-0.9.0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.5-x-0.8.5/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.5-x-0.8.5"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.5-x-0.8.5">cocos2d-0.99.5-x-0.8.5</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.5-x-0.8.4/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.5-x-0.8.4"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.5-x-0.8.4">cocos2d-0.99.5-x-0.8.4</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.5-x-0.8.3/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.5-x-0.8.3"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.5-x-0.8.3">cocos2d-0.99.5-x-0.8.3</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.5-x-0.8.2/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.5-x-0.8.2"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.5-x-0.8.2">cocos2d-0.99.5-x-0.8.2</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.5-x-0.8.1/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.5-x-0.8.1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.5-x-0.8.1">cocos2d-0.99.5-x-0.8.1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.5-x-0.8.0/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.5-x-0.8.0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.5-x-0.8.0">cocos2d-0.99.5-x-0.8.0</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.5-x-0.7.2/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.5-x-0.7.2"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.5-x-0.7.2">cocos2d-0.99.5-x-0.7.2</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.4-x-0.7.1/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.4-x-0.7.1"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.4-x-0.7.1">cocos2d-0.99.4-x-0.7.1</a>
</div>
<div class="select-menu-item js-navigation-item ">
<span class="select-menu-item-icon octicon octicon-check"></span>
<a href="/cocos2d/cocos2d-x/tree/cocos2d-0.99.4-x-0.7.0/docs/RELEA
SE_NOTES.md"
data-name="cocos2d-0.99.4-x-0.7.0"
data-skip-pjax="true"
rel="nofollow"
class="js-navigation-open select-menu-item-text css-truncate-ta
rget"
title="cocos2d-0.99.4-x-0.7.0">cocos2d-0.99.4-x-0.7.0</a>
</div>
</div>
<div class="select-menu-no-results">Nothing to show</div>
</div>
</div>
</div>
</div>
<div class="file-actions">
<div class="btn-group">
<a href="/cocos2d/cocos2d-x/raw/v3/docs/RELEASE_NOTES.md" class="btn btn
-sm " id="raw-url">Raw</a>
<a href="/cocos2d/cocos2d-x/blame/v3/docs/RELEASE_NOTES.md" class="btn
btn-sm js-update-url-with-hash">Blame</a>
<a href="/cocos2d/cocos2d-x/commits/v3/docs/RELEASE_NOTES.md" class="btn
btn-sm " rel="nofollow">History</a>
</div>
<a class="octicon-btn tooltipped tooltipped-nw"
href="https://windows.github.com"
aria-label="Open this file in GitHub Desktop"
data-ga-click="Repository, open with desktop, type:windows">
<span class="octicon octicon-device-desktop"></span>
</a>
<button type="button" class="octicon-btn disabled tooltipped tooltippe
d-n" aria-label="You must be signed in to make or propose changes">
<span class="octicon octicon-pencil"></span>
</button>
<button type="button" class="octicon-btn octicon-btn-danger disabled too
ltipped tooltipped-n" aria-label="You must be signed in to make or propose chang
es">
<span class="octicon octicon-trashcan"></span>
</button>
</div>
<div class="file-info">
526 lines (388 sloc)
<span class="file-info-divider"></span>
21.126 kB
</div>
</div>
<div id="readme" class="blob instapaper_body">
<article class="markdown-body entry-content" itemprop="mainContentOfPage">
href="#cocos-console">Cocos Console</a></li>
href="#mac-osx-&-ios">Mac OSX & iOS</a></li>
href="#android">Android</a></li>
href="#windows">Windows</a></li>
<li><a href="#linux">Linux</a></li>
</ul></li>
<li><a href="#how-to-start-a-new-game">How to start a new game</a></li>
</ul></li>
<li><a href="#v38">v3.8</a>
<ul>
<li><a href="#highlights-and-api-changes-of-v38">Highlights and API changes of v
3.8</a></li>
<li><a href="#download">Download</a></li>
<li><a href="#the-main-features-in-detail">The main features in detail:</a>
<ul>
<li><a href="#3d-module">3D Module</a></li>
<li><a href="#ui-system">UI System</a></li>
<li><a href="#audioengine">AudioEngine</a></li>
<li><a href="#fileutils">FileUtils</a></li>
<li><a href="#others">Others</a></li>
</ul></li>
<li><a href="#other-changes">Other changes</a></li>
<li><a href="#new-apis">New APIs</a></li>
</ul></li>
<li><a href="#the-next-step">The Next Step</a></li>
</ul>
</code></pre>
<p>Run</p>
<pre><code>$ cd bin/cpp-empty-test
$ ./cpp-empty-test
</code></pre>
<h2><a id="user-content-how-to-start-a-new-game" class="anchor" href="#how-to-st
art-a-new-game" aria-hidden="true"><span class="octicon octicon-link"></span></a
>How to start a new game</h2>
<p>Use Cocos Console to create a new game:</p>
<pre><code>cocos new -l cpp|js|lua MyNewGame
</code></pre>
<h1><a id="user-content-v38" class="anchor" href="#v38" aria-hidden="true"><span
class="octicon octicon-link"></span></a>v3.8</h1>
<h2><a id="user-content-highlights-and-api-changes-of-v38" class="anchor" href="
#highlights-and-api-changes-of-v38" aria-hidden="true"><span class="octicon octi
con-link"></span></a>Highlights and API changes of v3.8</h2>
<p>As promised, Cocos2d-x v3.8 have greatly improved the stability and API frien
dliness. On one side, we continue to improve 3D capacity by providing 3D physics
collider, skybox background brush and key frame event callback in Animate3D. On
another side, we have refined several core modules, including UI system, AudioE
ngine, FileUtils, Bindings Generator, etc.</p>
<p>Here is some highlighted improvments and API changes:</p>
<ol>
<li>3D Module
<ul>
<li>Added 3D physics collider</li>
<li>Supported setting camera background brushes with color/depth/skybox </li>
<li>Added key frame event Callback in Animate3D</li>
<li>Added light map support in Terrain</li>
</ul></li>
<li>UI System
<ul>
<li>Reimplemented and enhanced EditBox on Android</li>
<li>Added ScrollViewBar for displaying a scroll bar at the side of ScrollView (J
SB/Lua ready)</li>
<li>Added RadioButton widget (JSB/Lua ready)</li>
<li>Added HANYI FullType font support</li>
</ul></li>
<li>AudioEngine
<ul>
<li>AudioEngine supported audio preloading</li>
<li>Bound new AudioEngine in JSB</li>
</ul></li>
<li>FileUtils
<ul>
<li>Added a set of file writing APIs: writeStringToFile, writeDataToFile, writeV
alueMapToFile, writeValueVectorToFile</li>
</ul></li>
<li>Others
<ul>
<li>Improved Bindings Generator tool</li>
<li>Merged JSB test project into cocos2d test project</li>
<li>framework: Support generate prebuilt libs of engine with debug mode</li>
<li>console: Supported new portrait projects from templates</li>
</ul></li>
</ol>
<h2><a id="user-content-download" class="anchor" href="#download" aria-hidden="t
rue"><span class="octicon octicon-link"></span></a>Download</h2>
<p><a href="http://www.cocos2d-x.org/filedown/cocos2d-x-3.8-rc0.zip">Cocos2d-x v
3.8 rc0</a> including : C++, Lua & JS</p>
<h2><a id="user-content-the-main-features-in-detail" class="anchor" href="#the-m
ain-features-in-detail" aria-hidden="true"><span class="octicon octicon-link"></
span></a>The main features in detail:</h2>
<h3><a id="user-content-3d-module" class="anchor" href="#3d-module" aria-hidden=
"true"><span class="octicon octicon-link"></span></a>3D Module</h3>
<ol>
<li><p>3D physics collider</p>
<p>3D physics collider is a new type of physics object. It can be used as both t
rigger and collider. </p>
<p>Trigger is a region defined by physics shapes and can get callback when othe
r physics objects enter or leave. Its usage is described in the following code:<
/p>
<div class="highlight highlight-cpp"><pre><span class="pl-c">//create a collider
using colliderDes</span>
Physics3DColliderDes colliderDes;
colliderDes.shape = Physics3DShape::createSphere(<span class="pl-c1">10</span>.<
span class="pl-c1">0f</span>);
colliderDes.isTrigger = <span class="pl-c1">true</span>;
<span class="pl-k">auto</span> collider = Physics3DCollider::create(&collide
rDes);
<span class="pl-k">auto</span> component = Physics3DComponent::create(collider);
<span class="pl-k">auto</span> node = Node::create();
<span class="pl-en">addChild</span>(node);
node-><span class="pl-en">addComponent</span>(component);
collider->onTriggerEnter = [=](Physics3DObject *otherObject){
<span class="pl-c">//some body entering</span>
};
collider->onTriggerExit = [=](Physics3DObject *otherObject){
<span class="pl-c">//some one leaving</span>
}; </pre></div>
<p>Collider is similar to rigid body, it can give force to the rigid body that c
ollides with it. However, it is static and has better performance than rigid bod
y. It is proper to represent a static scene or objects using collider and dynami
c part using rigid body. You can set colliderDes.isTrigger to false when you wan
t to make it collider.</p></li>
></div></li>
<li><p>Light map support in Terrain</p>
<p>Terrain with light map is supported in v3.8, which means you can add a light
map texture baked from other tools to the terrain. The light map texture contain
s light info, so that the terrain seems to be lighted with several lights. Terra
in with light map can be created like this,</p>
<p>Usage:</p>
<div class="highlight highlight-cpp"><pre>ui::ScrollView* scrollView = ui::Scrol
lView::create();
scrollView-><span class="pl-en">setScrollBarWidth</span>(<span class="pl-c1">
4</span>);
scrollView-><span class="pl-en">setScrollBarPositionFromCorner</span>(Vec2(<s
pan class="pl-c1">2</span>, <span class="pl-c1">2</span>));
scrollView-><span class="pl-en">setScrollBarColor</span>(Color3B::WHITE);
<span class="pl-v">this</span>-><span class="pl-en">addChild</span>(scrollVie
w);</pre></div></li>
<li><p>RadioButton widget</p>
<p>RadioButton is a specific type of two-states button that is similar to CheckB
ox.</p>
</ol>
<h3><a id="user-content-others" class="anchor" href="#others" aria-hidden="true"
><span class="octicon octicon-link"></span></a>Others</h3>
<ol>
<li><p>Bindings Generator</p>
<p>In v3.8, we also improved our bindings generator tool, now it's even more pow
erful and be able to bind almost all kind of C++ APIs to script. Here is a detai
led list about improvement in bindings generator.</p>
<ul>
<li>Supported generating auto bindings code for public member variables</li>
<li>Avoid memory leak of non-Ref classes instance by controlling C++ object memo
ry with JS object</li>
<li>Made JSB classes automatically extendable if configured in classes_need_exte
nd list</li>
<li>Improved support for Lambda functions in JS auto bindings</li>
</ul></li>
<li><p>JSB test project</p>
<p>In v3.8, JSB test project have been merged into C++ test project. That means
cocos2d_js_tests.xcodeproj, cocos2d-js-win32.sln, cocos2d-js-win8.1-universal.sl
n have been removed. You can find jsb test targets in cocos2d_test.xcodeproj, co
cos2d-win32.sln and cocos2d-win8.1-universal.sln.</p></li>
<li><p>Compile custom framework in debug mode</p>
<p>From v3.7, you was able to generate customized Cocos Framework from cocos2d-x
. We have improved this ability in v3.8, now you will be able to generate frame
work in debug mode. Here is the some documentation about it:</p>
<ul>
<li><a href="http://www.cocos2d-x.org/wiki/Cocos_gen-libs">Framework compile doc
umentation</a>.</li>
<li><a href="http://www.cocos2d-x.org/docs/manual/studio/v4/chapter3/HowToCode/C
ustomizeFramework-v3.8/en">How to customize Cocos Framework</a></li>
<li><a href="http://www.cocos2d-x.org/wiki/Cocos_gen-simulator">How to generate
Cocos Simulator</a></li>
</ul></li>
<li><p>Portrait projects support</p>
<p>From v3.8, you can generate portrait oriented games with Cocos Console:</p>
<pre><code>cocos new -l cpp|lua|js --portrait MyPortraitGame
</code></pre>
<p>More details can be found in <a href="http://www.cocos2d-x.org/wiki/Cocos_new
">Cocos new command</a> and <a href="http://www.cocos2d-x.org/wiki/Cocos2d-conso
le">Cocos Console general documentation</a></p></li>
</ol>
<h2><a id="user-content-other-changes" class="anchor" href="#other-changes" aria
-hidden="true"><span class="octicon octicon-link"></span></a>Other changes</h2>
<ul>
<li>[NEW]
<li>[NEW]
<li>[NEW]
<li>[NEW]
UI:
UI:
UI:
UI:
<li>[NEW]
Action: Permitted setting bitwise flags to action</li>
<li>[NEW]
Animate: Added Animate's getCurrentFrameIndex function</li>
<li>[NEW]
FileUtils: Added FileUtils::getFileExtension for getting fil
e's extension name</li>
<li>[NEW]
Device: Added vibrate support to enable vibration for a dura
tion</li>
<li>[NEW]
UserDefault: Supported removing key pairs from UserDefault</
li>
<li>[NEW]
spine: Supported Spine runtime 2.3 (Both native and web engi
ne)</li>
<li>[NEW]
console: Moved the framework-compile tools into cocos2d-cons
ole</li>
<li><p>[NEW]
network: Upgrade SocketIO support to v1.x</p></li>
<li><p>[REFINE]
3D: Supported composite 2D/3D scene by moving UI and came
ra far away</p></li>
<li>[REFINE]
3D: Improved Particle3D performance</li>
<li>[REFINE]
Label: Supported adding child nodes in Label</li>
<li>[REFINE]
UI: Improved Slider's precision</li>
<li>[REFINE]
UI: Refined scroll event dispatching for ScrollView</li>
<li>[REFINE]
UI: Improved event handling in TextField</li>
<li>[REFINE]
Label: Supported auto batch with bitmap font or char map</li
>
<li>[REFINE]
studio: Added BlendFrame support to Skeleton Animation</li>
<li>[REFINE]
studio: Enabled blendfunc cascade to the skin of BoneNode</l
i>
<li>[REFINE]
utils: Made utils::captureScreen saving file in another thre
ad to improve the performance</li>
<li>[REFINE]
3rd party: Update Nibiru SDK to 2.6</li>
<li>[REFINE]
JS: Supported new construction for 3d classes in JS</li>
<li>[REFINE]
JS: Refine performance for Cocos Studio JSON parser for 2.x<
/li>
<li>[REFINE]
web: Avoid re-bake the content when the parent node's positi
on get changed</li>
<li>[REFINE]
web: Solved repeat loading same resource issue when parsing
cocos studio project</li>
<li>[REFINE]
web: Optimized resources automatic loading in JSON parser</l
i>
<li>[REFINE]
web: Avoid cc.loader resource loading being terminated while
encounter errors</li>
<li>[REFINE]
web: Suspended the video player when the browser is minimize
d</li>
</ul>
<p>You can also take a look at <a href="https://github.com/cocos2d/cocos2d-x/blo
b/v3/CHANGELOG">the full changelog</a></p>
<h2><a id="user-content-new-apis" class="anchor" href="#new-apis" aria-hidden="t
rue"><span class="octicon octicon-link"></span></a>New APIs</h2>
<p>In the above changes, there are some new APIs introduced in v3.8, they are li
sted here:</p>
<ol>
<li><p>PageView vertical scroll support</p>
<pre><code>PageView* pageView = PageView::create();
pageView->setContentSize(Size(240.0f, 130.0f));
pageView->setDirection(ui::PageView::Direction::VERTICAL);
</code></pre></li>
<li><p>Setter for line width in DrawNode</p>
<ol>
<li>We are about to provide a script based component system.</li>
<li>Improve ScrollView, ListView performance in both native and web engine.</li>
<li>Improve 2D particle system performance.</li>
<li>Improve web engine renderer logic and performance.</li>
<li>Support Action inheritance in JSB.</li>
<li>Remove libcurl dependency on iOS and Android.</li>
</ol>
<p><a href="https://github.com/cocos2d/cocos2d-x/milestones/v3.9">The v3.9 miles
tone tasks</a> (It's still being reviewing and will be updated)</p>
</article>
</div>
</div>
<a href="#jump-to-line" rel="facebox[.linejump]" data-hotkey="l" style="display:
none">Jump to Line</a>
<div id="jump-to-line" style="display:none">
<!-- </textarea> --><!-- '"` --><form accept-charset="UTF-8" action="" class="
js-jump-to-line-form" method="get"><div style="margin:0;padding:0;display:inline
"><input name="utf8" type="hidden" value="✓" /></div>
<input class="linejump-input js-jump-to-line-field" type="text" placeholder=
"Jump to line…" aria-label="Jump to line" autofocus>
<button type="submit" class="btn">Go</button>
</form></div>
</div>
</div>
<div class="modal-backdrop"></div>
</div>
</div>
</div><!-- /.wrapper -->
<div class="container">
<div class="site-footer" role="contentinfo">
<ul class="site-footer-links right">
<li><a href="https://status.github.com/" data-ga-click="Footer, go to st
atus, text:status">Status</a></li>
<li><a href="https://developer.github.com" data-ga-click="Footer, go to ap
i, text:api">API</a></li>
<li><a href="https://training.github.com" data-ga-click="Footer, go to tra
ining, text:training">Training</a></li>
<li><a href="https://shop.github.com" data-ga-click="Footer, go to shop, t
ext:shop">Shop</a></li>
<li><a href="https://github.com/blog" data-ga-click="Footer, go to blog,
text:blog">Blog</a></li>
<li><a href="https://github.com/about" data-ga-click="Footer, go to abou
t, text:about">About</a></li>
<li><a href="https://github.com/pricing" data-ga-click="Footer, go to pr
icing, text:pricing">Pricing</a></li>
</ul>
<a href="https://github.com" aria-label="Homepage">
<span class="mega-octicon octicon-mark-github" title="GitHub"></span>
</a>
<ul class="site-footer-links">
<li>© 2015 <span title="0.05100s from github-fe127-cp1-prd.iad.github
.net">GitHub</span>, Inc.</li>
<li><a href="https://github.com/site/terms" data-ga-click="Footer, go to
terms, text:terms">Terms</a></li>
<li><a href="https://github.com/site/privacy" data-ga-click="Footer, go
to privacy, text:privacy">Privacy</a></li>
<li><a href="https://github.com/security" data-ga-click="Footer, go to s
ecurity, text:security">Security</a></li>
<li><a href="https://github.com/contact" data-ga-click="Footer, go to co
ntact, text:contact">Contact</a></li>
<li><a href="https://help.github.com" data-ga-click="Footer, go to help,
text:help">Help</a></li>
</ul>
</div>
</div>
<div class="fullscreen-overlay js-fullscreen-overlay" id="fullscreen_overlay
">
<div class="fullscreen-container js-suggester-container">
<div class="textarea-wrap">
<textarea name="fullscreen-contents" id="fullscreen-contents" class="fulls
creen-contents js-fullscreen-contents" placeholder="" aria-label=""></textarea>
<div class="suggester-container">
<div class="suggester fullscreen-suggester js-suggester js-navigation-co
ntainer"></div>
</div>
</div>
</div>
<div class="fullscreen-sidebar">
<a href="#" class="exit-fullscreen js-exit-fullscreen tooltipped tooltippedw" aria-label="Exit Zen Mode">
<span class="mega-octicon octicon-screen-normal"></span>
</a>
<a href="#" class="theme-switcher js-theme-switcher tooltipped tooltipped-w"
aria-label="Switch themes">
<span class="octicon octicon-color-mode"></span>
</a>
</div>
</div>
8ba28fccdfb.js"></script>
<div class="js-stale-session-flash stale-session-flash flash flash-warn flas
h-banner hidden">
<span class="octicon octicon-alert"></span>
<span class="signed-in-tab-flash">You signed in with another tab or window
. <a href="">Reload</a> to refresh your session.</span>
<span class="signed-out-tab-flash">You signed out in another tab or window
. <a href="">Reload</a> to refresh your session.</span>
</div>
</body>
</html>