Skip to end of metadata
Go to start of metadata


The examples in this page use the Prototype library, which is included by default inside a portal. However, the same concepts may be applied using other implementations.


This command checks for any updates available for the Titanium SDK. When a dispatch request for a check is made, the Studio will access the Titanium repo online and will compare the installed version to the latest version. A post-check event will then be fired from the Studio. The event will hold the information regarding any available update.


This command is executed asynchronously.

Checking for Titanium SDK updates

This is the dispatch call for the check for updates.

When triggered, the Studio will perform the required checks and will later on send a notification to the portal by calling a JavaScript function eventsDispatcher.notify() and passing an event JSON into it.

The portal should handle this by defining an eventsDispatcher object that has a notify function that accepts an argument.
For example (taken from the studio3-sdk repository):

The example above calls portal.updates.update(e); whenever the Studio fires a titaniumSDK event. The update function than handles the event by reading the JSON content from it and re-render the UI.

The event that the Studio sends contains these fields:



Indicate the status of the check. Can hold the following values: 'ok', 'processing', 'error', 'incomplete' or 'unknown'

The currently installed Titanium Mobile SDK version

The currently installed Titanium Desktop SDK version

A boolean indication that an update is available


When the, for example, is undefined, the will indicate the stage of the command. The studio will fire multiple events after the dispatch call, and it's up to the JavaScript call to handle those and render the UI accordingly (for example, show a spinning wheel when the processing status is received).

The studio3_sdk repository contains a complete example of handling these events and tunneling them to the UI (see updates.js)

Installing a Titanium SDK update

When the Studio indicates that a Titanium SDK update is available, a displayed link can activate the action to download and install the SDK automatically.

Here is the dispatch call that does that:

Installing a Titanium SDK update using a URL

You can install a specific Titanium SDK via the url. The action will trigger an install similar to the "installUpdate" action, but just targeted to a specific SDK url.

Here is the dispatch call that does that:

The argument passed in is the url to the specific sdk.