2026-09-13 15:50:37 +08:00
|
|
|
// entry/src/main/ets/common/CardDataService.ets
|
|
|
|
|
// 服务卡片数据:从本地库取"今天起"的日程(含 RRULE 展开),输出 JSON 给卡片渲染
|
|
|
|
|
import { common } from '@kit.AbilityKit';
|
|
|
|
|
import { formBindingData, formProvider } from '@kit.FormKit';
|
|
|
|
|
import { BusinessError } from '@kit.BasicServicesKit';
|
|
|
|
|
import { preferences } from '@kit.ArkData';
|
|
|
|
|
import { CalendarDataService, DisplayEvent } from './CalendarDataService';
|
|
|
|
|
import { LunarUtil } from './LunarUtil';
|
|
|
|
|
import { LogUtil } from './LogUtil';
|
|
|
|
|
|
|
|
|
|
/** 卡片单条日程(按天分组:组内全天事件在前、有时间的按开始时间排序) */
|
|
|
|
|
export class CardItem {
|
|
|
|
|
title: string = '';
|
|
|
|
|
time: string = ''; // 开始时间 '08:30' / '全天'
|
|
|
|
|
endTime: string = ''; // 结束时间 '10:00'(全天事件为空)
|
|
|
|
|
date: string = ''; // '9月15日'
|
|
|
|
|
showDate: boolean = false; // 是否为当天分组的第一条(卡片上渲染日期头)
|
|
|
|
|
calName: string = ''; // 所属日历本名(右侧显示,颜色同日历色)
|
|
|
|
|
color: string = '#007DFF';
|
2026-09-14 10:18:31 +08:00
|
|
|
// 当前时间红线:start/end 为日程实际起止毫秒(用于定位"现在"位置);
|
|
|
|
|
// showNowLine 表示该日程上方应绘制红线,isNow 表示该日程正在进行中
|
|
|
|
|
startMs: number = 0;
|
|
|
|
|
endMs: number = 0;
|
|
|
|
|
showNowLine: boolean = false; // 红线画在该日程上方
|
|
|
|
|
isNow: boolean = false; // 该日程正在进行中
|
|
|
|
|
nowLineBelow: boolean = false; // 今天所有有时间日程已结束:红线画在最后一条下方
|
2026-09-13 15:50:37 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 卡片整体数据 */
|
|
|
|
|
export class CardData {
|
|
|
|
|
eventsJson: string = '[]';
|
|
|
|
|
dateText: string = '';
|
|
|
|
|
lunarText: string = '';
|
2026-09-14 09:07:47 +08:00
|
|
|
// 2x2 卡片强化:月-日(x月x日,年份冗余故省略)/ 星期 / 今日日程条数
|
|
|
|
|
dateMd: string = '';
|
|
|
|
|
weekday: string = '';
|
|
|
|
|
todayCount: number = 0;
|
2026-09-14 10:18:31 +08:00
|
|
|
ongoingCount: number = 0; // 此刻正在进行的日程条数(2x2 卡片红点提示用)
|
2026-09-14 11:09:15 +08:00
|
|
|
// 2x4 卡片右侧「正在进行」列表:与 eventsJson 同结构(CardItem[]),只含此刻进行中/下一个日程
|
|
|
|
|
ongoingJson: string = '[]';
|
2026-09-13 15:50:37 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export class CardDataService {
|
|
|
|
|
private static readonly MAX_ITEMS: number = 50;
|
|
|
|
|
// 已添加卡片的 formId 注册表(同进程内有效)
|
|
|
|
|
private static formIds: string[] = [];
|
|
|
|
|
// formIds 持久化(App 重启后内存注册表会清空,从 preferences 恢复,保证推送不丢卡片)
|
|
|
|
|
private static readonly PREF_STORE: string = 'card_form_ids';
|
|
|
|
|
private static readonly PREF_KEY: string = 'form_ids';
|
|
|
|
|
|
|
|
|
|
/** 注册卡片:内存 + 持久化 */
|
|
|
|
|
static async registerForm(context: common.Context, formId: string): Promise<void> {
|
|
|
|
|
if (formId !== '' && !CardDataService.formIds.includes(formId)) {
|
|
|
|
|
CardDataService.formIds.push(formId);
|
|
|
|
|
}
|
|
|
|
|
await CardDataService.saveFormIds(context);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 注销卡片:内存 + 持久化 */
|
|
|
|
|
static async unregisterForm(context: common.Context, formId: string): Promise<void> {
|
|
|
|
|
CardDataService.formIds = CardDataService.formIds.filter((id: string): boolean => id !== formId);
|
|
|
|
|
await CardDataService.saveFormIds(context);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static async saveFormIds(context: common.Context): Promise<void> {
|
|
|
|
|
try {
|
|
|
|
|
const store: preferences.Preferences =
|
|
|
|
|
await preferences.getPreferences(context, CardDataService.PREF_STORE);
|
|
|
|
|
await store.put(CardDataService.PREF_KEY, CardDataService.formIds.join(','));
|
|
|
|
|
await store.flush();
|
|
|
|
|
} catch (err) {
|
|
|
|
|
const e = err as BusinessError;
|
|
|
|
|
console.error(`保存 formIds 失败: ${e.message}`);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static async loadPersistedFormIds(context: common.Context): Promise<void> {
|
|
|
|
|
try {
|
|
|
|
|
const store: preferences.Preferences =
|
|
|
|
|
await preferences.getPreferences(context, CardDataService.PREF_STORE);
|
|
|
|
|
const raw: string = await store.get(CardDataService.PREF_KEY, '') as string;
|
|
|
|
|
for (const id of raw.split(',')) {
|
|
|
|
|
if (id !== '' && !CardDataService.formIds.includes(id)) {
|
|
|
|
|
CardDataService.formIds.push(id);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
} catch (err) {
|
|
|
|
|
// 读取失败则仅用内存注册表
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** App 内同步完成后调用:刷新所有已添加的卡片 */
|
|
|
|
|
static async pushToAllForms(context: common.Context): Promise<void> {
|
|
|
|
|
// 先恢复持久化的 formId(App 重启后内存注册表为空)
|
|
|
|
|
await CardDataService.loadPersistedFormIds(context);
|
|
|
|
|
if (CardDataService.formIds.length === 0) {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
const data: CardData = await CardDataService.buildCardData(context);
|
|
|
|
|
const binding: formBindingData.FormBindingData =
|
|
|
|
|
formBindingData.createFormBindingData(data);
|
|
|
|
|
const stale: string[] = [];
|
|
|
|
|
for (const formId of CardDataService.formIds) {
|
|
|
|
|
try {
|
|
|
|
|
await formProvider.updateForm(formId, binding);
|
|
|
|
|
} catch (err) {
|
|
|
|
|
const e = err as BusinessError;
|
|
|
|
|
console.error(`卡片 ${formId} 刷新失败(移除注册): ${e.message}`);
|
|
|
|
|
stale.push(formId);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
for (const id of stale) {
|
|
|
|
|
CardDataService.formIds = CardDataService.formIds.filter((x: string): boolean => x !== id);
|
|
|
|
|
}
|
|
|
|
|
if (stale.length > 0) {
|
|
|
|
|
await CardDataService.saveFormIds(context);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static startOfDay(ms: number): number {
|
|
|
|
|
const d = new Date(ms);
|
|
|
|
|
return new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 组装卡片数据(异步:查询本地库) */
|
|
|
|
|
static async buildCardData(context: common.Context): Promise<CardData> {
|
2026-09-14 09:07:47 +08:00
|
|
|
const data = new CardData();
|
|
|
|
|
try {
|
|
|
|
|
LogUtil.init(context);
|
|
|
|
|
const now = new Date();
|
|
|
|
|
const weekCn: string[] = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
|
|
|
|
|
const fullWeekCn: string[] = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
|
|
|
|
|
data.dateText = `${now.getMonth() + 1}月${now.getDate()}日 ${weekCn[now.getDay()]}`;
|
|
|
|
|
data.lunarText = LunarUtil.lunarDayText(now.getTime());
|
|
|
|
|
// 2x2 卡片强化字段:月-日(x月x日,年份冗余省略)、星期全名、今日日程条数
|
|
|
|
|
data.dateMd = `${now.getMonth() + 1}月${now.getDate()}日`;
|
|
|
|
|
data.weekday = fullWeekCn[now.getDay()];
|
2026-09-13 15:50:37 +08:00
|
|
|
const start: number = CardDataService.startOfDay(now.getTime());
|
|
|
|
|
const end: number = start + 60 * 86400000;
|
|
|
|
|
const sources = await CalendarDataService.loadSources(context);
|
|
|
|
|
const events: DisplayEvent[] = await CalendarDataService.loadEvents(context, start, end, sources);
|
2026-09-13 17:48:39 +08:00
|
|
|
// 1) 过滤:保留"今天 0 点以来"的日程(今天已结束的也显示,否则重复日程的
|
|
|
|
|
// 第一次发生会被隐藏,表现为"第一次不显示、第二次及以后显示");
|
|
|
|
|
// 2) 按天分组,组内全天在前、有时间按开始时间排序;
|
2026-09-13 15:50:37 +08:00
|
|
|
// 3) 平铺输出并给每组第一条打 showDate 标记(日期头只跟在自己日期前面)
|
|
|
|
|
// 跨天日程:已开始未结束的归到"今天"、按全天显示,不再从开始那天重复显示
|
|
|
|
|
const todayKey: number = CardDataService.startOfDay(now.getTime());
|
2026-09-13 17:48:39 +08:00
|
|
|
const upcoming: DisplayEvent[] = events
|
|
|
|
|
.filter((e: DisplayEvent): boolean => e.endTime >= todayKey);
|
|
|
|
|
|
2026-09-13 15:50:37 +08:00
|
|
|
const dayKey = (ms: number): number => CardDataService.startOfDay(ms);
|
|
|
|
|
const spansDays = (e: DisplayEvent): boolean =>
|
|
|
|
|
dayKey(e.endTime) > dayKey(e.startTime);
|
2026-09-14 11:09:15 +08:00
|
|
|
// 已开始的跨天日程按全天展示(不参与时间轴定位)
|
|
|
|
|
const isDayLong = (e: DisplayEvent): boolean => e.isAllDay || spansDays(e);
|
2026-09-13 15:50:37 +08:00
|
|
|
const groups = new Map<number, DisplayEvent[]>();
|
|
|
|
|
for (const e of upcoming) {
|
|
|
|
|
// 跨天且已开始:归今天;其余归开始日
|
|
|
|
|
const key: number = spansDays(e) && dayKey(e.startTime) < todayKey
|
|
|
|
|
? todayKey : dayKey(e.startTime);
|
|
|
|
|
const arr = groups.get(key);
|
|
|
|
|
if (arr === undefined) {
|
|
|
|
|
groups.set(key, [e]);
|
|
|
|
|
} else {
|
|
|
|
|
arr.push(e);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
const dayKeys: number[] = Array.from(groups.keys()).sort((a: number, b: number): number => a - b);
|
|
|
|
|
|
|
|
|
|
const items: CardItem[] = [];
|
|
|
|
|
const p = (n: number): string => n < 10 ? '0' + n : String(n);
|
|
|
|
|
outer:
|
|
|
|
|
for (const key of dayKeys) {
|
2026-09-13 16:18:56 +08:00
|
|
|
// 日期头文字由分组日期生成(与列表视图一致:第一天就是"今天"),
|
|
|
|
|
// 不能用事件的 startTime——跨天日程归组到今天后,日期头仍是开始日会造成"从开始显示"的假象
|
|
|
|
|
const gd = new Date(key);
|
|
|
|
|
const dateLabel: string = key === todayKey
|
|
|
|
|
? '今天'
|
|
|
|
|
: `${gd.getMonth() + 1}月${gd.getDate()}日`;
|
2026-09-13 15:50:37 +08:00
|
|
|
const list = groups.get(key) as DisplayEvent[];
|
|
|
|
|
const allDay = list.filter((e: DisplayEvent): boolean =>
|
|
|
|
|
e.isAllDay || spansDays(e)); // 跨天日程按全天展示
|
|
|
|
|
const timed = list.filter((e: DisplayEvent): boolean =>
|
|
|
|
|
!e.isAllDay && !spansDays(e))
|
|
|
|
|
.sort((a: DisplayEvent, b: DisplayEvent): number => a.startTime - b.startTime);
|
|
|
|
|
const ordered: DisplayEvent[] = allDay.concat(timed);
|
|
|
|
|
for (let i = 0; i < ordered.length; i++) {
|
|
|
|
|
if (items.length >= CardDataService.MAX_ITEMS) {
|
|
|
|
|
break outer;
|
|
|
|
|
}
|
|
|
|
|
const e = ordered[i];
|
|
|
|
|
const isDayLong: boolean = e.isAllDay || spansDays(e);
|
|
|
|
|
const d = new Date(e.startTime);
|
|
|
|
|
const item = new CardItem();
|
|
|
|
|
item.title = e.title === '' ? '(无标题)' : e.title;
|
|
|
|
|
item.time = isDayLong ? '全天' : `${p(d.getHours())}:${p(d.getMinutes())}`;
|
|
|
|
|
if (isDayLong) {
|
|
|
|
|
item.endTime = '';
|
|
|
|
|
} else {
|
|
|
|
|
const de = new Date(e.endTime);
|
|
|
|
|
item.endTime = `${p(de.getHours())}:${p(de.getMinutes())}`;
|
|
|
|
|
}
|
2026-09-13 16:18:56 +08:00
|
|
|
item.date = dateLabel;
|
2026-09-13 15:50:37 +08:00
|
|
|
item.showDate = i === 0; // 当天分组第一条 → 卡片上显示日期头
|
|
|
|
|
item.calName = e.calName;
|
|
|
|
|
item.color = e.color;
|
2026-09-14 10:18:31 +08:00
|
|
|
// 红线定位:记录实际起止毫秒(用于卡片渲染时判断"现在"位置)
|
|
|
|
|
item.startMs = e.startTime;
|
|
|
|
|
item.endMs = e.endTime;
|
2026-09-13 15:50:37 +08:00
|
|
|
items.push(item);
|
|
|
|
|
}
|
|
|
|
|
}
|
2026-09-14 10:18:31 +08:00
|
|
|
// 红线逻辑:仅对"今天"分组、且为"有时间"的日程生效(全天/跨天按全天展示,不参与时间轴定位)
|
|
|
|
|
const nowMs: number = Date.now();
|
|
|
|
|
let linePlaced: boolean = false;
|
|
|
|
|
// 1) 正在进行的日程(start<=now<end)→ 红线画在其上方,并标记 isNow
|
|
|
|
|
for (const it of items) {
|
|
|
|
|
if (it.date === '今天' && it.time !== '全天' && it.startMs <= nowMs && nowMs < it.endMs) {
|
|
|
|
|
it.isNow = true;
|
|
|
|
|
it.showNowLine = true;
|
|
|
|
|
linePlaced = true;
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
// 2) 否则:红线画在"下一个尚未开始"的有时间日程上方
|
|
|
|
|
if (!linePlaced) {
|
|
|
|
|
for (const it of items) {
|
|
|
|
|
if (it.date === '今天' && it.time !== '全天' && it.startMs > nowMs) {
|
|
|
|
|
it.showNowLine = true;
|
|
|
|
|
linePlaced = true;
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
// 3) 否则:今天所有有时间日程均已结束 → 红线画在最后一条下方(标记"今日已结束")
|
|
|
|
|
if (!linePlaced) {
|
|
|
|
|
for (let k = items.length - 1; k >= 0; k--) {
|
|
|
|
|
const it = items[k];
|
|
|
|
|
if (it.date === '今天' && it.time !== '全天') {
|
|
|
|
|
it.nowLineBelow = true;
|
|
|
|
|
linePlaced = true;
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
// 进行中条数:用于 2x2 卡片红点提示
|
|
|
|
|
data.ongoingCount = items.filter((i: CardItem): boolean => i.isNow).length;
|
2026-09-13 15:50:37 +08:00
|
|
|
data.eventsJson = JSON.stringify(items);
|
2026-09-14 09:07:47 +08:00
|
|
|
// 今日日程条数:item.date === '今天' 的均为今天分组(含全天/跨天进行中)
|
|
|
|
|
data.todayCount = items.filter((i: CardItem): boolean => i.date === '今天').length;
|
2026-09-14 11:09:15 +08:00
|
|
|
|
|
|
|
|
// ===== 2x4 卡片右侧:正在进行 / 下一个 日程(最多 3 条,作为 2x2 的右侧扩展)=====
|
|
|
|
|
// 规则:① 进行中或已开始未结束的(含全天/跨天,按 0 点起算)优先,最多 2 条;
|
|
|
|
|
// ② 不足时用"今天还没开始的下一个有时间日程"补 1 条。全部按开始时间升序。
|
|
|
|
|
const floorMs = Math.max(nowMs, todayKey);
|
|
|
|
|
const ongoingAll: DisplayEvent[] = upcoming
|
|
|
|
|
.filter((e: DisplayEvent): boolean => e.startTime <= nowMs && e.endTime > floorMs)
|
|
|
|
|
.sort((a: DisplayEvent, b: DisplayEvent): number => a.startTime - b.startTime);
|
|
|
|
|
let ongoingPick: DisplayEvent[] = ongoingAll.slice(0, 2);
|
|
|
|
|
if (ongoingPick.length < 2) {
|
|
|
|
|
const next: DisplayEvent | undefined = upcoming
|
|
|
|
|
.filter((e: DisplayEvent): boolean => !isDayLong(e) && e.startTime > nowMs)
|
|
|
|
|
.sort((a: DisplayEvent, b: DisplayEvent): number => a.startTime - b.startTime)[0];
|
|
|
|
|
if (next !== undefined) {
|
|
|
|
|
ongoingPick = ongoingPick.concat([next]);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
const ongoingItems: CardItem[] = [];
|
|
|
|
|
for (const e of ongoingPick) {
|
|
|
|
|
const dayLong: boolean = isDayLong(e);
|
|
|
|
|
const ds = new Date(e.startTime);
|
|
|
|
|
const de = new Date(e.endTime);
|
|
|
|
|
const oi = new CardItem();
|
|
|
|
|
oi.title = e.title === '' ? '(无标题)' : e.title;
|
|
|
|
|
oi.time = dayLong ? '全天' : `${p(ds.getHours())}:${p(ds.getMinutes())}`;
|
|
|
|
|
oi.endTime = dayLong ? '' : `${p(de.getHours())}:${p(de.getMinutes())}`;
|
|
|
|
|
oi.calName = e.calName;
|
|
|
|
|
oi.color = e.color;
|
|
|
|
|
oi.startMs = e.startTime;
|
|
|
|
|
oi.endMs = e.endTime;
|
|
|
|
|
oi.isNow = e.startTime <= nowMs && e.endTime > nowMs;
|
|
|
|
|
ongoingItems.push(oi);
|
|
|
|
|
}
|
|
|
|
|
data.ongoingJson = JSON.stringify(ongoingItems);
|
|
|
|
|
LogUtil.write(`卡片数据刷新:${items.length} 条,今日 ${data.todayCount} 条,进行中 ${ongoingItems.length} 条`);
|
2026-09-13 15:50:37 +08:00
|
|
|
} catch (err) {
|
|
|
|
|
LogUtil.write(`卡片数据刷新失败: ${JSON.stringify(err)}`);
|
|
|
|
|
}
|
|
|
|
|
return data;
|
|
|
|
|
}
|
|
|
|
|
}
|