richard/digital-pilates
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 优化后台任务管理，添加系统权限和用户偏好的完整检查，增强通知功能

Browse Source
This commit is contained in:
richarjiang
2025-09-04 18:23:05 +08:00
parent 6c21c4b448
commit cb89ee7bc2
5 changed files with 217 additions and 108 deletions
Download Patch File Download Diff File Expand all files Collapse all files

223
services/backgroundTaskManager.ts
View File

@@ -1,16 +1,38 @@
import AsyncStorage from '@react-native-async-storage/async-storage';
import * as BackgroundFetch from 'expo-background-fetch';
import * as BackgroundTask from 'expo-background-task';
import * as TaskManager from 'expo-task-manager';
// 后台任务名称常量
const BACKGROUND_TASK_NAME = 'health-background-task';
// 必须在全局作用域定义任务处理器
TaskManager.defineTask(BACKGROUND_TASK_NAME, async () => {
console.log('======= 后台任务被系统调用 =======');
const now = new Date();
console.log(`后台任务执行时间: ${now.toISOString()}`);
try {
// 获取后台任务管理器实例并执行所有注册的任务
const manager = BackgroundTaskManager.getInstance();
console.log('开始执行所有注册的任务...');
const results = await manager.executeAllTasks();
console.log('后台任务执行结果:', results);
// 返回成功状态
return BackgroundTask.BackgroundTaskResult.Success;
} catch (error) {
console.error('后台任务执行失败:', error);
return BackgroundTask.BackgroundTaskResult.Failed;
}
});
// 任务类型定义
export interface BackgroundTask {
export interface BackgroundTaskConfig {
id: string;
name: string;
handler: (data?: any) => Promise<void>;
options?: {
minimumInterval?: number; // 最小间隔时间（分钟）
stopOnTerminate?: boolean; // 应用终止时是否停止
startOnBoot?: boolean; // 设备重启时是否启动
};
}
@@ -27,9 +49,10 @@ export interface TaskStatus {
// 后台任务管理器类
class BackgroundTaskManager {
private static instance: BackgroundTaskManager;
private tasks: Map<string, BackgroundTask> = new Map();
private tasks: Map<string, BackgroundTaskConfig> = new Map();
private taskStatuses: Map<string, TaskStatus> = new Map();
private isInitialized = false;
private systemTaskRegistered = false;
// 单例模式
public static getInstance(): BackgroundTaskManager {
@@ -49,11 +72,11 @@ class BackgroundTaskManager {
this.isInitialized = true;
// 注册后台任务
await this.registerBackgroundTask();
await this.registerSystemBackgroundTask();
// 加载已保存的任务状态
await this.loadTaskStatuses();
console.log('后台任务管理器初始化成功');
} catch (error) {
console.error('后台任务管理器初始化失败:', error);
@@ -61,53 +84,49 @@ class BackgroundTaskManager {
}
}
// 注册后台任务
private async registerBackgroundTask(): Promise<void> {
const BACKGROUND_FETCH_TASK = 'background-fetch-task';
// 注册系统后台任务
private async registerSystemBackgroundTask(): Promise<void> {
console.log('开始注册系统后台任务...');
console.log('注册后台获取任务');
// 定义后台获取任务
TaskManager.defineTask(BACKGROUND_FETCH_TASK, async () => {
console.log('后台获取任务被系统调用');
const now = new Date();
try {
console.log(`开始执行后台任务 - ${now.toISOString()}`);
// 执行所有注册的任务
const results = await this.executeAllTasks();
console.log('后台任务执行完成:', results);
// 返回成功状态
return BackgroundFetch.BackgroundFetchResult.NewData;
} catch (error) {
console.error('后台任务执行失败:', error);
return BackgroundFetch.BackgroundFetchResult.Failed;
}
});
// 注册后台获取任务
try {
const status = await BackgroundFetch.getStatusAsync();
if (status === BackgroundFetch.BackgroundFetchStatus.Available) {
await BackgroundFetch.registerTaskAsync(BACKGROUND_FETCH_TASK, {
minimumInterval: 15 * 60, // 15分钟（以秒为单位）
stopOnTerminate: false,
startOnBoot: true,
});
console.log('后台获取任务注册成功');
// 检查后台任务状态
const status = await BackgroundTask.getStatusAsync();
console.log('后台任务服务状态:', BackgroundTask.BackgroundTaskStatus[status]);
if (status === BackgroundTask.BackgroundTaskStatus.Available) {
// 检查任务是否已经注册
const isRegistered = await TaskManager.isTaskRegisteredAsync(BACKGROUND_TASK_NAME);
console.log('系统任务是否已注册:', isRegistered);
if (!isRegistered) {
// 注册后台任务
await BackgroundTask.registerTaskAsync(BACKGROUND_TASK_NAME);
console.log('✅ 系统后台任务注册成功');
this.systemTaskRegistered = true;
} else {
console.log('✅ 系统后台任务已经注册，跳过重复注册');
this.systemTaskRegistered = true;
}
} else {
console.warn('后台获取不可用，状态:', status);
const statusText = Object.keys(BackgroundTask.BackgroundTaskStatus).find(
key => BackgroundTask.BackgroundTaskStatus[key as keyof typeof BackgroundTask.BackgroundTaskStatus] === status
);
console.warn('❌ 后台任务服务不可用，状态:', statusText || status);
console.warn('可能的原因:');
console.warn('- 设备省电模式开启');
console.warn('- 后台应用刷新被禁用');
console.warn('- 设备电量过低');
this.systemTaskRegistered = false;
}
} catch (error) {
console.error('注册后台获取任务失败:', error);
console.error('❌ 注册系统后台任务失败:', error);
this.systemTaskRegistered = false;
throw error;
}
}
// 注册自定义任务
public async registerTask(task: BackgroundTask): Promise<void> {
public async registerTask(task: BackgroundTaskConfig): Promise<void> {
try {
// 检查任务是否已存在
if (this.tasks.has(task.id)) {
@@ -165,10 +184,10 @@ class BackgroundTaskManager {
}
console.log(`开始执行任务: ${taskId}`);
// 执行任务
await task.handler(data);
// 更新任务状态
const status = this.taskStatuses.get(taskId);
if (status) {
@@ -181,14 +200,14 @@ class BackgroundTaskManager {
console.log(`任务 ${taskId} 执行成功`);
} catch (error) {
console.error(`执行任务 ${taskId} 失败:`, error);
// 更新错误状态
const status = this.taskStatuses.get(taskId);
if (status) {
status.lastError = error instanceof Error ? error.message : String(error);
await this.saveTaskStatuses();
}
throw error;
}
}
@@ -196,8 +215,8 @@ class BackgroundTaskManager {
// 执行所有任务
public async executeAllTasks(): Promise<{ [taskId: string]: 'success' | 'failed' }> {
const results: { [taskId: string]: 'success' | 'failed' } = {};
for (const [taskId, task] of this.tasks) {
for (const [taskId, task] of Array.from(this.tasks.entries())) {
try {
await this.executeTask(taskId);
results[taskId] = 'success';
@@ -206,7 +225,7 @@ class BackgroundTaskManager {
results[taskId] = 'failed';
}
}
return results;
}
@@ -221,13 +240,13 @@ class BackgroundTaskManager {
}
// 获取已注册的任务列表
public getRegisteredTasks(): BackgroundTask[] {
public getRegisteredTasks(): BackgroundTaskConfig[] {
return Array.from(this.tasks.values());
}
// 检查后台任务状态
public async getBackgroundTaskStatus(): Promise<BackgroundFetch.BackgroundFetchStatus | null> {
return await BackgroundFetch.getStatusAsync();
public async getBackgroundTaskStatus(): Promise<BackgroundTask.BackgroundTaskStatus> {
return await BackgroundTask.getStatusAsync();
}
// 保存任务状态到本地存储
@@ -259,50 +278,92 @@ class BackgroundTaskManager {
public async cleanupTaskStatuses(): Promise<void> {
const now = new Date();
const thirtyDaysAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
for (const [taskId, status] of this.taskStatuses) {
if (status.lastExecution && status.lastExecution < thirtyDaysAgo && !status.isRegistered) {
this.taskStatuses.delete(taskId);
}
}
await this.saveTaskStatuses();
}
// 调试函数：强制触发后台任务执行
// 手动触发后台任务（仅开发环境）
public async triggerTaskForTesting(): Promise<void> {
if (!__DEV__) {
console.warn('⚠️ triggerTaskForTesting 仅在开发环境可用');
return;
}
try {
console.log('🧪 触发后台任务进行测试...');
await BackgroundTask.triggerTaskWorkerForTestingAsync();
console.log('✅ 后台任务测试触发成功');
} catch (error) {
console.error('❌ 触发后台任务测试失败:', error);
}
}
// 调试函数：显示后台任务状态
public async debugExecuteBackgroundTask(): Promise<void> {
console.log('=== 调试：手动触发后台任务执行 ===');
console.log('===============================');
console.log('🔧 调试：后台任务状态检查');
console.log('===============================');
try {
// 获取后台任务状态
const status = await this.getBackgroundTaskStatus();
console.log('后台获取状态:', status);
// 执行所有注册的任务
console.log('当前注册的任务数量:', this.tasks.size);
const statusText = Object.keys(BackgroundTask.BackgroundTaskStatus).find(
key => BackgroundTask.BackgroundTaskStatus[key as keyof typeof BackgroundTask.BackgroundTaskStatus] === status
);
console.log('📊 后台任务服务状态:', statusText || status);
// 检查系统任务是否已注册
const isSystemTaskRegistered = await TaskManager.isTaskRegisteredAsync(BACKGROUND_TASK_NAME);
console.log('🔄 系统后台任务是否已注册:', isSystemTaskRegistered);
console.log('🔄 管理器中的系统任务状态:', this.systemTaskRegistered);
// 显示自定义任务信息
console.log('📝 当前注册的自定义任务数量:', this.tasks.size);
this.tasks.forEach((task, id) => {
console.log(`- 任务ID: ${id}, 名称: ${task.name}`);
console.log(` - 任务ID: ${id}, 名称: ${task.name}`);
});
if (this.tasks.size === 0) {
console.warn('⚠️ 没有注册的自定义任务');
}
// 手动执行所有任务
console.log('🚀 手动执行所有注册的任务...');
const results = await this.executeAllTasks();
console.log('任务执行结果:', results);
// 显示任务状态
console.log('✅ 任务执行结果:', results);
// 显示详细的任务状态
console.log('📈 任务执行统计:');
const taskStatuses = this.getAllTaskStatuses();
taskStatuses.forEach(status => {
console.log(`任务 ${status.id} 状态:`, {
isRegistered: status.isRegistered,
executionCount: status.executionCount,
lastExecution: status.lastExecution?.toISOString(),
lastError: status.lastError
taskStatuses.forEach(taskStatus => {
console.log(` 📊 任务 ${taskStatus.id}:`, {
注册状态: taskStatus.isRegistered ? '✅ 已注册' : '❌ 未注册',
执行次数: taskStatus.executionCount,
最后执行: taskStatus.lastExecution?.toLocaleString('zh-CN') || '从未执行',
最后错误: taskStatus.lastError || '无'
});
});
// 开发环境下触发测试
if (__DEV__) {
console.log('🧪 开发环境：触发后台任务测试...');
await this.triggerTaskForTesting();
}
console.log('===============================');
console.log('✅ 调试检查完成');
console.log('===============================');
} catch (error) {
console.error('调试执行失败:', error);
console.error('❌ 调试执行失败:', error);
console.log('===============================');
}
console.log('=== 调试执行完成 ===');
}
}
@@ -310,4 +371,4 @@ class BackgroundTaskManager {
export const backgroundTaskManager = BackgroundTaskManager.getInstance();
// 导出类型
export type { BackgroundTask as BackgroundTaskType, TaskStatus as TaskStatusType };
export type { BackgroundTaskConfig as BackgroundTaskType, TaskStatus as TaskStatusType };