# 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+`
* minimum deployment target iOS `15+`

### Android

* minSdkVersion `23+`
* compileSdkVersion `36+`

## 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`.