Release Notes

Titanium SDK 3.2.0 General Availability - 12/20/2013

Please note: Once you upgrade to this version of Studio, all of your existing Alloy-based apps will need to be re-compiled with the 3.2.0 SDK and Alloy 1.3.0..

If you do not want to upgrade your Alloy applications at this time, you should decline this update.

For information, see the Support Matrix.

Contents

About This Release

This is the general release (GA) version of the Titanium SDK 3.2.0. This release introduces a number of new features. See New Features for a summary of new features in this release.

Note that this release includes breaking changes. See Notice of Breaking Changes in Release 3.2.0 for details.

This release includes over 700 bug fixes and improvements:

Alloy 1.3

This release coincides with the release of Alloy 1.3. Alloy 1.3 only supports Titanium SDK 3.2 and later.

Summary of New Features:

For more details, see the Alloy Changelog.

Android 4.4 Support

This release includes support for Android 4.4 (KitKat).

iOS 7.1 Support

This release includes preliminary support for iOS 7.1 Beta. A complete testing pass is being performed against Release 3.2. The following issues were discovered:

Studio 3.2.0

This release coincides with the release of Studio 3.2. Studio 3.2.0 requires Titanium CLI 3.2.0 or later.

Summary of New Features:

For more details, see Studio 3.2.0 Changes and Titanium Studio Release Notes.

Tizen 2.2.1 Support

This release includes support for Tizen 2.2.1.

Support Matrix

Due to changes with Xcode introduced in version 5.0.1, only certain combinations of the Titanium toolchain and Xcode are supported.

SDKCLIStudioAlloyXcodeNotes
3.2.03.2.03.2.01.3.0Xcode 5.0.1+
3.1.X*3.2.03.2.01.3.0Xcode 5.0.1+Alloy apps must be converted to SDK 3.2.0
3.1.33.1.23.1.31.2.XXcode 5.0.0
3.1.X*3.1.4**3.1.31.2.XXcode 5.0.1+

(*) 3.1.X indicates a build from the 3_1_X branch of the Titanium SDK not version 3.1.0, 3.1.1, 3.1.2 or 3.1.3.
(**) Not yet released.

To continue using SDK 3.1.3, you can only use Xcode 5.0.

Installation Notes

If you previously installed the Beta or Release Candidate versions of the Titanium CLI and Alloy, you need to first uninstall these components before installing or updating to 3.2.0.GA.

To check the current versions run the following commands:

npm list -g titanium
npm list -g alloy

If either package has a version number ending in -alpha, -beta, or -cr, you should uninstall the package manually before installing 3.2.0.GA.

To uninstall these packages:

npm remove -g titanium
npm remove -g alloy

Note: You may need to use sudo before these terminal commands on OS X and Linux.

If you are using Titanium Studio, these components will be updated if you chose to install additional Titanium updates or from the Help menu, select Check for Titanium Updates.

If you are using the Titainium CLI, you need to reinstall the CLI and Alloy from the terminal:

npm install -g titanium
npm install -g alloy

If you should run into any issues, run npm cache clean and then retry the steps above.

Deploying to the iTunes Store with Mavericks

If you are using Mac OS X 10.9 (Mavericks) and packaging an iOS application to the iTunes Stores, after the Xcode Organizer is launched, a dialog from OS X may open stating, 'UI element scripting is not enabled. Check "Enable access for assitive devices"'.

This message is misleading as this was the name of the setting in previous versions of Mac OS X, which is already enabled by default on the older versions.

On Mavericks, to fix this issue:

  1. Open System Preferences from the Apple Menu.
  2. Click Security & Privacy.
  3. Click the Privacy tab.
  4. If the dialog is locked (bottom-left corner), unlock it.
  5. Click Accessibility from the left list.
  6. Enable TitaniumStudio or AppceleratorStudio.
  7. Close the System Preferences.

Notice of Breaking Changes in Release 3.2

Android Platform

This section lists breaking changes for the Android platform.

Build Command

The new Android build command for the Titanium CLI was rewritten and deprecated flags used to specify launching the application on the emulator, including --avd-abi, --avd-id and --avd-skin.

Use the --device-id flag with the AVD name to launch the application on the emulator.

The --password option, used to specify the keystore password, was renamed to --store-password to clarify its usage from the new --key-password option, used to specify the password for the keystore private key.

By default, the latest installed Android SDK is used to build your application unless otherwise specified in your tiapp.xml file with the android:targetSdkVersion attribute of the uses-sdk element. For example, the following code specifies to use API level 16 (Android 4.1.x):

<android xmlns:android="http://schemas.android.com/apk/res/android">
    <manifest>
        <uses-sdk android:targetSdkVersion="16"/>
    </manifest>
</android>

Previously, the minimum required SDK was used.

CloudPush Module

The ti.cloudpush module no longer supports push notifications with MQTT. Please upgrade your application to use the GCM protocol.

Fastdev Support

As of this Release, Fastdev support is deprecated and is disabled by default. To re-enable Fastdev, follow the directions in the Fastdev Reference guide.

Lightweight Windows

As of this Release, all windows are heavyweight. You cannot control the type of window created.

The Android windowing system was re-architected to improve performance and simplify the previous windowing system. As part of this performance improvement, all windows are heavyweight.

Previously, all windows were lightweight and to create a heavyweight window, you had to specify the state of one of the following properties: fullscreen, navBarHidden, modal, or windowSoftInputMode.

To enable the old behavior, add the following to your tiapp.xml file:

<property name="ti.android.useLegacyWindow" type="bool">true</property>

Tiapp.xml settings

The settings of two tiapp.xml settings used by Android has changed.

The default value for the ti.android.bug2373.finishfalseroot application property is now set to true by default. This property suppresses a dialog asking the user to restart the application after it has been installed or updated after the first launch. Previously, the default value for this property was false. To enable the old behavior, add the following under the ti:app element in your tiapp.xml file:

<property name="ti.android.bug2373.finishfalseroot">false</property>

The tool-api-level element in the Android manifest section is deprecated and now sets the targetSdkVersion attribute in the generated Android manifest file to the same value if set. Previously, the minSdkVersion attribute would be set to the same value in the generated Android manifest file.

iOS Platform

This section lists breaking changes for the iOS platform.

iOS 5.x Support and iPhone Navigation Group

As of this Release, the Titanium SDK no longer supports iOS 5.x and the Titanium.UI.iPhone.NavigationGroup class has been removed.

Native Map Support

The Titanium.Map namespace no longer supports native maps on the iOS platform. This functionality is now available on the ti.map add-on module with additional features only available for iOS 7.

The API calls are similar except the addRoute method no longer accepts a dictionary as a parameter. Pass a Route object to this method instead.

JavaScript Style Sheet (JSS) Support

As of this Release, JSS support is deprecated.

Studio

This section lists breaking changes in Studio 3.2.

App Explorer View

The App Explorer view is deprecated and will be removed in a future release of Studio. Use the Project Explorer view instead.

Launch Modes

The launch mode buttons (Run, Debug, Package, etc.) have been removed from the App Explorer and Project Explorer views.

To launch a project:

  1. Select the project in the Project Explorer view.
  2. In the global tool bar, select the launch mode and device to launch the application on from the Launch Mode drop-down list and Target drop-down list, respectively.
  3. If the Launch Automatically option is enabled under the Target drop-down list, the application will be automatically launched after the target is selected. If not, you need to click the Launch button to start the build process.

To use a launch configuration, first select the launch mode, then select the <Launch> Configuration... option under the Target drop-down list to open the Launch Configuration dialog. Select and run your launch configuration.

Studio Updates

The mechanism to check for Studio updates has been grouped with the updates for the other Titanium components. To check for Studio updates, from the menu bar, select Help > Check for Titanium Updates or Check for Appcelerator Updates.

Previously, to check for Studio updates, select Help > Check for Updates.

New Features

This section describes new features introduced in Release 3.2.

Android Platform

This section lists new features and improvements only available on the Android platform.

Animation Improvements

This Release fixes many bugs with 2D matrix transformations, and incorporates a new library to achieve parity closer to the performance of the iOS platform (TIMOB-11811).

No additions or changes were made to the existing APIs.

Broadcast Intents

As of this Release, the application can create broadcast intents to pass to broadcast receivers. To create a BroadcastIntent, use the Titanium.Android.createBroadcastIntent method, then use either the Titanium.Android.sendBroadcast or Titanium.Android.sendBroadcastWithPermission method to pass the intent to a BroadcastReceiver.

If you are using the sendBroadcastWithPermssion method, modify the tiapp.xml file to declare a permission with the Android manifest permission element and allow the application to use that permission with the Android manifest uses-permission element. Pass the permission name as the second parameter to the sendBroadcastWithPermission method. Below is an example of how the Android manifest section should look like:

<android xmlns:android="http://schemas.android.com/apk/res/android">
    <manifest>
        <permission
            android:name="com.appcelerator.test.withPermission" />
        <uses-permission android:name="com.appcelerator.test.withPermission"/>
    </manifest>
</android>

Build Command

The Titanium CLI build for Android is now written in JavaScript with many, many bug fixes and improvements (TIMOB-9028).

The rewritten build command works the same as the old Python build script except for the ones mentioned in the "Breaking Changes" section.

Summary of Improvements:

Camera Improvements

This Release fixes a number of issues with using the device's camera and achieves parity with the iOS platform by adding support for additional APIs.

CloudPush Module

The ti.cloudpush mode now supports grouped notifications, allowing the application to collapse multiple notifications into one.

The ti.cloudpush module version number changed to 3.2.0 to match the SDK version.

Cookie Management

This Release introduces the Titanium.Network.Cookie object and a number of new Titanium.Network methods to help the application manage cookies between the Android system cookie store, utilized by WebViews, and the HTTPClient's cookie store.

For more information, see the "Android Platform Implementation Notes" in either Titanium.Network.HTTPClient or Titanium.UI.WebView.

Extra, Extra High Density Support

As of this Release, the Titanium SDK supports extra, extra high density assets (480 dpi) for Android applications. Place these assets in an Android resource folder with the -xxhdpi suffix, for example, Resources/android/res-xxhdpi or app/assets/android/res-xxhdpi.

ListView Phase 2

The following ListView features were completed in this Release:

For more information, see the ListViews guide and Titanium.UI.ListView API reference.

Map Module

The ti.map module supports the following new APIs:

WebView WebSettings

The Titanium.UI.WebView class exposes two Android WebSettings APIs as two new properties:

Cloud Module

The ti.cloud module supports the following new APIs:

The ti.cloud module version number changed to 3.2.0 to match the version of the SDK.

iOS Platform

This section lists new features and improvements only available on the iOS platform.

Attributed Strings

As of this Release, the Titanium SDK supports attributed strings allowing the application to manage and apply specific attributes, such as font and kerning, to characters or range of characters in a string.

Create a Titanium.UI.iOS.AttributedString object and assign it to one of the following properties:

Build Directly to Device

You can now directly install your iOS application to the iOS device without using iTunes. First, make sure your device is connected to your computer with the USB cable.

Using Titanium Studio 3.2.0 and later:

  1. Select the project in the Project Explorer view.
  2. In the global tool bar, select Run from the Launch Mode drop-down list.
  3. In the Target drop-down list, select iOS Device, then select a device (not iTunes Sync) to directly install your application to it.
  4. If the Launch Automatically option is enabled under the Target drop-down list, the application will be automatically launched after the device is selected. If not, you need to click the Launch button to start the build process.

Using the Titanium CLI 3.2.0 and later, run the following command:

ti build -p ios -T device -C <DEVICE_UDID> [-V "<DEVELOPER_CERTIFICATE_NAME>"  -P <PROVISIONING_PROFILE_UUID>]

If you omit the optional parameters, the CLI will prompt your for the information with options. You can obtain the missing information from Xcode's Organizer or running the ti info -t ios command.

You can still install your device to iTunes, then install the application from iTunes to the device.

Dynamic Animations

The Titanium.UI.iOS.Animator object provides support for the built-in iOS dynamic animations, which are supported on iOS 7 and later. The animator provides physics-related capabilities and animations using the iOS physics engine.

For more information, see the Titanium.UI.iOS.Animator API reference.

Font Text Styles

The Font object supports a new property, textStyle, available for iOS 7 and later. Assign this property a Titanium.UI.TEXT_STYLE_* constant to use a predefined text style. If this property is assigned a valid value, all other font properties are ignored.

iOS 7 Animated Transitions

iOS 7 introduced new animation capabilities for transitioning Windows in a NavigationWindow or Tab. Create a transition animation object with the Titanium.UI.iOS.createTransitionAnimation method to specify animation objects to hide the current window and show the new window, then assign the transition animation object to the Window's transitionAnimation property.

iOS 7 Background Services

iOS 7 introduced new background execution modes allowing the application to download large content while its in the background. These background modes are exposed as the following Titanium APIs:

For more information, see the iOS Background Services guide.

ListView Phase 2

The following ListView features were completed in this Release:

For more information, see the ListViews guide and Titanium.UI.ListView API reference.

Map Module

As of this Release, the ti.map module provides native map support on the iOS platform and includes a new iOS 7 feature that allows the map to be viewed in a 3D perspective.

For more information, see iOS Map Kit.

Popover Content

The Titanium.UI.iPad.Popover class supports a new property, contentView, used to assign a view object as the content area of the popover before showing the popover. This is now the preferred way to set the content area of a popover instead of using the add method.

This property does not support the Titanium.UI.iPad.SplitWindow or Titanium.UI.TabGroup objects. Use a Titanium.UI.iOS.NavigationWindow object to display and manage content with a navigation controller.

Refresh Control

iOS 6 introduced a new refresh control that can be used to implement the pull-to-refresh mechanism for ListView and TableView. The Titanium SDK exposes this control as the Titanium.UI.RefreshControl object.

StoreKit Module

The ti.storekit module now supports the new iOS 7 receipt validation system and Apple-hosted, in-app purchase downloads.

Note that the ti.storekit module cannot be tested on the iOS simulator.

Window Title Attributes

The Titanium.UI.Window class supports a new property, titleAttributes, used to specify the color, font, and shadow of the window's title.

Previously, the only way to specify these attributes was to create a custom Label object and assign it to the window's titleControl property.

Shadow Text Effect

On the Android and Mobile Web platforms, you can now add a shadow effect to a Button's title or Label's text property using the shadowColor, shadowOffset and shadowRadius properties.

Previously, these were iOS-only properties.

Known Issues

The following issues are known with this release.

Field Service sample crashes on Android -- On Android, the Field Service sample application crashes with java.lang.ClassCastException: java.lang.String cannot be cast to java.lang.Boolean error. To fix, this issue:

  1. In Studio, open app/styles/my-service-outlets/placard.tss.
  2. Locate the "#statusView" style rule and change touchEnabled: "true" to touchEnabled: true:

"#statusView": { width: Ti.UI.SIZE, backgroundImage: "/common/btn-light-flex.png", backgroundLeftCap: 6, height: 36, top: 12, layout: "horizontal", touchEnabled: true }

Issue animating view's height and width on Samsung S3 -- On a Samsung S3, animating a view's height and width may produce unexpected results (TIMOB-15719). To workaround this issue, enable hardware acceleration in the <application/> element of the Android manifest in your project's tiapp.xml file:

<ti:app xmlns:ti="http://ti.appcelerator.org"> <android xmlns:android="http://schemas.android.com/apk/res/android"> <manifest> <application android:hardwareAccelerated="true"> ... </application> </manifest> </android> </ti:app>

API Changes

This section lists new APIs, deprecated APIs, and APIs that have been removed from the SDK.

New APIs

The following APIs are new or have expanded platform support in Release 3.2.0.

APITypeNotes
Titanium.Android.ActionBar.navigationModemethod

Controls the navigation mode. (New API, supported on Android.)

Titanium.Android.Activity.sendBroadcastmethod

Broadcast the passed in Intent to all BroadcastReceivers. (New API, supported on Android.)

Titanium.Android.Activity.sendBroadcastWithPermissionmethod

Broadcast the passed in Intent to all BroadcastReceivers with an optional permission. (New API, supported on Android.)

Titanium.Android.Activity.userleavehintevent

Fired when the activity is about to go into the background as a result of user choice. (New API, supported on Android.)

Titanium.Android.NAVIGATION_MODE_STANDARDproperty

Standard Action Bar navigation mode (New API, supported on Android.)

Titanium.Android.NAVIGATION_MODE_TABSproperty

Action Bar tab navigation mode (New API, supported on Android.)

Titanium.Android.createBroadcastIntentmethod

Create an Intent to be used in a broadcast. (New API, supported on Android.)

Titanium.App.iOS.BACKGROUNDFETCHINTERVAL_MINproperty

Use with (endBackgroundHandler)[Titanium.App.iOS.endBackgroundHandler] method. Specifies the smallest fetch interval supported by the system. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.BACKGROUNDFETCHINTERVAL_NEVERproperty

Use with (endBackgroundHandler)[Titanium.App.iOS.endBackgroundHandler] method. Used to specify a fetch interval large enough to prevent fetch operations from occurring. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.backgroundTransferevent

Fired when the events related to a urlSession are waiting to be processed. Available only on iOS 7. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.backgroundfetchevent

Fired when the application is woken up for a fetch operation. Available only in iOS 7. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.downloadcompletedevent

Fired to indicate that a download task has finished downloading. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.downloadprogressevent

Fired periodically to informs the app about the download's progress. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.endBackgroundHandlermethod

Marks the end of the app execution when a download operation is complete. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.sessioncompletedevent

Fired to indicate that a session task finished transferring data. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.sessioneventscompletedevent

Fired to indicate that all messages enqueued for a session have been delivered. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.setMinimumBackgroundFetchIntervalmethod

Specifies the minimum amount of time that must elapse between background fetch operations. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.silentpushevent

Fired when the application is woken up by a silent remote notification. Available only on iOS 7. (New API, supported on iPhone and iPad.)

Titanium.Media.CAMERA_FRONTproperty

Constant specifying the front camera. (Added support for Android.)

Titanium.Media.CAMERA_REARproperty

Constant indicating the rear camera. (Added support for Android.)

Titanium.Media.availableCamerasproperty

Array indicating which cameras are available, CAMERA_FRONT, CAMERA_REAR or both. (Added support for Android.)

Titanium.Media.hideCameramethod

Hides the device camera UI. (Added support for Android.)

Titanium.Media.switchCameramethod

Switches between front and rear-facing cameras. (Added support for Android.)

Titanium.Network.Cookieobject

Cookie object used to manage the system cookie store and HTTP client cookie store. (New API, supported on Android.)

Titanium.Network.addHTTPCookiemethod

Adds a cookie to the HTTP client cookie store. (New API, supported on Android.)

Titanium.Network.addSystemCookiemethod

Adds a cookie to the system cookie store. (New API, supported on Android.)

Titanium.Network.createCookiemethod

Creates and returns an instance of Titanium.Network.Cookie. (New API, supported on Android.)

Titanium.Network.getHTTPCookiesmethod

Gets all the cookies with the domain, path and name matched with the given values from the HTTP client cookie store. (New API, supported on Android.)

Titanium.Network.getHTTPCookiesForDomainmethod

Gets all the cookies with the domain matched with the given values from the HTTP client cookie store. (New API, supported on Android.)

Titanium.Network.getSystemCookiesmethod

Gets all the cookies with the domain, path and name matched with the given values from the system cookie store. (New API, supported on Android.)

Titanium.Network.removeAllHTTPCookiesmethod

Removes all the cookies from the HTTP client cookie store. (New API, supported on Android.)

Titanium.Network.removeAllSystemCookiesmethod

Removes all the cookie from the system client cookie store. (New API, supported on Android.)

Titanium.Network.removeHTTPCookiemethod

Removes the cookie with the domain, path and name exactly the same as the given values from the HTTP client cookie store. (New API, supported on Android.)

Titanium.Network.removeHTTPCookiesForDomainmethod

Removes the cookies with the domain matched with the given values from the HTTP client cookie store. (New API, supported on Android.)

Titanium.Network.removeSystemCookiemethod

Removes the cookie with the domain, path and name exactly the same as the given values from the system cookie store. (New API, supported on Android.)

Titanium.Proxy.apiNameproperty

The name of the API that this proxy corresponds to. (New API, supported on all platforms.)

Titanium.Proxy.getApiNamemethod

Gets the value of the apiName property. (New API, supported on all platforms.)

Titanium.UI.Android.WEBVIEW_LOAD_CACHE_ELSE_NETWORKproperty

Use with WebView.cacheMode to override how the cache is used in a web view. (New API, supported on Android.)

Titanium.UI.Android.WEBVIEW_LOAD_CACHE_ONLYproperty

Use with WebView.cacheMode to override how the cache is used in a web view. (New API, supported on Android.)

Titanium.UI.Android.WEBVIEW_LOAD_DEFAULTproperty

Use with WebView.cacheMode to override how the cache is used in a web view. (New API, supported on Android.)

Titanium.UI.Android.WEBVIEW_LOAD_NO_CACHEproperty

Use with WebView.cacheMode to override how the cache is used in a web view. (New API, supported on Android.)

Titanium.UI.Button.disabledColorproperty

Text color when the button is in the disabled state, as a color name or hex triplet. (New API, supported on iPhone and iPad.)

Titanium.UI.Button.getShadowColormethod

Gets the value of the shadowColor property. (New API, supported on Android and Mobile Web.)

Titanium.UI.Button.getShadowOffsetmethod

Gets the value of the shadowOffset property. (New API, supported on Android and Mobile Web.)

Titanium.UI.Button.getShadowRadiusmethod

Gets the value of the shadowRadius property. (New API, supported on Android and Mobile Web.)

Titanium.UI.Button.setShadowColormethod

Sets the value of the shadowColor property. (New API, supported on Android and Mobile Web.)

Titanium.UI.Button.setShadowOffsetmethod

Sets the value of the shadowOffset property. (New API, supported on Android and Mobile Web.)

Titanium.UI.Button.setShadowRadiusmethod

Sets the value of the shadowRadius property. (New API, supported on Android and Mobile Web.)

Titanium.UI.Button.shadowColorproperty

Shadow color of the title, as a color name or hex triplet. (New API, supported on Android and Mobile Web.)

Titanium.UI.Button.shadowOffsetproperty

Shadow offset of the title, as a dictionary with the properties x and y. (New API, supported on Android and Mobile Web.)

Titanium.UI.Button.shadowRadiusproperty

Shadow radius of the title. (New API, supported on Android and Mobile Web.)

Titanium.UI.Label.attributedStringproperty

Specify an attributed string for the label. (New API, supported on iPhone and iPad.)

Titanium.UI.Label.getAttributedStringmethod

Gets the value of the attributedString property. (New API, supported on iPhone and iPad.)

Titanium.UI.Label.getShadowRadiusmethod

Gets the value of the shadowRadius property. (New API, supported on Android and Mobile Web.)

Titanium.UI.Label.linkevent

Fired when user performs a long press on a URL in the text area. (New API, supported on iPhone and iPad.)

Titanium.UI.Label.setAttributedStringmethod

Sets the value of the attributedString property. (New API, supported on iPhone and iPad.)

Titanium.UI.Label.setShadowRadiusmethod

Sets the value of the shadowRadius property. (New API, supported on Android and Mobile Web.)

Titanium.UI.Label.shadowColorproperty

Shadow color of the text, as a color name or hex triplet. (Added support for Android.)

Titanium.UI.Label.shadowOffsetproperty

Shadow offset of the text, as a dictionary with the properties x and y. (Added support for Android.)

Titanium.UI.Label.shadowRadiusproperty

Shadow radius of the text. (New API, supported on Android and Mobile Web.)

Titanium.UI.ListItem.backgroundGradientproperty

Background gradient to render when the item is not selected. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListItem.backgroundImageproperty

Background image to render when the item is not selected. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListItem.canEditproperty

Specifies if the item can be deleted by a user initiated action. (New API, supported on iPhone and iPad.)

Titanium.UI.ListItem.canMoveproperty

Specifies if the item can be reordered within the list view by a user initiated action. (New API, supported on iPhone and iPad.)

Titanium.UI.ListItem.searchableTextproperty

The text to match against when the ListView is performing a search. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListItem.selectedBackgroundColorproperty

Background color of the view, as a color name or hex triplet when item is selected. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListItem.selectedBackgroundGradientproperty

Background gradient to render when the item is selected. (New API, supported on iPhone and iPad.)

Titanium.UI.ListItem.selectedBackgroundImageproperty

Background image to render when the item is selected. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListSection.footerViewproperty

View to use for this section footer. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListSection.getFooterViewmethod

Gets the value of the footerView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListSection.getHeaderViewmethod

Gets the value of the headerView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListSection.headerViewproperty

View to use for this section header. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListSection.setFooterViewmethod

Sets the value of the footerView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListSection.setHeaderViewmethod

Sets the value of the headerView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.canScrollproperty

Determines if the list view can scroll in response to user actions. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.caseInsensitiveSearchproperty

Determines if the search performed is case insensitive. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.deleteevent

Fired when a list row is deleted by the user. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.deselectItemmethod

Deselects a specific item. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.editingproperty

Determines if the list view is currently in editing mode. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.footerViewproperty

List view footer as a view that will be rendered instead of a label. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.getCanScrollmethod

Gets the value of the canScroll property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.getCaseInsensitiveSearchmethod

Gets the value of the caseInsensitiveSearch property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.getEditingmethod

Gets the value of the editing property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.getFooterViewmethod

Gets the value of the footerView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.getHeaderViewmethod

Gets the value of the headerView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.getKeepSectionsInSearchmethod

Gets the value of the keepSectionsInSearch property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.getPruneSectionsOnEditmethod

Gets the value of the pruneSectionsOnEdit property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.getPullViewmethod

Gets the value of the pullView property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.getRefreshControlmethod

Gets the value of the refreshControl property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.getSearchTextmethod

Gets the value of the searchText property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.getSearchViewmethod

Gets the value of the searchView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.getSectionIndexTitlesmethod

Gets the value of the sectionIndexTitles property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.getSeparatorColormethod

Gets the value of the separatorColor property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.getSeparatorInsetsmethod

Gets the value of the separatorInsets property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.getSeparatorStylemethod

Gets the value of the separatorStyle property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.headerViewproperty

List view header as a view that will be rendered instead of a label. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.keepSectionsInSearchproperty

Determines if the section information is displayed in the search results when using the searchText property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.markerevent

Fired when the list view displays the reference item or an item beyond the reference item. (New API, supported on iPhone, iPad and Android.)

Titanium.UI.ListView.moveevent

Fired when a list row is moved to a different location by the user. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.pruneSectionsOnEditproperty

Determines if empty sections are retained when the user completes editing the list view. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.pullevent

Fired when the user drags the list view past the top edge of the pullView. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.pullViewproperty

View positioned above the first row that is only revealed when the user drags the list view contents down. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.pullendevent

Fired when the user stops dragging the list view and the pullView is completely visible. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.refreshControlproperty

View positioned above the first row that is only revealed when the user drags the list view contents down. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.searchTextproperty

The string to use as the search parameter. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.searchViewproperty

Search field to use for the list view. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.sectionIndexTitlesproperty

Array of objects (with title and index properties) to control the list view index. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.separatorColorproperty

Separator line color between rows, as a color name or hex triplet. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.separatorInsetsproperty

The insets for list view separators (applies to all cells). This property is applicable on iOS 7 and greater. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.separatorStyleproperty

Separator style constant. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setCanScrollmethod

Sets the value of the canScroll property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setCaseInsensitiveSearchmethod

Sets the value of the caseInsensitiveSearch property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.setContentInsetsmethod

Sets this list view's content insets. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setEditingmethod

Sets the value of the editing property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setFooterViewmethod

Sets the value of the footerView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.setHeaderViewmethod

Sets the value of the headerView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.setKeepSectionsInSearchmethod

Sets the value of the keepSectionsInSearch property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setMarkermethod

Sets a reference item in the list view. (New API, supported on iPhone, iPad and Android.)

Titanium.UI.ListView.setPruneSectionsOnEditmethod

Sets the value of the pruneSectionsOnEdit property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setPullViewmethod

Sets the value of the pullView property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setRefreshControlmethod

Sets the value of the refreshControl property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setSearchTextmethod

Sets the value of the searchText property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.setSearchViewmethod

Sets the value of the searchView property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.setSectionIndexTitlesmethod

Sets the value of the sectionIndexTitles property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setSeparatorColormethod

Sets the value of the separatorColor property. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ListView.setSeparatorInsetsmethod

Sets the value of the separatorInsets property. (New API, supported on iPhone and iPad.)

Titanium.UI.ListView.setSeparatorStylemethod

Sets the value of the separatorStyle property. (New API, supported on iPhone and iPad.)

Titanium.UI.RefreshControlobject

The RefreshControl is a representation of the native UIRefreshControl. (New API, supported on iPhone and iPad.)

Titanium.UI.TEXT_STYLE_BODYproperty

Specifies the text style for the Font Object. (New API, supported on iPhone and iPad.)

Titanium.UI.TEXT_STYLE_CAPTION1property

Specifies the text style for the Font Object. (New API, supported on iPhone and iPad.)

Titanium.UI.TEXT_STYLE_CAPTION2property

Specifies the text style for the Font Object. (New API, supported on iPhone and iPad.)

Titanium.UI.TEXT_STYLE_FOOTNOTEproperty

Specifies the text style for the Font Object. (New API, supported on iPhone and iPad.)

Titanium.UI.TEXT_STYLE_HEADLINEproperty

Specifies the text style for the Font Object. (New API, supported on iPhone and iPad.)

Titanium.UI.TEXT_STYLE_SUBHEADLINEproperty

Specifies the text style for the Font Object. (New API, supported on iPhone and iPad.)

Titanium.UI.TableView.getRefreshControlmethod

Gets the value of the refreshControl property. (New API, supported on iPhone and iPad.)

Titanium.UI.TableView.getSeparatorInsetsmethod

Gets the value of the separatorInsets property. (New API, supported on iPhone and iPad.)

Titanium.UI.TableView.refreshControlproperty

View positioned above the first row that is only revealed when the user drags the list view contents down. (New API, supported on iPhone and iPad.)

Titanium.UI.TableView.separatorInsetsproperty

The insets for table view separators (applies to all cells). This property is applicable on iOS 7 and greater. (New API, supported on iPhone and iPad.)

Titanium.UI.TableView.setRefreshControlmethod

Sets the value of the refreshControl property. (New API, supported on iPhone and iPad.)

Titanium.UI.TableView.setSeparatorInsetsmethod

Sets the value of the separatorInsets property. (New API, supported on iPhone and iPad.)

Titanium.UI.TextArea.attributedStringproperty

TextArea attributed string. (New API, supported on iPhone and iPad.)

Titanium.UI.TextArea.getAttributedStringmethod

Gets the value of the attributedString property. (New API, supported on iPhone and iPad.)

Titanium.UI.TextArea.getHandleLinksmethod

Gets the value of the handleLinks property. (New API, supported on iPhone and iPad.)

Titanium.UI.TextArea.handleLinksproperty

Specifies if the text area should allow user interaction with the given URL in the given range of text. (New API, supported on iPhone and iPad.)

Titanium.UI.TextArea.linkevent

Fired when user interacts with a URL in the text area. See handleLinks. (New API, supported on iPhone and iPad.)

Titanium.UI.TextArea.setAttributedStringmethod

Sets the value of the attributedString property. (New API, supported on iPhone and iPad.)

Titanium.UI.TextArea.setHandleLinksmethod

Sets the value of the handleLinks property. (New API, supported on iPhone and iPad.)

Titanium.UI.TextField.attributedHintTextproperty

Hint text attributed string. (New API, supported on iPhone and iPad.)

Titanium.UI.TextField.attributedStringproperty

TextField attributed string. (New API, supported on iPhone and iPad.)

Titanium.UI.TextField.getAttributedHintTextmethod

Gets the value of the attributedHintText property. (New API, supported on iPhone and iPad.)

Titanium.UI.TextField.getAttributedStringmethod

Gets the value of the attributedString property. (New API, supported on iPhone and iPad.)

Titanium.UI.TextField.setAttributedHintTextmethod

Sets the value of the attributedHintText property. (New API, supported on iPhone and iPad.)

Titanium.UI.TextField.setAttributedStringmethod

Sets the value of the attributedString property. (New API, supported on iPhone and iPad.)

Titanium.UI.WebView.cacheModeproperty

Determines how a cache is used in this web view. (New API, supported on Android.)

Titanium.UI.WebView.getCacheModemethod

Gets the value of the cacheMode property. (New API, supported on Android.)

Titanium.UI.WebView.getLightTouchEnabledmethod

Gets the value of the lightTouchEnabled property. (New API, supported on Android.)

Titanium.UI.WebView.lightTouchEnabledproperty

Enables using light touches to make a selection and activate mouseovers. (New API, supported on Android.)

Titanium.UI.WebView.setCacheModemethod

Sets the value of the cacheMode property. (New API, supported on Android.)

Titanium.UI.WebView.setLightTouchEnabledmethod

Sets the value of the lightTouchEnabled property. (New API, supported on Android.)

Titanium.UI.Window.getHideShadowmethod

Gets the value of the hideShadow property. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.getShadowImagemethod

Gets the value of the shadowImage property. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.getTitleAttributesmethod

Gets the value of the titleAttributes property. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.getTransitionAnimationmethod

Gets the value of the transitionAnimation property. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.hideShadowproperty

Set this to true to hide the shadow image of the navigation bar. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.setHideShadowmethod

Sets the value of the hideShadow property. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.setShadowImagemethod

Sets the value of the shadowImage property. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.setTitleAttributesmethod

Sets the value of the titleAttributes property. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.setTransitionAnimationmethod

Sets the value of the transitionAnimation property. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.shadowImageproperty

Shadow image for the navigation bar, specified as a URL to a local image.. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.titleAttributesproperty

Title text attributes of the window. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.transitionAnimationproperty

Use a transition animation when opening or closing windows in a Titanium.UI.iOS.NavigationWindow or Titanium.UI.Tab. (New API, supported on iPhone and iPad.)

Titanium.UI.createRefreshControlmethod

Creates and returns an instance of Titanium.UI.RefreshControl. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.AnchorAttachmentBehaviorobject

Dynamic behavior to support connections between an anchor point and an item. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.Animatorobject

Provides support for the built-in iOS dynamic animations (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.AttributedStringobject

An attributed string proxy manages character strings and associated sets of attributes (for example, font and kerning) that apply to individual characters or ranges of characters in the string. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.COLLISION_MODE_ALLproperty

Use with Titanium.UI.iOS.CollisionBehavior.collisionMode to specify collisions with both items and boundaries. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.COLLISION_MODE_BOUNDARYproperty

Use with Titanium.UI.iOS.CollisionBehavior.collisionMode to specify collisions with boundaries only. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.COLLISION_MODE_ITEMproperty

Use with Titanium.UI.iOS.CollisionBehavior.collisionMode to specify collisions with items only. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.CollisionBehaviorobject

Dynamic behavior to support collisions between items and boundaries. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.DynamicItemBehaviorobject

Base dynamic configuration for an item. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.GravityBehaviorobject

Gravitational force to apply to an item. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.PUSH_MODE_CONTINUOUSproperty

Use with Titanium.UI.iOS.PushBehavior.pushMode to specifiy a continuous force. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.PUSH_MODE_INSTANTANEOUSproperty

Use with Titanium.UI.iOS.PushBehavior.pushMode to specifiy an instantaneous force. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.PushBehaviorobject

Continuous or instantaneous force to apply to an item. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.SnapBehaviorobject

Dynamic behavior defining an item's movement to a specific point. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.ViewAttachmentBehaviorobject

Dynamic behavior to support connections between two items. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createAnchorAttachmentBehaviormethod

Creates and returns an instance of Titanium.UI.iOS.AnchorAttachmentBehavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createAnimatormethod

Creates and returns an instance of Titanium.UI.iOS.Animator. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createAttributedStringmethod

Creates and returns an instance of Titanium.UI.iOS.AttributedString. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createCollisionBehaviormethod

Creates and returns an instance of Titanium.UI.iOS.CollisionBehavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createDynamicItemBehaviormethod

Creates and returns an instance of Titanium.UI.iOS.DynamicItemBehavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createGravityBehaviormethod

Creates and returns an instance of Titanium.UI.iOS.GravityBehavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createPushBehaviormethod

Creates and returns an instance of Titanium.UI.iOS.PushBehavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createSnapBehaviormethod

Creates and returns an instance of Titanium.UI.iOS.SnapBehavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createTransitionAnimationmethod

Creates a transition animation when opening or closing windows in a Titanium.UI.iOS.NavigationWindow or Titanium.UI.Tab. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createViewAttachmentBehaviormethod

Creates and returns an instance of Titanium.UI.iOS.ViewAttachmentBehavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iPad.Popover.contentViewproperty

The View to use for popover content instead of the popover. Must be set before calling show method. (New API, supported on iPad.)

Titanium.UI.iPad.Popover.getContentViewmethod

Gets the value of the contentView property. (New API, supported on iPad.)

Titanium.UI.iPad.Popover.setContentViewmethod

Sets the value of the contentView property. (New API, supported on iPad.)

Titanium.UI.iPhone.ListViewSeparatorStyleobject

A set of constants for the style that can be used for the separatorStyle property of Titanium.UI.ListView. (New API, supported on iPhone and iPad.)

Removed APIs

The following APIs have been removed in Release 3.2.0.

APITypeNotes
Titanium.Calendar.Event.getRecurenceRulemethodNo replacement API. Not supported on iOS 6 or later.
Titanium.Calendar.Event.recurenceRulepropertyNo replacement API. Not supported on iOS 6 or later.
Titanium.Calendar.Event.setRecurenceRulemethodNo replacement API. Not supported on iOS 6 or later.
Titanium.Mapmodule

For new Android applications or to use Google Maps v2, use the ti.map add-on module.

For the iOS platform, use the ti.map add-on module. Support for the Titanium.Map module on iOS was removed in Release 3.2.0.

For all other platforms, continue to use this module.

Titanium.Map.Annotationobject

For new Android applications or to use Google Maps v2, use the ti.map add-on module.

For the iOS platform, use the ti.map add-on module. Support for the Titanium.Map module on iOS was removed in Release 3.2.0.

For all other platforms, continue to use this module.

Titanium.Map.Viewobject

For new Android applications or to use Google Maps v2, use the ti.map add-on module.

For the iOS platform, use the ti.map add-on module. Support for the Titanium.Map module on iOS was removed in Release 3.2.0.

For all other platforms, continue to use this module.

Titanium.UI.iPhone.NavigationGroupobject

Use the Titanium.UI.iOS.NavigationWindow class instead.

Titanium.UI.iPhone.createNavigationGroupmethod

Use the Titanium.UI.iOS.NavigationWindow class instead.

Titanium.UI.iPhone.hideStatusBarmethod

This method does not work on iOS 7 and is deprecated on earlier versions. Use the fullscreen property of the window to control if the staus bar is shown or not.

Titanium.UI.iPhone.showStatusBarmethod

This method does not work on iOS 7 and is deprecated on earlier versions. Use the fullscreen property of the window to control if the staus bar is shown or not.