# Titanium

Integrate the Airship SDK into your Titanium applications.

<!-- PAGE: Titanium Module Changelog, PATH: https://www.airship.com/docs/developer/sdk-integration/titanium/changelog/ -->

# Titanium Module Changelog

> The latest updates to the Airship Titanium module
See the [SDK Support Policy](https://www.airship.com/docs/reference/sdk-support-policy/) for version coverage and maintenance windows.

[View Older Releases](https://github.com/urbanairship/titanium-module/releases?q=created%3A%3C2024-05-15&expanded=true)

<!-- /PAGE: Titanium Module Changelog -->

<!-- PAGE: Titanium Setup, PATH: https://www.airship.com/docs/developer/sdk-integration/titanium/setup/ -->

# Titanium Setup

> How to install Airship Titanium module.## Resources

* [Airship Titanium Module Release](https://github.com/urbanairship/titanium-module/releases)
* [Titanium Example](https://github.com/urbanairship/titanium-module/blob/main/example/app.js)
* [Github Repo](https://github.com/urbanairship/titanium-module)


## Requirements

* Titanium 10.0.0+
* To use notifications:
    - [iOS APNs setup instructions](https://www.airship.com/docs/guides/getting-started/developers/configure-channels/#ios-channel-configuration)
    - [Android FCM setup instructions](https://www.airship.com/docs/guides/getting-started/developers/configure-channels/#android-channel-configuration)

### iOS

* Xcode `15.3&#43;`
* minimum deployment target iOS `15&#43;`

### Android

* minSdkVersion `23&#43;`
* compileSdkVersion `36&#43;`

## Setup

Start by [downloading](https://github.com/urbanairship/titanium-module/releases)
the latest iOS and Android modules. Modify the `tiapp.xml` file to include and
configure the Airship module.

### Configure Airship

**Example app.js**

```js
var Airship = require("ti.airship");

Airship.takeOff({
  development: {
    appKey: "Your Development App Key",
    appSecret: "Your Development App Secret"
  },
  production: {
    appKey: "Your Production App Key",
    appSecret: "Your Production App Secret"
  },
  site: "us", // use "eu" for EU sites.
  urlAllowList: ["*"], // allows all URLs
  android: {
      notificationConfig: {
          icon: "ic_notification",
          accentColor: "#ff0000"
      }
  }
});
```


**tiapp.xml**

```xml
<ti:app>
    ...

    <modules>
       ...

       <module platform="android">ti.airship</module>
       <module platform="iphone">ti.airship</module>
    </modules>


    <ios>
        <plist>
            <dict>
                ...
                <key>UIBackgroundModes</key>
                <array>
                    <string>remote-notification</string>
                </array>
            </dict>
        </plist>
    </ios>

</ti:app>
```


### Android FCM
Android requires the `google-services.json` file to be copied into the app's directory `platform/android/google-services.json`.


<!-- /PAGE: Titanium Setup -->