Cocos2d-x 3.17.1 側重于穩定性的提升, 已有問題的修復。
當前版本包含 45 項 bug 修復和 34 項小改進，不再列舉，請參考 ChangeLog。
Cocos2d-x 3.17 版本著重于工具鏈的更新，和穩定性的增強。
Android 平臺使用 Android Studio (3.0, 3.1, 3.1.1) 和 NDK r16 進行測試。
3.17 帶來對 iPhone X 的支持，包含支持全屏模式，支持自動隱藏 Home 指示器，改用 Storyboard 作為啟動屏幕，和增加獲取 Safe Area 的接口。在開發支持 iPhone X 的應用時，最需要了解清楚的就是 Safe Area：
開發者可以通過調用 `Director::getSafeAreaRect()` 來獲取 Safe Area 區域。
Android Studio 是 Google 官方唯一支持的 Android 開發 IDE。
該版本增加了對 Android Studio 3.0+ 的支持。在支持的過程中，同時將 NDK 版本從 r14 升級到 r16。對 Gradle 工程配置也進行了諸多改進，包括簡化 Gradle 變量 PROP_*，將依賴聲明中棄用的 `compile` 改為新的 `implementation`，增加用以削減 Release 包體積的 Proguard 文件。
擴展 CMake 構建支持至全平臺，包括 Android (NDK)、iOS、macOS、Linux、Windows（VC++ compiler）。支持將引擎部分進行預編譯，并在新的構建過程中重用預編譯的引擎庫。通過使用預編譯庫，可以極大的縮短工程構建時間。
詳細的使用方法請參考 CMake 文檔
Spine 骨骼動畫廣泛用于 Cocos2d-x 開發的游戲，引擎跟進 Spine 的升級，升級 Runtime 至 3.6.39。
升級 GLFW 至 3.2.1 以修復支持游戲手柄時存在的問題，同時提供 GLFW 預編譯庫。
社區希望引擎升級 Box2D，可 Box2D 的新版本遲遲未發布，根據反饋 GitHub 提交 f655c603ba9d83 是穩定的，升級 Box2D 至該提交，同時提供 Box2D 的預編譯庫。
每一次版本發布，都會附帶特定版本的第三方預編譯庫，如果由于項目需要想對第三方庫進行定制，請參考: 第三方庫文檔
由于 Google 官方自 Android SDK Tools 25.3.0 就已放棄 ant 支持。移除舊有的 `proj.android` ant 工程，新的 `proj.android` 是 Android Studio 工程。NDK r16 棄用了 armeabi，引擎調整默認的編譯架構從 armeabi 為 armeabi-v7a。
在 win32 平臺，越來越多的開發者已經使用 Visual Studio 2015/2017 進行開發，移除對年代久遠的 2013 的支持?，F存的工程配置適合于 2015 ，如果需要使用 2017，可打開現有的 sln 文件，調整配置，或使用 CMake。
該版本包含 51 項 bugs 修復和 33 項小改進，不再列舉，請參考 Changelog。
Cocos2d-x v3.16版本使用如下Android工具鏈進行測試：
creator_to_cocos2dx是一個Cocos Creator的插件。該插件用于導出Creator創建的場景內容給cocos2d-x的C++/Lua工程使用。下文的__插件__就是指這個插件。
通過使用該插件，可以把Cocos Creator當成cocos2d-x的場景編輯器。該插件目前支持這些特性，會持續支持其他新的特性。有些特性只在v3.16+版本支持，比如RichText img標簽。
插件的詳細使用方法可以參考插件倉庫的the READE，歡迎使用并給與反饋。
Scene effect in cocos creator
Scene effect in cocos2d-x
LayerRadialGradien和LayerColor類似，它會在制定的圓里繪制顏色，效果如下：
v3.16版本之前，Lua工程在Xcode 8.0+模擬器會崩潰。這是luajit本身的一個bug，v3.16版本修復了這個問題。如果不想更新引擎，也可以直接更新luajit。
v3.16版本之前，CCFileUtils使用system()函數來刪除目錄。iOS 11刪除了system，因此導致了編譯錯誤。改版本修復了這個問題。對應的PR鏈接在這里，如果不想更新引擎的話，可以參考該PR的改動合并以修復這個問題。
v3.15更新了flatbuffer，破壞了Cocos Studio reader的兼容性。該版本回退了flatbuffer和Cocos Studio的reader。
如果不想更新引擎的話，可以手動從改版本或者v3.15之前的版本拷貝flatbuffer和Cocos Studio的reader。
大部分的項目不需要bullet，因此這個版本使用bullet的預編譯庫以加快編譯速度。后續還會繼續使用更多預編譯庫，比如Box2D，3D粒子系統等以加快編譯速度。
該版本同時修復了大量的warning，后續版本也會持續修復warning。
由于人力資源問題，改版本刪除了一些平臺的支持。
Windows 10的metro模式和Windows Phone平臺一直是微軟的員工在負責維護了，但是他們決定不再繼續維護了，而我們人力資源不足，因此去除支持這兩個平臺。不過在Windows 10仍然可以使用Win32工程。
同樣由于人力資源問題，該版本去除了Tizen平臺的支持。
從 3.15 版本開始，可以使用Android Studio 2.3+ 編輯、編譯和調試C++代碼。只需要通過Android Studio打開 proj.android-studio 文件夾（比如 tests/cpp-empty-test/proj.android-studio ），然后點擊 run 按鈕就可以在Android設備或者模擬器運行、調試了。
3.15版本之前，音頻模塊使用 OpenSL ES 解碼、播放音頻文件，但是很多的Android設備廠商會修改這部分代碼，導致音頻模塊在不同的Android設備上有兼容性問題。該帖子就列出了許多音頻模塊的問題。
為了解決兼容性問題，我們引入了第三方的解碼庫tremolo和 MP3 Decoder Library 。該解碼庫也是Android源碼使用的解碼庫。使用該解碼庫除了能解決Android設備的兼容性問題，同時還帶來了不少性能提升：
引入該解碼庫會使最終的APK包增大100K左右，和帶來的好處相比還是值得的。
Windows 8.1的支持一直是微軟的開發者在維護。因為市場占有率原因，微軟覺得沒必要繼續支持Windows 8.1了。
目前大部分的PC都是64位了，所以我們覺得去除對32位linux的支持。去除這個支持意味著第三方庫去掉了對應的32位版本，這樣可以減小發行包的大小，也減少引擎維護的工作。開發者如果想支持32位版本的話，可以使用這個倉庫自己編譯32位版本的第三方庫。
Android SDK Tools 25.3.0+去除了ant腳本和android命令 ，使得cocos命令無法打包Android的Eclipse工程（proj.android）。為了不至于在最后生成APK時才報錯，現在cocos命令檢查到這個版本后直接返回錯誤。有兩個方法可以解決這個問題：
從Android工具刪除ant腳本和android的行為來看，谷歌是不希望大家繼續使用Eclipse工程，所以建議大家還是使用Android Studio來編譯打包吧。舊版本引擎雖然不支持Android Studio調試C++代碼功能，但是編譯打包還是沒問題的。
在2017新年來臨之際，Cocos引擎團隊送上了新一年的驚喜：Cocos2d-x v3.14全新版本。該版本支持所有平臺使用luajit 2.10-beta2、Sprite支持九宮格特性、新增動作類ResizeBy和ResizeTo......這么多給力的新功能，相信你一定會喜歡的。
話不多說，下面我們趕緊來細細盤點Cocos2d-x v3.14新版新驚喜。
之前的luajit版本無法在PC上方便地編譯出arm64的字節碼，需要用真機（比如iPhone6真機)編譯，因此在之前的版本，iOS 64位使用的是lua，iOS 32位使用的是luajit。
新版本支持luajit 2.10-beta2版，開發者可以方便地在PC平臺編譯出arm64位的字節碼，因此我們在各平臺都使用了luajit，這樣能夠提升性能。如果使用Cocos命令編譯、打包的話，那么Cocos命令會自動編譯出對應平臺的字節碼，如果有生成64位字節碼的話，那么會把這些字節碼放到64-bit目錄下。當然你也可以通過Cocos luacompile自己編譯字節碼，具體的使用方式可以參考Cocos luacompile -h輸出的幫助信息。
通過Cocos命令編譯、打包生成的字節碼時各平臺的情況如下：
|
平臺 |
生成32位字節碼 |
生成64位字節碼 |
|
iOS |
是 |
是 |
|
Android |
是，如果APP_ABI的內容不是只包含64位架構(APP_ABI := arm64-v8a) |
是，如果APP_ABI包含了64位架構，比如APP_ABI := arm64-v8a ... |
|
Mac |
否 |
是 |
|
Windows |
是 |
否 |
|
Linux |
否 |
否 |
在開發 UI 界面時，我們通常會使用九宮格格式的圖像來顯示尺寸可能會根據適配屏幕分辨率的需要動態修改的 UI 元素。如今Sprite現在支持九宮格特性了，使用方式如下：
c++ auto sprite = Sprite::create(...); // set center rect // the origin is top-left sprite->setCenterRectNormalized(Rect(x, y, width, heigh));
這樣即使使用很小的原始圖片也能生成覆蓋整個屏幕的背景圖像，一方面節約游戲包體空間，另一方面能夠靈活適配不同的排版需要。
詳細信息可以參考Sprite::setCenterNormalized()的注釋。
使用方式沒有改變，只是文件格式變成了二進制格式。這樣的好處就是解析效率更高，文件更小。具體的使用方法如下：
`c++ skeletonNode = SkeletonAnimation::createWithBinaryFile("spine/spineboy.skel", "spine/spineboy.atlas", 0.6f);
...
新增加兩個動作類：ResizeBy和ResizeTo。和ScaleBy、ScaleTo不同的是，ResizeBy和ResizeTo改變的是節點的content size的大小。這種動作對于支持九宮格特性的節點的縮放效果比ScaleBy和ScaleTo好，因為ScaleBy和ScaleTo是對節點做整體縮放。效果對比如下：
如果使用Xcode 8.2，那么lua工程會在iOS模擬器上崩潰。通過調試發現崩潰在lua_open函數的調用上。如果使用Xcode 8.1或一下版本，那么沒有問題。我們懷疑這是Xcode的bug，在v3.14無法解決。使用lua的開發者在位iOS平臺開發時有兩個選擇：
該問題的進展可以跟蹤下列帖子：
更多詳細的改動列表，歡迎查看：
通過查看3.14.1版本信息了解所有的問題或者代碼改動。
Cocos2d-x核心優勢在于允許開發人員利用C++、Lua及Javascript來進行跨平臺部署，覆蓋平臺包括iOS、Android、Windows Phone等等，省事省力省成本。
近日， Cocos引擎完成重大更新：正式推出Cocos2d-x v3.13版本。在新版本里，AudioEngine性能最高提升4倍、支持ETC1 alpha通道、集成AnySDK、增加VR插件、優化Canvas臟矩形算法等等。該版本進一步完善并整合了歷史零碎功能，為開發者創造更為簡單、快捷的開發環境。
Android平臺下，AudioEngine使用OpenSL ES播放聲音。從Android 4.2開始，OpenSL ES支持解碼聲音文件為PCM數據，引擎正是利用這個以特性來緩存解碼后數據以提升性能。因此，該性能提升只在Android 4.2及以上版本有效。需要先preload，否則第一次播放性能沒有很大提升。
感謝halx99的貢獻，Cocos2d-x 支持ETC1 alpha通道，幫助開發者降低紋理占用，從而減少內存占用，讓游戲運行更為流暢。
要想使用ETC1 alpha通道，必須在相同目錄下提供xxx.pkm和xxx.pkm@alpha，代碼使用方法如下：
auto sprite = Sprite::create("xxx.pkm");
引擎會自動去加載xxx.pkm@alpha作為alpha通道數據。更詳細的使用方式請參考tests/cpp-tests/Classes/SpriteTest/SpriteTest.cpp里的Sprite1ETC1Alpha測試例子。
圖中藍色部分就是帶alpha通道的ETC1圖片
AnySDK為CP商提供一套第三方SDK接入解決方案，整個接入過程，不改變任何SDK的功能、特性、參數等，對于最終玩家而言是完全透明無感知的。支持的第三方SDK包括渠道SDK、用戶系統、支付系統、廣告系統、統計系統、分享系統等。
可以通過Cocos包管理器集成AnySDK：
cocos package import anysdk -p PROJECT_PATH --anysdk
注：此版本的Cocos包管理器仍為預覽版，后續我們會持續優化改進。
PROJECT_PATH是游戲工程的根目錄，比如COCOS2DX_ROOT/tests/cpp-empty-test。通過上面命令后，AnySDK框架就集成到了游戲項目中，可以在代碼里調用AnySDK接口接入各種第三方SDK了。AnySDK的詳細介紹和使用方法請參考AnySDK官網。
AnySDK官網：http://www.anysdk.com/
Cocos2d-x v3.13 目前支持了GearVR、Deepoon、Google Cardboard And Daydream和Oculus，其他SDK也正在陸續添加中。具體的使用方法可以參考以下的項目指引手冊：
在v3.12中我們通過重構WebGL渲染器大幅度提升了Web引擎的性能，在這個版本中，我們又實現了臟矩形算法來提升Canvas渲染器的性能。臟矩形算法允許引擎只渲染當前幀中和前一幀不同的區域，而不是渲染整個畫布，大大降低填充率，可以同時帶來渲染效率的提升以及CPU使用率和耗電量的降低。對于相對靜態的游戲畫面來說，非常有效。這個功能默認是關閉的，開啟它可以通過下面的代碼：
// 開啟臟矩形算法
if (cc._renderType === cc.game.RENDER_TYPE_CANVAS) {
cc.renderer.enableDirtyRegion(true);
// 設置允許用臟矩形算法進行局部渲染的最高臟矩形數量
cc.renderer.setDirtyRegionCountThreshold(6);
}
// 檢查臟矩形算法是否開啟
var enabled = isDirtyRegionEnabled();
該版本提供了Android 64位的第三方庫，因此可以編譯出64位的Android應用?？梢允褂萌缦旅罹幾g、運行64位Android程序：
cocos run -p android --app-abi arm64-v8a
Cocos2d-x 3.12時使用了clang編譯器，結果發現了崩潰問題。通過測試發現該問題是由于使用clang + gnustl_static造成的，因此該版本切換回使用gcc 4.9。當c++_static穩定后再切換成clang。
CURL 7.50.0解決了在NAT64環境連接IPV4地址格式的IP地址錯誤問題，Cocos引擎也第一時間響應并即時跟進升級了CURL版本。
完整版改動列表： https://github.com/cocos2d/cocos2d-x/blob/v3/CHANGELOG
使用新的內存模型后，開發者不需要關心對象的聲明周期。這就意味著不需要在JS代碼里手動調用retain/release函數。
不過該內存模型默認是關閉的。雖然我們已經做了很多的測試，目前沒有發現任何問題，但是保險起見，你需要手動開啟該功能，開啟的方法是在base/ccConfig.h里把CC_ENABLE_GC_FOR_NATIVE的值改為1：
#ifdef CC_ENABLE_SCRIPT_BINDING
#ifndef CC_ENABLE_GC_FOR_NATIVE_OBJECTS
#define CC_ENABLE_GC_FOR_NATIVE_OBJECTS 1 // change to 1
#endif
#endifCocos2d-x已經把OpenSSL升級到1.0.2.g。
從2016年7月11日開始，Google Play將不再接受使用低版本的OpenSSL的新應用程序或者應用程序更新。更新程序中使用的OpenSSL版本變得十分重要。更詳細的信息可以參考這個帖子。
如果你使用的是v2.x或者低版本的v3.x引擎，那么你可以只更新CURL和OpenSSL，具體步驟如下：
version字段。如果是v3.x的話，那么version字段的值改為v3-deps-92，如果是v2.x的話，那么值是v2-deps-5(jtsm @ 15 ~) $ cd cocos2d-x
(jtsm @ 15 ~/cocos2d-x) $ ./download-deps.py
=======================================================
==> Prepare to download external libraries!
==> Ready to download 'v3-deps-92.zip' from 'https://github.com/cocos2d/cocos2d-x-3rd-party-libs-bin/archive/v3-deps-92.zip'
==> WARNING: Couldnt grab the file size from remote, use 'zip_file_size' section in '/Users/jtsm/Chukong-Inc/cocos2d-x/external/config.json'
==> Start to download, please wait ...
==> Downloading finished!
==> Extracting files, please wait ...
==> Extraction done! ==> Copying files...
==> Cleaning...有任何問題可以在引擎的中文論壇上發帖反饋。
v3.11版本之前，不能使用Firefox 30+版本來調試cocos2d-x JSB程序。這個版本修復了該問題，同時支持了web console功能。如果你不了解如何使用Firefox調試cocos2d-x JSB程序，可以參考[這篇文檔]。
當然你也可以使用VSCode來調試，具體的使用方法參考這篇文檔。
在v3.11中，為了提升性能，我們重構了WebGL渲染器，下面是幾項重要的改進：
在這些優化后，與舊版本相比，合并貼圖后的游戲中draw call數量將得到顯著的降低。不僅如此，v3.11中的CPU使用率和內存使用也都得到了降低。在我們的bunnymark測試中，v3.11相比之前的版本有4倍以上的渲染性能提升。當然，這是我們對WebGL渲染器做的第一步升級，在后續版本中，WebGL渲染器還將得到持續優化。
更完整的改動列表可以閱讀full changelog。