重要提示
下载地址 http://www.cocos.com/download
文档地址 http://docs.cocos.com/cocos2d-x/manual/zh/
- 环境搭建章节有较多更新，建议阅读
3.17 版本的问题，请优先在本帖回复，集中讨论便于其它开发者了解
发布说明
Cocos2d-x 3.17 版本着重于工具链的更新，和稳定性的增强。
测试环境
Android 平台使用 Android Studio (3.0, 3.1, 3.1.1) 和 NDK r16 进行测试。
版本特性
- 支持 iPhone X
- 支持 Android Studio 3.0+
- CMake 支持全平台，支持预编译引擎库
- 升级 Spine runtime 至 v3.6.39
- 升级 GLFW 至 3.2.1，并提供预编译库
- 更新 Box2D，并提供预编译库
- 去除 Android 的 ant 工程
- 去除 Visual Studio 2013 的支持
详细介绍
支持 iPhone X
3.17 带来对 iPhone X 的支持，包含支持全屏模式，支持自动隐藏 Home 指示器，改用 Storyboard 作为启动屏幕，和增加获取 Safe Area 的接口。在开发支持 iPhone X 的应用时，最需要了解清楚的就是 Safe Area：
开发者可以通过调用 Director::getSafeAreaRect() 来获取 Safe Area 区域。
支持 Android Studio 3.0+
Android Studio 是 Google 官方唯一支持的 Android 开发 IDE。
该版本增加了对 Android Studio 3.0+ 的支持。在支持的过程中，同时将 NDK 版本从 r14 升级到 r16。对 Gradle 工程配置也进行了诸多改进，包括简化 Gradle 变量 PROP_*，将依赖声明中弃用的 compile 改为新的 implementation，增加用以削减 Release 包体积的 Proguard 文件。
CMake 支持全平台
扩展 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 的支持。现存的工程配置适合于 2015 ，如果需要使用 2017，可打开现有的 sln 文件，调整配置，或使用 CMake。
Bugs 修复，提高稳定性
该版本包含 51 项 bugs 修复和 33 项小改进，不再列举，请参考 Changelog。
今年能出吗
