Release Notes

Titanium SDK 3.3.0 General Availability - 07/17/2014

Contents

About This Release

This is the general availability (GA) release version of the Titanium SDK 3.3.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 feature and behavior changes. See Notice of Feature and Behavior Changes in Release 3.3.0 for details.

This release includes over 300 bug fixes and improvements:

Alloy 1.4.0

This release coincides with the release of Alloy 1.4.0, which includes an update to the Alloy plugin. After upgrading to Alloy 1.4.0, there is a small chance the first build may fail. For more information, see the Alloy Studio Plugin section.

Summary of New Features:

For more details, see the Alloy Changelog.

Studio 3.3.0

This release coincides with the release of Studio 3.3.0.

Summary of New Features:

For more details, see the Studio Release Notes.

Titanium CLI 3.3.0

This release coincides with the release of Titanium CLI 3.3.0.

Summary of New Features:

For more details, see the CLI Changelog.

Android Wear and Android L SDK Support

The Titanium SDK does not officially support the Android L SDK, since it is in beta. However, there are no known issues and you should be able build Titanium applications with it. You are encouraged to file bugs if you encounter issues compiling or running Titanium applications with the L SDK.

The Titanium SDK does not currently support the Android W SDK.

Also, if you have either the Android L or W SDKs installed, it's recommended that you explicitly set the targetSdkVersion property in the <uses-sdk/> element in your project's tiapp.xml file. The reason for doing this is that Studio, by default, uses the latest installed SDK to compile your project. Both Android L and W have a target API level of 20, whereas the latest supported Android SDK release has an API target level of 19. Setting the target API version explicitly ensures your project will always compile and run as expected.

For example, the following sets the target and minimum API version to 19:

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

Windows Hybrid Platform Support

This release supports Windows 8 Apps and Windows Phone 8 applications built using the Mobile Web APIs. Titanium turns your Mobile Web application in to Windows 8 JavaScript and Windows Phone HTML5 applications.

All development is done through the command-line tools. There is no support with Appcelerator or Titanium Studio.

For information on getting started, see:

To access native features of the Windows Phone platform, create a module that uses the Titanium Windows Phone 8 Reflection API to make calls to the native Windows Phone 8 API. For details on adding native Windows Phone 8 functionality to your application, see Windows Phone 8 Module Development Guide.

Notice of Feature or Behavior Changes in Release 3.3.0

Android Platform

This section lists changes for the Android platform.

Action Bar

Due to changes to support the appcompat library, the action bar is now displayed by default. Previously, you had to set a theme to display the action bar.

To hide the action bar, the application needs to wait for the main window or tab group to open, then call the Activity's actionbar.hide() method; or create a theme that hides the action bar.

As of this Release, the tiapp.xml element, <navbar-hidden>, which used to be able to hide the action bar, has no effect on Android applications.

For information about hiding the action bar, see Android Action Bar: Hiding the Action Bar.

Lightweight Windows

As of this Release, support for lightweight windows (windows without an Android Activity) is removed and using the ti.android.useLegacyWindow property in the tiapp.xml file has no effect.

As previously mentioned, all windows are heavyweight, and you cannot control the type of window created.

Prior to Release 3.2.0, all windows were lightweight by default and you had to explicitly create a heavyweight window.

Due to this change, your application may behave differently or break since all windows are now heavyweight.

Target SDK Version

Due to changes to support the appcompat library, if you set the Android target SDK version in your tiapp.xml file, you must specify version 14 or higher. For example:

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

If you do not set a target SDK, you need to have Android SDK 4.0.x (API level 14) or higher installed to build the application.

The minimum supported Android SDK (android:minSdkVersion) is version 2.3.x or API level 10. Titanium still supports devices running Android 2.3.x and greater.

Themes

Due to changes to support the appcompat library, applications cannot use the base Holo, Light or Dark themes. If you are using a custom theme in your application, you must update the theme file to use an AppCompat theme as the parent, for example:

platform/android/res/values/mytheme.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:android="http://schemas.android.com/apk/res/android">
    <style name="LightDarkBar" parent="Theme.AppCompat.Light.DarkActionBar"/>
</resources>

For more information about using Android Themes, see Android Themes.

View enabled property

As of this Release, the Android-specific enabled property for view components is deprecated. Use the non-platform-specific touchEnabled property to disable touch events for a view component.

iOS Platform

This section lists changes for the iOS platform.

Building to a Device

By default, when building to an iOS device, the Titanium CLI and Studio will choose the first connected device if any devices are connected.

Previously, the default device was iTunes sync.

CFBundleShortVersionString

To generate the CFBundleShortVersionString in the application's info.plist file for iOS packages, the version field in the tiapp.xml is truncated to three dot-separated numbers. For example, '2.1' remains as '2.1', but '2.1.0.1' will be converted to '2.1.0'.

Prior to Release 3.3.0, the version number was always converted to three dot-separated numbers when creating a package. For example, if you specify '2.1' or '2.1.0.1', the version number will be converted to '2.1.0' for the final package.

CFBundleVersion for iTunes Sync Builds

To fix an issue with iTunes sync builds with iTunes 11.2 and later, the CFBundleVersion in the application's info.plist file is set to an Epoch timestamp.

Previously, this field was set to the version field in the tiapp.xml file, then an Epoch timestamp was appended to the end of the version.

Database fieldcount method

To achieve parity across platforms, the Titanium.Database.ResultSet.fieldcount() method has been removed from the SDK. Use the read-only Titanium.Database.ResultSet.fieldcount property to retrieve the same information.

SSL Client Certificates

The mechanisms introduced in Release 3.1.0 to support SSL Certificate Stores for HTTP Clients are no longer supported.

Use the HTTPClient's securityManager property to implement support for SSL Certificate Stores.

Titanium include method

As of this release, the Titanium.include method is deprecated. This method was used to include external JavaScript files into a project.

Instead, create a CommonJS module and use the require method to include external JavaScript.

New Features

This section describes new features introduced in Release 3.3.0.

Android Platform

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

ActionBar Improvements

This Release exposes the Android methods, setDisplayShowHomeEnabled and setDisplayShowTitleEnabled, to programmatically show or hide the action bar home icon, and title and subtitle, respectively.

See also the AppCompat Library section below.

AppCompat Library

As of this Release, the Titanium SDK uses the appcompat library to provide support for the Action Bar on devices running Android 2.3.x and later. Due to the addition of the appcompat library, there are a number of behavior changes to the application:

  1. The action bar is now enabled by default. Previously, you had to set a theme to enable the action bar.
  2. The target SDK must be set to API level 14 (Android 4.0.x) or higher, or you must have API level 14 or higher installed.
  3. If the application is using a custom theme, the parent theme must be based off an AppCompat theme. The application cannot use the base Holo, Light or Dark themes.

For more information about using Android Themes and the Action Bar, see Android Themes and Android Action Bar, respectively.

Application-Level APIs

This Release introduces several application-level properties:

AudioPlayer Improvements

This Release introduces the time property to report or set the current playback time of the AudioPlayer.

Camera Improvements

This Release adds support for camera features to the Android platform that were previously only available for iOS:

Genymotion Virtual Devices

This Release officially supports testing Android applications on Genymotion virtual devices with both the Titanium CLI and Studio. Genymotion is an alternative to the Android SDK's native Android Virtual Device manager. Genymotion emulators run a lot faster than the native Android emulators (even with Intel Hardware Accelerated Execution Manger enabled). However, the Android virtual devices provide more configurable options than the free Genymotion emulators. You can pay for an enterprise license if you want more features with Genymotion.

For more information about installing and using Genymotion virtual devices, see Installing Genymotion.

Label Padding

This Release introduces the includeFontPadding property to increase the padding above and below the label to display diacritical marks, such as accents and subscript curls.

ListView and TableView Improvements

This Release introduces properties to show or hide a divider after the header or before the footer in either a ListView or TableView:

This Release also adds the ability to disable animations when scrolling to an item in ListView. When using the scrollToItem method, set the animated property of the optional animation dictionary to false to disable the scrolling animation.

listView.scrollToItem(sIndex,iIndex,{animated:false});

Previously, scrolling animations could only be controlled on the iOS platform.

Proximity Sensor Support

This Release adds Android platform support for the proximity sensor, which determines if the user is holding the phone to their ear to shut down the phone's display. Use the following APIs to determine the state of the proximity sensor:

Previously, these APIs were only available for the iOS platform.

WebView SSL Error Event

This Release introduces the sslerror event that fires when an SSL error occurs during a request. Use this event to set the ignoreSslError property to allow the request to proceed or fail.

Window Flags

This Release introduces two new properties to set flags on the window activity:

BlackBerry Platform

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

applyProperties and removeAllChildren

As of this Release, the BlackBerry platform supports the applyProperties and removeAllChildren methods.

iOS Platform

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

Clipping Behavior

Use the clipMode property to control the clipping behavior of the view component. Set this property to one of the following constants:

By default, the view component uses the CLIP_MODE_DEFAULT behavior. Previously, clipping was always enabled.

For more information, see the "iOS Clipping Behavior" section in the Titanium.UI.View API Reference.

Core Motion Module

The Core Motion module provides support for monitoring various hardware sensors on iOS devices, such as the accelerometer, gyroscope, and magnetometer. The Core Motion module allows you to access the measurements provided by these sensors.

For more information, see the Core Motion Module guide and CoreMotion API Reference.

HTTPClient Improvements

As of this Release, the HTTP client on iOS uses the iOS NSURLConnection class, replacing the ASIHTTPRequest class. The new implementation did not add, modify or remove any APIs. No modifications to existing application should be required.

The HTTP Client for iOS now supports cookie management. Previously, this feature was only available for Android.

ListView Improvements

This Release introduces new APIs for ListView:

ScrollableView Move Methods

This Release adds iOS support for the movePrevious and moveNext methods to programmatically change the current view displayed in the scrollable view.

These methods plus the scrollToView method will animate the transition. If you do not want to animate the transition, use the setCurrentPage method.

Previously, these APIs were only available for Android and BlackBerry.

Switch Tint Colors

This Release exposes iOS properties to customize the tint colors of a Switch:

TabGroup Appearance

This Release introduces new properties to control the appearance of a Tab Group:

Toolbar Background

This Release introduces the extendBackground property to extend the background of the Toolbar into the iOS 7 status bar.

View Shadows

To add a shadow to a view component, use the following properties to control the appearance of the shadow:

WebView and App URLs

To have the WebView handle application URLs, such as a phone number, which is normally sent to a shared application, use the handlePlatformUrl property to override the default behavior.

Window Navigation Buttons

This Release introduces the leftNavButtons and rightNavButtons properties to add multiples buttons to the left and right side of the iOS navigation bar.

Previously, only one button could be displayed in the left and right side of the iOS navigation bar.

SSL Certificate Support

This Release introduces a new mechanism to support SSL certificates with the HTTPClient exposed as the securityManager property. This property is only available on the Android and iOS platforms.

TableView Search Improvements

This Release introduces the filterAnchored property for TableView to limit searches to the start of the string. For example, if this property is set to true, searching for "ha" returns results for "Harold" and "Harvard", but not "Sharon" and "Jonathan". If the property is set to false, the search returns all of the previous strings.

This property is only available on the Android and iOS platforms.

TextArea and TextField Selection

This Release introduces the selection property for TextArea and TextField to return the start location and length of the currently selected text. This property can also be used to get the current location of the cursor. This property is only available on the Android and iOS platforms.

Known Issues

Alloy Studio Plugin

Alloy 1.4.0 includes changes to the Alloy plugin, which is used by Studio to compile and launch your project. These changes will be applied automatically the first time you build a project after updating to 1.4.0. However, because the first build uses the old plugin, there is a small chance that it will fail. Retrying the build should resolve the issue, or you can manually update the plugin with the following command:

alloy install plugin [path_to_project]

If you enter this command while in your project's folder, omit the path.

CLI users are not affected by this change.

Cannot Run KitchenSink with Genymotion

Genymotion virtual devices do not include the Google Play Services SDK. If you want to run KitchenSink on a Genymotion virtual device, you need to install the Google Play Services SDK to the virtual device.

For instructions, see http://www.tushroy.com/2013/12/installing-google-play-services-on-genymotion-2-0.html.

Cannot Submit an iOS application with the Facebook Module

When including the Facebook module in an iOS project and built for the iTunes Store, during the validation process you may receive an error message referring to an Improper Advertising identifier [IDFA] Usage.

As part of the Apple review process when submitting an application, you will be asked if your app uses the Advertising Identifier (IDFA). Please check "Yes". You will then be asked how your app makes use of it. The question will take this form:

This app uses the Advertising Identifier to (select all that apply)?
- Serve advertisements within the app
- Attribute this app installation to a previously served advertisement
- Attribute an action taken within this app to a previously served advertisement

Select the second and third options.

You will also be asked to check a box to confirm that your app honors a user's Limit Ad Tracking setting in iOS. The Facebook SDK honors the iOS Limited Ad Tracking Setting. When a person enables Limited Ad Tracking, Facebook only uses data obtained through the use of the Advertising Identifier for "Limited Advertising Purposes" as defined by the iOS Developer Program License Agreement. Please make sure to check this box when prompted.

For more information, see Facebook Issue #242477629268301 and TIMODOPEN-391.

API Changes

New APIs

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

APITypeNotes
Titanium.Android.ActionBar.setDisplayShowHomeEnabledmethod

Shows or hides the action bar home icon (New API, supported on Android.)

Titanium.Android.ActionBar.setDisplayShowTitleEnabledmethod

Shows or hides the action bar title/subtitle (New API, supported on Android.)

Titanium.App.Android.appVersionCodeproperty

The version number of the application. (New API, supported on Android.)

Titanium.App.Android.appVersionNameproperty

The version name of the application. (New API, supported on Android.)

Titanium.App.Android.getAppVersionCodemethod

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

Titanium.App.Android.getAppVersionNamemethod

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

Titanium.App.Android.getLaunchIntentmethod

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

Titanium.App.Android.launchIntentproperty

Return the intent that was used to launch the application. (New API, supported on Android.)

Titanium.App.proximityevent

Fired when the proximity sensor changes state. (Added support for Android.)

Titanium.App.proximityDetectionproperty

Determines whether proximity detection is enabled. (Added support for Android.)

Titanium.App.proximityStateproperty

Indicates the state of the device's proximity sensor, according to the Titanium.App.proximity event. (Added support for Android.)

Titanium.Database.ResultSet.fieldCountproperty

The number of columns in this result set. (Added support for iPhone and iPad.)

Titanium.Media.AudioPlayer.getTimemethod

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

Titanium.Media.AudioPlayer.setTimemethod

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

Titanium.Media.AudioPlayer.timeproperty

Current playback position of the audio. (New API, supported on Android.)

Titanium.Media.CAMERA_FLASH_AUTOproperty

Constant specifying to have the device determine to use the flash or not. (Added support for Android.)

Titanium.Media.CAMERA_FLASH_OFFproperty

Constant specifying to never fire the flash. (Added support for Android.)

Titanium.Media.CAMERA_FLASH_ONproperty

Constant specifying to always fire the flash. (Added support for Android.)

Titanium.Media.cameraFlashModeproperty

Determines how the flash is fired when using the device's camera. (Added support for Android.)

Titanium.Media.saveToPhotoGallerymethod

Saves media to the device's photo gallery / camera roll. (Added support for Android.)

Titanium.Network.Cookieobject

Cookie object used to manage the system cookie store and HTTP client cookie store. (Added support for iPhone and iPad.)

Titanium.Network.HTTPClient.getSecurityManagermethod

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

Titanium.Network.HTTPClient.securityManagerproperty

The Security Manager for this client. (New API, supported on iPad, iPhone and Android.)

Titanium.Network.addHTTPCookiemethod

Adds a cookie to the HTTP client cookie store. (Added support for iPhone and iPad.)

Titanium.Network.allHTTPCookiesproperty

A list of all cookies in the cookie storage. (New API, supported on iPhone and iPad.)

Titanium.Network.createCookiemethod

Creates and returns an instance of Titanium.Network.Cookie. (Added support for iPhone and iPad.)

Titanium.Network.getAllHTTPCookiesmethod

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

Titanium.Network.getHTTPCookiesmethod

Gets all the cookies with the domain, path and name matched with the given values from the HTTP client cookie store. (Added support for iPhone and iPad.)

Titanium.Network.getHTTPCookiesForDomainmethod

Gets all the cookies with the domain matched with the given values from the HTTP client cookie store. (Added support for iPhone and iPad.)

Titanium.Network.removeAllHTTPCookiesmethod

Removes all the cookies from the HTTP client cookie store. (Added support for iPhone and iPad.)

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. (Added support for iPhone and iPad.)

Titanium.Network.removeHTTPCookiesForDomainmethod

Removes the cookies with the domain matched with the given values from the HTTP client cookie store. (Added support for iPhone and iPad.)

Titanium.Proxy.appyPropertiesmethod

Applies the properties to the proxy. (Added support for BlackBerry.)

Titanium.UI.Label.getIncludeFontPaddingmethod

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

Titanium.UI.Label.includeFontPaddingproperty

Includes extra top and bottom padding to make room for accents that go above normal ascent and descent. (New API, supported on Android.)

Titanium.UI.Label.setIncludeFontPaddingmethod

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

Titanium.UI.ListView.footerDividersEnabledproperty

When set to false, the ListView will not draw the divider before the footer view. (New API, supported on Android.)

Titanium.UI.ListView.getFooterDividersEnabledmethod

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

Titanium.UI.ListView.getHeaderDividersEnabledmethod

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

Titanium.UI.ListView.headerDividersEnabledproperty

When set to false, the ListView will not draw the divider after the header view. (New API, supported on Android.)

Titanium.UI.ListView.noresultsevent

Fired when the search using either searchView or searchText has no results. (New API, supported on iPhone and iPad.)

Titanium.UI.ScrollableView.moveNextmethod

Sets the current page to the next consecutive page in Titanium.UI.ScrollableView.views. (Added support for iPhone and iPad.)

Titanium.UI.ScrollableView.movePreviousmethod

Sets the current page to the previous consecutive page in Titanium.UI.ScrollableView.views. (Added support for iPhone and iPad.)

Titanium.UI.Switch.getOnTintColormethod

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

Titanium.UI.Switch.getThumbTintColormethod

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

Titanium.UI.Switch.getTintColormethod

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

Titanium.UI.Switch.onTintColorproperty

The color used to tint the appearance of the switch when it is turned on. (New API, supported on iPhone and iPad.)

Titanium.UI.Switch.setOnTintColormethod

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

Titanium.UI.Switch.setThumbTintColormethod

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

Titanium.UI.Switch.setTintColormethod

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

Titanium.UI.Switch.thumbTintColorproperty

The color used to tint the appearance of the thumb. (New API, supported on iPhone and iPad.)

Titanium.UI.Switch.tintColorproperty

The color used to tint the outline of the switch when it is turned off. (New API, supported on iPhone and iPad.)

Titanium.UI.TabGroup.getNavTintColormethod

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

Titanium.UI.TabGroup.getTitlemethod

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

Titanium.UI.TabGroup.getTitleAttributesmethod

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

Titanium.UI.TabGroup.getTranslucentmethod

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

Titanium.UI.TabGroup.navTintColorproperty

The tintColor to apply to the navigation bar (typically for the More tab). This property is applicable on iOS 7 and greater. (New API, supported on iPhone and iPad.)

Titanium.UI.TabGroup.setNavTintColormethod

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

Titanium.UI.TabGroup.setTitlemethod

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

Titanium.UI.TabGroup.setTitleAttributesmethod

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

Titanium.UI.TabGroup.setTranslucentmethod

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

Titanium.UI.TabGroup.titleproperty

Title for this tabGroup. (New API, supported on Android.)

Titanium.UI.TabGroup.titleAttributesproperty

Title text attributes of the window to be applied on the More tab. (New API, supported on iPhone and iPad.)

Titanium.UI.TabGroup.translucentproperty

Boolean value indicating if the nav bar (typically for the More tab), is translucent. (New API, supported on iPhone and iPad.)

Titanium.UI.TableView.filterAnchoredproperty

Determines whether the search is limited to the start of the string (New API, supported on Android, iPhone and iPad.)

Titanium.UI.TableView.footerDividersEnabledproperty

When set to false, the ListView will not draw the divider before the footer view. (New API, supported on Android.)

Titanium.UI.TableView.getFilterAnchoredmethod

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

Titanium.UI.TableView.getFooterDividersEnabledmethod

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

Titanium.UI.TableView.getHeaderDividersEnabledmethod

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

Titanium.UI.TableView.headerDividersEnabledproperty

When set to false, the ListView will not draw the divider after the header view. (New API, supported on Android.)

Titanium.UI.TableView.setFilterAnchoredmethod

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

Titanium.UI.TextArea.getSelectionmethod

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

Titanium.UI.TextArea.selectionproperty

Returns the currently selected text of the text area. (New API, supported on iPhone, iPad and Android.)

Titanium.UI.TextField.getSelectionmethod

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

Titanium.UI.TextField.selectionproperty

Returns the currently selected text of the text field. (New API, supported on iPhone, iPad and Android.)

Titanium.UI.View.clipModeproperty

View's clipping behavior. (New API, supported on iPhone and iPad.)

Titanium.UI.View.getClipModemethod

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

Titanium.UI.View.getPullBackgroundColormethod

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

Titanium.UI.View.getViewShadowColormethod

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

Titanium.UI.View.getViewShadowOffsetmethod

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

Titanium.UI.View.getViewShadowRadiusmethod

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

Titanium.UI.View.pullBackgroundColorproperty

Background color of the wrapper view when this view is used as either Titanium.UI.ListView.pullView or Titanium.UI.TableView.headerPullView. (New API, supported on iPhone and iPad.)

Titanium.View.removeAllChildrenmethod

Removes all child views from this view's hierarchy. (Added support for BlackBerry.)

Titanium.UI.View.setClipModemethod

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

Titanium.UI.View.setPullBackgroundColormethod

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

Titanium.UI.View.setViewShadowColormethod

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

Titanium.UI.View.setViewShadowOffsetmethod

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

Titanium.UI.View.setViewShadowRadiusmethod

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

Titanium.UI.View.viewShadowColorproperty

Determines the color of the shadow. (New API, supported on iPhone and iPad.)

Titanium.UI.View.viewShadowOffsetproperty

Determines the offset for the shadow of the view. (New API, supported on iPhone and iPad.)

Titanium.UI.View.viewShadowRadiusproperty

Determines the blur radius used to create the shadow. (New API, supported on iPhone and iPad.)

Titanium.UI.WebView.getHandlePlatformUrlmethod

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

Titanium.UI.WebView.handlePlatformUrlproperty

Lets the webview handle platform supported urls (New API, supported on iPhone and iPad.)

Titanium.UI.WebView.setHandlePlatformUrlmethod

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

Titanium.UI.WebView.sslerrorevent

Fired when an SSL error occurred. (New API, supported on Android.)

Titanium.UI.Window.flagSecureproperty

Treat the content of the window as secure, preventing it from appearing in screenshots or from being viewed on non-secure displays. (New API, supported on Android.)

Titanium.UI.Window.getFlagSecuremethod

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

Titanium.UI.Window.getLeftNavButtonsmethod

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

Titanium.UI.Window.getRightNavButtonsmethod

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

Titanium.UI.Window.getWindowFlagsmethod

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

Titanium.UI.Window.leftNavButtonsproperty

An Array of views to show in the left nav bar area. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.rightNavButtonsproperty

An Array of views to show in the right nav bar area. (New API, supported on iPhone and iPad.)

Titanium.UI.Window.setLeftNavButtonsmethod

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

Titanium.UI.Window.setRightNavButtonsmethod

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

Titanium.UI.Window.windowFlagsproperty

Additional flags to set on the Activity Window. (New API, supported on Android.)

Titanium.UI.iOS.CLIP_MODE_DEFAULTproperty

Use with Titanium.UI.View.clipMode to specify clipping behavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.CLIP_MODE_DISABLEDproperty

Use with Titanium.UI.View.clipMode to specify clipping behavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.CLIP_MODE_ENABLEDproperty

Use with Titanium.UI.View.clipMode to specify clipping behavior. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.Toolbar.extendBackgroundproperty

If true, the background of the toolbar extends upwards. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.Toolbar.getExtendBackgroundmethod

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

Deprecated APIs

The following APIs are deprecated in Release 3.3.0.

APITypeNotes
Titanium.includemethod

Create a CommonJS module and use the require method to include external JavaScript.

Titanium.Network.HTTPClient.addKeyManagermethod

Use the securityManager property instead.

Titanium.Network.HTTPClient.addTrustManagermethod

Use the securityManager property instead.

Titanium.UI.View.enabledproperty

This is deprecated on Android. Use touchEnabled property instead.

Titanium.UI.View.getEnabledmethod
Titanium.UI.View.setEnabledmethod

Removed APIs

The following APIs have been removed in Release 3.3.0.

APITypeNotes
Titanium.Analytics.addEventmethod
Titanium.Analytics.settingsEventmethod
Titanium.Analytics.timedEventmethod
Titanium.Analytics.userEventmethod
Titanium.Database.ResultSet.fieldCountmethod

Use the fieldCount property instead.