|
2 | 2 | <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --> |
3 | 3 | **Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* |
4 | 4 |
|
5 | | -- [Cocos2d-x 3.17 Release Notes](#cocos2d-x-317-release-notes) |
6 | | - - [Android requirements](#android-requirements) |
| 5 | +- [Cocos2d-x 3.17.1 Release Notes](#cocos2d-x-3171-release-notes) |
7 | 6 | - [Highlights](#highlights) |
8 | | - - [added support for iPhone X](#added-support-for-iphone-x) |
9 | | - - [added support Android Studio 3.0+](#added-support-android-studio-30) |
10 | | - - [CMake is now supported on all platforms](#cmake-is-now-supported-on-all-platforms) |
11 | | - - [upgrade 3rd-party libraries](#upgrade-3rd-party-libraries) |
12 | | - - [remove outdated](#remove-outdated) |
13 | | - - [misc bugs fix and stability improvements](#misc-bugs-fix-and-stability-improvements) |
14 | 7 |
|
15 | 8 | <!-- END doctoc generated TOC please keep comment here to allow auto update --> |
16 | 9 |
|
17 | | -# Cocos2d-x 3.17 Release Notes # |
18 | | -The 3.17 release focuses on stability and increased performance with some under the hood enhancements that will make cross-platform development easier. |
| 10 | +# Cocos2d-x 3.17.1 Release Notes # |
19 | 11 |
|
20 | | -## Android requirements |
21 | | - |
22 | | -v3.17 has been tested using Android Studio (3.0, 3.1, 3.1.1) with NDK r16 |
| 12 | +The 3.17.1 release focuses on bug fixing. |
23 | 13 |
|
24 | 14 | ## Highlights |
25 | 15 |
|
26 | | -- added support for iPhone X |
27 | | -- added support Android Studio 3.0+ |
28 | | -- CMake is now supported on all platforms |
29 | | -- upgraded Spine runtime to v3.6.39 |
30 | | -- upgraded GLFW to 3.2.1 |
31 | | -- misc bugs fix and stability improvements |
32 | | - |
33 | | -### added support for iPhone X |
34 | | - |
35 | | -3.17 brings support for iPhone X including supporting full screen mode, using Storyboards for launch images, __safe area__ API and support for auto hiding the Home indicator. It is important to note exactly what and where the safe area is: |
36 | | - |
37 | | -<p align="center"> |
38 | | - <img width="400" src="https://raw.githubusercontent.com/cocos2d/cocos2d-x-docs/master/en/installation/iOS-img/iPhoneXSafeArea.png"> |
39 | | -</p> |
40 | | - |
41 | | -Developers can get the safe area easily by calling: `Director::getSafeAreaRect()`. |
42 | | - |
43 | | -### added support Android Studio 3.0+ |
44 | | - |
45 | | -Android Studio is the only official IDE for Google's Android operating system. |
46 | | -Cocos2d-x supports Android Studio using NDK version r16 to r16. Gradle configurations have been updated, including simplifying Gradle PROP_* values, changing the deprecated `compile` to the new `implementation`in dependency declaration, and added Proguard configuration to reduce Release package size. |
47 | | - |
48 | | -### CMake is now supported on all platforms |
49 | | - |
50 | | -CMake is now supported on all platforms, including Android(NDK), iOS, macOS, Windows (VC++ compiler), Linux. Supports precompile libraries for engine, and reusing precompiled libraries in the new build process. Your projects build time will be greatly reduced. For detailed usage, please refer to [CMake Doc](https://github.com/cocos2d/cocos2d-x/blob/v3/cmake/README.md) |
51 | | - |
52 | | -### upgrade 3rd-party libraries |
53 | | - |
54 | | -Spine skeleton animation is widely used in games developed by Cocos2d-x. Spine runtime has been upgraded to 3.6.39 to keep current. |
55 | | - |
56 | | -GLFW has been upgraded to 3.2.1 to help fix joystick issues. You can also now use GLFW as a precompiled library. |
57 | | - |
58 | | -Box2D hasn't been updated in quite some time. A new production version has yet to be released so far in 2018. We felt GitHub commit f655c603ba9d83 was stable. You can also now use Box2D as a precompiled library. |
59 | | - |
60 | | -Each Cocos2d-x release comes with a specific version of third-party libraries. If you want to upgrade third-party libraries due to your projects needs, please refer to: [3rd-party Doc](https://github.com/cocos2d/cocos2d-x-3rd-party-libs-src/blob/v3/README.md) |
61 | | - |
62 | | -### remove outdated |
63 | | - |
64 | | -Google officially deprecated ant build support starting in [Android SDK Tools 25.3.0](http://tools.android.com/recent/androidsdktoolsrevision2530feb2017). The old ant based `proj.android` and been dropped and now `proj.android` is an Android Studio project. The default architecture is changed from `armeabi` to `armeabi-v7a`. |
65 | | - |
66 | | -Visual Studio 2013 support has been dropped. Visual Studio 2015/2017 are still currently supported. The existing win32 project files is quite suitable for 2015. To use 2017, you can open a 2015 project file, modify the configuration to suit your needs, or use CMake (See above). |
67 | | - |
68 | | -### misc bugs fix and stability improvements |
69 | | - |
70 | | -This release contains more than 51 bugs fixed and 33 misc improvements, please refer to [Changelog](https://github.com/cocos2d/cocos2d-x/blob/v3/CHANGELOG) |
| 16 | +- Fix Lua loading performance drop bug introduced in 3.17 |
| 17 | +- Renderer limit glClear invoke times, reduce power consuming |
| 18 | +- optimize CMake script,fix some linking issues |
| 19 | +- Android use CMake as default PROP_BUILD_TYPE value |
| 20 | +- Android upgrade Gradle to 4.6, SDK 28, android gradle plugin 3.1.0 |
| 21 | +- upgrade LuaJIT to 2.1.0-beta3, fix random crash in 3.17 Lua release mode |
| 22 | +- upgrade libwebsockets to 2.4.2 |
| 23 | +- FileUtils provide thread-safe implementation and add missing cross-platform interface |
| 24 | +- limit Labels text length to fix render error |
| 25 | +- add Downloader binding to Lua |
| 26 | + |
| 27 | +This release contains more than 45 bugs fixed and 34 misc improvements, please refer to [ChangeLog](https://github.com/cocos2d/cocos2d-x/blob/v3/CHANGELOG) |
0 commit comments