Titanium SDK iOS模块深度解析：本地通知与后台服务-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00913/article/details/148782530

Titanium SDK iOS模块深度解析：本地通知与后台服务

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk

概述

Titanium.App.iOS模块是专为iOS设备设计的顶级模块，提供了管理本地通知和后台服务的功能。作为跨平台开发框架Titanium SDK的重要组成部分，该模块让开发者能够充分利用iOS系统的特色功能，同时保持代码的跨平台兼容性。

本地通知系统

基本概念

本地通知是应用程序在非前台运行时向用户传递信息的重要方式。当触发时，系统会显示横幅消息或带有"关闭"和"打开"按钮的警告对话框。通知还可以修改应用图标角标（显示待处理通知数量）并播放提示音。

实现流程

注册通知权限：使用registerUserNotificationSettings方法申请通知权限
调度通知：通过scheduleLocalNotification方法设置并发送通知
处理响应：监听notification事件来处理用户对通知的交互

// 示例代码：发送简单本地通知
Ti.App.iOS.registerUserNotificationSettings({
    types: [
        Ti.App.iOS.USER_NOTIFICATION_TYPE_ALERT,
        Ti.App.iOS.USER_NOTIFICATION_TYPE_SOUND
    ]
});

var notification = {
    alertBody: "您有一条新消息",
    sound: "default",
    userInfo: {id: "msg123"}
};
Ti.App.iOS.scheduleLocalNotification(notification);

交互式通知

高级功能

iOS 8+引入了交互式通知，允许用户在不打开应用的情况下直接响应通知。实现交互式通知需要：

使用createUserNotificationAction创建通知操作
通过createUserNotificationCategory创建通知类别并关联操作
使用registerUserNotificationSettings注册通知类别
监听localnotificationaction事件处理用户响应

// 示例：创建交互式通知
var action = Ti.App.iOS.createUserNotificationAction({
    identifier: "REPLY_ACTION",
    title: "回复",
    activationMode: Ti.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_BACKGROUND,
    behavior: Ti.App.iOS.USER_NOTIFICATION_BEHAVIOR_TEXTINPUT
});

var category = Ti.App.iOS.createUserNotificationCategory({
    identifier: "MESSAGE_CATEGORY",
    actionsForDefaultContext: [action],
    actionsForMinimalContext: [action]
});

Ti.App.iOS.registerUserNotificationSettings({
    categories: [category],
    types: [Ti.App.iOS.USER_NOTIFICATION_TYPE_ALERT]
});

后台服务

后台下载

iOS 7+支持应用在后台下载内容，Titanium SDK 3.2.0+提供了相应支持。关键方法包括：

setMinimumBackgroundFetchInterval：设置后台获取的最小时间间隔
endBackgroundHandler：标记后台操作完成

// 设置后台获取间隔
Ti.App.iOS.setMinimumBackgroundFetchInterval(
    Ti.App.iOS.BACKGROUNDFETCHINTERVAL_MIN
);

// 处理后台获取事件
Ti.App.iOS.addEventListener('backgroundfetch', function(e) {
    // 执行后台任务
    doBackgroundWork();
    
    // 任务完成后必须调用
    Ti.App.iOS.endBackgroundHandler(e.handlerId);
});

后台服务

使用registerBackgroundService注册后台服务，需指定一个本地JavaScript文件：

var service = Ti.App.iOS.registerBackgroundService({
    url: 'bgService.js'
});

内容索引与搜索

iOS 9+允许将应用内容索引到系统Spotlight搜索中，相关API：

SearchableItemAttributeSet：创建内容元数据
SearchableItem：打包元数据为可搜索项
SearchableIndex：管理设备搜索索引

设备间活动传递(Handoff)

Handoff功能支持跨设备继续用户活动，如在一台设备上开始编辑文档，在另一台设备上继续：

使用UserActivityAPI创建可共享活动
监听continueactivity事件处理活动传递

通知权限与设置

iOS通知系统提供了细粒度的权限控制，开发者需要了解以下重要常量：

| 常量 | 说明 | |------|------| | USER_NOTIFICATION_TYPE_* | 控制通知类型（声音、角标、提醒等） | | USER_NOTIFICATION_AUTHORIZATION_STATUS_* | 应用授权状态 | | USER_NOTIFICATION_SETTING_* | 通知设置状态 | | USER_NOTIFICATION_ALERT_STYLE_* | 通知显示样式 |