15 KiB
Table of Contents generated with DocToc
- [Cocos2d-x 3.10 Release Notes](#cocos2d-x-
- -release-notes)
- Misc Information
- Requirements
- v3.10
Cocos2d-x 3.10 Release Notes
Misc Information
Requirements
Runtime Requirements
- Android 2.3 or newer
- iOS 5.0 or newer
- OS X 10.7 or newer
- Windows 7 or newer
- Windows Phone 8.1
- Windows 10 UWP
- Linux Ubuntu 14.04 or newer
- Mordern browsers and IE 9+ (On mobile platforms, only iOS and Android 5 activated WebGL support)
Compiler Requirements
- Xcode 5.1 or newer for iOS or Mac
- gcc 4.9 or newer for Linux
- ndk-r10c for Android
- Visual Studio 2013 or newer for Windows (win32)
- Visual Studio 2013 update4 or newer for Windows 8.1 universal Apps
- Visual Studio 2015 RC or newer and Windows 10.0 (build 10074 or higher) for Windows 10.0 UWP Apps
How to run tests
Cocos Console
You can use Cocos Console command line tool to run the test cases on almost all supported platforms.
In console application:
// Enter cpp test folder
cd tests/cpp-tests
// Or enter js test folder
cd tests/js-tests
// Or enter lua test folder
cd tests/lua-tests
// Compile or run test case
cocos compile -p ios|mac|android|win32|win8_1|metro|web -m debug|release
cocos run -p ios|mac|android|win32|win8_1|metro|web -m debug|release
For example, if you want to run cpp test in release mode on Android, you can use the following command:
cocos run -p android -m release
Mac OSX & iOS
- Enter
cocos2d-x/build
folder, opencocos2d_test.xcodeproj
- Select
cpp-tests
,lua-tests
,js-tests
foriOS
orOS X
target in scheme toolbar - Click
run
button
Android
You can run the samples...
Using command line:
$ cd cocos2d-x
$ ./setup.py
$ cd build
$ ./android-build.py cpp-empty-test -p 10
$ adb install cocos2d-x/tests/cpp-empty-test/proj.android/bin/CppEmptyTest-debug.apk
Then click item on Android device to run tests. Available value of -p
is the API level, cocos2d-x supports from level 10.
Using Eclipse:
$ cd cocos2d-x
$ ./setup.py
$ cd build
$ ./android-build.py cpp-empty-test -p 10
Then
- Import cocos2d-x Android project into Eclipse, the path used to import is
cocos/2d/platform/android
- Import
cpp-empty-test
Android project into Eclipse, the path used to import istests/cpp-empty-test/proj.android
- Build
cpp-empty-test
Android project and run
Windows
- For win32 project, enter
cocos2d-x/build
, and opencocos2d-win32.sln
- For win 8.1 project, enter
cocos2d-x/build
, and opencocos2d-win8.1-universal.sln
- For win 10 project, enter
cocos2d-x/build
, and opencocos2d-win10.sln
- Select running target
- Click run button
Linux
$ cd cocos2d-x/build
$ ./install-deps-linux.sh
$ cd ../..
Then
$ mkdir build
$ cd build
$ cmake ../cocos2d-x
$ make -j4
Run
$ cd bin/cpp-empty-test
$ ./cpp-empty-test
How to start a new game
Use Cocos Console to create a new game:
cocos new -l cpp|js|lua MyNewGame
v3.10
Highlights features, improvements and API updates of v3.10
We are happy to announce the release of Cocos2d-x v3.10. Following are the highlighted features, improvements and API updates in this version.
- Provides a unified setup for both Cocos2d-x and Cocos.
- New Cocos Launcher too! Cocos Launcher:
- one step creates a new project by either using our precompiled libraries or source code.
- easily integrate SDKBOX for 3rd party services. Easily add Facebook, in-app purchase and many more.
- provide feedback and get support, directly within Cocos Launcher, making it simple to contact the engine team for help.
- UI System:
- Reimplemented
Scale9Sprite
and improve the scale9sprite performance and reduce memory consumption. - Changed
PageView
to derived from ListView, PageView can be added any widget as child. - Added three overflow type to new label: CLAMP,SHRINK,RESIZE_HEIGHT.
- Reimplemented
- JSModule:
- Improved JS Bindings: follows SpiderMonkey GC best practices making it more robust.
The main features in detail of Cocos2d-x v3.10:
UI System
-
Reimplemented
Scale9Sprite
and improve the scale9sprite performance and reduce memory consumption.Reimplemented ui::Scale9Sprite, now the Slice sprite uses 16 vertices and 54 indices instead of the old 9 sprites way, The memory consumption is much lower than the previous implementation, and it is also more efficient.
In SIMPLE mode, the 4 borders are all 0 and the whole sprite will scale horizontally and vertically. In this mode only 1 quad is used for rendering, for example:
auto blocks = ui::Scale9Sprite::createWithSpriteFrameName("blocks9c.png"); //When setting to SIMPLE, only 4 vertexes is used to rendering. blocks->setRenderingType(Scale9Sprite::RenderingType::SIMPLE);
In SLICE mode, it will use 18 triangles to rendering the slice 9 sprite. If the 4 borders are 0, there still be 18 triangles computed. So choose your RenderingType wisely, for example:
auto sprite = ui::Scale9Sprite::createWithSpriteFrameName("blocks9c.png"); //When setting to SLICE, 16 vertexes will be used to rendering. sprite->setRenderingType(Scale9Sprite::RenderingType::SLICE);
-
Changed
PageView
to derived from ListView, PageView can add any type of widget as child.PageView was derived from Layout and it implemented the features of scrolling and item arrangement from scratch. But the features are already there in ListView. So remove those duplicated implementations from PageView and make it inherit from ListView.
By consequence, PageView becomes simpler and easier to maintain because it considers only paging implementation. for example:
// Create the page view Size size(240, 130); PageView* pageView = PageView::create(); pageView->setDirection(PageView::Direction::HORIZONTAL); pageView->setContentSize(size); Size backgroundSize = background->getContentSize(); //"removeAllPages" is changed to "removeAllItems" pageView->removeAllItems(); pageView->setIndicatorEnabled(true); int pageCount = 4; for (int i = 0; i < pageCount; ++i) { Layout* layout = Layout::create(); layout->setContentSize(size); ImageView* imageView = ImageView::create("cocosui/scrollviewbg.png"); imageView->setScale9Enabled(true); imageView->setContentSize(size); imageView->setPosition(Vec2(layout->getContentSize().width / 2.0f, layout->getContentSize().height / 2.0f)); layout->addChild(imageView); Text* label = Text::create(StringUtils::format("page %d",(i+1)), "fonts/Marker Felt.ttf", 30); label->setColor(Color3B(192, 192, 192)); label->setPosition(Vec2(layout->getContentSize().width / 2.0f, layout->getContentSize().height / 2.0f)); layout->addChild(label); //"insertPage" is changed to "insertCustomItem" pageView->insertCustomItem(layout, i); } //"removePageAtIndex" is changed to "removeItem" pageView->removeItem(0); //"scrollToPage" is changed to "scrollToItem" pageView->scrollToItem(pageCount - 2);
More detail usage please refer to: tests/cpp-tests/Classes/UITest/CocoStudioGUITest/UIPageViewTest/UIPageViewTest.cpp.
-
Added three overflow type to new label: CLAMP, SHRINK, RESIZE_HEIGHT.
Overflow type is used to control label overflow result, In SHRINK mode, the font size will change dynamically to adapt the content size. In CLAMP mode, when label content goes out of the bounding box, it will be clipped, In RESIZE_HEIGHT mode, you can only change the width of label and the height is changed automatically. For example:
//Change the label's Overflow type label->setOverflow(Label::Overflow::RESIZE_HEIGHT);
More detail usage please refer to: tests/cpp-tests/Classes/LabelTest/LabelTestNew.cpp.
Limitations:
currently only TTF and BMFont support all the valid Overflow type. Char Map font supports all the Overflow type except for SHRINK, because we can't measure its font size. System font only support Overflow::Normal and Overflow::RESIZE_HEIGHT.
Other changes
[NEW] RichText supported new line element.
[NEW] UIText::clone supports clone the text effect.
[NEW] UI: Added methods to query label effect state.
[REFINE] IOS: Added virtual keyword for some render related function.
[REFINE] UI: Fixed boring deprecated warning in HttpRequest.
[REFINE] Network: Fixed Downloader bug on iOS & Android platform.
[REFINE] Studio: Fixed deprecation warning in SkeletonRenderer.
[REFINE] JS: Added js test case for fix, improve template.
[REFINE] Network: Permit http access to cocos2d-x.org in test projects on iOS.
[REFINE] Network: Crash when removing a remotely downloaded image from texture cache in js-binding.
[REFINE] Win10: WinRT project update version to v3.10.
[REFINE] Console: Added quiet option for Cocos Toolkit.
[REFINE] JS: New GC model for js-binding.
[REFINE] Doc: Fixed typos in documentation and comments.
[REFINE] UI: Updated controlButton size calculate with new Scale9Sprite logic.
[REFINE] Win10: Added missing _USRJSSTATIC preprocessor define for ARM builds.
[REFINE] JS: Added ccvector_to / ccmap_to converted to new js-binding API.
[REFINE] UI: Slider misprint fix.
[FIX] Core: Fixed premultiplyAlpha for mipmaps and compressed textures.
[FIX] UI: Fixed Scale9sprite rendering error when content size smaller than the sum of leftInset and rightInset.
[FIX] Win32: Fixed EditBox crash when removing an EditBox in a scheduler.
[FIX] Android: Fixed cannot add view to mFrameLayout when extends Cocos2dxActivity.
[FIX] 2D: Fixed actionNode set at wrong position bug.
[FIX] 3D: Fixed the movement of PUParticle lags one frame.
[FIX] UI: Fixed the wront argument of setPlaceholderFontName in EditBox.
[FIX] UI: Fixed EditBox editBoxEditingDidEnd may use the original text after change the text of EditBox in user script.
[FIX] Audio: Fixed FinishCallback
never be called in Windows.
[FIX] UI: Fixed Layout stencil clipping nested with Clipping Node rendering issue.
[FIX] UI: Keyboard doesn't hide when click the screen outside of EditBox on iOS platform.
[FIX] UI: Fixed a fatal bug in EditBox implement on Windows platform.
[FIX] UI: Fixed edit box setPlaceholderFontName and scale font size issue.
[FIX] Core: Fixed memory leak when initWithImage() failed.
[FIX] Network: CCDownloader on iOS is broken in v3.9 js-binding.
[FIX] JS: Bindings fixes for Menu, Sprite and Label.
[FIX] Studio: Removed weak reference in ActionNode.
[FIX] UI: shouldStartLoading method should return value to js in js-binding.
[FIX] UI: Fixed scrollview render error.
[FIX] JS: Fixed win32 js project crash issue.
[FIX] UI: Button touch doesn't work with scale9 enabled.
[FIX] JS: Fixed evalString doesn't return result issue.
[FIX] JS: Fixed ComponentJS proxy management issue in JSB.
[FIX] Android: Fixed include in cocos network module.
[FIX] Network: Fixed web socket crash.
[FIX] UI: Fixed TextField missing default password style text setting.
[TEST] S9SpriteTest: Scale9Sprite fade actions with cascade opacity.
[TEST] Web: Removed default focus block from UIFocusTestVertical.
[TEST] Lua: Fixed pageViewTest Horizontal scroll won't work in Lua-test.
You can also take a look at the full changelog.
NEW APIS
-
RichText
Added RichElementNewLine class to create new RichText Element.
For more information: https://github.com/cocos2d/cocos2d-x/pull/14033
-
PageViewIndicator
Added PageViewIndicator class to create PageViewIndicator.
For more information: https://github.com/cocos2d/cocos2d-x/blob/v3/cocos/ui/UIPageViewIndicator.h
-
PageView
Changed PageView to derived from ListView. For more information: https://github.com/cocos2d/cocos2d-x/pull/14252
-
ApplicationProtocol
Added the API getVersion.
-
PolygonInfo
Added the API setTriangles.
-
Scale9Sprite
Added setRenderingType, getRenderingType.
-
FontFNT
Added setFontSize, getOriginalFontSize.
-
Label
Added setBMFontSize, getBMFontSize, enableWrap, isWrapEnabled, setOverflow, getOverflow, initWithTTF, isShadowEnabled, getShadowOffset, getShadowBlurRadius, getShadowColor, getOutlineSize, getLabelEffectType, getEffectColor.
-
AudioEngineImpl
Added AudioEngineImpl to implement FMOD.
-
Lua Module
Added luaval_to_node, node_to_luaval.
-
JS Module
Added js_cocos2dx_ComponentJS_create
-
ui::Text
Added isShadowEnabled, getShadowOffset, getShadowBlurRadius, getShadowColor, getOutlineSize, getLabelEffectType, getEffectColor.
-
UITextTest_Clone
Added UITextTest_Clone class.