Titanium Mobile SDK Release 2.1.0 is a feature release of the Titanium Mobile SDK, including several new features and a number of bug fixes and parity improvements.
This release includes breaking changes that may require changes to existing applications developed with previous releases. Please read these release notes completely before installing and using the Release 2.1.0 SDK. In particular, you should review the New in This Release sections.
If you are upgrading from Titanium Mobile SDK 2.0.1, this release also includes all fixes included in Release 2.0.2.
For a list of issues addressed in Release 2.0.2, see the release notes for the previous releases:
Further information is available in the updated Titanium Mobile SDK and Titanium Studio Documentation.
Support for ACS Access Control Lists (ACLs). ACLs allow you to control which users can read or write an ACS object.
Parity enhancements for horizontal layouts. Horizontal layouts now follow the same rules on iOS, Android and Mobile Web.
A new property, horizontalWrap,
has been added to enable or disable wrapping on horizontal layouts. With
horizontalWrap set to
false, a horizontal layout lays out its children in a single
row, left to right. With
horizontalWrap set to
true (default) horizontal layout
lays out its children in multiple rows, as Android and iOS did in previous releases.
When wrapping is enabled, the first row is aligned at the top of the parent view --
this matches the iOS behavior in previous releases.
See the discussion of horizontal layout in the description for the layout property for more details.
ScrollableView scroll event enhancements. Prior to Release 2.1, the
scroll event behavior was not consistent with the
scroll event on other views.
On Android, it fired when dragging ended, and on iOS it fired when the view finished
scrolling. To be more consistent with other views, the
scroll event was redefined to
fire continuously while the view is scrolling.
To obtain the previous behavior on Android, add a listener for the
event instead. To obtain the previous behavior on iOS, add a listener for the
scrollEnd event instead.
volume property was added to all media player types that didn't already support
New unit test framework. This release includes the first version of the new Anvil unit
test framework. Anvil is designed as a replacement for the existing Drillbit unit test
Node.js, and is designed to allow for test automation. If you are currently using
Drillbit and you are interested in using Anvil, see the
file in the Titanium Mobile GitHub repo.
Anvil supports the same basic types of tests as Drillbit, but each test suite is
defined as a CommonJS module. See
driver/harnessTemplate/Resources/suites for examples of
Anvil test suites.
Deprecation updates. Some API members that were moved to the iOS namespace in previous releases are now supported on both iOS and Mobile Web, so these objects are being moved back into the common namespace and the previous deprecation is being reversed.
In this release, the
object and the
ANIMATION_CURVE constants are being moved back into the common namespace.
|Old name||New name|
The following is a sample of notable new Android features and bug fixes in this release:
Added support for adding and removing contacts.
Added x86 emulator support.
focus events for lightweight windows
Added support for
pinch events (TIMOB-5224).
Added support for background gradients on views. Only linear background gradients are supported on Android at this point (TIMOB-1125).
Added support for
addRoute on map views
For a complete list of Android features and bug fixes in this release, see: Fixed Android Issues in JIRA
The following section lists notable new iOS features and bug fixes in this release.
TLS version fallback. With iOS Release 5.0, Apple changed the default TLS version for secure HTTP from 1.0 to 1.2, causing secure HTTP connections to fail when communicating with older servers. With this fix, when using HTTPClient to access an HTTPS URL, if the initial connection fails and no TLS version was specified, the HTTP client retries the connection using TLS 1.0.
Other objects that use
HTTPClient internally, such as
ImageView, will also fall
back to the earlier TLS version if 1.2 is not supported.
Upgrading your servers to support TLS 1.2 is recommended.
When running in Debug mode, a warning will be printed to the console when falling back to TLS 1.0.
Improvements include new properties for customizing the paging control appearance and position:
Also, the new
hitRect property allows a
ScrollableView to detect touch events outside
of its bounds. This is useful when width of the
ScrollableView is less than the full width of
the parent view, and
clipViews is set to
false, so the edges of the previous and next views are
displayed outside the bounds of the scrollable view.
Support for custom
Info.plist values in
tiapp.xml. Many of the existing
tiapp.xml values are deprecated in favor of the new values.
Added drag and drop for map annotations (TIMOB-1242).
dragEnd events on
method to define padding around the table's contents.
Ti.App supports a new
Support for iOS system textures. The following constants, defined in Ti.UI.iOS, can be used wherever a color value is required:
COLOR_GROUP_TABLEVIEW_BACKGROUND. Background color for group table views.
In current versions of iOS, this is a blue pinstriped texture on iPhone and
iPod Touch devices, and is transparent on iPad devices.
COLOR_SCROLLVIEW_BACKGROUND. System texture used behind scrollable content.
In current versions of iOS, specifies a "linen" texture.
COLOR_UNDER_PAGE_BACKGROUND. System texture used behind, supported in iOS 5.0
and newer only. In current versions of iOS, specifies a "light linen" texture.
COLOR_VIEW_FLIPSIDE_BACKGROUND. System texture used for the back side of a
flipped view. In current versions of iOS, specifies a "dark linen" texture.
Note that the exact representation of these textures may vary between devices and between SDK versions.
Undocumented properties removed. The following undocumented properties were removed:
soundproperty -- use
scaleproperty -- use
For a complete list of iOS features and bug fixes in this release, see: Fixed iOS Issues in JIRA.
With this release, the Mobile Web platform is general availability (GA) platform.
The following section lists notable new Mobile Web features and bug fixes in this release:
Support for IE9/Windows Phone 7.5.
Improved UI performance.
Kinetic scrolling (momentum) and elastic scrolling (overscroll/snapback) for
Fixed parent-child relationships for views.
source property set correctly.
View.children set correctly.
Ti.Cloud Module works on Mobile Web in Chrome, Firefox, and Safari (TIMOB-8877).
Performance instrumentation for view debugging.
For a complete list of Mobile Web features and bug fixes in this release, see: Fixed Mobile Web Issues in JIRA.
This release includes a number of documentation fixes and enhancements, including updates to the unified documentation site for the Titanium Mobile SDK and Titanium Studio:
Fixed Documentation Site Issues
Known Issues With the Documentation Site
For a complete list of documentation fixes in this release, see: