feat: 实现目标通知功能及相关组件
- 新增目标通知功能，支持根据用户创建目标时选择的频率和开始时间自动创建本地定时推送通知 - 实现每日、每周和每月的重复类型，用户可自定义选择提醒时间和重复规则 - 集成目标通知测试组件，方便开发者测试不同类型的通知 - 更新相关文档，详细描述目标通知功能的实现和使用方法 - 优化目标页面，确保用户体验和界面一致性
This commit is contained in:
223
docs/goal-notification-implementation.md
Normal file
223
docs/goal-notification-implementation.md
Normal file
@@ -0,0 +1,223 @@
|
||||
# 目标通知功能实现文档
|
||||
|
||||
## 概述
|
||||
|
||||
本功能实现了根据用户创建目标时选择的频率和开始时间，自动创建本地定时推送通知。当用户创建目标并开启提醒功能时，系统会根据目标的重复类型（每日、每周、每月）和提醒时间，自动安排相应的本地推送通知。
|
||||
|
||||
## 功能特性
|
||||
|
||||
### ✅ 已实现功能
|
||||
|
||||
- [x] 根据目标重复类型创建定时推送
|
||||
- [x] 支持每日重复通知
|
||||
- [x] 支持每周重复通知（可自定义星期几）
|
||||
- [x] 支持每月重复通知（可自定义日期）
|
||||
- [x] 支持自定义提醒时间
|
||||
- [x] 目标达成通知
|
||||
- [x] 取消特定目标的通知
|
||||
- [x] 通知点击处理
|
||||
- [x] 开发环境测试功能
|
||||
|
||||
## 技术实现
|
||||
|
||||
### 1. 通知服务扩展 (services/notifications.ts)
|
||||
|
||||
#### 新增方法
|
||||
|
||||
```typescript
|
||||
/**
|
||||
* 安排日历重复通知（支持每日、每周、每月）
|
||||
*/
|
||||
async scheduleCalendarRepeatingNotification(
|
||||
notification: NotificationData,
|
||||
options: {
|
||||
type: 'daily' | 'weekly' | 'monthly';
|
||||
hour: number;
|
||||
minute: number;
|
||||
weekdays?: number[]; // 0-6，0为周日，仅用于weekly类型
|
||||
dayOfMonth?: number; // 1-31，仅用于monthly类型
|
||||
}
|
||||
): Promise<string>
|
||||
```
|
||||
|
||||
#### 通知处理扩展
|
||||
|
||||
```typescript
|
||||
// 处理目标提醒通知点击
|
||||
else if (data?.type === 'goal_reminder') {
|
||||
console.log('用户点击了目标提醒通知', data);
|
||||
// 这里可以添加导航到目标页面的逻辑
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 目标通知辅助函数 (utils/notificationHelpers.ts)
|
||||
|
||||
#### 核心方法
|
||||
|
||||
```typescript
|
||||
/**
|
||||
* 根据目标设置创建定时推送
|
||||
*/
|
||||
static async scheduleGoalNotifications(
|
||||
goalData: {
|
||||
title: string;
|
||||
repeatType: 'daily' | 'weekly' | 'monthly';
|
||||
frequency: number;
|
||||
hasReminder: boolean;
|
||||
reminderTime?: string;
|
||||
customRepeatRule?: {
|
||||
weekdays?: number[];
|
||||
dayOfMonth?: number[];
|
||||
};
|
||||
startTime?: number;
|
||||
},
|
||||
userName: string
|
||||
): Promise<string[]>
|
||||
|
||||
/**
|
||||
* 取消特定目标的所有通知
|
||||
*/
|
||||
static async cancelGoalNotifications(goalTitle: string): Promise<void>
|
||||
```
|
||||
|
||||
#### 支持的重复类型
|
||||
|
||||
1. **每日重复**
|
||||
- 使用 `scheduleCalendarRepeatingNotification` 的 `daily` 类型
|
||||
- 每天在指定时间发送通知
|
||||
|
||||
2. **每周重复**
|
||||
- 支持自定义星期几（如周一、三、五）
|
||||
- 为每个选中的星期几创建单独的通知
|
||||
- 使用 `scheduleCalendarRepeatingNotification` 的 `weekly` 类型
|
||||
|
||||
3. **每月重复**
|
||||
- 支持自定义日期（如每月1号和15号）
|
||||
- 为每个选中的日期创建单独的通知
|
||||
- 使用 `scheduleCalendarRepeatingNotification` 的 `monthly` 类型
|
||||
|
||||
### 3. 目标创建页面集成 (app/(tabs)/goals.tsx)
|
||||
|
||||
#### 创建目标后的通知设置
|
||||
|
||||
```typescript
|
||||
// 创建目标成功后，设置定时推送
|
||||
try {
|
||||
const notificationIds = await GoalNotificationHelpers.scheduleGoalNotifications(
|
||||
{
|
||||
title: goalData.title,
|
||||
repeatType: goalData.repeatType,
|
||||
frequency: goalData.frequency,
|
||||
hasReminder: goalData.hasReminder,
|
||||
reminderTime: goalData.reminderTime,
|
||||
customRepeatRule: goalData.customRepeatRule,
|
||||
startTime: goalData.startTime,
|
||||
},
|
||||
userName
|
||||
);
|
||||
|
||||
console.log(`目标"${goalData.title}"的定时推送已创建，通知ID：`, notificationIds);
|
||||
} catch (notificationError) {
|
||||
console.error('创建目标定时推送失败:', notificationError);
|
||||
// 通知创建失败不影响目标创建的成功
|
||||
}
|
||||
```
|
||||
|
||||
## 使用示例
|
||||
|
||||
### 1. 创建每日目标通知
|
||||
|
||||
```typescript
|
||||
const notificationIds = await GoalNotificationHelpers.scheduleGoalNotifications(
|
||||
{
|
||||
title: '每日运动目标',
|
||||
repeatType: 'daily',
|
||||
frequency: 1,
|
||||
hasReminder: true,
|
||||
reminderTime: '09:00',
|
||||
},
|
||||
'张三'
|
||||
);
|
||||
```
|
||||
|
||||
### 2. 创建每周目标通知
|
||||
|
||||
```typescript
|
||||
const notificationIds = await GoalNotificationHelpers.scheduleGoalNotifications(
|
||||
{
|
||||
title: '每周运动目标',
|
||||
repeatType: 'weekly',
|
||||
frequency: 1,
|
||||
hasReminder: true,
|
||||
reminderTime: '10:00',
|
||||
customRepeatRule: {
|
||||
weekdays: [1, 3, 5], // 周一、三、五
|
||||
},
|
||||
},
|
||||
'张三'
|
||||
);
|
||||
```
|
||||
|
||||
### 3. 创建每月目标通知
|
||||
|
||||
```typescript
|
||||
const notificationIds = await GoalNotificationHelpers.scheduleGoalNotifications(
|
||||
{
|
||||
title: '每月运动目标',
|
||||
repeatType: 'monthly',
|
||||
frequency: 1,
|
||||
hasReminder: true,
|
||||
reminderTime: '11:00',
|
||||
customRepeatRule: {
|
||||
dayOfMonth: [1, 15], // 每月1号和15号
|
||||
},
|
||||
},
|
||||
'张三'
|
||||
);
|
||||
```
|
||||
|
||||
### 4. 发送目标达成通知
|
||||
|
||||
```typescript
|
||||
await GoalNotificationHelpers.sendGoalAchievementNotification('张三', '每日运动目标');
|
||||
```
|
||||
|
||||
### 5. 取消目标通知
|
||||
|
||||
```typescript
|
||||
await GoalNotificationHelpers.cancelGoalNotifications('每日运动目标');
|
||||
```
|
||||
|
||||
## 测试功能
|
||||
|
||||
### 开发环境测试按钮
|
||||
|
||||
在开发环境下，目标页面会显示一个"测试通知"按钮，可以快速测试各种通知类型：
|
||||
|
||||
- 每日目标通知测试
|
||||
- 每周目标通知测试
|
||||
- 目标达成通知测试
|
||||
|
||||
### 测试组件
|
||||
|
||||
创建了 `GoalNotificationTest` 组件，提供完整的测试界面：
|
||||
|
||||
```typescript
|
||||
import { GoalNotificationTest } from '@/components/GoalNotificationTest';
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **权限要求**: 需要用户授予通知权限才能正常工作
|
||||
2. **平台限制**: Expo Notifications 的重复通知功能有一定限制，我们使用日历重复通知来绕过这些限制
|
||||
3. **时间处理**: 所有时间都基于用户设备的本地时间
|
||||
4. **错误处理**: 通知创建失败不会影响目标创建的成功
|
||||
5. **通知管理**: 每个目标的通知都有唯一的标识，可以单独取消
|
||||
|
||||
## 未来改进
|
||||
|
||||
1. **通知模板**: 支持更多样化的通知内容模板
|
||||
2. **智能提醒**: 根据用户行为调整提醒时间
|
||||
3. **批量管理**: 支持批量管理多个目标的通知
|
||||
4. **通知历史**: 记录和显示通知发送历史
|
||||
5. **自定义声音**: 支持自定义通知声音
|
||||
121
docs/goal-notification-summary.md
Normal file
121
docs/goal-notification-summary.md
Normal file
@@ -0,0 +1,121 @@
|
||||
# 目标通知功能实现总结
|
||||
|
||||
## 实现概述
|
||||
|
||||
已成功实现了根据用户创建目标时选择的频率和开始时间，自动创建本地定时推送通知的功能。
|
||||
|
||||
## 主要功能
|
||||
|
||||
### ✅ 已完成功能
|
||||
|
||||
1. **目标创建后自动设置通知**
|
||||
- 在用户创建目标成功后，自动根据目标设置创建定时推送
|
||||
- 支持每日、每周、每月三种重复类型
|
||||
- 支持自定义提醒时间
|
||||
|
||||
2. **多种重复类型支持**
|
||||
- **每日重复**: 每天在指定时间发送通知
|
||||
- **每周重复**: 支持自定义星期几（如周一、三、五）
|
||||
- **每月重复**: 支持自定义日期（如每月1号和15号）
|
||||
|
||||
3. **通知管理功能**
|
||||
- 目标达成通知
|
||||
- 取消特定目标的通知
|
||||
- 通知点击处理
|
||||
|
||||
4. **开发测试功能**
|
||||
- 开发环境下的测试按钮
|
||||
- 完整的测试组件
|
||||
|
||||
## 技术实现
|
||||
|
||||
### 核心文件
|
||||
|
||||
1. **services/notifications.ts**
|
||||
- 扩展了通知服务，添加了 `scheduleCalendarRepeatingNotification` 方法
|
||||
- 支持日历重复通知（每日、每周、每月）
|
||||
|
||||
2. **utils/notificationHelpers.ts**
|
||||
- 添加了 `GoalNotificationHelpers` 类
|
||||
- 实现了 `scheduleGoalNotifications` 方法
|
||||
- 实现了 `cancelGoalNotifications` 方法
|
||||
|
||||
3. **app/(tabs)/goals.tsx**
|
||||
- 在目标创建成功后调用通知设置
|
||||
- 添加了开发环境测试按钮
|
||||
|
||||
4. **components/GoalNotificationTest.tsx**
|
||||
- 创建了完整的测试组件
|
||||
|
||||
### 关键代码
|
||||
|
||||
```typescript
|
||||
// 创建目标后的通知设置
|
||||
const notificationIds = await GoalNotificationHelpers.scheduleGoalNotifications(
|
||||
{
|
||||
title: goalData.title,
|
||||
repeatType: goalData.repeatType,
|
||||
frequency: goalData.frequency,
|
||||
hasReminder: goalData.hasReminder,
|
||||
reminderTime: goalData.reminderTime,
|
||||
customRepeatRule: goalData.customRepeatRule,
|
||||
startTime: goalData.startTime,
|
||||
},
|
||||
userName
|
||||
);
|
||||
```
|
||||
|
||||
## 使用流程
|
||||
|
||||
1. **用户创建目标**
|
||||
- 设置目标标题、描述
|
||||
- 选择重复类型（每日/每周/每月）
|
||||
- 设置频率
|
||||
- 开启提醒并设置提醒时间
|
||||
- 选择自定义重复规则（如星期几、日期）
|
||||
|
||||
2. **系统自动创建通知**
|
||||
- 目标创建成功后，系统自动调用通知设置
|
||||
- 根据重复类型创建相应的定时推送
|
||||
- 返回通知ID用于后续管理
|
||||
|
||||
3. **通知触发**
|
||||
- 在指定时间自动发送通知
|
||||
- 用户点击通知可进行相应操作
|
||||
|
||||
## 测试验证
|
||||
|
||||
### 开发环境测试
|
||||
|
||||
在开发环境下，目标页面会显示"测试通知"按钮，可以测试：
|
||||
|
||||
- 每日目标通知
|
||||
- 每周目标通知（自定义星期几）
|
||||
- 目标达成通知
|
||||
|
||||
### 测试组件
|
||||
|
||||
创建了 `GoalNotificationTest` 组件，提供完整的测试界面，包括：
|
||||
|
||||
- 各种通知类型的测试按钮
|
||||
- 测试结果显示
|
||||
- 错误处理
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **权限要求**: 需要用户授予通知权限
|
||||
2. **平台兼容**: 使用 Expo Notifications 的日历重复功能
|
||||
3. **错误处理**: 通知创建失败不影响目标创建
|
||||
4. **时间处理**: 基于用户设备本地时间
|
||||
|
||||
## 后续优化建议
|
||||
|
||||
1. **通知模板**: 支持更丰富的通知内容
|
||||
2. **智能提醒**: 根据用户行为调整提醒时间
|
||||
3. **批量管理**: 支持批量管理多个目标的通知
|
||||
4. **通知历史**: 记录和显示通知发送历史
|
||||
5. **自定义声音**: 支持自定义通知声音
|
||||
|
||||
## 总结
|
||||
|
||||
目标通知功能已完全实现，能够根据用户的目标设置自动创建本地定时推送，支持多种重复类型和自定义规则，并提供了完整的测试和错误处理机制。
|
||||
Reference in New Issue
Block a user