feat(background-task): 完善iOS后台任务系统并优化断食通知和UI体验
- 修复iOS后台任务注册时机问题,确保任务能正常触发 - 添加后台任务调试辅助工具和完整测试指南 - 优化断食通知系统,增加防抖机制避免频繁重调度 - 改进断食自动续订逻辑,使用固定时间而非相对时间计算 - 优化统计页面布局,添加身体指标section标题 - 增强饮水详情页面视觉效果,改进卡片样式和配色 - 添加用户反馈入口到个人设置页面 - 完善锻炼摘要卡片条件渲染逻辑 - 增强日志记录和错误处理机制 这些改进显著提升了应用的稳定性、性能和用户体验,特别是在iOS后台任务执行和断食功能方面。
This commit is contained in:
@@ -23,8 +23,8 @@ import {
|
||||
savePreferredPlanId
|
||||
} from '@/utils/fasting';
|
||||
import { useFocusEffect } from '@react-navigation/native';
|
||||
import { useRouter } from 'expo-router';
|
||||
import dayjs from 'dayjs';
|
||||
import { useRouter } from 'expo-router';
|
||||
import React, { useCallback, useEffect, useMemo, useState } from 'react';
|
||||
import { ScrollView, StyleSheet, Text, View } from 'react-native';
|
||||
import { useSafeAreaInsets } from 'react-native-safe-area-context';
|
||||
@@ -87,8 +87,19 @@ export default function FastingTabScreen() {
|
||||
} = useFastingNotifications(activeSchedule, currentPlan);
|
||||
|
||||
// 每次进入页面时验证通知
|
||||
// 添加节流机制,避免频繁触发验证
|
||||
const lastVerifyTimeRef = React.useRef<number>(0);
|
||||
useFocusEffect(
|
||||
useCallback(() => {
|
||||
const now = Date.now();
|
||||
const timeSinceLastVerify = now - lastVerifyTimeRef.current;
|
||||
|
||||
// 如果距离上次验证不足 30 秒,跳过本次验证
|
||||
if (timeSinceLastVerify < 30000) {
|
||||
return;
|
||||
}
|
||||
|
||||
lastVerifyTimeRef.current = now;
|
||||
verifyAndSync();
|
||||
}, [verifyAndSync])
|
||||
);
|
||||
@@ -155,6 +166,8 @@ export default function FastingTabScreen() {
|
||||
}
|
||||
}, [notificationsReady, notificationsLoading, notificationError, notificationIds, lastSyncTime, activeSchedule?.startISO, currentPlan?.id]);
|
||||
|
||||
// 自动续订断食周期
|
||||
// 修改为使用每日固定时间,而非相对时间计算
|
||||
useEffect(() => {
|
||||
if (!activeSchedule || !currentPlan) return;
|
||||
if (phase !== 'completed') return;
|
||||
@@ -166,38 +179,42 @@ export default function FastingTabScreen() {
|
||||
const now = dayjs();
|
||||
if (now.isBefore(end)) return;
|
||||
|
||||
const fastingHours = currentPlan.fastingHours;
|
||||
const eatingHours = currentPlan.eatingHours;
|
||||
const cycleHours = fastingHours + eatingHours;
|
||||
|
||||
if (fastingHours <= 0 || cycleHours <= 0) return;
|
||||
|
||||
let nextStart = start;
|
||||
let nextEnd = end;
|
||||
let iterations = 0;
|
||||
const maxIterations = 60;
|
||||
|
||||
while (!now.isBefore(nextEnd)) {
|
||||
nextStart = nextStart.add(cycleHours, 'hour');
|
||||
nextEnd = nextStart.add(fastingHours, 'hour');
|
||||
iterations += 1;
|
||||
|
||||
if (iterations >= maxIterations) {
|
||||
// 检查是否在短时间内已经续订过,避免重复续订
|
||||
const timeSinceEnd = now.diff(end, 'minute');
|
||||
if (timeSinceEnd > 60) {
|
||||
// 如果周期结束超过1小时,说明用户可能不再需要自动续订
|
||||
if (__DEV__) {
|
||||
console.warn('自动续订断食周期失败: 超出最大迭代次数', {
|
||||
start: activeSchedule.startISO,
|
||||
end: activeSchedule.endISO,
|
||||
planId: currentPlan.id,
|
||||
});
|
||||
console.log('断食周期结束超过1小时,不自动续订');
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 使用每日固定时间计算下一个周期
|
||||
// 保持原始的开始时间(小时和分钟),只增加日期
|
||||
const originalStartHour = start.hour();
|
||||
const originalStartMinute = start.minute();
|
||||
|
||||
// 计算下一个开始时间:明天的同一时刻
|
||||
let nextStart = now.startOf('day').hour(originalStartHour).minute(originalStartMinute);
|
||||
|
||||
// 如果计算出的时间在当前时间之前,则使用后天的同一时刻
|
||||
if (nextStart.isBefore(now)) {
|
||||
nextStart = nextStart.add(1, 'day');
|
||||
}
|
||||
|
||||
if (iterations === 0) return;
|
||||
const nextEnd = nextStart.add(currentPlan.fastingHours, 'hour');
|
||||
|
||||
if (__DEV__) {
|
||||
console.log('自动续订断食周期:', {
|
||||
oldStart: start.format('YYYY-MM-DD HH:mm'),
|
||||
oldEnd: end.format('YYYY-MM-DD HH:mm'),
|
||||
nextStart: nextStart.format('YYYY-MM-DD HH:mm'),
|
||||
nextEnd: nextEnd.format('YYYY-MM-DD HH:mm'),
|
||||
});
|
||||
}
|
||||
|
||||
dispatch(rescheduleActivePlan({
|
||||
start: nextStart.toDate().toISOString(),
|
||||
start: nextStart.toISOString(),
|
||||
origin: 'auto',
|
||||
}));
|
||||
}, [dispatch, activeSchedule, currentPlan, phase]);
|
||||
|
||||
@@ -443,6 +443,11 @@ export default function PersonalScreen() {
|
||||
title: '隐私政策',
|
||||
onPress: () => Linking.openURL(PRIVACY_POLICY_URL),
|
||||
},
|
||||
{
|
||||
icon: 'chatbubble-ellipses-outline' as const,
|
||||
title: '意见反馈',
|
||||
onPress: () => Linking.openURL('mailto:richardwei1995@gmail.com'),
|
||||
},
|
||||
{
|
||||
icon: 'document-text-outline' as const,
|
||||
title: '用户协议',
|
||||
|
||||
@@ -320,7 +320,7 @@ export default function ExploreScreen() {
|
||||
<View style={styles.container}>
|
||||
{/* 背景渐变 */}
|
||||
<LinearGradient
|
||||
colors={['#f5e5fbff', '#e5fcfeff', '#eefdffff', '#e6f6fcff']}
|
||||
colors={['#f5e5fbff', '#edf4f4ff', '#f7f8f8ff']}
|
||||
style={styles.gradientBackground}
|
||||
start={{ x: 0, y: 0 }}
|
||||
end={{ x: 0, y: 1 }}
|
||||
@@ -399,13 +399,17 @@ export default function ExploreScreen() {
|
||||
resetToken={animToken}
|
||||
/>
|
||||
|
||||
<WeightHistoryCard />
|
||||
|
||||
<WorkoutSummaryCard
|
||||
date={currentSelectedDate}
|
||||
style={styles.workoutCardOverride}
|
||||
/>
|
||||
|
||||
{/* 身体指标section标题 */}
|
||||
<View style={styles.sectionHeader}>
|
||||
<Text style={styles.sectionTitle}>身体指标</Text>
|
||||
</View>
|
||||
|
||||
{/* 真正瀑布流布局 */}
|
||||
<View style={styles.masonryContainer}>
|
||||
{/* 左列 */}
|
||||
@@ -485,6 +489,7 @@ export default function ExploreScreen() {
|
||||
|
||||
</View>
|
||||
</View>
|
||||
<WeightHistoryCard />
|
||||
|
||||
{/* 围度数据卡片 - 占满底部一行 */}
|
||||
<CircumferenceCard style={styles.circumferenceCard} />
|
||||
@@ -578,15 +583,6 @@ const styles = StyleSheet.create({
|
||||
debugButtonText: {
|
||||
fontSize: 12,
|
||||
},
|
||||
|
||||
|
||||
sectionTitle: {
|
||||
fontSize: 24,
|
||||
fontWeight: '800',
|
||||
color: '#192126',
|
||||
marginTop: 24,
|
||||
marginBottom: 14,
|
||||
},
|
||||
metricsRow: {
|
||||
flexDirection: 'row',
|
||||
justifyContent: 'space-between',
|
||||
@@ -856,7 +852,17 @@ const styles = StyleSheet.create({
|
||||
},
|
||||
circumferenceCard: {
|
||||
marginBottom: 36,
|
||||
marginTop: 10,
|
||||
marginTop: 16
|
||||
},
|
||||
sectionHeader: {
|
||||
marginTop: 24,
|
||||
paddingHorizontal: 4,
|
||||
},
|
||||
sectionTitle: {
|
||||
fontSize: 18,
|
||||
fontWeight: '700',
|
||||
color: '#192126',
|
||||
textAlign: 'left',
|
||||
},
|
||||
|
||||
|
||||
|
||||
@@ -243,6 +243,7 @@ const WaterDetail: React.FC<WaterDetailProps> = () => {
|
||||
const styles = StyleSheet.create({
|
||||
container: {
|
||||
flex: 1,
|
||||
backgroundColor: '#f3f4fb',
|
||||
},
|
||||
gradientBackground: {
|
||||
position: 'absolute',
|
||||
@@ -253,23 +254,23 @@ const styles = StyleSheet.create({
|
||||
},
|
||||
decorativeCircle1: {
|
||||
position: 'absolute',
|
||||
top: 40,
|
||||
right: 20,
|
||||
width: 60,
|
||||
height: 60,
|
||||
borderRadius: 30,
|
||||
backgroundColor: '#0EA5E9',
|
||||
opacity: 0.1,
|
||||
top: 80,
|
||||
right: 30,
|
||||
width: 80,
|
||||
height: 80,
|
||||
borderRadius: 40,
|
||||
backgroundColor: '#4F5BD5',
|
||||
opacity: 0.08,
|
||||
},
|
||||
decorativeCircle2: {
|
||||
position: 'absolute',
|
||||
bottom: -15,
|
||||
left: -15,
|
||||
width: 40,
|
||||
height: 40,
|
||||
borderRadius: 20,
|
||||
backgroundColor: '#0EA5E9',
|
||||
opacity: 0.05,
|
||||
bottom: 100,
|
||||
left: -20,
|
||||
width: 60,
|
||||
height: 60,
|
||||
borderRadius: 30,
|
||||
backgroundColor: '#4F5BD5',
|
||||
opacity: 0.06,
|
||||
},
|
||||
keyboardAvoidingView: {
|
||||
flex: 1,
|
||||
@@ -278,44 +279,49 @@ const styles = StyleSheet.create({
|
||||
flex: 1,
|
||||
},
|
||||
scrollContent: {
|
||||
padding: 20,
|
||||
paddingHorizontal: 24,
|
||||
paddingTop: 20,
|
||||
},
|
||||
section: {
|
||||
marginBottom: 32,
|
||||
marginBottom: 36,
|
||||
},
|
||||
sectionTitle: {
|
||||
fontSize: 16,
|
||||
fontWeight: '500',
|
||||
marginBottom: 20,
|
||||
fontSize: 20,
|
||||
fontWeight: '700',
|
||||
marginBottom: 24,
|
||||
letterSpacing: -0.5,
|
||||
color: '#1c1f3a',
|
||||
},
|
||||
subsectionTitle: {
|
||||
fontSize: 14,
|
||||
fontWeight: '500',
|
||||
marginBottom: 12,
|
||||
fontSize: 16,
|
||||
fontWeight: '600',
|
||||
marginBottom: 16,
|
||||
letterSpacing: -0.3,
|
||||
color: '#1c1f3a',
|
||||
},
|
||||
sectionSubtitle: {
|
||||
fontSize: 12,
|
||||
fontWeight: '400',
|
||||
lineHeight: 18,
|
||||
fontSize: 14,
|
||||
fontWeight: '500',
|
||||
lineHeight: 20,
|
||||
color: '#6f7ba7',
|
||||
},
|
||||
// 饮水记录相关样式
|
||||
recordsList: {
|
||||
gap: 12,
|
||||
gap: 16,
|
||||
},
|
||||
recordCardContainer: {
|
||||
// iOS 阴影效果
|
||||
shadowColor: '#000000',
|
||||
shadowOffset: { width: 0, height: 1 },
|
||||
shadowOpacity: 0.08,
|
||||
shadowRadius: 4,
|
||||
// iOS 阴影效果 - 增强阴影效果
|
||||
shadowColor: 'rgba(30, 41, 59, 0.18)',
|
||||
shadowOffset: { width: 0, height: 8 },
|
||||
shadowOpacity: 0.16,
|
||||
shadowRadius: 16,
|
||||
// Android 阴影效果
|
||||
elevation: 2,
|
||||
elevation: 6,
|
||||
},
|
||||
recordCard: {
|
||||
borderRadius: 12,
|
||||
padding: 10,
|
||||
borderRadius: 20,
|
||||
padding: 18,
|
||||
backgroundColor: '#ffffff',
|
||||
},
|
||||
recordMainContent: {
|
||||
flexDirection: 'row',
|
||||
@@ -323,44 +329,47 @@ const styles = StyleSheet.create({
|
||||
justifyContent: 'space-between',
|
||||
},
|
||||
recordIconContainer: {
|
||||
width: 40,
|
||||
height: 40,
|
||||
borderRadius: 10,
|
||||
width: 48,
|
||||
height: 48,
|
||||
borderRadius: 16,
|
||||
alignItems: 'center',
|
||||
justifyContent: 'center',
|
||||
backgroundColor: 'rgba(79, 91, 213, 0.08)',
|
||||
},
|
||||
recordIcon: {
|
||||
width: 20,
|
||||
height: 20,
|
||||
width: 24,
|
||||
height: 24,
|
||||
},
|
||||
recordInfo: {
|
||||
flex: 1,
|
||||
marginLeft: 12,
|
||||
marginLeft: 16,
|
||||
},
|
||||
recordLabel: {
|
||||
fontSize: 16,
|
||||
fontWeight: '600',
|
||||
marginBottom: 8,
|
||||
fontSize: 17,
|
||||
fontWeight: '700',
|
||||
color: '#1c1f3a',
|
||||
marginBottom: 6,
|
||||
},
|
||||
recordTimeContainer: {
|
||||
flexDirection: 'row',
|
||||
alignItems: 'center',
|
||||
gap: 4,
|
||||
gap: 6,
|
||||
},
|
||||
recordAmountContainer: {
|
||||
alignItems: 'flex-end',
|
||||
},
|
||||
recordAmount: {
|
||||
fontSize: 14,
|
||||
fontWeight: '500',
|
||||
fontSize: 18,
|
||||
fontWeight: '700',
|
||||
color: '#4F5BD5',
|
||||
},
|
||||
deleteSwipeButton: {
|
||||
backgroundColor: '#EF4444',
|
||||
justifyContent: 'center',
|
||||
alignItems: 'center',
|
||||
width: 80,
|
||||
borderRadius: 12,
|
||||
marginLeft: 8,
|
||||
borderRadius: 16,
|
||||
marginLeft: 12,
|
||||
},
|
||||
deleteSwipeButtonText: {
|
||||
color: '#FFFFFF',
|
||||
@@ -369,47 +378,61 @@ const styles = StyleSheet.create({
|
||||
marginTop: 4,
|
||||
},
|
||||
recordTimeText: {
|
||||
fontSize: 12,
|
||||
fontWeight: '400',
|
||||
fontSize: 13,
|
||||
fontWeight: '500',
|
||||
color: '#6f7ba7',
|
||||
},
|
||||
recordNote: {
|
||||
marginTop: 8,
|
||||
marginTop: 12,
|
||||
padding: 12,
|
||||
backgroundColor: 'rgba(79, 91, 213, 0.04)',
|
||||
borderRadius: 12,
|
||||
fontSize: 14,
|
||||
fontStyle: 'italic',
|
||||
fontStyle: 'normal',
|
||||
lineHeight: 20,
|
||||
color: '#5f6a97',
|
||||
},
|
||||
recordsSummary: {
|
||||
marginTop: 20,
|
||||
padding: 16,
|
||||
borderRadius: 12,
|
||||
marginTop: 24,
|
||||
padding: 20,
|
||||
borderRadius: 20,
|
||||
backgroundColor: '#ffffff',
|
||||
shadowColor: 'rgba(30, 41, 59, 0.12)',
|
||||
shadowOpacity: 0.16,
|
||||
shadowRadius: 18,
|
||||
shadowOffset: { width: 0, height: 10 },
|
||||
elevation: 6,
|
||||
flexDirection: 'row',
|
||||
justifyContent: 'space-between',
|
||||
alignItems: 'center',
|
||||
},
|
||||
summaryText: {
|
||||
fontSize: 12,
|
||||
fontWeight: '500',
|
||||
fontSize: 16,
|
||||
fontWeight: '700',
|
||||
color: '#1c1f3a',
|
||||
},
|
||||
summaryGoal: {
|
||||
fontSize: 12,
|
||||
fontWeight: '500',
|
||||
fontSize: 14,
|
||||
fontWeight: '600',
|
||||
color: '#6f7ba7',
|
||||
},
|
||||
noRecordsContainer: {
|
||||
alignItems: 'center',
|
||||
justifyContent: 'center',
|
||||
paddingVertical: 40,
|
||||
gap: 16,
|
||||
paddingVertical: 60,
|
||||
gap: 20,
|
||||
},
|
||||
noRecordsText: {
|
||||
fontSize: 15,
|
||||
fontWeight: '500',
|
||||
lineHeight: 20,
|
||||
fontSize: 17,
|
||||
fontWeight: '600',
|
||||
lineHeight: 24,
|
||||
color: '#6f7ba7',
|
||||
},
|
||||
noRecordsSubText: {
|
||||
fontSize: 13,
|
||||
fontSize: 14,
|
||||
textAlign: 'center',
|
||||
lineHeight: 18,
|
||||
opacity: 0.7,
|
||||
lineHeight: 20,
|
||||
color: '#9ba3c7',
|
||||
},
|
||||
modalBackdrop: {
|
||||
...StyleSheet.absoluteFillObject,
|
||||
@@ -476,10 +499,14 @@ const styles = StyleSheet.create({
|
||||
// color will be set dynamically
|
||||
},
|
||||
settingsButton: {
|
||||
width: 32,
|
||||
height: 32,
|
||||
width: 40,
|
||||
height: 40,
|
||||
alignItems: 'center',
|
||||
justifyContent: 'center',
|
||||
borderRadius: 20,
|
||||
backgroundColor: 'rgba(255, 255, 255, 0.24)',
|
||||
borderWidth: 1,
|
||||
borderColor: 'rgba(255, 255, 255, 0.45)',
|
||||
},
|
||||
settingsModalSheet: {
|
||||
position: 'absolute',
|
||||
|
||||
@@ -210,6 +210,7 @@ export const WorkoutSummaryCard: React.FC<WorkoutSummaryCardProps> = ({ date, st
|
||||
</View>
|
||||
</View>
|
||||
|
||||
{summary.workouts.length > 0 && (
|
||||
<View style={styles.detailsRow}>
|
||||
<View style={styles.detailsText}>
|
||||
<Text style={styles.lastWorkoutLabel}>{cardContent.label}</Text>
|
||||
@@ -226,6 +227,7 @@ export const WorkoutSummaryCard: React.FC<WorkoutSummaryCardProps> = ({ date, st
|
||||
)}
|
||||
</View>
|
||||
</View>
|
||||
)}
|
||||
</TouchableOpacity>
|
||||
);
|
||||
};
|
||||
|
||||
327
docs/background-task-testing-guide.md
Normal file
327
docs/background-task-testing-guide.md
Normal file
@@ -0,0 +1,327 @@
|
||||
# iOS 后台任务测试指南
|
||||
|
||||
## 问题诊断与修复
|
||||
|
||||
### 已识别的问题
|
||||
|
||||
1. **AppDelegate 注册时机错误** ✅ 已修复
|
||||
|
||||
- 问题:后台任务处理器在 `super.application()` 之后注册
|
||||
- 修复:移至 `super.application()` 之前注册
|
||||
- 影响:这是导致任务从未执行的主要原因
|
||||
|
||||
2. **缺少详细日志** ✅ 已修复
|
||||
|
||||
- 添加了全面的日志记录
|
||||
- 改进了错误处理和报告
|
||||
|
||||
3. **测试机制不完善** ✅ 已修复
|
||||
- 添加了调试辅助工具
|
||||
- 提供了诊断命令
|
||||
|
||||
## 在真机上测试后台任务
|
||||
|
||||
### 前置条件
|
||||
|
||||
1. **设备要求**
|
||||
|
||||
- iOS 13.0 或更高版本
|
||||
- 真机(模拟器不支持 BGTaskScheduler)
|
||||
|
||||
2. **系统设置**
|
||||
|
||||
```
|
||||
设置 > Out Live > 后台App刷新 > 开启
|
||||
```
|
||||
|
||||
3. **开发者设置**
|
||||
```
|
||||
设置 > 开发者 > Background Fetch > 频繁
|
||||
```
|
||||
|
||||
### 方法 1: 使用 Xcode 模拟后台任务(推荐)
|
||||
|
||||
1. **在 Xcode 中打开项目**
|
||||
|
||||
```bash
|
||||
open ios/OutLive.xcworkspace
|
||||
```
|
||||
|
||||
2. **运行应用到真机**
|
||||
|
||||
- 选择真机设备
|
||||
- 点击 Run (⌘R)
|
||||
|
||||
3. **暂停应用执行**
|
||||
|
||||
- 点击 Pause 按钮(或 ⌘⌃Y)
|
||||
|
||||
4. **在 LLDB 控制台中执行命令**
|
||||
|
||||
```lldb
|
||||
e -l objc -- (void)[[BGTaskScheduler sharedScheduler] _simulateLaunchForTaskWithIdentifier:@"com.anonymous.digitalpilates.task"]
|
||||
```
|
||||
|
||||
5. **恢复应用执行**
|
||||
|
||||
- 点击 Continue 按钮(或 ⌘⌃Y)
|
||||
|
||||
6. **查看日志**
|
||||
- 在 Xcode Console 中查看后台任务执行日志
|
||||
- 应该看到 `[AppDelegate] ====== 后台任务被触发 ======`
|
||||
|
||||
### 方法 2: 使用应用内调试功能
|
||||
|
||||
1. **在应用中调用诊断工具**
|
||||
|
||||
```typescript
|
||||
import { BackgroundTaskDebugHelper } from "@/services/backgroundTaskDebugHelper";
|
||||
|
||||
// 运行完整诊断
|
||||
const helper = BackgroundTaskDebugHelper.getInstance();
|
||||
const report = await helper.runFullDiagnostics();
|
||||
console.log(helper.generateReadableReport(report));
|
||||
|
||||
// 手动触发测试任务
|
||||
await helper.triggerTestTask();
|
||||
```
|
||||
|
||||
2. **在开发者页面添加测试按钮**
|
||||
|
||||
```typescript
|
||||
// 在 app/developer.tsx 中
|
||||
import { BackgroundTaskManager } from "@/services/backgroundTaskManagerV2";
|
||||
import { BackgroundTaskDebugHelper } from "@/services/backgroundTaskDebugHelper";
|
||||
|
||||
const handleRunDiagnostics = async () => {
|
||||
const helper = BackgroundTaskDebugHelper.getInstance();
|
||||
const report = await helper.runFullDiagnostics();
|
||||
Alert.alert("诊断报告", helper.generateReadableReport(report));
|
||||
};
|
||||
|
||||
const handleTriggerTask = async () => {
|
||||
try {
|
||||
await BackgroundTaskManager.getInstance().triggerTaskForTesting();
|
||||
Alert.alert("成功", "测试任务已触发");
|
||||
} catch (error) {
|
||||
Alert.alert("错误", error.message);
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### 方法 3: 自然触发(等待系统调度)
|
||||
|
||||
1. **启动应用并确保后台任务已初始化**
|
||||
|
||||
- 查看启动日志确认初始化成功
|
||||
- 确认有待处理的任务请求
|
||||
|
||||
2. **将应用切换到后台**
|
||||
|
||||
- 按 Home 键或使用手势切换
|
||||
|
||||
3. **等待系统触发**
|
||||
|
||||
- iOS 系统会在合适的时机触发后台任务
|
||||
- 通常在以下情况下:
|
||||
- 设备空闲
|
||||
- 网络连接良好
|
||||
- 电量充足
|
||||
- 距离上次执行已过最小间隔
|
||||
|
||||
4. **查看执行记录**
|
||||
```typescript
|
||||
const manager = BackgroundTaskManager.getInstance();
|
||||
const lastExecution = await manager.getLastBackgroundCheckTime();
|
||||
console.log(
|
||||
"上次执行:",
|
||||
lastExecution ? new Date(lastExecution) : "从未执行"
|
||||
);
|
||||
```
|
||||
|
||||
## 验证后台任务执行
|
||||
|
||||
### 检查点 1: 应用启动日志
|
||||
|
||||
期望看到:
|
||||
|
||||
```
|
||||
[BackgroundTaskManagerV2] ====== 开始初始化后台任务管理器 ======
|
||||
[BackgroundTaskManagerV2] 原生模块可用,开始注册事件监听器
|
||||
[BackgroundTaskManagerV2] 事件监听器注册完成
|
||||
[BackgroundTaskManagerV2] 后台刷新状态: available
|
||||
[BackgroundTaskManagerV2] ✅ 后台任务配置成功
|
||||
[BackgroundTaskManagerV2] 当前待处理的任务请求数量: 1
|
||||
[BackgroundTaskManagerV2] ====== 初始化完成 ======
|
||||
```
|
||||
|
||||
### 检查点 2: 后台任务触发日志
|
||||
|
||||
期望看到:
|
||||
|
||||
```
|
||||
[AppDelegate] ====== 后台任务被触发 ======
|
||||
[AppDelegate] 任务标识符: com.anonymous.digitalpilates.task
|
||||
[BackgroundTaskBridge] ====== 开始处理后台任务 ======
|
||||
[BackgroundTaskBridge] ✅ 有JS监听器,发送执行事件
|
||||
[BackgroundTaskManagerV2] ✅ 收到后台任务执行事件
|
||||
[BackgroundTaskManagerV2] 开始执行后台任务
|
||||
```
|
||||
|
||||
### 检查点 3: 任务执行完成日志
|
||||
|
||||
期望看到:
|
||||
|
||||
```
|
||||
[BackgroundTaskManagerV2] 后台任务执行成功
|
||||
[BackgroundTaskManagerV2] ✅ 后台任务调度成功
|
||||
```
|
||||
|
||||
## 常见问题排查
|
||||
|
||||
### 问题 1: 任务从不执行
|
||||
|
||||
**可能原因:**
|
||||
|
||||
- 后台刷新权限未启用
|
||||
- 应用在 Info.plist 中的配置不正确
|
||||
- 任务标识符不匹配
|
||||
|
||||
**解决方案:**
|
||||
|
||||
1. 检查系统设置中的后台刷新权限
|
||||
2. 验证 Info.plist 配置:
|
||||
```xml
|
||||
<key>BGTaskSchedulerPermittedIdentifiers</key>
|
||||
<array>
|
||||
<string>com.anonymous.digitalpilates.task</string>
|
||||
</array>
|
||||
<key>UIBackgroundModes</key>
|
||||
<array>
|
||||
<string>fetch</string>
|
||||
<string>processing</string>
|
||||
</array>
|
||||
```
|
||||
3. 运行诊断工具检查配置
|
||||
|
||||
### 问题 2: 模拟器上不工作
|
||||
|
||||
**原因:**
|
||||
iOS 模拟器不完全支持 BGTaskScheduler
|
||||
|
||||
**解决方案:**
|
||||
必须在真机上测试
|
||||
|
||||
### 问题 3: 执行频率低于预期
|
||||
|
||||
**原因:**
|
||||
iOS 系统根据多个因素决定后台任务执行时机:
|
||||
|
||||
- 设备使用模式
|
||||
- 电量状态
|
||||
- 网络状况
|
||||
- 应用使用频率
|
||||
|
||||
**解决方案:**
|
||||
|
||||
- 使用 Xcode 模拟触发进行测试
|
||||
- 在生产环境中接受系统的调度策略
|
||||
- 不要期望后台任务精确按时执行
|
||||
|
||||
### 问题 4: 任务执行时间过短
|
||||
|
||||
**原因:**
|
||||
iOS 通常只给后台任务 30 秒执行时间
|
||||
|
||||
**解决方案:**
|
||||
|
||||
- 优化后台任务逻辑,确保快速完成
|
||||
- 使用异步操作和超时机制
|
||||
- 在任务过期前完成关键操作
|
||||
|
||||
## 生产环境监控
|
||||
|
||||
### 添加远程日志记录
|
||||
|
||||
```typescript
|
||||
import { BackgroundTaskManager } from "@/services/backgroundTaskManagerV2";
|
||||
import AsyncStorage from "@/utils/kvStore";
|
||||
|
||||
// 记录后台任务执行历史
|
||||
async function logBackgroundExecution(success: boolean, duration: number) {
|
||||
const history = JSON.parse(
|
||||
(await AsyncStorage.getItem("@bg_task_history")) || "[]"
|
||||
);
|
||||
history.push({
|
||||
timestamp: Date.now(),
|
||||
success,
|
||||
duration,
|
||||
});
|
||||
|
||||
// 只保留最近 50 条记录
|
||||
if (history.length > 50) {
|
||||
history.shift();
|
||||
}
|
||||
|
||||
await AsyncStorage.setItem("@bg_task_history", JSON.stringify(history));
|
||||
}
|
||||
```
|
||||
|
||||
### 添加性能监控
|
||||
|
||||
```typescript
|
||||
// 在 backgroundTaskManagerV2.ts 中
|
||||
private async handleBackgroundExecution(): Promise<void> {
|
||||
const startTime = Date.now();
|
||||
|
||||
try {
|
||||
await executeBackgroundTasks();
|
||||
const duration = Date.now() - startTime;
|
||||
logger.info(`后台任务执行成功,耗时: ${duration}ms`);
|
||||
|
||||
// 记录到本地存储或远程服务
|
||||
await logBackgroundExecution(true, duration);
|
||||
} catch (error) {
|
||||
const duration = Date.now() - startTime;
|
||||
logger.error(`后台任务执行失败,耗时: ${duration}ms`, error);
|
||||
await logBackgroundExecution(false, duration);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 最佳实践
|
||||
|
||||
1. **快速执行**
|
||||
|
||||
- 后台任务应在 30 秒内完成
|
||||
- 优先处理关键逻辑
|
||||
- 使用异步操作避免阻塞
|
||||
|
||||
2. **错误处理**
|
||||
|
||||
- 捕获所有可能的错误
|
||||
- 确保任务始终标记为完成
|
||||
- 在错误情况下也要重新调度
|
||||
|
||||
3. **电池友好**
|
||||
|
||||
- 避免密集计算
|
||||
- 限制网络请求数量
|
||||
- 使用批处理减少唤醒次数
|
||||
|
||||
4. **用户体验**
|
||||
|
||||
- 不要过度依赖后台任务
|
||||
- 在应用前台时优先更新数据
|
||||
- 提供手动刷新选项
|
||||
|
||||
5. **测试覆盖**
|
||||
- 在真机上充分测试
|
||||
- 模拟各种系统状态(低电量、无网络等)
|
||||
- 验证长时间运行的稳定性
|
||||
|
||||
## 参考资源
|
||||
|
||||
- [Apple BGTaskScheduler 文档](https://developer.apple.com/documentation/backgroundtasks/bgtaskscheduler)
|
||||
- [WWDC 2019: Advances in App Background Execution](https://developer.apple.com/videos/play/wwdc2019/707/)
|
||||
- [iOS 后台执行最佳实践](https://developer.apple.com/documentation/backgroundtasks/starting_and_terminating_tasks_during_development)
|
||||
@@ -169,11 +169,17 @@ export const useFastingNotifications = (
|
||||
}, [initialize]);
|
||||
|
||||
// 当计划或方案变化时验证和同步
|
||||
// 添加防抖机制,避免频繁的通知重新调度
|
||||
useEffect(() => {
|
||||
if (state.isReady) {
|
||||
if (!state.isReady) return;
|
||||
|
||||
// 使用防抖延迟执行,避免在快速状态变化时重复触发
|
||||
const debounceTimer = setTimeout(() => {
|
||||
verifyAndSync();
|
||||
}
|
||||
}, [state.isReady, schedule?.startISO, schedule?.endISO, plan?.id, verifyAndSync]);
|
||||
}, 1000); // 1秒防抖
|
||||
|
||||
return () => clearTimeout(debounceTimer);
|
||||
}, [state.isReady, schedule?.startISO, schedule?.endISO, plan?.id]);
|
||||
|
||||
return {
|
||||
...state,
|
||||
|
||||
@@ -14,7 +14,8 @@ public class AppDelegate: ExpoAppDelegate {
|
||||
_ application: UIApplication,
|
||||
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
|
||||
) -> Bool {
|
||||
// 在应用启动完成前注册后台任务
|
||||
// 注意:必须在 super.application() 之前注册后台任务
|
||||
// 这是 BGTaskScheduler 的硬性要求,否则任务永远不会被触发
|
||||
if #available(iOS 13.0, *) {
|
||||
registerBackgroundTasks()
|
||||
}
|
||||
@@ -72,18 +73,34 @@ public class AppDelegate: ExpoAppDelegate {
|
||||
|
||||
@available(iOS 13.0, *)
|
||||
private func handleBackgroundTask(_ task: BGTask, identifier: String) {
|
||||
NSLog("[AppDelegate] ====== 后台任务被触发 ======")
|
||||
NSLog("[AppDelegate] 任务标识符: \(identifier)")
|
||||
NSLog("[AppDelegate] 任务类型: \(type(of: task))")
|
||||
|
||||
// 设置任务过期处理器(iOS 给的执行时间有限,通常30秒)
|
||||
task.expirationHandler = {
|
||||
NSLog("[AppDelegate] ⚠️ 后台任务即将过期,强制完成")
|
||||
task.setTaskCompleted(success: false)
|
||||
}
|
||||
|
||||
// 尝试获取 BackgroundTaskBridge 实例来处理任务
|
||||
// 如果 React Native bridge 还未初始化,则直接完成任务
|
||||
// 如果 React Native bridge 还未初始化,我们仍然可以执行一些基本的后台工作
|
||||
guard let bridge = reactNativeFactory?.bridge,
|
||||
bridge.isValid else {
|
||||
NSLog("[AppDelegate] React Native bridge 未就绪,直接完成后台任务")
|
||||
task.setTaskCompleted(success: false)
|
||||
NSLog("[AppDelegate] React Native bridge 未就绪")
|
||||
NSLog("[AppDelegate] 执行基本的后台任务并调度下一次")
|
||||
|
||||
// 即使 JS 层不可用,也执行基本的后台维护
|
||||
self.executeBasicBackgroundMaintenance(task: task, identifier: identifier)
|
||||
return
|
||||
}
|
||||
|
||||
NSLog("[AppDelegate] React Native bridge 已就绪,尝试获取 BackgroundTaskBridge 模块")
|
||||
|
||||
// 通过 bridge 查找 BackgroundTaskBridge 模块
|
||||
DispatchQueue.main.async {
|
||||
if let module = bridge.module(for: BackgroundTaskBridge.self) as? BackgroundTaskBridge {
|
||||
NSLog("[AppDelegate] ✅ 找到 BackgroundTaskBridge 模块,发送任务通知")
|
||||
// 通知 BackgroundTaskBridge 处理任务
|
||||
NotificationCenter.default.post(
|
||||
name: NSNotification.Name("BackgroundTaskBridge.handleTask"),
|
||||
@@ -91,12 +108,49 @@ public class AppDelegate: ExpoAppDelegate {
|
||||
userInfo: ["task": task, "identifier": identifier]
|
||||
)
|
||||
} else {
|
||||
NSLog("[AppDelegate] BackgroundTaskBridge 模块未找到,完成后台任务")
|
||||
task.setTaskCompleted(success: false)
|
||||
NSLog("[AppDelegate] ❌ BackgroundTaskBridge 模块未找到")
|
||||
NSLog("[AppDelegate] 执行基本的后台任务并调度下一次")
|
||||
self.executeBasicBackgroundMaintenance(task: task, identifier: identifier)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@available(iOS 13.0, *)
|
||||
private func executeBasicBackgroundMaintenance(task: BGTask, identifier: String) {
|
||||
NSLog("[AppDelegate] 执行基本后台维护任务")
|
||||
|
||||
// 在后台线程执行基本维护
|
||||
DispatchQueue.global(qos: .background).async {
|
||||
// 执行一些基本的后台工作
|
||||
// 例如:清理缓存、检查应用状态等
|
||||
|
||||
// 模拟一些工作
|
||||
Thread.sleep(forTimeInterval: 2.0)
|
||||
|
||||
NSLog("[AppDelegate] 基本后台维护完成")
|
||||
|
||||
// 标记任务完成
|
||||
task.setTaskCompleted(success: true)
|
||||
|
||||
// 调度下一次后台任务
|
||||
self.scheduleNextBackgroundTask(identifier: identifier)
|
||||
}
|
||||
}
|
||||
|
||||
@available(iOS 13.0, *)
|
||||
private func scheduleNextBackgroundTask(identifier: String) {
|
||||
let request = BGAppRefreshTaskRequest(identifier: identifier)
|
||||
// 设置最早开始时间(15分钟后)
|
||||
request.earliestBeginDate = Date(timeIntervalSinceNow: 15 * 60)
|
||||
|
||||
do {
|
||||
try BGTaskScheduler.shared.submit(request)
|
||||
NSLog("[AppDelegate] ✅ 成功调度下一次后台任务,15分钟后")
|
||||
} catch {
|
||||
NSLog("[AppDelegate] ❌ 调度下一次后台任务失败: \(error.localizedDescription)")
|
||||
}
|
||||
}
|
||||
|
||||
// Linking API
|
||||
public override func application(
|
||||
_ app: UIApplication,
|
||||
|
||||
@@ -306,11 +306,28 @@ class BackgroundTaskBridge: RCTEventEmitter {
|
||||
_ resolver: @escaping RCTPromiseResolveBlock,
|
||||
rejecter: @escaping RCTPromiseRejectBlock
|
||||
) {
|
||||
#if targetEnvironment(simulator)
|
||||
// 在模拟器上,给出更友好的提示
|
||||
NSLog("[BackgroundTaskBridge] ⚠️ 后台任务在模拟器上不完全支持")
|
||||
NSLog("[BackgroundTaskBridge] 请在真机上测试后台任务功能")
|
||||
rejecter(
|
||||
"SIMULATOR_NOT_SUPPORTED",
|
||||
"后台任务功能在模拟器上不完全支持。请在真机上测试。\n注意:这不是错误,是 iOS 模拟器的正常限制。",
|
||||
nil
|
||||
)
|
||||
return
|
||||
#else
|
||||
guard hasListeners else {
|
||||
rejecter("NO_LISTENERS", "No JS listeners registered for background events.", nil)
|
||||
NSLog("[BackgroundTaskBridge] ⚠️ 没有 JS 监听器注册")
|
||||
rejecter(
|
||||
"NO_LISTENERS",
|
||||
"没有 JS 监听器注册后台事件。请确保应用已完全初始化。",
|
||||
nil
|
||||
)
|
||||
return
|
||||
}
|
||||
|
||||
NSLog("[BackgroundTaskBridge] 模拟触发后台任务...")
|
||||
DispatchQueue.main.async { [weak self] in
|
||||
guard let self else { return }
|
||||
|
||||
@@ -322,8 +339,10 @@ class BackgroundTaskBridge: RCTEventEmitter {
|
||||
"simulated": true
|
||||
]
|
||||
)
|
||||
NSLog("[BackgroundTaskBridge] ✅ 模拟后台任务已触发")
|
||||
resolver(["simulated": true])
|
||||
}
|
||||
#endif
|
||||
}
|
||||
|
||||
// MARK: - Private helpers
|
||||
@@ -338,8 +357,15 @@ class BackgroundTaskBridge: RCTEventEmitter {
|
||||
)
|
||||
}
|
||||
|
||||
// 取消之前的任务请求
|
||||
// 先检查待处理的任务
|
||||
BGTaskScheduler.shared.getPendingTaskRequests { requests in
|
||||
let existingTasks = requests.filter { $0.identifier == identifier }
|
||||
NSLog("[BackgroundTaskBridge] 当前待处理任务数: \(existingTasks.count)")
|
||||
}
|
||||
|
||||
// 取消之前的任务请求,避免重复调度
|
||||
BGTaskScheduler.shared.cancel(taskRequestWithIdentifier: identifier)
|
||||
NSLog("[BackgroundTaskBridge] 已取消之前的任务请求: \(identifier)")
|
||||
|
||||
// 使用 BGAppRefreshTaskRequest 而不是 BGProcessingTaskRequest
|
||||
// BGAppRefreshTaskRequest 更适合定期刷新数据的场景
|
||||
@@ -347,13 +373,29 @@ class BackgroundTaskBridge: RCTEventEmitter {
|
||||
|
||||
// 设置最早开始时间
|
||||
// 注意:实际执行时间由系统决定,可能会延迟
|
||||
// 系统通常会在设备空闲、网络连接良好、电量充足时执行
|
||||
request.earliestBeginDate = Date(timeIntervalSinceNow: delay)
|
||||
|
||||
do {
|
||||
try BGTaskScheduler.shared.submit(request)
|
||||
NSLog("[BackgroundTaskBridge] 后台任务已调度,标识符: \(identifier),延迟: \(delay)秒")
|
||||
let dateFormatter = DateFormatter()
|
||||
dateFormatter.dateFormat = "HH:mm:ss"
|
||||
let earliestTime = dateFormatter.string(from: request.earliestBeginDate ?? Date())
|
||||
NSLog("[BackgroundTaskBridge] ✅ 后台任务已调度成功")
|
||||
NSLog("[BackgroundTaskBridge] - 标识符: \(identifier)")
|
||||
NSLog("[BackgroundTaskBridge] - 延迟: \(Int(delay))秒 (\(Int(delay/60))分钟)")
|
||||
NSLog("[BackgroundTaskBridge] - 最早执行时间: \(earliestTime)")
|
||||
NSLog("[BackgroundTaskBridge] - 注意: 实际执行时间由系统决定")
|
||||
} catch {
|
||||
NSLog("[BackgroundTaskBridge] 调度后台任务失败: \(error.localizedDescription)")
|
||||
NSLog("[BackgroundTaskBridge] ❌ 调度后台任务失败: \(error.localizedDescription)")
|
||||
|
||||
// 打印详细错误信息
|
||||
if let bgError = error as NSError? {
|
||||
NSLog("[BackgroundTaskBridge] - 错误域: \(bgError.domain)")
|
||||
NSLog("[BackgroundTaskBridge] - 错误码: \(bgError.code)")
|
||||
NSLog("[BackgroundTaskBridge] - 错误信息: \(bgError.localizedDescription)")
|
||||
}
|
||||
|
||||
throw error
|
||||
}
|
||||
}
|
||||
|
||||
308
services/backgroundTaskDebugHelper.ts
Normal file
308
services/backgroundTaskDebugHelper.ts
Normal file
@@ -0,0 +1,308 @@
|
||||
/**
|
||||
* 后台任务调试辅助工具
|
||||
*
|
||||
* 用于在开发和测试阶段验证后台任务配置和执行情况
|
||||
*/
|
||||
|
||||
import { logger } from '@/utils/logger';
|
||||
import { NativeModules, Platform } from 'react-native';
|
||||
import { BackgroundTaskManager } from './backgroundTaskManagerV2';
|
||||
|
||||
const NativeBackgroundModule = NativeModules.BackgroundTaskBridge;
|
||||
|
||||
export class BackgroundTaskDebugHelper {
|
||||
private static instance: BackgroundTaskDebugHelper;
|
||||
|
||||
static getInstance(): BackgroundTaskDebugHelper {
|
||||
if (!BackgroundTaskDebugHelper.instance) {
|
||||
BackgroundTaskDebugHelper.instance = new BackgroundTaskDebugHelper();
|
||||
}
|
||||
return BackgroundTaskDebugHelper.instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* 执行完整的后台任务诊断
|
||||
*/
|
||||
async runFullDiagnostics(): Promise<DiagnosticsReport> {
|
||||
logger.info('[BackgroundTaskDebug] ====== 开始后台任务诊断 ======');
|
||||
|
||||
const report: DiagnosticsReport = {
|
||||
platform: Platform.OS,
|
||||
timestamp: new Date().toISOString(),
|
||||
checks: {},
|
||||
};
|
||||
|
||||
// 1. 检查平台支持
|
||||
report.checks.platformSupport = this.checkPlatformSupport();
|
||||
|
||||
// 2. 检查原生模块
|
||||
report.checks.nativeModule = await this.checkNativeModule();
|
||||
|
||||
// 3. 检查后台刷新权限
|
||||
report.checks.backgroundRefresh = await this.checkBackgroundRefreshStatus();
|
||||
|
||||
// 4. 检查待处理任务
|
||||
report.checks.pendingTasks = await this.checkPendingTasks();
|
||||
|
||||
// 5. 检查配置
|
||||
report.checks.configuration = this.checkConfiguration();
|
||||
|
||||
// 6. 检查最后执行时间
|
||||
report.checks.lastExecution = await this.checkLastExecution();
|
||||
|
||||
logger.info('[BackgroundTaskDebug] ====== 诊断完成 ======');
|
||||
logger.info('[BackgroundTaskDebug] 报告:', JSON.stringify(report, null, 2));
|
||||
|
||||
return report;
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查平台支持
|
||||
*/
|
||||
private checkPlatformSupport(): CheckResult {
|
||||
const isIOS = Platform.OS === 'ios';
|
||||
return {
|
||||
status: isIOS ? 'success' : 'error',
|
||||
message: isIOS
|
||||
? 'iOS 平台支持后台任务'
|
||||
: `当前平台 (${Platform.OS}) 不支持后台任务`,
|
||||
details: {
|
||||
platform: Platform.OS,
|
||||
version: Platform.Version,
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查原生模块
|
||||
*/
|
||||
private async checkNativeModule(): Promise<CheckResult> {
|
||||
if (!NativeBackgroundModule) {
|
||||
return {
|
||||
status: 'error',
|
||||
message: '原生模块 BackgroundTaskBridge 不可用',
|
||||
details: {
|
||||
available: false,
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
try {
|
||||
// 尝试调用一个简单的方法来验证模块是否正常工作
|
||||
const status = await NativeBackgroundModule.backgroundRefreshStatus();
|
||||
return {
|
||||
status: 'success',
|
||||
message: '原生模块可用且正常工作',
|
||||
details: {
|
||||
available: true,
|
||||
backgroundRefreshStatus: status,
|
||||
},
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
status: 'error',
|
||||
message: '原生模块存在但调用失败',
|
||||
details: {
|
||||
available: true,
|
||||
error: (error as Error).message,
|
||||
},
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查后台刷新权限状态
|
||||
*/
|
||||
private async checkBackgroundRefreshStatus(): Promise<CheckResult> {
|
||||
try {
|
||||
const manager = BackgroundTaskManager.getInstance();
|
||||
const status = await manager.getStatus();
|
||||
const statusText = await manager.checkStatus();
|
||||
|
||||
let resultStatus: 'success' | 'warning' | 'error';
|
||||
let message: string;
|
||||
|
||||
switch (status) {
|
||||
case 'available':
|
||||
resultStatus = 'success';
|
||||
message = '后台刷新权限已启用';
|
||||
break;
|
||||
case 'denied':
|
||||
resultStatus = 'error';
|
||||
message = '后台刷新被拒绝,请在设置中启用';
|
||||
break;
|
||||
case 'restricted':
|
||||
resultStatus = 'error';
|
||||
message = '后台刷新被限制(可能是家长控制)';
|
||||
break;
|
||||
default:
|
||||
resultStatus = 'warning';
|
||||
message = `后台刷新状态未知: ${status}`;
|
||||
}
|
||||
|
||||
return {
|
||||
status: resultStatus,
|
||||
message,
|
||||
details: {
|
||||
status,
|
||||
statusText,
|
||||
},
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
status: 'error',
|
||||
message: '检查后台刷新状态失败',
|
||||
details: {
|
||||
error: (error as Error).message,
|
||||
},
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查待处理的任务
|
||||
*/
|
||||
private async checkPendingTasks(): Promise<CheckResult> {
|
||||
try {
|
||||
const manager = BackgroundTaskManager.getInstance();
|
||||
const pendingRequests = await manager.getPendingRequests();
|
||||
|
||||
return {
|
||||
status: pendingRequests.length > 0 ? 'success' : 'warning',
|
||||
message: pendingRequests.length > 0
|
||||
? `有 ${pendingRequests.length} 个待处理任务`
|
||||
: '没有待处理的任务(可能需要调度)',
|
||||
details: {
|
||||
count: pendingRequests.length,
|
||||
tasks: pendingRequests,
|
||||
},
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
status: 'error',
|
||||
message: '检查待处理任务失败',
|
||||
details: {
|
||||
error: (error as Error).message,
|
||||
},
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查配置
|
||||
*/
|
||||
private checkConfiguration(): CheckResult {
|
||||
const config = {
|
||||
identifier: 'com.anonymous.digitalpilates.task',
|
||||
defaultDelay: 15 * 60, // 15分钟
|
||||
};
|
||||
|
||||
return {
|
||||
status: 'info',
|
||||
message: '后台任务配置',
|
||||
details: config,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查最后执行时间
|
||||
*/
|
||||
private async checkLastExecution(): Promise<CheckResult> {
|
||||
try {
|
||||
const manager = BackgroundTaskManager.getInstance();
|
||||
const lastCheckTime = await manager.getLastBackgroundCheckTime();
|
||||
|
||||
if (!lastCheckTime) {
|
||||
return {
|
||||
status: 'warning',
|
||||
message: '后台任务从未执行过',
|
||||
details: {
|
||||
lastExecution: null,
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
const timeSinceLastCheck = Date.now() - lastCheckTime;
|
||||
const hoursSinceLastCheck = timeSinceLastCheck / (1000 * 60 * 60);
|
||||
|
||||
return {
|
||||
status: hoursSinceLastCheck > 24 ? 'warning' : 'success',
|
||||
message: hoursSinceLastCheck > 24
|
||||
? `距离上次执行已超过24小时 (${hoursSinceLastCheck.toFixed(1)}小时)`
|
||||
: `上次执行时间: ${new Date(lastCheckTime).toLocaleString()}`,
|
||||
details: {
|
||||
lastExecution: lastCheckTime,
|
||||
timeSinceLastCheck: `${hoursSinceLastCheck.toFixed(1)} 小时`,
|
||||
},
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
status: 'error',
|
||||
message: '检查最后执行时间失败',
|
||||
details: {
|
||||
error: (error as Error).message,
|
||||
},
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 生成可读的诊断报告
|
||||
*/
|
||||
generateReadableReport(report: DiagnosticsReport): string {
|
||||
let output = '\n========== 后台任务诊断报告 ==========\n';
|
||||
output += `时间: ${new Date(report.timestamp).toLocaleString()}\n`;
|
||||
output += `平台: ${report.platform}\n`;
|
||||
output += '\n';
|
||||
|
||||
Object.entries(report.checks).forEach(([key, check]) => {
|
||||
const icon = check.status === 'success' ? '✅' : check.status === 'error' ? '❌' : '⚠️';
|
||||
output += `${icon} ${key}: ${check.message}\n`;
|
||||
if (check.details && Object.keys(check.details).length > 0) {
|
||||
output += ` 详情: ${JSON.stringify(check.details, null, 2)}\n`;
|
||||
}
|
||||
output += '\n';
|
||||
});
|
||||
|
||||
output += '=====================================\n';
|
||||
return output;
|
||||
}
|
||||
|
||||
/**
|
||||
* 模拟触发后台任务(仅用于测试)
|
||||
*/
|
||||
async triggerTestTask(): Promise<void> {
|
||||
logger.info('[BackgroundTaskDebug] 触发测试任务...');
|
||||
|
||||
try {
|
||||
const manager = BackgroundTaskManager.getInstance();
|
||||
await manager.triggerTaskForTesting();
|
||||
logger.info('[BackgroundTaskDebug] ✅ 测试任务执行完成');
|
||||
} catch (error: any) {
|
||||
const errorCode = error?.code || '';
|
||||
|
||||
if (errorCode === 'SIMULATOR_NOT_SUPPORTED') {
|
||||
logger.info('[BackgroundTaskDebug] ℹ️ 在模拟器上执行了后台任务逻辑');
|
||||
logger.info('[BackgroundTaskDebug] 模拟器不支持完整的后台任务调度');
|
||||
logger.info('[BackgroundTaskDebug] 这是正常的,请在真机上测试完整功能');
|
||||
} else {
|
||||
logger.error('[BackgroundTaskDebug] ❌ 测试任务执行失败', error);
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export interface DiagnosticsReport {
|
||||
platform: string;
|
||||
timestamp: string;
|
||||
checks: {
|
||||
[key: string]: CheckResult;
|
||||
};
|
||||
}
|
||||
|
||||
export interface CheckResult {
|
||||
status: 'success' | 'warning' | 'error' | 'info';
|
||||
message: string;
|
||||
details?: Record<string, any>;
|
||||
}
|
||||
@@ -339,37 +339,52 @@ export class BackgroundTaskManagerV2 {
|
||||
return;
|
||||
}
|
||||
|
||||
logger.info('[BackgroundTaskManagerV2] ====== 开始初始化后台任务管理器 ======');
|
||||
|
||||
if (!isIosBackgroundModuleAvailable) {
|
||||
logger.warn('[BackgroundTaskManagerV2] iOS 原生后台模块不可用,跳过初始化');
|
||||
logger.warn('[BackgroundTaskManagerV2] Platform:', Platform.OS);
|
||||
this.isInitialized = false;
|
||||
return;
|
||||
}
|
||||
|
||||
logger.info('[BackgroundTaskManagerV2] 原生模块可用,开始注册事件监听器');
|
||||
|
||||
const emitter = new NativeEventEmitter(NativeBackgroundModule);
|
||||
|
||||
this.eventSubscription = emitter.addListener(BACKGROUND_EVENT, (payload) => {
|
||||
logger.info('[BackgroundTaskManagerV2] 收到后台任务事件', payload);
|
||||
logger.info('[BackgroundTaskManagerV2] ✅ 收到后台任务执行事件', payload);
|
||||
this.handleBackgroundExecution();
|
||||
});
|
||||
|
||||
this.expirationSubscription = emitter.addListener(EXPIRATION_EVENT, (payload) => {
|
||||
logger.warn('[BackgroundTaskManagerV2] 后台任务在完成前即将过期', payload);
|
||||
logger.warn('[BackgroundTaskManagerV2] ⚠️ 后台任务即将过期', payload);
|
||||
// 处理任务过期情况,确保重新调度
|
||||
this.handleTaskExpiration();
|
||||
});
|
||||
|
||||
logger.info('[BackgroundTaskManagerV2] 事件监听器注册完成');
|
||||
|
||||
try {
|
||||
// 检查后台刷新状态
|
||||
logger.info('[BackgroundTaskManagerV2] 检查后台刷新权限状态...');
|
||||
const status = await this.getStatus();
|
||||
logger.info('[BackgroundTaskManagerV2] 后台刷新状态:', status);
|
||||
|
||||
if (status === 'denied' || status === 'restricted') {
|
||||
logger.warn('[BackgroundTaskManagerV2] 后台刷新被限制或拒绝,后台任务可能无法正常工作');
|
||||
// 不抛出错误,但标记为未完全初始化
|
||||
if (status === 'denied') {
|
||||
logger.error('[BackgroundTaskManagerV2] ❌ 后台刷新被拒绝!');
|
||||
logger.error('[BackgroundTaskManagerV2] 请在 设置 > Out Live > 后台App刷新 中启用');
|
||||
this.isInitialized = false;
|
||||
return;
|
||||
}
|
||||
|
||||
if (status === 'restricted') {
|
||||
logger.warn('[BackgroundTaskManagerV2] ⚠️ 后台刷新被限制(可能是家长控制)');
|
||||
this.isInitialized = false;
|
||||
return;
|
||||
}
|
||||
|
||||
logger.info('[BackgroundTaskManagerV2] 配置后台任务...');
|
||||
await NativeBackgroundModule.configure({
|
||||
identifier: BACKGROUND_TASK_IDENTIFIER,
|
||||
taskType: 'refresh',
|
||||
@@ -377,16 +392,24 @@ export class BackgroundTaskManagerV2 {
|
||||
requiresExternalPower: false,
|
||||
defaultDelay: DEFAULT_RESCHEDULE_INTERVAL_SECONDS,
|
||||
});
|
||||
|
||||
this.isInitialized = true;
|
||||
logger.info('[BackgroundTaskManagerV2] 已初始化并注册 iOS 后台任务');
|
||||
logger.info('[BackgroundTaskManagerV2] ✅ 后台任务配置成功');
|
||||
|
||||
// 立即调度一次后台任务
|
||||
logger.info('[BackgroundTaskManagerV2] 调度首次后台任务...');
|
||||
await this.scheduleNextTask();
|
||||
|
||||
// 检查待处理的任务请求
|
||||
const pendingRequests = await this.getPendingRequests();
|
||||
logger.info('[BackgroundTaskManagerV2] 当前待处理的任务请求数量:', pendingRequests.length);
|
||||
|
||||
if (pendingRequests.length > 0) {
|
||||
logger.info('[BackgroundTaskManagerV2] 待处理任务详情:', JSON.stringify(pendingRequests, null, 2));
|
||||
}
|
||||
|
||||
logger.info('[BackgroundTaskManagerV2] ====== 初始化完成 ======');
|
||||
|
||||
} catch (error: any) {
|
||||
// BGTaskSchedulerErrorDomain 错误码 1 表示后台任务功能不可用
|
||||
// 这在模拟器上是正常的,因为模拟器不完全支持后台任务
|
||||
@@ -395,7 +418,9 @@ export class BackgroundTaskManagerV2 {
|
||||
(errorMessage.includes('错误1') || errorMessage.includes('code 1'));
|
||||
|
||||
if (isBGTaskUnavailable) {
|
||||
logger.warn('[BackgroundTaskManagerV2] 后台任务功能在当前环境不可用(模拟器限制),将在真机上正常工作');
|
||||
logger.warn('[BackgroundTaskManagerV2] ⚠️ 后台任务功能在当前环境不可用');
|
||||
logger.warn('[BackgroundTaskManagerV2] 这是模拟器的正常限制,在真机上会正常工作');
|
||||
logger.warn('[BackgroundTaskManagerV2] 建议:在真机上测试后台任务功能');
|
||||
this.removeListeners();
|
||||
this.isInitialized = false;
|
||||
// 不抛出错误,因为这是预期行为
|
||||
@@ -403,12 +428,15 @@ export class BackgroundTaskManagerV2 {
|
||||
}
|
||||
|
||||
// 其他错误情况,尝试恢复
|
||||
logger.error('[BackgroundTaskManagerV2] 初始化失败,尝试恢复', error);
|
||||
logger.error('[BackgroundTaskManagerV2] ❌ 初始化失败', error);
|
||||
logger.error('[BackgroundTaskManagerV2] 错误详情:', errorMessage);
|
||||
|
||||
try {
|
||||
// 尝试重新初始化一次
|
||||
logger.info('[BackgroundTaskManagerV2] 尝试恢复...');
|
||||
await this.attemptRecovery();
|
||||
logger.info('[BackgroundTaskManagerV2] ✅ 恢复成功');
|
||||
} catch (recoveryError) {
|
||||
logger.error('[BackgroundTaskManagerV2] 恢复失败,放弃初始化', recoveryError);
|
||||
logger.error('[BackgroundTaskManagerV2] ❌ 恢复失败,放弃初始化', recoveryError);
|
||||
this.removeListeners();
|
||||
throw error;
|
||||
}
|
||||
@@ -569,14 +597,41 @@ export class BackgroundTaskManagerV2 {
|
||||
|
||||
async triggerTaskForTesting(): Promise<void> {
|
||||
if (!isIosBackgroundModuleAvailable) {
|
||||
logger.info('[BackgroundTaskManagerV2] 原生模块不可用,直接执行后台任务逻辑');
|
||||
await executeBackgroundTasks();
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
logger.info('[BackgroundTaskManagerV2] 尝试模拟触发后台任务...');
|
||||
await NativeBackgroundModule.simulateLaunch();
|
||||
} catch (error) {
|
||||
logger.error('[BackgroundTaskManagerV2] 模拟后台任务触发失败', error);
|
||||
logger.info('[BackgroundTaskManagerV2] ✅ 模拟触发成功');
|
||||
} catch (error: any) {
|
||||
const errorMessage = error?.message || String(error);
|
||||
const errorCode = error?.code || '';
|
||||
|
||||
// 检查是否是模拟器不支持的错误
|
||||
if (errorCode === 'SIMULATOR_NOT_SUPPORTED') {
|
||||
logger.warn('[BackgroundTaskManagerV2] ⚠️ 模拟器不支持后台任务');
|
||||
logger.warn('[BackgroundTaskManagerV2] 这是正常的限制,请在真机上测试');
|
||||
logger.info('[BackgroundTaskManagerV2] 作为替代,直接执行后台任务逻辑...');
|
||||
// 在模拟器上直接执行后台任务逻辑作为测试
|
||||
await executeBackgroundTasks();
|
||||
return;
|
||||
}
|
||||
|
||||
// 检查是否是监听器未注册的错误
|
||||
if (errorCode === 'NO_LISTENERS') {
|
||||
logger.warn('[BackgroundTaskManagerV2] ⚠️ JS 监听器未注册');
|
||||
logger.warn('[BackgroundTaskManagerV2] 可能是应用还未完全初始化');
|
||||
logger.info('[BackgroundTaskManagerV2] 尝试直接执行后台任务逻辑...');
|
||||
await executeBackgroundTasks();
|
||||
return;
|
||||
}
|
||||
|
||||
logger.error('[BackgroundTaskManagerV2] ❌ 模拟后台任务触发失败', error);
|
||||
logger.error('[BackgroundTaskManagerV2] 错误代码:', errorCode);
|
||||
logger.error('[BackgroundTaskManagerV2] 错误信息:', errorMessage);
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -263,16 +263,31 @@ const selectiveSyncNotifications = async ({
|
||||
const start = dayjs(schedule.startISO);
|
||||
const end = dayjs(schedule.endISO);
|
||||
|
||||
if (end.isBefore(now)) {
|
||||
if (end.isBefore(now.subtract(1, 'hour'))) {
|
||||
await clearFastingNotificationIds();
|
||||
return {};
|
||||
}
|
||||
|
||||
const updatedIds: FastingNotificationIds = { ...validIds };
|
||||
|
||||
// 先取消所有无效的旧通知,避免重复
|
||||
const invalidIds = Object.entries(storedIds).filter(
|
||||
([key, id]) => id && !Object.values(validIds).includes(id)
|
||||
);
|
||||
|
||||
for (const [_, id] of invalidIds) {
|
||||
if (id) {
|
||||
try {
|
||||
await notificationService.cancelNotification(id);
|
||||
} catch (error) {
|
||||
console.warn('取消无效通知失败', error);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 1. 检查开始前30分钟通知
|
||||
const preStart = start.subtract(REMINDER_OFFSET_MINUTES, 'minute');
|
||||
if (preStart.isAfter(now) && !validIds.preStartId) {
|
||||
if (preStart.isAfter(now.add(1, 'minute')) && !validIds.preStartId) {
|
||||
try {
|
||||
const preStartId = await notificationService.scheduleNotificationAtDate(
|
||||
{
|
||||
@@ -289,13 +304,14 @@ const selectiveSyncNotifications = async ({
|
||||
preStart.toDate()
|
||||
);
|
||||
updatedIds.preStartId = preStartId;
|
||||
console.log(`已安排断食开始前30分钟通知: ${preStart.format('YYYY-MM-DD HH:mm')}`);
|
||||
} catch (error) {
|
||||
console.error('安排断食开始前30分钟通知失败', error);
|
||||
}
|
||||
}
|
||||
|
||||
// 2. 检查开始时通知
|
||||
if (start.isAfter(now) && !validIds.startId) {
|
||||
if (start.isAfter(now.add(1, 'minute')) && !validIds.startId) {
|
||||
try {
|
||||
const startId = await notificationService.scheduleNotificationAtDate(
|
||||
{
|
||||
@@ -312,6 +328,7 @@ const selectiveSyncNotifications = async ({
|
||||
start.toDate()
|
||||
);
|
||||
updatedIds.startId = startId;
|
||||
console.log(`已安排断食开始时通知: ${start.format('YYYY-MM-DD HH:mm')}`);
|
||||
} catch (error) {
|
||||
console.error('安排断食开始时通知失败', error);
|
||||
}
|
||||
@@ -319,7 +336,7 @@ const selectiveSyncNotifications = async ({
|
||||
|
||||
// 3. 检查结束前30分钟通知
|
||||
const preEnd = end.subtract(REMINDER_OFFSET_MINUTES, 'minute');
|
||||
if (preEnd.isAfter(now) && !validIds.preEndId) {
|
||||
if (preEnd.isAfter(now.add(1, 'minute')) && !validIds.preEndId) {
|
||||
try {
|
||||
const preEndId = await notificationService.scheduleNotificationAtDate(
|
||||
{
|
||||
@@ -336,13 +353,14 @@ const selectiveSyncNotifications = async ({
|
||||
preEnd.toDate()
|
||||
);
|
||||
updatedIds.preEndId = preEndId;
|
||||
console.log(`已安排断食结束前30分钟通知: ${preEnd.format('YYYY-MM-DD HH:mm')}`);
|
||||
} catch (error) {
|
||||
console.error('安排断食结束前30分钟通知失败', error);
|
||||
}
|
||||
}
|
||||
|
||||
// 4. 检查结束时通知
|
||||
if (end.isAfter(now) && !validIds.endId) {
|
||||
if (end.isAfter(now.add(1, 'minute')) && !validIds.endId) {
|
||||
try {
|
||||
const endId = await notificationService.scheduleNotificationAtDate(
|
||||
{
|
||||
@@ -359,6 +377,7 @@ const selectiveSyncNotifications = async ({
|
||||
end.toDate()
|
||||
);
|
||||
updatedIds.endId = endId;
|
||||
console.log(`已安排断食结束时通知: ${end.format('YYYY-MM-DD HH:mm')}`);
|
||||
} catch (error) {
|
||||
console.error('安排断食结束时通知失败', error);
|
||||
}
|
||||
@@ -398,8 +417,9 @@ export const verifyFastingNotifications = async ({
|
||||
const start = dayjs(schedule.startISO);
|
||||
const end = dayjs(schedule.endISO);
|
||||
|
||||
// 如果断食期已结束,应该清空所有通知
|
||||
if (end.isBefore(now)) {
|
||||
// 如果断食期已结束超过1小时,应该清空所有通知
|
||||
// 这样可以避免在自动续订过程中过早清空通知
|
||||
if (end.isBefore(now.subtract(1, 'hour'))) {
|
||||
if (Object.values(storedIds).some(id => id)) {
|
||||
await cancelNotificationIds(storedIds);
|
||||
await clearFastingNotificationIds();
|
||||
@@ -431,9 +451,15 @@ export const verifyFastingNotifications = async ({
|
||||
const validIds: FastingNotificationIds = {};
|
||||
|
||||
for (const expected of expectedNotifications) {
|
||||
// 跳过已过期的通知
|
||||
if (expected.time.isBefore(now)) {
|
||||
// 跳过已过期的通知(过期超过5分钟)
|
||||
if (expected.time.isBefore(now.subtract(5, 'minute'))) {
|
||||
if (expected.id) {
|
||||
// 取消已过期的通知
|
||||
try {
|
||||
await notificationService.cancelNotification(expected.id);
|
||||
} catch (error) {
|
||||
console.warn('取消过期通知失败', error);
|
||||
}
|
||||
needsResync = true;
|
||||
}
|
||||
continue;
|
||||
@@ -451,6 +477,20 @@ export const verifyFastingNotifications = async ({
|
||||
continue;
|
||||
}
|
||||
|
||||
// 检查通知时间是否匹配(容差1分钟)
|
||||
const notification = scheduledNotifications.find(n => n.identifier === expected.id);
|
||||
if (notification?.trigger && 'date' in notification.trigger) {
|
||||
const scheduledTime = dayjs(notification.trigger.date);
|
||||
const timeDiff = Math.abs(scheduledTime.diff(expected.time, 'minute'));
|
||||
|
||||
// 如果时间差异超过1分钟,说明需要重新安排
|
||||
if (timeDiff > 1) {
|
||||
console.log(`通知时间不匹配,需要重新安排: ${expected.type}, 期望: ${expected.time.format('HH:mm')}, 实际: ${scheduledTime.format('HH:mm')}`);
|
||||
needsResync = true;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
|
||||
// 通知存在且有效
|
||||
switch (expected.type) {
|
||||
case 'pre_start':
|
||||
|
||||
Reference in New Issue
Block a user