Customizing Appcelerator Titanium Module
How to customize Pushwoosh SDK for your Appcelerator Titanium project
Push Notifications in Foreground
By default, Pushwoosh plugin does not display notifications in the foreground and automatically triggers onPushOpened callback. This is controlled by
PW_BROADCAST_PUSHmetadata on Android:tiapp.xml
1
<?xml version="1.0" encoding="UTF-8"?>
2
<ti:app xmlns:ti="http://ti.appcelerator.org">
3
<android xmlns:android="http://schemas.android.com/apk/res/android">
4
<manifest>
5
<application>
6
<!-- Set to false if you want to disable automatic push open in foreground -->
7
<meta-data android:name="PW_BROADCAST_PUSH" android:value="true"/>
8
</application>
9
</manifest>
10
</android>
11
</ti:app>
Copied!
And
Pushwoosh_ALERT_TYPE Info.plist key on iOS:tiapp.xml
1
<?xml version="1.0" encoding="UTF-8"?>
2
<ti:app xmlns:ti="http://ti.appcelerator.org">
3
<ios>
4
<plist>
5
<dict>
6
<!-- Set value to ALERT or BANNER to change notification appearance in foreground -->
7
<key>Pushwoosh_ALERT_TYPE</key>
8
<string>NONE</string>
9
</dict>
10
</plist>
11
</ios>
12
</ti:app>
Copied!
Custom Push Sound
To enable custom push notifications sounds for Android put sound samples in app/platform/android/res/raw folder. The sounds will be accessible through Sound dropdown menu of Send Push panel.
Custom Push Icon
Push notification icon can be customized on Android locally by using pw_notification as resource name for such icon; or remotely by referencing any resource name in Icon setting in Send Push panel. Android resources should be placed in app/platform/android/res/ folder
Custom Push Data
Custom push data can be sent using Action setting in the Send Push panel. To receive and handle such data use the following code:
1
pushwoosh.onPushOpened(function(e) {
2
var customData = e.extras;
3
// handle custom push data
4
});
Copied!
Push receive callback
If application is registered for push notifications and is not closed, push delivery event can be handled using:
1
pushwoosh.onPushReceived(function(e) {
2
var message = e.message;
3
var foreground = e.foreground;
4
var customData = e.extras;
5
var raw = e.data;
6
7
// handle push receive here
8
});
Copied!
For iOS, enable Background Modes:
tiapp.xml
1
<?xml version="1.0" encoding="UTF-8"?>
2
<ti:app xmlns:ti="http://ti.appcelerator.org">
3
<ios>
4
<plist>
5
<dict>
6
<key>UIBackgroundModes</key>
7
<array>
8
<string>remote-notification</string>
9
</array>
10
</dict>
11
</plist>
12
</ios>
13
</ti:app>
Copied!
iOS10+ Media attachment
You need to add Notification Service Extension to the XCode project. The problem is that Titanium does not expose access to the XCode project and builds it in the background.
See this thread for the possible solution: https://github.com/Pushwoosh/pushwoosh-appcelerator-titanium/issues/45
Geozones
To use Geozones feature, implement Pushwoosh Geozones Module and add the following code to your project:
1
var pushwooshGeozones = require('com.pushwoosh.geozones');
2
pushwooshGeozones.startTrackingGeoPushes();
Copied!
Known issue with Google Services gradle plugin:
Build error:
1
In project 'app' a resolved Google Play services library dependency depends on another at an exact version (e.g. "[17.0.0, 18.0.99]", but isn't being resolved to that version. Behavior exhibited by the library will be unknown.
Copied!
Solution:
Add this line to your app/build.gradle file:
1
googleServices { disableVersionCheck = true }
Copied!
Share your feedback with us
Your feedback helps us create a better experience, so we would love to hear from you if you have any issues during the SDK integration process. If you face any difficulties, please do not hesitate to share your thoughts with us via this form.
Last modified 1mo ago