Titanium SDK 4.0.0 Release Note

Titanium SDK 4.0.0 General Availability - 21 May 2015

Icon

Please note: You need to install Android SDK 5.0 (API 21) to build Android applications with this Release.

Contents

About This Release

This is the general availability (GA) release version of the Titanium SDK 4.0.0.

Note that this release includes feature and behavior changes. See Notice of Feature and Behavior Changes for details.

This release includes over 150 bug fixes and improvements, see the full list of issues that were addressed in Release 4.0.0

Alloy 1.6.0

This release coincides with the release of Alloy 1.6.0.

Summary of New Features:

  • Support for Backbone 1.1.2
  • Upgrade to Underscore 1.6.0
  • Update extract-i18n command to extract localized strings from XML files in addition to JavaScript and TSS files
  • XML Markup/TSS Enhancements:
    • Set the Titanium.Android.MenuItem.actionView property in XML Markup using the <ActionView/> element

For more details, see the Alloy Changelog.

Android Support

Due to the addition of Material Theme support in this Release, the target SDK version must be set to API 21 (Android 5.0) or greater. If you do not set the target SDK version, Android SDK 5.0 or greater must still be installed. Previously, the target SDK version could be API 14 or greater.

The Titanium SDK no longer supports deploying applications to devices running Android 3.x or less. The minimum SDK version (if used) must be set to API 14 (Android 4.0) or greater. Previously, the minimum API level was 10 (Android 2.3.x).

BlackBerry Support

Support for building and deploying to the BlackBerry OS was removed in this Release.

Studio 4.0.0

This Release coincides with the release of Studio 4.0.0.

Summary of Changes:

  • Integration with the Appcelerator CLI.
  • New installers for OS X and Windows with silent installation capabilities, and prerequisite detection and installation.
  • Update Eclipse base from 4.3 (Kepler) to 4.4 (Lunar).
  • Update content assist for Alloy projects.
  • Add hyperlink detector to jump from i18n translation keys in Alloy JavaScript and TSS attributes to their definition in strings.xml files.

For more details, see the Studio Release Notes.

Notice of Feature or Behavior Changes

Android Platform

Action Bar Icons

Due to the requirement that the target SDK must be set to Android 5.0 (API level 21) or higher, action bar icons may not display. Google is discouraging the use of icons in toolbars:

In modern Android UIs developers should lean more on a visually distinct color scheme for toolbars than on their application icon. The use of application icon plus title as a standard layout is discouraged on API 21 devices and newer.

Source: Android Developer: Toolbar API reference

Facebook Module

The Facebook module was updated to use a newer version of the Facebook SDK for Android and iOS. Some APIs were removed due to changes in the native Facebook SDKs and removal of the Facebook v1.0 REST APIs.

For details, see the Migration section in the Facebook API reference.

iOS Platform

This section lists changes for the iOS platform.

iOS Attributed String

Since Android supports attributed strings, the Titanium.UI.iOS.AttributedString class is deprecated and a new Titanium.UI.AttributedString class was added. The new class behaves the same as the old class. If you currently use attributed strings in your application, just remove the iOS namespace. Note that Android only supports a subset of attributes as compared to iOS.

The Label link event now responds to a single tap rather than a long press.

iPad Split Window

In iOS 8, the iPhone now supports the SplitView class. The Titanium.UI.iPad.SplitWindow class is deprecated and a new Titanium.UI.iOS.SplitWindow class was added. Any application that uses the old iPad SplitWindow should transition to the new iOS SplitWindow.

New Features

This section describes new features introduced in Release 4.0.0.

Android Platform

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

Attributed String

As of this Release, the Android platform supports attributed strings using the Titanium.UI.AttributedString class. Previously, this feature was only available for iOS.

For more details, see the Attributed String guide.

Material Theme

Starting with this Release, the Titanium SDK exposes the Material Theme color palette attributes, introduced in Android 5.0 (Lollipop). These attributes allow you to style the status bar, action bar and several control widgets, such as toggle switches and text fields, without having to individually style each component.

To use the Material Theme with Titanium, you need to create a custom theme that extends one of the AppCompat themes, then set the color palette attributes you want to change from the default theme.

For details, see the "Material Theme" section in the Android Themes guide.

Module Lifecycle Hooks

Starting with this Release, an Android module proxy can respond to activity lifecycle events by overriding the activity lifecycle callbacks in the proxy, then in the JavaScript application, assign either a Window or TabGroup object to the proxy's lifecycleContainer property when creating the module proxy to monitor the lifecycle events of that object to trigger the module proxy's lifecycle events.

For details, see the "Activity Lifecycle Events" section in Android Module Architecture guide.

Notifications

The Titanium.Android.Notifications class exposes the following new properties:

  • category: Set to a Titanium.Android.CATEGORY_* constant if the notification falls into one of the pre-defined notification categories. Android uses the category to determine where and how it should be displayed. Supported on Android 5.0 and greater.
  • priority: Set to a Titanium.Android.PRIORITY_* constant to determine where the notification is displayed in the drawer. Supported on Android 4.1 and greater.
  • visibility: Set to a Titanium.Android.VISIBILITY_* constant to filter notifications in the lock screen. Supported on Android 5.0 and greater.

For details, see the Android Notifications guide.

Scrollable Tabs

This Release adds support for scrollable tabs, where users can swipe to navigate between tabs in addition to tapping a tab in the tab bar. The following APIs were added:

Split Action Bar

This Release adds support for the split action bar, which displays action items in a separate bar at the bottom of the window instead of at the top. To create a split action bar, set the splitActionBar property to true when creating a Window object.

TLS Support

As of this Release, the application can specify which TLS version to use with the HTTPClient. Set the HTTPClient's tlsVersion property to one of theTitanium.Network.TLS_* constants to force the TLS version to use.

Previously, this feature was only available for iOS.

For details, see the "TLS Support" section in the HTTPClient API reference.

Video Thumbnails

The following Titanium.Media.VideoPlayer methods are exposed to the Android platform to support extracting thumbnails from a video:

Previously, this feature was only available for iOS.

Facebook Module

The Facebook module was updated to use a newer version of the Facebook SDK for Android and iOS. New features include the Like button and using the Facebook application's interface for dialogs if the Facebook app is also installed on device.

For details, see the Facebook API reference.

iOS Platform

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

Camera Permission Request

This Release exposes the following APIs to request permission to use the device's camera:

Note that the application will automatically request permission to use the camera if the camera application is launched. The new APIs allow the application to explicitly request permission from the user before the camera is launched.

Contacts

The Titanium.Contacts.Person class exposes the following new properties:

Split Window

This Release introduces the Titanium.UI.iOS.SplitWindow class to support the SplitWindow object on both iPhone and iPad devices, introduced in iOS 8. Previously, this feature was only available for iPad. This class deprecates the Titanium.UI.iPad.SplitWindow class.

User Defaults

This Release exposes the iOS NSUserDefaults APIs to allow a Titanium application to access user preferences that can be shared between multiple applications that are registered with the same application group permission.

Known Issues

Cannot Preview Mobile Web Application in Studio

After building a mobile web application in Studio, Studio does not launch the application in a browser (TISTUD-7428).

To workaround this issue, create your own web server to launch the application. Instructions will be available in the linked ticket.

Fail to Encrypt JavaScript Files on Windows

When building an application on Windows, the build fails at the encryption stage (CLI-658).

To workaround this issue, install the 32-bit version of Java.

API Changes

New APIs

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

API Type Notes
Titanium.Android.CATEGORY_ALARM property

Notification category indicating an alarm or timer. (New API, supported on Android.)

Titanium.Android.CATEGORY_CALL property

Notification category indicating an incoming call (voice or video) or similar synchronous communication request. (New API, supported on Android.)

Titanium.Android.CATEGORY_EMAIL property

Notification category indicating an asynchronous bulk message (email). (New API, supported on Android.)

Titanium.Android.CATEGORY_ERROR property

Notification category indicating an error in background operation or authentication status. (New API, supported on Android.)

Titanium.Android.CATEGORY_EVENT property

Notification category indicating a calendar event. (New API, supported on Android.)

Titanium.Android.CATEGORY_MESSAGE property

Notification category indicating an incoming direct message (SMS, instant message, etc.). (New API, supported on Android.)

Titanium.Android.CATEGORY_PROGRESS property

Notification category indicating the progress of a long-running background operation. (New API, supported on Android.)

Titanium.Android.CATEGORY_PROMO property

Notification category indicating a promotion or advertisement. (New API, supported on Android.)

Titanium.Android.CATEGORY_RECOMMENDATION property

Notification category indicating a specific, timely recommendation for a single thing. (New API, supported on Android.)

Titanium.Android.CATEGORY_SERVICE property

Notification category for a running background service. (New API, supported on Android.)

Titanium.Android.CATEGORY_SOCIAL property

Notification category for a social network or sharing update. (New API, supported on Android.)

Titanium.Android.CATEGORY_STATUS property

Notification category indicating ongoing information about device or contextual status. (New API, supported on Android.)

Titanium.Android.CATEGORY_TRANSPORT property

Notification category indicating media transport control for playback. (New API, supported on Android.)

Titanium.Android.Notification.category property

Sets the notification's category. (New API, supported on Android.)

Titanium.Android.Notification.getCategory method

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

Titanium.Android.Notification.getPriority method

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

Titanium.Android.Notification.getVisibility method

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

Titanium.Android.Notification.priority property

Sets the priority of the notification. (New API, supported on Android.)

Titanium.Android.Notification.setCategory method

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

Titanium.Android.Notification.setPriority method

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

Titanium.Android.Notification.setVisibility method

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

Titanium.Android.Notification.visibility property

Allows user to conceal private information of the notification on the lockscreen. (New API, supported on Android.)

Titanium.Android.PRIORITY_DEFAULT property

Default priority if it does no fit into another priority category. (New API, supported on Android.)

Titanium.Android.PRIORITY_HIGH property

Use for high priority notifications like real-time chat messages. (New API, supported on Android.)

Titanium.Android.PRIORITY_LOW property

Use for low priority notifications like software updates. (New API, supported on Android.)

Titanium.Android.PRIORITY_MAX property

Use for urgent or time-critical notifications, for example, turn-by-turn directions or emergency alerts. (New API, supported on Android.)

Titanium.Android.PRIORITY_MIN property

Use for expired events. (New API, supported on Android.)

Titanium.Android.VISIBILITY_PRIVATE property

Shows basic information about the notification. (New API, supported on Android.)

Titanium.Android.VISIBILITY_PUBLIC property

Shows the notification's full content on the lockscreen. This is the system default if visibility is left unspecified. (New API, supported on Android.)

Titanium.Android.VISIBILITY_SECRET property

Shows the most minimal information of the notification on the lockscreen. (New API, supported on Android.)

Titanium.App.iOS.UserDefaults module

The UserDefaults module is used for storing application-related data in property/value pairs that persist beyond application sessions and device power cycles. UserDefaults allows the suiteName of the UserDefaults to be specified at creation time. (New API, supported on iPhone and iPad.)

Titanium.App.iOS.createUserDefaults method

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

Titanium.Contacts.Person.alternateBirthday property

Alternate birthday of the person. Single Dictionary. (New API, supported on iPhone and iPad.)

Titanium.Contacts.Person.getAlternateBirthday method

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

Titanium.Contacts.Person.getSocialProfile method

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

Titanium.Contacts.Person.setAlternateBirthday method

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

Titanium.Contacts.Person.setSocialProfile method

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

Titanium.Contacts.Person.socialProfile property

Social profile information of the person. Multi-value. (New API, supported on iPhone and iPad.)

Titanium.Filesystem.directoryForSuite method

Returns the path to the container directory associated with the specified security application group ID. (New API, supported on iPhone and iPad.)

Titanium.Media.CAMERA_AUTHORIZATION_AUTHORIZED property

Constant specifying that app is authorized to use camera. This is available on iOS 7 and later. (New API, supported on iPhone and iPad.)

Titanium.Media.CAMERA_AUTHORIZATION_DENIED property

Constant specifying that app is denied usage of camera. This is available on iOS 7 and later. (New API, supported on iPhone and iPad.)

Titanium.Media.CAMERA_AUTHORIZATION_NOT_DETERMINED property

Constant specifying that app is not yet authorized to use camera. This is available on iOS 7 and later. (New API, supported on iPhone and iPad.)

Titanium.Media.CAMERA_AUTHORIZATION_RESTRICTED property

Constant specifying that app is restricted from using camera. This is available on iOS 7 and later. (New API, supported on iPhone and iPad.)

Titanium.Media.cameraAuthorizationStatus property

Returns the authorization status for the camera. (New API, supported on iPhone and iPad.)

Titanium.Media.getCameraAuthorizationStatus method

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

Titanium.Media.requestCameraAccess method

Requests for camera access. (New API, supported on iPhone and iPad.)

Titanium.Media.VIDEO_TIME_OPTION_CLOSEST_SYNC property

Use the closest sync (or key) frame at given the time. (New API, supported on Android.)

Titanium.Media.VIDEO_TIME_OPTION_NEAREST_KEYFRAME property

Use the closest keyframe in the time. (Added support for Android.)

Titanium.Media.VIDEO_TIME_OPTION_NEXT_SYNC property

Use the sync (or key) frame located right after or at given the time. (New API, supported on Android.)

Titanium.Media.VIDEO_TIME_OPTION_PREVIOUS_SYNC property

Use the sync (or key) frame located right before or at given the time. (New API, supported on Android.)

Titanium.Media.VideoPlayer.cancelAllThumbnailImageRequests method

Cancels all pending asynchronous thumbnail requests. (Added support for Android.)

Titanium.Media.VideoPlayer.requestThumbnailImagesAtTimes method

Asynchronously request thumbnail images for one or more points in time in the video. (Added support for Android.)

Titanium.Network.HTTPClient.tlsVersion property

Sets the TLS version to use for handshakes. (Added support for Android.)

Titanium.Network.TLS_VERSION_1_0 property

Constant value specifying TLS version 1.0 for SSL. (Added support for Android.)

Titanium.Network.TLS_VERSION_1_1 property

Constant value specifying TLS version 1.1 for SSL. (Added support for Android.)

Titanium.Network.TLS_VERSION_1_2 property

Constant value specifying TLS version 1.2 for SSL. (Added support for Android.)

Titanium.Proxy.getLifecycleContainer method

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

Titanium.Proxy.lifecycleContainer property

The Window or TabGroup whose Activity lifecycle should be triggered on the proxy. (New API, supported on Android.)

Titanium.Proxy.setLifecycleContainer method

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

Titanium.UI.ATTRIBUTE_BACKGROUND_COLOR property

Use with Attribute.type to specify a background color. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ATTRIBUTE_BASELINE_OFFSET property

Use with Attribute.type to apply a different baseline to the text. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_EXPANSION property

Use with Attribute.type to stretch the text horizontally. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_FONT property

Use with Attribute.type to specify a font. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ATTRIBUTE_FOREGROUND_COLOR property

Use with Attribute.type to specify a font color. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ATTRIBUTE_KERN property

Use with Attribute.type to specify kerning (space between characters). (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_LETTERPRESS_STYLE property

Use with Attribute.value to use a letterpress text effect. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_LIGATURE property

Use with Attribute.type to enable or disable ligatures. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_LINK property

Use with Attribute.type to create a link. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ATTRIBUTE_OBLIQUENESS property

Use with Attribute.type to skew the text. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_SHADOW property

Use with Attribute.type to display a shadow behind the text. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_STRIKETHROUGH_COLOR property

Use with Attribute.type to change the color of the horizontal line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE property

Use with Attribute.type to place a horizontal line through the text. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ATTRIBUTE_STROKE_COLOR property

Use with Attribute.type to specify a color for the stroke text. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_STROKE_WIDTH property

Use with Attribute.type to specify the width of the stroke text. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_TEXT_EFFECT property

Use with Attribute.type to apply a text effect. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE property

Use with Attribute.type to place a horizontal line under the text. (New API, supported on Android, iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_BY_WORD property

Use with Attribute.value to draw a line only underneath or through words. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_COLOR property

Use with Attribute.type to change the color of the horizontal line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_DASH property

Use with Attribute.value to draw a dashed line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_DASH_DOT property

Use with Attribute.value to draw an alternating line of dashes and dots. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_DASH_DOT_DOT property

Use with Attribute.value to draw an alternating line of dashes and two dots. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_DOT property

Use with Attribute.value to draw a dotted line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_SOLID property

Use with Attribute.value to draw a solid line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_STYLE_DOUBLE property

Use with Attribute.value to draw a double line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_STYLE_NONE property

Use with Attribute.value to not draw a line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_STYLE_SINGLE property

Use with Attribute.value to draw a single line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_UNDERLINE_STYLE_THICK property

Use with Attribute.value to draw a thick line. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_WRITING_DIRECTION property

Use with Attribute.type to control the direction of the text. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_EMBEDDING property

Use with Attribute.value to use the embedded text direction. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_LEFT_TO_RIGHT property

Use with Attribute.value to write text left to right. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_NATURAL property

Use with Attribute.value to use the Unicode Bidirection Algorithm rules P2 and P3 to determine which direction to use. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_OVERRIDE property

Use with Attribute.value to override the text direction. (New API, supported on iPhone and iPad.)

Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_RIGHT_TO_LEFT property

Use with Attribute.value to write text right to left. (New API, supported on iPhone and iPad.)

Titanium.UI.Android.SWITCH_STYLE_SWITCH property

Display a switch. (New API, supported on Android.)

Titanium.UI.Android.ProgressIndicator.canceledOnTouchOutside property

When cancelable is set to true and this is set to true, the dialog is canceled when touched outside the window's bounds. (New API, supported on Android.)

Titanium.UI.Android.ProgressIndicator.getCanceledOnTouchOutside method

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

Titanium.UI.Android.ProgressIndicator.setCanceledOnTouchOutside method

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

Titanium.UI.AttributedString object

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

Titanium.UI.Label.attributedString property

Specify an attributed string for the label. (Added support for Android.)

Titanium.UI.Label.link event

Fired when user interacts with a URL in the Label. (Added support for Android.)

Titanium.UI.Tab.selected event

Fired when the tab is selected. (New API, supported on Android.)

Titanium.UI.Tab.unselected event

Fired when the tab is unselected. (New API, supported on Android.)

Titanium.UI.TabGroup.disableTabNavigation method

Disable (or re-enable) tab navigation. If tab navigation is disabled, the tabs are hidden and the last selected tab window is shown. (New API, supported on Android.)

Titanium.UI.TabGroup.getSmoothScrollOnTabClick method

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

Titanium.UI.TabGroup.getSwipeable method

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

Titanium.UI.TabGroup.setSmoothScrollOnTabClick method

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

Titanium.UI.TabGroup.setSwipeable method

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

Titanium.UI.TabGroup.smoothScrollOnTabClick property

Boolean value indicating if changing pages by tab clicks is animated. (New API, supported on Android.)

Titanium.UI.TabGroup.swipeable property

Boolean value indicating if tab navigation can be done by swipes, in addition to tab clicks. (New API, supported on Android.)

Titanium.UI.TextArea.attributedString property

TextArea attributed string. (Added support for Android.)

Titanium.UI.TextField.attributedHintText property

Hint text attributed string. (Added support for Android.)

Titanium.UI.TextField.attributedString property

TextField attributed string. (Added support for Android.)

Titanium.UI.WebView.enableJavascriptInterface property

Enable adding javascript interfaces internally to webview prior to JELLY_BEAN_MR1 (Android 4.2) (New API, supported on Android.)

Titanium.UI.WebView.getEnableJavascriptInterface method

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

Titanium.UI.WebView.onLoadResource event

Fired when loading resource. (New API, supported on Android.)

Titanium.UI.Window.getSplitActionBar method

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

Titanium.UI.Window.splitActionBar property

Boolean value to enable split action bar. (New API, supported on Android.)

Titanium.UI.createAttributedString method

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

Titanium.UI.iOS.SplitWindow object

A SplitWindow is a window that manages the presentation of two side-by-side view controllers. (New API, supported on iPhone and iPad.)

Titanium.UI.iOS.createSplitWindow method

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

Deprecated APIs

The following APIs are deprecated in Release 4.0.0.

API Type Notes
Titanium.UI.iOS.ATTRIBUTE_BACKGROUND_COLOR property

Use the Titanium.UI.ATTRIBUTE_BACKGROUND_COLOR constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_BASELINE_OFFSET property

Use the Titanium.UI.ATTRIBUTE_BASELINE_OFFSET constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_EXPANSION property

Use the Titanium.UI.ATTRIBUTE_EXPANSION constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_FONT property

Use the Titanium.UI.ATTRIBUTE_FONT constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_FOREGROUND_COLOR property

Use the Titanium.UI.ATTRIBUTE_FOREGROUND_COLOR constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_KERN property

Use the Titanium.UI.ATTRIBUTE_KERN constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_LETTERPRESS_STYLE property

Use the Titanium.UI.ATTRIBUTE_LETTERPRESS_STYLE constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_LIGATURE property

Use the Titanium.UI.ATTRIBUTE_LIGATURE constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_LINK property

Use the Titanium.UI.ATTRIBUTE_LINK constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_OBLIQUENESS property

Use the Titanium.UI.ATTRIBUTE_OBLIQUENESS constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_SHADOW property

Use the Titanium.UI.ATTRIBUTE_SHADOW constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_STRIKETHROUGH_COLOR property

Use the Titanium.UI.ATTRIBUTE_STRIKETHROUGH_COLOR constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_STRIKETHROUGH_STYLE property

Use the Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_STROKE_COLOR property

Use the Titanium.UI.ATTRIBUTE_STROKE_COLOR constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_STROKE_WIDTH property

Use the Titanium.UI.ATTRIBUTE_STROKE_WIDTH constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_TEXT_EFFECT property

Use the Titanium.UI.ATTRIBUTE_TEXT_EFFECT constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINES_STYLE property

Use the Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_BY_WORD property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_BY_WORD constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_COLOR property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_COLOR constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_PATTERN_DASH property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_DASH constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_PATTERN_DASH_DOT property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_DASH_DOT constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_PATTERN_DASH_DOT_DOT property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_DASH_DOT_DOT constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_PATTERN_DOT property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_DOT constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_PATTERN_SOLID property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_PATTERN_SOLID constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_STYLE_DOUBLE property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_STYLE_DOUBLE constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_STYLE_NONE property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_STYLE_NONE constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_STYLE_SINGLE property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_STYLE_SINGLE constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_UNDERLINE_STYLE_THICK property

Use the Titanium.UI.ATTRIBUTE_UNDERLINE_STYLE_THICK constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_WRITING_DIRECTION property

Use the Titanium.UI.ATTRIBUTE_WRITING_DIRECTION constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_WRITING_DIRECTION_EMBEDDING property

Use the Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_EMBEDDING constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_WRITING_DIRECTION_LEFT_TO_RIGHT property

Use the Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_LEFT_TO_RIGHT constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_WRITING_DIRECTION_NATURAL property

Use the Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_NATURAL constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_WRITING_DIRECTION_OVERRIDE property

Use the Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_OVERRIDE constant instead (without the iOS namespace).

Titanium.UI.iOS.ATTRIBUTE_WRITING_DIRECTION_RIGHT_TO_LEFT property

Use the Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_RIGHT_TO_LEFT constant instead (without the iOS namespace).

Titanium.UI.iOS.Attribute object

use Attribute instead.

Titanium.UI.iOS.AttributedString object

use Titanium.UI.AttributedString instead.

Titanium.UI.iOS.createAttribute method

use Attribute instead.

Titanium.UI.iOS.createAttributedString method

use Titanium.UI.AttributedString instead.

Titanium.UI.iPad.SplitWindow object

Use Titanium.UI.iOS.SplitWindow instead.

Titanium.UI.iPad.createSplitWindow method

Use Titanium.UI.iOS.SplitWindow instead.

Removed APIs

The following APIs have been removed in Release 4.0.0.

API Type Notes
Titanium.App.keyboardFrameChanged event

Renamed to keyboardframechanged (all lowercase).

Titanium.UI.Window.getUrl method  
Titanium.UI.Window.url property  
Titanium.UI.iOS.COLOR_SCROLLVIEW_BACKGROUND property  
Titanium.UI.iOS.COLOR_UNDER_PAGE_BACKGROUND property  
Titanium.UI.iOS.COLOR_VIEW_FLIPSIDE_BACKGROUND property  
Titanium.UI.iOS.SplitWindow.getUrl method  
Titanium.UI.iOS.SplitWindow.url property  
Titanium.UI.iPad.SplitWindow.getUrl method  
Titanium.UI.iPad.SplitWindow.url property  

Related Links