Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
 laoyang
|
ed26da8dc4 | ||
|
laoyang
|
68329c57a0 | ||
|
laoyang
|
2b29f197e8 | ||
|
laoyang
|
da0249d9f4 | ||
|
laoyang
|
17d7602d7d | ||
|
laoyang
|
cd2401242c | ||
|
laoyang
|
5e6f347fc6 | ||
|
laoyang
|
5c80c0b773 | ||
|
laoyang
|
d5e5d54d35 | ||
|
laoyang
|
c76c78b8a6 | ||
|
laoyang
|
32162b8f04 | ||
|
laoyang
|
b83ce83d43 | ||
|
laoyang
|
d0b8720c41 |
+2
-2
@@ -2,8 +2,8 @@
|
||||
"app": {
|
||||
"bundleName": "synccalendar.yangyq.net",
|
||||
"vendor": "yangyq",
|
||||
"versionCode": 300,
|
||||
"versionName": "0.0.3",
|
||||
"versionCode": 700,
|
||||
"versionName": "0.0.7",
|
||||
"buildVersion": "1",
|
||||
"icon": "$media:layered_image",
|
||||
"label": "$string:app_name"
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
一款以**同步为核心**的鸿蒙原生日历应用，基于 HarmonyOS NEXT（ArkTS / Stage 模型）开发。对接标准 CalDAV 服务器（群晖、Nextcloud、Radicale、Baikal 等），让你的日程真正掌握在自己手里——不经过第三方云服务，数据始终同步在你自己的 NAS 上。
|
||||
|
||||
- 应用市场送审版本：**0.0.2** ｜ 仓库当前：**0.0.3**（versionCode 300）
|
||||
- 应用市场送审版本：**0.0.6** ｜ 仓库当前：**0.0.6**（versionCode 600）
|
||||
- 官网：<https://synccalendar.yangyq.net> ｜ 问题反馈：<https://synccalendar.yangyq.net/feedback/>
|
||||
- 开源协议：Apache License 2.0
|
||||
|
||||
@@ -55,11 +55,15 @@
|
||||
|
||||
### 后台同步与数据备份
|
||||
|
||||
- **自动同步间隔**：App 在前台时按设定间隔自动同步
|
||||
- **后台持续同步**：申请后台长时任务（`dataTransfer`），退到后台也按间隔继续同步，通知栏显示常驻通知
|
||||
- **系统级定时同步**：通过 WorkScheduler 扩展能力在条件满足时触发一轮同步
|
||||
- **前台自动同步**：App 在前台时按设定间隔自动同步（可设 1 / 5 / 15 / 30 分钟）
|
||||
- **后台自动同步**：开启后由系统定时唤起同步，退到后台也会继续（受系统省电策略限制，**最短约 2 小时一次**）
|
||||
- **回到前台 / 网络恢复补同步**：切回应用、或从断网恢复到有网时，**立即补同步一次**，保证你打开日历时数据总是最新的
|
||||
- **应用数据备份/恢复**：接入 Backup 扩展能力，换机时可恢复账号与本地数据
|
||||
|
||||
> 说明：HarmonyOS 出于省电考虑，**不允许普通应用在后台常驻并高频轮询**
|
||||
> （长时任务 `dataTransfer` 超过 10 分钟无进度即被系统取消，延迟任务存在小时级下限）。
|
||||
> 本应用遵循系统机制，采用「前台按间隔同步 + 后台定时唤起 + 回前台/网络恢复即时补同步」的分层组合。
|
||||
|
||||
### 界面与适配
|
||||
|
||||
- **深色模式**：全程使用资源引用（`$r('app.color.*')`），深浅两套色板一一对应，跟随系统自动切换
|
||||
@@ -69,7 +73,7 @@
|
||||
|
||||
### 设置项一览
|
||||
|
||||
系统日历处理方式（仅显示 / 备份到 CalDAV）· 镜像到系统日历 · 选择要镜像的日历本 · 回写开关 · 默认视图 · 日程显示方式 · 自动同步间隔 · 后台持续同步 · 通知权限 · 混合显示系统日历 · 日历本只读 / 静音 · 重建日程数据 · 重置账号库 · 软件特性 · 使用帮助 · 隐私政策与用户协议
|
||||
系统日历处理方式（仅显示 / 备份到 CalDAV）· 镜像到系统日历 · 选择要镜像的日历本 · 回写开关 · 默认视图 · 日程显示方式 · 自动同步间隔 · 后台自动同步 · 通知权限 · 混合显示系统日历 · 日历本只读 / 静音 · 重建日程数据 · 重置账号库 · 软件特性 · 使用帮助 · 隐私政策与用户协议
|
||||
|
||||
---
|
||||
|
||||
@@ -89,10 +93,11 @@
|
||||
|
||||
- **架构**：`SyncEngine` 同步引擎 + `DavClient`（HTTP / WebDAV）+ `EventDb`（relationalStore 本地库）+ `CalendarDataService`（多源合并展示）
|
||||
- **镜像**：`SystemCalendarMirror`（出站写入）+ `MirrorInbound`（入站回写）+ `MirrorSnapshot`（变更快照）
|
||||
- **后台调度**：`BackgroundSyncRunner`（后台同步唯一执行体）+ `BackgroundSyncService`（延迟任务/短时任务）+ `NetworkSyncWatcher`（网络恢复补同步）
|
||||
- **卡片**：FormExtensionAbility + FormBindingData，JSON 数据驱动渲染
|
||||
- **农历**：`LunarUtil`，1901–2099 压缩表推算
|
||||
- **提醒**：`ReminderService` 基于 `reminderAgentManager` 代理提醒
|
||||
- **权限**：INTERNET / READ_CALENDAR / READ_WHOLE_CALENDAR / WRITE_CALENDAR（仅镜像）/ PUBLISH_AGENT_REMINDER / KEEP_BACKGROUND_RUNNING / LOCATION（仅地点导航时）
|
||||
- **权限**：INTERNET / READ_CALENDAR / READ_WHOLE_CALENDAR / WRITE_CALENDAR（仅镜像）/ PUBLISH_AGENT_REMINDER / LOCATION（仅地点导航时）
|
||||
|
||||
### 目录结构
|
||||
|
||||
@@ -118,7 +123,7 @@ SyncCalendar/
|
||||
│ ├─ entryability/ 主能力
|
||||
│ ├─ entrybackupability/ 应用数据备份恢复
|
||||
│ ├─ entryformability/ 桌面卡片
|
||||
│ └─ syncwork/ 后台定时同步（WorkScheduler）
|
||||
│ └─ syncwork/ 后台定时同步（WorkScheduler 扩展能力）
|
||||
└─ resources/ base / dark 两套资源与颜色
|
||||
```
|
||||
|
||||
@@ -126,14 +131,169 @@ SyncCalendar/
|
||||
|
||||
## 📦 构建与运行
|
||||
|
||||
1. 使用 **DevEco Studio** 打开工程根目录
|
||||
2. 连接鸿蒙真机（需 HarmonyOS NEXT）或模拟器
|
||||
3. 编译安装后进入「≡ → 账号管理」，添加 CalDAV 服务器地址、用户名和密码
|
||||
4. 选择要同步的日历本，等待首次同步完成
|
||||
5. 长按桌面空白处 → 添加服务卡片，选择 SyncCalendar 的卡片规格
|
||||
### 一、准备工程
|
||||
|
||||
> 上架包构建：`hvigorw assembleApp --mode project -p product=default -p buildMode=release`
|
||||
> （需要在 `build-profile.json5` 里配置自己的签名，该文件不入库）
|
||||
1. 安装 **DevEco Studio**（建议 5.0 及以上，需配套 HarmonyOS NEXT SDK）
|
||||
2. 用 DevEco Studio 打开工程根目录，等待自动同步（`ohpm install`）完成
|
||||
3. 连接鸿蒙真机（需 HarmonyOS NEXT）或模拟器
|
||||
|
||||
### 二、首次构建：先补上签名配置（重要）
|
||||
|
||||
> **为什么需要自己配？**
|
||||
> 鸿蒙应用在编译安装与上架时都必须签名。工程根目录的 **`build-profile.json5`** 里记录了
|
||||
> 签名文件的**绝对路径与加密口令**，属于机器相关且敏感的凭据，因此该文件**被 `.gitignore` 排除、不在仓库中**。
|
||||
> 你从仓库克隆下来的代码默认**不含任何签名信息**，直接编译会失败。下面是补全方法。
|
||||
|
||||
#### 1. 需要准备哪些文件
|
||||
|
||||
签名一共涉及 **4 个文件**，全部放在仓库**之外**的某个目录里（例如 `D:\DevEcoSign\`）：
|
||||
|
||||
| 文件 | 格式 | 说明 |
|
||||
|---|---|---|
|
||||
| 密钥库 | `.p12` | 存放你的私钥与证书链，**最关键、绝不能泄露** |
|
||||
| 证书 | `.cer` | 与密钥库配套的应用证书 |
|
||||
| Profile | `.p7b` | 授权档案，决定该包能装到哪些设备 / 能否上架 |
|
||||
| （口令） | — | 密钥库口令、私钥口令（在生成时自己设定，请务必记牢） |
|
||||
|
||||
#### 2. 这些文件怎么申请、怎么得到
|
||||
|
||||
有两种途径，按你的目的选一种：
|
||||
|
||||
**途径 A：调试用（自用真机安装）—— 全自动，推荐**
|
||||
|
||||
DevEco Studio 可以一键生成并自动完成签名配置，无需手工操作：
|
||||
|
||||
1. 打开 `File → Project Structure → Project → Signing Configs`
|
||||
2. 勾选 **`Automatically generate signature`**（自动生成签名）
|
||||
3. 按提示登录你的**华为开发者账号**（需先在 [AppGallery Connect](https://developer.huawei.com/consumer/cn/) 完成实名认证）
|
||||
4. 等待自动完成——DevEco 会替你：生成 `.p12` 密钥库与 `.cer` 证书 → 向华为**申请调试 Profile（`.p7b`）**
|
||||
并自动注册当前设备 → 把 `signingConfigs` 写入 `build-profile.json5`
|
||||
5. 生成的文件默认落在 `C:\Users\<你>\.ohos\config\` 下
|
||||
|
||||
> 这是最省事的方式，**只要一个已实名认证的华为开发者账号**即可，不需要额外审批。
|
||||
|
||||
**途径 B：上架用（发布到应用市场）—— 需在 AGC 后台申请**
|
||||
|
||||
若要打**上架包**（`.app`），必须使用**发布证书 + 发布 Profile**，需手动申请：
|
||||
|
||||
1. 登录 [AppGallery Connect](https://developer.huawei.com/consumer/cn/)，进入
|
||||
`用户与访问 → 证书管理`，创建并下载：
|
||||
- **发布证书（`.cer`）**——需先在本机用 `keytool` 或 DevEco 生成一个 `.p12` 密钥库，
|
||||
再上传其生成的 **CSR 文件**申请证书；
|
||||
- **发布 Profile（`.p7b`）**——在 `证书、APP ID 和 Profile → Profile` 中新建，
|
||||
类型选 **发布（Release）**，关联上面的证书与你的 App ID。
|
||||
2. 记住创建密钥库时设定的**密钥库口令**与**私钥口令**。
|
||||
|
||||
> 官方文档入口：AppGallery Connect → 帮助中心 → **「配置应用签名」** / 「证书管理」。
|
||||
|
||||
#### 3. 在哪个文件里填写
|
||||
|
||||
在**仓库根目录**新建 `build-profile.json5`（就是被忽略的那份），填入你的签名信息。
|
||||
可直接复制仓库中的模板 **`build-profile.example.json5`** 改名为 `build-profile.json5` 后使用，格式如下：
|
||||
|
||||
```json5
|
||||
{
|
||||
"app": {
|
||||
"signingConfigs": [
|
||||
{
|
||||
// 调试配置：真机安装用这项
|
||||
"name": "default",
|
||||
"type": "HarmonyOS",
|
||||
"material": {
|
||||
"storeFile": "D:/DevEcoSign/your.p12", // ← 改成你的密钥库绝对路径
|
||||
"storePassword": "<你的密钥库口令>", // ← 自动生成时是一段密文
|
||||
"keyAlias": "your_key_alias", // ← 密钥别名（生成时指定）
|
||||
"keyPassword": "<你的私钥口令>", // ← 同上
|
||||
"signAlg": "SHA256withECDSA",
|
||||
"profile": "D:/DevEcoSign/yourDebug.p7b", // ← 调试 Profile
|
||||
"certpath": "D:/DevEcoSign/yourDebug.cer" // ← 配套证书
|
||||
}
|
||||
},
|
||||
{
|
||||
// 上架配置：打 .app 包用这项（真机安装勿用）
|
||||
"name": "release",
|
||||
"type": "HarmonyOS",
|
||||
"material": {
|
||||
"storeFile": "D:/DevEcoSign/your.p12",
|
||||
"storePassword": "<你的密钥库口令>",
|
||||
"keyAlias": "your_key_alias",
|
||||
"keyPassword": "<你的私钥口令>",
|
||||
"signAlg": "SHA256withECDSA",
|
||||
"profile": "D:/DevEcoSign/yourRelease.p7b", // ← 发布 Profile
|
||||
"certpath": "D:/DevEcoSign/yourRelease.cer" // ← 发布证书
|
||||
}
|
||||
}
|
||||
],
|
||||
"products": [
|
||||
{
|
||||
"name": "default",
|
||||
"signingConfig": "default", // 用哪套签名：debug 用 "default"，上架改 "release"
|
||||
"targetSdkVersion": "26.0.0",
|
||||
"compatibleSdkVersion": "6.1.1(24)",
|
||||
"runtimeOS": "HarmonyOS",
|
||||
"buildOption": {
|
||||
"strictMode": { "caseSensitiveCheck": true, "useNormalizedOHMUrl": true }
|
||||
}
|
||||
}
|
||||
],
|
||||
"buildModeSet": [ { "name": "debug" }, { "name": "release" } ]
|
||||
},
|
||||
"modules": [
|
||||
{ "name": "entry", "srcPath": "./entry",
|
||||
"targets": [ { "name": "default", "applyToProducts": [ "default" ] } ] }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**关键位置说明：**
|
||||
|
||||
| 位置 | 作用 |
|
||||
|---|---|
|
||||
| `signingConfigs[].material.*` | 四个签名文件的**绝对路径**与两个口令 |
|
||||
| `products[0].signingConfig` | 选哪套签名：真机安装填 `"default"`，打上架包填 `"release"` |
|
||||
|
||||
> ⚠️ **`build-profile.json5` 已在 `.gitignore` 中，请勿提交**。
|
||||
> 若用「途径 A」自动生成，DevEco 会自动创建并填好该文件，你通常无需手写。
|
||||
> 注意：`entry/build-profile.json5` 是**模块级**普通构建配置（不含密钥），它在仓库中是**需要保留**的，两者不要混淆。
|
||||
|
||||
#### 4. 一个更省事的替代做法
|
||||
|
||||
如果不想手写，也可以直接在 DevEco Studio 里操作：
|
||||
`File → Project Structure → Project → Signing Configs`，勾选 `Automatically generate signature`
|
||||
并登录华为开发者账号——DevEco 会自动把 `build-profile.json5` 生成好，随后直接编译即可。
|
||||
|
||||
### 三、编译运行
|
||||
|
||||
1. 点击 DevEco Studio 的 **Run ▶**，或执行：
|
||||
|
||||
```bash
|
||||
hvigorw assembleHap --mode module -p product=default
|
||||
```
|
||||
|
||||
2. 安装后进入「≡ → 账号管理」，添加 CalDAV 服务器地址、用户名和密码
|
||||
3. 选择要同步的日历本，等待首次同步完成
|
||||
4. 长按桌面空白处 → 添加服务卡片，选择 SyncCalendar 的卡片规格
|
||||
|
||||
### 四、打上架包（App Pack）
|
||||
|
||||
应用市场上架需要提交 **`.app`（App Pack）**，而不是 `.hap`（`.hap` 仅用于真机侧载）：
|
||||
|
||||
```bash
|
||||
hvigorw assembleApp --mode project -p product=default -p buildMode=release
|
||||
```
|
||||
|
||||
- 产物：`build/outputs/default/SyncCalendar-default-signed.app`
|
||||
- **前提**：请先把 `products[0].signingConfig` 改为 `"release"`（用发布证书 + 发布 Profile），
|
||||
否则会因签名不匹配而无法通过审核。
|
||||
- 校验签名（可选，`-inForm zip` 不可省，否则会误报 `can not find codesign block`）：
|
||||
|
||||
```bash
|
||||
java -jar hap-sign-tool.jar verify-app -inForm zip \
|
||||
-inFile SyncCalendar-default-signed.app \
|
||||
-outCertChain out.cer -outProfile out.p7b
|
||||
```
|
||||
|
||||
出现 `verify-app success` 即表示签名有效。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,90 @@
|
||||
/**
|
||||
* build-profile.json5 模板（示例）
|
||||
*
|
||||
* 用法：
|
||||
* 1. 把本文件复制为同目录下的 build-profile.json5
|
||||
* 2. 按注释把 <尖括号> 内容替换成你自己的签名信息
|
||||
* 3. 不要提交生成后的 build-profile.json5（它已在 .gitignore 中）
|
||||
*
|
||||
* 4 个签名文件（.p12 / .cer / .p7b ×2）需要放在仓库之外的任意目录，
|
||||
* 这里用 D:/DevEcoSign/ 作为示例路径，请改成你自己的真实路径。
|
||||
*
|
||||
* 如何获取这些文件、在哪里填写，详见 README.md 的「📦 构建与运行 → 二、首次构建：先补上签名配置」。
|
||||
*
|
||||
* 最省事的替代方案：用 DevEco Studio 打开工程 →
|
||||
* File → Project Structure → Project → Signing Configs →
|
||||
* 勾选 "Automatically generate signature" 并登录华为开发者账号，
|
||||
* IDE 会自动生成并填好本文件，无需手工编辑。
|
||||
*/
|
||||
{
|
||||
"app": {
|
||||
"signingConfigs": [
|
||||
{
|
||||
// ── 调试配置：真机安装 / 本地运行用这一项 ──
|
||||
"name": "default",
|
||||
"type": "HarmonyOS",
|
||||
"material": {
|
||||
"storeFile": "D:/DevEcoSign/<你的密钥库>.p12",
|
||||
"storePassword": "<密钥库口令>",
|
||||
"keyAlias": "<密钥别名>",
|
||||
"keyPassword": "<私钥口令>",
|
||||
"signAlg": "SHA256withECDSA",
|
||||
"profile": "D:/DevEcoSign/<你的调试Profile>.p7b",
|
||||
"certpath": "D:/DevEcoSign/<你的调试证书>.cer"
|
||||
}
|
||||
},
|
||||
{
|
||||
// ── 上架配置：打 .app 上架包用这一项（真机安装请勿使用）──
|
||||
"name": "release",
|
||||
"type": "HarmonyOS",
|
||||
"material": {
|
||||
"storeFile": "D:/DevEcoSign/<你的密钥库>.p12",
|
||||
"storePassword": "<密钥库口令>",
|
||||
"keyAlias": "<密钥别名>",
|
||||
"keyPassword": "<私钥口令>",
|
||||
"signAlg": "SHA256withECDSA",
|
||||
"profile": "D:/DevEcoSign/<你的发布Profile>.p7b",
|
||||
"certpath": "D:/DevEcoSign/<你的发布证书>.cer"
|
||||
}
|
||||
}
|
||||
],
|
||||
"products": [
|
||||
{
|
||||
"name": "default",
|
||||
// 用哪套签名：真机安装填 "default"；打上架包前改成 "release"
|
||||
"signingConfig": "default",
|
||||
"targetSdkVersion": "26.0.0",
|
||||
"compatibleSdkVersion": "6.1.1(24)",
|
||||
"runtimeOS": "HarmonyOS",
|
||||
"buildOption": {
|
||||
"strictMode": {
|
||||
"caseSensitiveCheck": true,
|
||||
"useNormalizedOHMUrl": true
|
||||
}
|
||||
}
|
||||
}
|
||||
],
|
||||
"buildModeSet": [
|
||||
{
|
||||
"name": "debug"
|
||||
},
|
||||
{
|
||||
"name": "release"
|
||||
}
|
||||
]
|
||||
},
|
||||
"modules": [
|
||||
{
|
||||
"name": "entry",
|
||||
"srcPath": "./entry",
|
||||
"targets": [
|
||||
{
|
||||
"name": "default",
|
||||
"applyToProducts": [
|
||||
"default"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,102 @@
|
||||
// entry/src/main/ets/common/BackgroundSyncRunner.ets
|
||||
// ⭐ 后台同步的**唯一**执行体：延迟任务 / 短时任务 / 网络恢复 / 回到前台 都调它。
|
||||
//
|
||||
// 设计要点（2026-10-10 定时同步方案调研结论）：
|
||||
// - 不再依赖"进程常驻"（系统不允许，dataTransfer 长时任务会被强制取消）
|
||||
// - 而是让"最合适的机制在最合适的时机把数据对齐"
|
||||
// - 本类只负责"跑一次完整同步"，幂等（基于 etag 全量比对 + dirty 标记）
|
||||
//
|
||||
// ⚠️ 与 SyncEngine.syncAccount 的分工：本类不关心超时与互斥锁（由 SyncEngine 内部处理）。
|
||||
import { common } from '@kit.AbilityKit';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { DavAccount, AccountStore, TYPE_CALDAV } from './AccountStore';
|
||||
import { SyncEngine } from './SyncEngine';
|
||||
import { CardDataService } from './CardDataService';
|
||||
import { ReminderService } from './ReminderService';
|
||||
import { SystemCalendarImport } from './SystemCalendarImport';
|
||||
import { SystemCalendarMirror } from './SystemCalendarMirror';
|
||||
import { MirrorInbound } from './MirrorInbound';
|
||||
import { AppSettings } from './AppSettings';
|
||||
import { LogUtil } from './LogUtil';
|
||||
|
||||
/** 一次后台同步的结果（供日志/埋点，不做 UI） */
|
||||
export class BackgroundSyncResult {
|
||||
ok: number = 0;
|
||||
attempted: number = 0;
|
||||
failed: number = 0;
|
||||
}
|
||||
|
||||
export class BackgroundSyncRunner {
|
||||
/**
|
||||
* 跑一次完整同步。全流程 try-catch，**永不抛错**（后台路径没有 UI 承担异常）。
|
||||
* @param context 应用上下文
|
||||
* @param tag 日志标签，用于区分触发来源（deferred/transient/netRecover/foreground）
|
||||
*/
|
||||
static async runOnce(context: common.Context, tag: string): Promise<BackgroundSyncResult> {
|
||||
const r = new BackgroundSyncResult();
|
||||
try {
|
||||
const accounts: DavAccount[] = await AccountStore.loadAll(context);
|
||||
if (accounts.length === 0) {
|
||||
LogUtil.write(`后台同步[${tag}]：无账号，跳过`);
|
||||
return r;
|
||||
}
|
||||
// 备份模式：先导入系统本地日历（幂等），再随同步推送
|
||||
try {
|
||||
await SystemCalendarImport.importIfNeeded(context);
|
||||
} catch (err) {
|
||||
// 导入失败不影响正常同步
|
||||
}
|
||||
// 入站对账：把用户在系统日历里的改动读回来置 dirty（必须在同步之前）
|
||||
try {
|
||||
await MirrorInbound.reconcile(context);
|
||||
} catch (err) {
|
||||
// 对账失败不影响正常同步
|
||||
}
|
||||
for (const acc of accounts) {
|
||||
if (acc.type !== TYPE_CALDAV) {
|
||||
continue;
|
||||
}
|
||||
r.attempted++;
|
||||
try {
|
||||
await SyncEngine.syncAccount(context, acc);
|
||||
r.ok++;
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
// "已有同步进行中"不算失败（前台可能正在同步）
|
||||
r.failed++;
|
||||
LogUtil.write(`后台同步[${tag}] id=${acc.id} 失败: ${e.message}`);
|
||||
}
|
||||
}
|
||||
// 全部账号同步成功才结束"一次性全量重拉"状态
|
||||
if (r.attempted > 0 && r.ok === r.attempted) {
|
||||
await AppSettings.markFullRefetchDone(context);
|
||||
}
|
||||
await SyncEngine.settleLocalEvents(context);
|
||||
await SyncEngine.pruneOrphanRows(context, accounts);
|
||||
// ⚠️ 必须回写账号：syncAccount 会就地更新 acc（服务器日历本颜色、写权限等）。
|
||||
// 缺了这一步，后台同步刷到的颜色只留在内存里、进程退出即丢失。
|
||||
await AccountStore.saveAll(context, accounts);
|
||||
// 出站镜像：把服务器最新状态写进系统日历（自动化，无需手点）
|
||||
try {
|
||||
if (await AppSettings.getMirrorEnabled(context) && await SystemCalendarMirror.hasPermission()) {
|
||||
const mr = await SystemCalendarMirror.syncNow(context);
|
||||
LogUtil.write(`后台同步[${tag}] 自动镜像：本=${mr.books} 新增=${mr.added} 更新=${mr.updated} 删除=${mr.deleted}`);
|
||||
}
|
||||
} catch (err) {
|
||||
// 镜像失败不影响同步
|
||||
}
|
||||
// 同步后刷新卡片 + 重建提醒，保证后台同步的成果直接可见
|
||||
try {
|
||||
await CardDataService.pushToAllForms(context);
|
||||
await ReminderService.refreshReminders(context as common.UIAbilityContext);
|
||||
} catch (err) {
|
||||
// 卡片/提醒刷新失败不影响同步结果
|
||||
}
|
||||
LogUtil.write(`后台同步[${tag}] 完成：${r.ok}/${r.attempted} 个账号`);
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`后台同步[${tag}] 流程异常: ${e.message}`);
|
||||
}
|
||||
return r;
|
||||
}
|
||||
}
|
||||
@@ -1,115 +1,152 @@
|
||||
// entry/src/main/ets/common/BackgroundSyncService.ets
|
||||
// 后台同步管理：
|
||||
// 1) 长时任务（DATA_TRANSFER）：进程不被挂起，前台定时器在后台继续跑（需用户在设置中开启）
|
||||
// 2) 延迟任务（workScheduler）：App 被杀/重启后由系统按条件拉起兜底同步（最小周期 20 分钟）
|
||||
// ⭐ 后台同步调度（2026-10-10 重构，依据《定时同步方案调研.md》）
|
||||
//
|
||||
// 为什么不再用长时任务（重要）：
|
||||
// 旧版申请 `dataTransfer` 长时任务想让进程常驻，但系统对 DATA_TRANSFER 有**一致性校验**——
|
||||
// "超过 10 分钟未更新传输进度 → 任务被强制取消"。日历同步是"间歇跑、平时无进度"，
|
||||
// 本质不符合"持续传输中"的语义 → 必被取消（常驻通知消失就是这个原因），
|
||||
// 且频繁触发校验失败可能被系统列入管控名单。故**彻底移除**。
|
||||
//
|
||||
// 现在的分层调度（每层各司其职）：
|
||||
// ① 前台：Index 里的 setInterval 按用户设定间隔同步（最准，已在前台实现）
|
||||
// ② 退后台瞬间：**短时任务**（requestSuspendDelay）兜住"退后台后那一次"
|
||||
// ③ 长期后台：**延迟任务**（workScheduler，≥2 小时，对齐系统活跃分组下限）
|
||||
// ④ 网络恢复 / 回到前台：各补一次（性价比最高，见 NetworkSyncWatcher / Index.onForeground）
|
||||
//
|
||||
// ⚠️ 关键约束（踩过的坑，勿改）：
|
||||
// - workScheduler 的 repeatCycleTime **不得低于 2 小时**：系统按"应用活跃分组"压制
|
||||
// （活跃≥2h / 经常使用≥4h / 常用≥24h / 极少使用≥48h / 受限·从未使用禁止调度），
|
||||
// 请求更短不报错但会被压制，形同虚设。
|
||||
// - WorkSchedulerExtensionAbility 单次回调**上限 2 分钟**，超时进程被杀。
|
||||
// - 短时任务配额：单日 10 分钟、单次最长 3 分钟（低电量 1 分钟）→ 只做短收尾，用完必须 cancel。
|
||||
import { backgroundTaskManager } from '@kit.BackgroundTasksKit';
|
||||
import { wantAgent, common } from '@kit.AbilityKit';
|
||||
import { common } from '@kit.AbilityKit';
|
||||
import { workScheduler } from '@kit.BackgroundTasksKit';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { AppSettings } from './AppSettings';
|
||||
import { LogUtil } from './LogUtil';
|
||||
|
||||
const WORK_ID: number = 1001;
|
||||
/** 延迟任务周期：2 小时（系统"活跃分组"下限，不可再短） */
|
||||
const DEFERRED_CYCLE_MS: number = 2 * 60 * 60 * 1000;
|
||||
|
||||
export class BackgroundSyncService {
|
||||
/** 申请长时任务（DATA_TRANSFER）：申请成功后进程在后台不被挂起，失败抛错由调用方提示用户 */
|
||||
static async startContinuousTask(context: common.UIAbilityContext): Promise<void> {
|
||||
try {
|
||||
const info: wantAgent.WantAgentInfo = {
|
||||
wants: [{
|
||||
bundleName: context.abilityInfo.bundleName,
|
||||
abilityName: 'EntryAbility'
|
||||
}],
|
||||
operationType: wantAgent.OperationType.START_ABILITY,
|
||||
requestCode: 0
|
||||
};
|
||||
const agent = await wantAgent.getWantAgent(info);
|
||||
await backgroundTaskManager.startBackgroundRunning(
|
||||
context, backgroundTaskManager.BackgroundMode.DATA_TRANSFER, agent);
|
||||
LogUtil.write('长时任务已申请：后台持续同步开启');
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`长时任务申请失败: ${e.code} - ${e.message}`);
|
||||
throw new Error(`长时任务申请失败（错误码 ${e.code}）`);
|
||||
}
|
||||
}
|
||||
|
||||
/** 停止长时任务 */
|
||||
static async stopContinuousTask(context: common.UIAbilityContext): Promise<void> {
|
||||
try {
|
||||
await backgroundTaskManager.stopBackgroundRunning(context);
|
||||
LogUtil.write('长时任务已停止');
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`长时任务停止失败: ${e.code} - ${e.message}`);
|
||||
}
|
||||
}
|
||||
/** 当前短时任务的 requestId（0 = 无）；退后台申请、回前台取消 */
|
||||
private static transientId: number = 0;
|
||||
|
||||
/**
|
||||
* 注册延迟任务兜底同步：无论长时任务开关与否都注册。
|
||||
* 条件：有任意网络即执行；周期重复；重启后自动恢复。
|
||||
* 注：repeatCycleTime 各版本下限不同（20 分钟 ~ 2 小时），先用 20 分钟，
|
||||
* 被系统拒绝（9700003 条件无效）时降级为 2 小时再试。
|
||||
* 注册延迟任务兜底同步：周期 2 小时、重启后自动恢复（isPersisted）。
|
||||
* 条件：有任意网络即执行。
|
||||
* ⚠️ 周期**不得低于 2 小时**（系统按"应用活跃分组"压制：活跃≥2h / 经常使用≥4h / 常用≥24h /
|
||||
* 极少使用≥48h / 受限·从未使用禁止调度）。请求更短不报错但会被压制，形同虚设。
|
||||
*/
|
||||
static scheduleDeferredSync(context: common.UIAbilityContext): void {
|
||||
const build = (cycleMs: number): workScheduler.WorkInfo => {
|
||||
const info: workScheduler.WorkInfo = {
|
||||
workId: WORK_ID,
|
||||
bundleName: context.abilityInfo.bundleName,
|
||||
abilityName: 'SyncWorkAbility',
|
||||
networkType: workScheduler.NetworkType.NETWORK_TYPE_ANY,
|
||||
isRepeat: true,
|
||||
isPersisted: true,
|
||||
repeatCycleTime: cycleMs
|
||||
};
|
||||
return info;
|
||||
const info: workScheduler.WorkInfo = {
|
||||
workId: WORK_ID,
|
||||
bundleName: context.abilityInfo.bundleName,
|
||||
abilityName: 'SyncWorkAbility',
|
||||
networkType: workScheduler.NetworkType.NETWORK_TYPE_ANY,
|
||||
isRepeat: true,
|
||||
isPersisted: true,
|
||||
repeatCycleTime: DEFERRED_CYCLE_MS
|
||||
};
|
||||
try {
|
||||
workScheduler.startWork(build(20 * 60 * 1000));
|
||||
LogUtil.write('延迟任务已注册：20 分钟兜底同步');
|
||||
workScheduler.startWork(info);
|
||||
LogUtil.write('延迟任务已注册：2 小时兜底同步（系统活跃分组下限）');
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
if (e.code === 9700003) {
|
||||
try {
|
||||
workScheduler.startWork(build(2 * 60 * 60 * 1000));
|
||||
LogUtil.write('延迟任务降级注册：2 小时兜底同步');
|
||||
return;
|
||||
} catch (err2) {
|
||||
const e2 = err2 as BusinessError;
|
||||
LogUtil.write(`延迟任务注册失败(2h): ${e2.code} - ${e2.message}`);
|
||||
return;
|
||||
}
|
||||
}
|
||||
LogUtil.write(`延迟任务注册失败: ${e.code} - ${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
/** App 启动时统一入口：注册延迟任务 + 按设置恢复长时任务（恢复失败静默，不影响启动） */
|
||||
static async initOnLaunch(context: common.UIAbilityContext): Promise<void> {
|
||||
BackgroundSyncService.scheduleDeferredSync(context);
|
||||
const enabled: boolean = await AppSettings.getBackgroundSync(context);
|
||||
if (enabled) {
|
||||
try {
|
||||
await BackgroundSyncService.startContinuousTask(context);
|
||||
} catch (err) {
|
||||
// 启动时恢复失败不阻塞 App：下次开关切换或重启再试
|
||||
}
|
||||
/** 取消延迟任务（用户关闭"后台自动同步"时调用） */
|
||||
static cancelDeferredSync(context: common.UIAbilityContext): void {
|
||||
const info: workScheduler.WorkInfo = {
|
||||
workId: WORK_ID,
|
||||
bundleName: context.abilityInfo.bundleName,
|
||||
abilityName: 'SyncWorkAbility',
|
||||
networkType: workScheduler.NetworkType.NETWORK_TYPE_ANY,
|
||||
isRepeat: true,
|
||||
isPersisted: true,
|
||||
repeatCycleTime: DEFERRED_CYCLE_MS
|
||||
};
|
||||
try {
|
||||
workScheduler.stopWork(info, true);
|
||||
LogUtil.write('延迟任务已取消（后台自动同步关闭）');
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`延迟任务取消失败: ${e.code} - ${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
/** 设置页开关切换：失败抛错由页面提示并回滚 UI */
|
||||
static async setBackgroundSync(context: common.UIAbilityContext, enabled: boolean): Promise<void> {
|
||||
/**
|
||||
* ⭐ 退到后台时申请**短时任务**：让"刚退后台的这一次同步"能跑完。
|
||||
* 必须在**前台或退后台 5 秒内**调用，否则申请失败。
|
||||
* 单次最长 3 分钟（实际申请到的时长以返回值为准），单日总配额 10 分钟。
|
||||
*/
|
||||
static requestTransientSync(reason: string): void {
|
||||
if (BackgroundSyncService.transientId !== 0) {
|
||||
return; // 已有短时任务在跑，不重复申请（重复申请会浪费配额）
|
||||
}
|
||||
try {
|
||||
const info: backgroundTaskManager.DelaySuspendInfo =
|
||||
backgroundTaskManager.requestSuspendDelay(reason, (): void => {
|
||||
// 超时回调：配额用完，系统即将挂起；清状态，等下次前台/退后台再申请
|
||||
LogUtil.write('短时任务超时（配额用尽），后台同步将被挂起');
|
||||
BackgroundSyncService.transientId = 0;
|
||||
});
|
||||
BackgroundSyncService.transientId = info.requestId;
|
||||
LogUtil.write(`短时任务已申请：requestId=${info.requestId}，可用 ${Math.round(info.actualDelayTime / 1000)} 秒`);
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`短时任务申请失败: ${e.code} - ${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
/** 回到前台时取消短时任务：不占用当日配额（很重要，配额只有 10 分钟） */
|
||||
static cancelTransientSync(): void {
|
||||
if (BackgroundSyncService.transientId === 0) {
|
||||
return;
|
||||
}
|
||||
try {
|
||||
backgroundTaskManager.cancelSuspendDelay(BackgroundSyncService.transientId);
|
||||
LogUtil.write('短时任务已取消（回到前台，归还配额）');
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`短时任务取消失败: ${e.code} - ${e.message}`);
|
||||
}
|
||||
BackgroundSyncService.transientId = 0;
|
||||
}
|
||||
|
||||
/** 查询短时任务剩余时间（毫秒）；无任务或无配额返回 0 */
|
||||
static async remainingTransientMs(): Promise<number> {
|
||||
if (BackgroundSyncService.transientId === 0) {
|
||||
return 0;
|
||||
}
|
||||
try {
|
||||
return await backgroundTaskManager.getRemainingDelayTime(BackgroundSyncService.transientId);
|
||||
} catch (err) {
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
/** App 启动时统一入口：按用户设置注册/不注册延迟任务兜底同步 */
|
||||
static async initOnLaunch(context: common.UIAbilityContext): Promise<void> {
|
||||
const enabled: boolean = await AppSettings.getBackgroundSync(context);
|
||||
if (enabled) {
|
||||
// 先申请任务，成功才落盘设置（失败时设置页回滚开关）
|
||||
await BackgroundSyncService.startContinuousTask(context);
|
||||
await AppSettings.setBackgroundSync(context, true);
|
||||
BackgroundSyncService.scheduleDeferredSync(context);
|
||||
} else {
|
||||
await AppSettings.setBackgroundSync(context, false);
|
||||
try {
|
||||
await BackgroundSyncService.stopContinuousTask(context);
|
||||
} catch (err) {
|
||||
// 停止失败（如任务本就不在运行）不影响设置保存
|
||||
}
|
||||
LogUtil.write('后台自动同步未开启：不注册延迟任务');
|
||||
}
|
||||
}
|
||||
|
||||
/** 设置页开关切换：控制"后台自动同步"（延迟任务注册与否） */
|
||||
static async setBackgroundSync(context: common.UIAbilityContext, enabled: boolean): Promise<void> {
|
||||
await AppSettings.setBackgroundSync(context, enabled);
|
||||
if (enabled) {
|
||||
BackgroundSyncService.scheduleDeferredSync(context);
|
||||
} else {
|
||||
BackgroundSyncService.cancelDeferredSync(context);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -36,6 +36,20 @@ export class DavCalendarDiscovery {
|
||||
entries: DavCalendarEntry[] = [];
|
||||
}
|
||||
|
||||
/**
|
||||
* 带 HTTP 状态码的 DAV 请求错误。
|
||||
* 同步引擎据此区分「404 日历本/资源在服务器上已不存在」（可降级处理：
|
||||
* 单本跳过、自动从账号移除）与其它网络/服务器故障（整个账号同步失败）。
|
||||
*/
|
||||
export class DavHttpError extends Error {
|
||||
readonly status: number;
|
||||
|
||||
constructor(status: number, message: string) {
|
||||
super(message);
|
||||
this.status = status;
|
||||
}
|
||||
}
|
||||
|
||||
export class DavClient {
|
||||
/**
|
||||
* PROPFIND 拉取某路径下所有集合的 calendar-color
|
||||
@@ -346,7 +360,7 @@ export class DavClient {
|
||||
});
|
||||
LogUtil.write(`HTTP REPORT(etag) ${href} → ${resp.responseCode}`);
|
||||
if (resp.responseCode < 200 || resp.responseCode >= 300) {
|
||||
throw new Error(`服务器返回状态码 ${resp.responseCode}`);
|
||||
throw new DavHttpError(resp.responseCode, `服务器返回状态码 ${resp.responseCode}`);
|
||||
}
|
||||
const xml: string = resp.result as string;
|
||||
const items: RemoteItem[] = [];
|
||||
@@ -403,11 +417,11 @@ export class DavClient {
|
||||
LogUtil.write(`HTTP REPORT(${compName}) ${href} → ${resp.responseCode}`);
|
||||
if (resp.responseCode === 401) {
|
||||
LogUtil.write(`HTTP REPORT(${compName}) 401 拒绝凭据`);
|
||||
throw new Error('服务器拒绝凭据(401)');
|
||||
throw new DavHttpError(401, '服务器拒绝凭据(401)');
|
||||
}
|
||||
if (resp.responseCode < 200 || resp.responseCode >= 300) {
|
||||
LogUtil.write(`HTTP REPORT(${compName}) 异常状态码 ${resp.responseCode}`);
|
||||
throw new Error(`服务器返回状态码 ${resp.responseCode}`);
|
||||
throw new DavHttpError(resp.responseCode, `服务器返回状态码 ${resp.responseCode}`);
|
||||
}
|
||||
const xml: string = resp.result as string;
|
||||
LogUtil.write(`HTTP REPORT(${compName}) 响应体 ${xml.length} 字符`);
|
||||
@@ -459,7 +473,7 @@ export class DavClient {
|
||||
console.info(`PUT ${url} 响应码: ${resp.responseCode}`);
|
||||
LogUtil.write(`HTTP PUT ${url} → ${resp.responseCode}`);
|
||||
if (resp.responseCode < 200 || resp.responseCode >= 300) {
|
||||
throw new Error(`推送失败，服务器返回 ${resp.responseCode}`);
|
||||
throw new DavHttpError(resp.responseCode, `推送失败，服务器返回 ${resp.responseCode}`);
|
||||
}
|
||||
const headers = resp.header as Record<string, string>;
|
||||
if (headers !== undefined && headers !== null) {
|
||||
@@ -489,7 +503,7 @@ export class DavClient {
|
||||
LogUtil.write(`HTTP DELETE ${url} → ${resp.responseCode}`);
|
||||
// 404 视为已删除，成功
|
||||
if ((resp.responseCode < 200 || resp.responseCode >= 300) && resp.responseCode !== 404) {
|
||||
throw new Error(`删除失败，服务器返回 ${resp.responseCode}`);
|
||||
throw new DavHttpError(resp.responseCode, `删除失败，服务器返回 ${resp.responseCode}`);
|
||||
}
|
||||
} finally {
|
||||
httpRequest.destroy();
|
||||
|
||||
@@ -0,0 +1,458 @@
|
||||
// entry/src/main/ets/common/DavDiscovery.ets
|
||||
// ⭐ CalDAV 地址自动发现与智能补全（0.0.7）
|
||||
//
|
||||
// 解决的用户问题（见《CalDAV排查指南-405与读不出日历.md》）：
|
||||
// 用户习惯只填域名或 DAV 根，而 Nextcloud 等要求填「日历家目录」
|
||||
// （/remote.php/dav/calendars/<用户名>/）。填错表现为"读不出日历"或 405。
|
||||
// DAVx5 能用是因为它内置 .well-known 自动发现 —— 本模块补上这一能力。
|
||||
//
|
||||
// 发现顺序（逐级降级，任一成功即停）：
|
||||
// ① 用户填的地址原样探测（保持既有行为，兼容已能用的用户）
|
||||
// ② .well-known/caldav（RFC 6764 标准；Nextcloud/Radicale/Baïkal 均支持）
|
||||
// ③ 常见候选路径拼接（remote.php/dav/calendars/<用户名>/ 等）
|
||||
//
|
||||
// ⚠️ 设计约束：
|
||||
// - 全部探测都是 PROPFIND + Depth:0，只判断「是不是能列出日历的端点」，不做副作用；
|
||||
// - 单次探测失败不抛错（网络异常吞掉继续试下一个），保证不会因某个候选不可达而整体失败；
|
||||
// - 最终由调用方用 listCalendars 校验（能列出 calendar 集合才算真成功）。
|
||||
import { http } from '@kit.NetworkKit';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { LogUtil } from './LogUtil';
|
||||
|
||||
/** 发现结果：拿到一个可用的"日历集合列表"端点 */
|
||||
export class DiscoverResult {
|
||||
ok: boolean = false;
|
||||
url: string = ''; // 最终可用的端点 URL
|
||||
via: string = ''; // 来源：direct / well-known / candidate / public
|
||||
readOnly: boolean = false; // 是否只读（公开日历分享）；本版本仅识别，不做写入
|
||||
hint: string = ''; // 失败时给用户的可操作提示
|
||||
}
|
||||
|
||||
/** 415/405 之外：用于判断"不是 DAV 端点"的状态码集合 */
|
||||
const NOT_DAV_CODES: number[] = [404, 405, 501];
|
||||
|
||||
export class DavDiscovery {
|
||||
// ───────────────────────── 公开工具：URL 形态识别 ─────────────────────────
|
||||
|
||||
/** 取 origin（scheme://host[:port]） */
|
||||
static originOf(url: string): string {
|
||||
const m = /^https?:\/\/[^/]+/i.exec(url.trim());
|
||||
return m !== null ? m[0] : '';
|
||||
}
|
||||
|
||||
/** 规范化：去掉末尾多余斜杠、去空白 */
|
||||
static tidy(url: string): string {
|
||||
let s: string = url.trim();
|
||||
// 去掉查询与片段（发现阶段不保留）
|
||||
s = s.replace(/[?#].*$/, '');
|
||||
while (s.endsWith('/') && s.length > DavDiscovery.originOf(s).length + 1) {
|
||||
s = s.substring(0, s.length - 1);
|
||||
}
|
||||
return s;
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 识别「网页分享链接」——这类地址对 PROPFIND 一律 405，必须提前拦下并提示。
|
||||
* 覆盖：
|
||||
* - Nextcloud 日历分享页：/apps/calendar/p/<token>
|
||||
* - Nextcloud 文件分享页：/s/<token>、/index.php/s/<token>
|
||||
* - Nextcloud 公开日历（只读，可用）：/remote.php/dav/public-calendars/<token>
|
||||
*/
|
||||
static classify(url: string): string {
|
||||
const u: string = url.trim();
|
||||
const path = u.replace(/^https?:\/\/[^/]+/i, '');
|
||||
if (/^\/apps\/calendar\/p\//i.test(path)) {
|
||||
return 'share_calendar'; // 日历分享页面（网页）
|
||||
}
|
||||
if (/^\/(index\.php\/)?s\//i.test(path)) {
|
||||
return 'share_file'; // 文件分享页面（网页）
|
||||
}
|
||||
if (/^\/remote\.php\/dav\/public-calendars\//i.test(path)) {
|
||||
return 'public_caldav'; // 公开日历（DAV，只读）
|
||||
}
|
||||
if (/^\/remote\.php\/dav\/public-calendars$/i.test(path.replace(/\/$/, ''))) {
|
||||
return 'public_caldav';
|
||||
}
|
||||
return 'normal';
|
||||
}
|
||||
|
||||
/** 分享链接 → 给用户的人话解释 */
|
||||
static shareHint(kind: string): string {
|
||||
if (kind === 'share_calendar') {
|
||||
return '这是 Nextcloud 的「日历分享链接」（网页地址），CalDAV 客户端不能直接使用。'
|
||||
+ '请在 Nextcloud 网页版「日历 → 左下角设置 → 目标日历 → 复制私有链接」，'
|
||||
+ '把得到的私有链接填到「服务器地址」。';
|
||||
}
|
||||
if (kind === 'share_file') {
|
||||
return '这是文件分享链接（网页地址），不是 CalDAV 地址。'
|
||||
+ '请改用日历的「私有链接」：Nextcloud 网页版「日历 → 设置 → 复制私有链接」。';
|
||||
}
|
||||
return '';
|
||||
}
|
||||
|
||||
/**
|
||||
* 是否为"只可能返回 405/404 的网页地址"——用于在探测前直接拦截，省一次请求。
|
||||
*/
|
||||
static isWebPage(url: string): boolean {
|
||||
const k: string = DavDiscovery.classify(url);
|
||||
return k === 'share_calendar' || k === 'share_file';
|
||||
}
|
||||
|
||||
/**
|
||||
* DAV 根 / 站点根 → 需要补全。用于判断是否值得走候选路径。
|
||||
* `/remote.php/dav` 或仅 origin 时，多半缺"日历家目录"这一层。
|
||||
*/
|
||||
static looksIncomplete(url: string): boolean {
|
||||
const path: string = DavDiscovery.tidy(url).replace(/^https?:\/\/[^/]+/i, '').replace(/\/$/, '');
|
||||
if (path === '' || path === '/') {
|
||||
return true; // 只填了域名
|
||||
}
|
||||
if (/\/remote\.php\/dav$/i.test(path)) {
|
||||
return true; // DAV 根
|
||||
}
|
||||
if (/\/remote\.php\/dav\/(calendars|addressbooks)$/i.test(path)) {
|
||||
return true; // 少了用户名一层
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
// ───────────────────────── 探测原语 ─────────────────────────
|
||||
|
||||
/**
|
||||
* PROPFIND Depth:0 探测端点：只关心"能不能列、是不是 DAV"。
|
||||
* 不抛错：网络异常/状态码异常都返回可判定的结果。
|
||||
*/
|
||||
static async probe(url: string, auth: string): Promise<number> {
|
||||
const body: string =
|
||||
'<?xml version="1.0" encoding="utf-8"?>' +
|
||||
'<d:propfind xmlns:d="DAV:"><d:prop><d:resourcetype/></d:prop></d:propfind>';
|
||||
const httpRequest = http.createHttp();
|
||||
try {
|
||||
const resp: http.HttpResponse = await httpRequest.request(url, {
|
||||
method: 'PROPFIND' as http.RequestMethod,
|
||||
header: {
|
||||
'Authorization': auth,
|
||||
'Content-Type': 'application/xml; charset=utf-8',
|
||||
'Depth': '0',
|
||||
'User-Agent': 'SyncCalendar/1.0'
|
||||
},
|
||||
extraData: body,
|
||||
connectTimeout: 8000,
|
||||
readTimeout: 12000
|
||||
});
|
||||
LogUtil.write(`HTTP PROPFIND(发现) ${url} → ${resp.responseCode}`);
|
||||
return resp.responseCode;
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`PROPFIND(发现) ${url} 异常: ${e.code} - ${e.message}`);
|
||||
return 0; // 0 = 网络层失败
|
||||
} finally {
|
||||
httpRequest.destroy();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ OPTIONS 探测服务器的 DAV 能力：
|
||||
* - 返回 `DAV:` 响应头 → 标准 WebDAV
|
||||
* - 返回 `Allow` 里含 PROPFIND/REPORT → 支持 CalDAV 所需方法
|
||||
* 用于区分"这不是 DAV 端点"（如网页路由）与"服务端把方法挡了"。
|
||||
*/
|
||||
static async optionsCapability(url: string, auth: string): Promise<DavCapability> {
|
||||
const cap = new DavCapability();
|
||||
const httpRequest = http.createHttp();
|
||||
try {
|
||||
const resp: http.HttpResponse = await httpRequest.request(url, {
|
||||
method: http.RequestMethod.OPTIONS,
|
||||
header: {
|
||||
'Authorization': auth,
|
||||
'User-Agent': 'SyncCalendar/1.0'
|
||||
},
|
||||
connectTimeout: 8000,
|
||||
readTimeout: 12000
|
||||
});
|
||||
cap.status = resp.responseCode;
|
||||
const headers = resp.header as Record<string, string>;
|
||||
if (headers !== undefined && headers !== null) {
|
||||
// 头名大小写不统一，逐个大小写变体试
|
||||
const dav = headers['DAV'] ?? headers['Dav'] ?? headers['dav'] ?? '';
|
||||
const allow = headers['Allow'] ?? headers['allow'] ?? '';
|
||||
cap.davHeader = typeof dav === 'string' ? dav : '';
|
||||
cap.allow = typeof allow === 'string' ? allow : '';
|
||||
cap.isDav = cap.davHeader !== '' || /PROPFIND/i.test(cap.allow);
|
||||
cap.supportsPropfind = /PROPFIND/i.test(cap.allow) || cap.isDav;
|
||||
cap.supportsReport = /REPORT/i.test(cap.allow);
|
||||
// Allow 明确列出但两者都没有 → 大概率不是 DAV
|
||||
if (cap.allow !== '' && !cap.supportsPropfind) {
|
||||
cap.isDav = false;
|
||||
}
|
||||
}
|
||||
LogUtil.write(`OPTIONS ${url} → ${resp.responseCode}，DAV=${cap.davHeader || '(无)'}，Allow=${cap.allow || '(无)'}`);
|
||||
return cap;
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`OPTIONS ${url} 异常: ${e.code} - ${e.message}`);
|
||||
return cap;
|
||||
} finally {
|
||||
httpRequest.destroy();
|
||||
}
|
||||
}
|
||||
|
||||
// ───────────────────────── 候选路径生成 ─────────────────────────
|
||||
|
||||
/**
|
||||
* 生成候选「日历家目录 / 集合列表」端点。
|
||||
* @param base 用户填入并规范化后的地址
|
||||
* @param username 用户名（用于 Nextcloud 的 calendars/<用户名>/ 等模式）
|
||||
*/
|
||||
static candidates(base: string, username: string): string[] {
|
||||
const origin: string = DavDiscovery.originOf(base);
|
||||
const out: string[] = [];
|
||||
if (origin === '') {
|
||||
return out;
|
||||
}
|
||||
const path: string = DavDiscovery.tidy(base).substring(origin.length);
|
||||
// 站点可能部署在子目录（如 /nextcloud）——保留用户填的前缀，只补 DAV 相关部分
|
||||
// 例：填 https://h/nextcloud → 前缀 /nextcloud
|
||||
let prefix: string = '';
|
||||
const idx: number = path.toLowerCase().indexOf('/remote.php');
|
||||
if (idx >= 0) {
|
||||
prefix = path.substring(0, idx);
|
||||
} else if (path !== '' && path !== '/') {
|
||||
prefix = path.replace(/\/$/, '');
|
||||
}
|
||||
const u: string = encodeURIComponent(username);
|
||||
const push = (p: string): void => {
|
||||
const full: string = origin + p;
|
||||
if (out.indexOf(full) < 0 && DavDiscovery.tidy(full) !== DavDiscovery.tidy(base)) {
|
||||
out.push(full);
|
||||
}
|
||||
};
|
||||
// Nextcloud / ownCloud
|
||||
push(`${prefix}/remote.php/dav/calendars/${u}/`);
|
||||
push(`${prefix}/remote.php/dav`);
|
||||
// Radicale（通常直接就是 /<用户名>/）
|
||||
push(`${prefix}/${u}/`);
|
||||
// Baïkal
|
||||
push(`${prefix}/dav.php/calendars/${u}/`);
|
||||
// 通用：直接在根下找
|
||||
push(`${prefix}/`);
|
||||
return out;
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 主入口：在给定端点集合上依次探测，返回第一个"能列出日历"的端点。
|
||||
* 判据＝PROPFIND 得 207/200。真正的"日历集合筛选"仍由 DavClient.listCalendars 完成
|
||||
* （本方法只负责找到"哪个地址对"，避免与既有解析逻辑重复）。
|
||||
*
|
||||
* @param rawUrl 用户填入的原始地址（未规范化也可）
|
||||
* @param username 用户名
|
||||
* @param auth Authorization 头
|
||||
* @param verify 可选的校验函数：传入端点，返回是否真的能列出日历（由调用方注入 listCalendars）
|
||||
*/
|
||||
static async resolve(rawUrl: string, username: string, auth: string,
|
||||
verify?: (url: string) => Promise<boolean>): Promise<DiscoverResult> {
|
||||
const res = new DiscoverResult();
|
||||
const base: string = DavDiscovery.tidy(rawUrl);
|
||||
|
||||
// ① 网页分享链接：直接拦下，不浪费请求
|
||||
const kind: string = DavDiscovery.classify(base);
|
||||
if (kind === 'share_calendar' || kind === 'share_file') {
|
||||
res.ok = false;
|
||||
res.hint = DavDiscovery.shareHint(kind);
|
||||
LogUtil.write(`发现：识别为网页分享链接，已拦截（${kind}）`);
|
||||
return res;
|
||||
}
|
||||
|
||||
const check = async (url: string, via: string): Promise<boolean> => {
|
||||
const code: number = await DavDiscovery.probe(url, auth);
|
||||
if (code !== 207 && code !== 200) {
|
||||
return false;
|
||||
}
|
||||
if (verify !== undefined) {
|
||||
const good: boolean = await verify(url);
|
||||
if (!good) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
res.ok = true;
|
||||
res.url = url;
|
||||
res.via = via;
|
||||
res.readOnly = (kind === 'public_caldav');
|
||||
LogUtil.write(`发现成功（${via}）：${url}`);
|
||||
return true;
|
||||
};
|
||||
|
||||
// ① 用户填的地址优先（保持既有行为）
|
||||
if (await check(base, 'direct')) {
|
||||
return res;
|
||||
}
|
||||
|
||||
// ①b ⭐ 公开日历（只读订阅）：Nextcloud 的 public-calendars 链接本身即端点。
|
||||
// 此类端点通常无需认证，且只能读——后续由 SyncEngine 的写权限探测自动标记为只读。
|
||||
if (kind === 'public_caldav') {
|
||||
// 若用户填的是 public-calendars 根（少了 token），无法继续推断，直接给提示
|
||||
res.ok = false;
|
||||
res.hint = '这是「公开日历」链接但似乎不完整。请使用完整的公开日历地址'
|
||||
+ '（形如 https://你的域名/remote.php/dav/public-calendars/<令牌>/），'
|
||||
+ '或改用日历的「私有链接」以获得可读可写体验。';
|
||||
return res;
|
||||
}
|
||||
|
||||
// ② .well-known/caldav（RFC 6764）——标准自动发现
|
||||
const origin: string = DavDiscovery.originOf(base);
|
||||
if (origin !== '') {
|
||||
const wk: string = await DavDiscovery.resolveWellKnown(origin, auth);
|
||||
if (wk !== '') {
|
||||
if (await check(wk, 'well-known')) {
|
||||
return res;
|
||||
}
|
||||
// .well-known 给了地址但直接探测不通过 → 也纳入候选由 ③ 继续尝试其下级
|
||||
LogUtil.write(`.well-known 指向 ${wk}，但该地址未通过日历校验，继续尝试常见路径`);
|
||||
}
|
||||
}
|
||||
|
||||
// ③ 常见候选路径
|
||||
const cands: string[] = DavDiscovery.candidates(base, username);
|
||||
for (const c of cands) {
|
||||
if (await check(c, 'candidate')) {
|
||||
return res;
|
||||
}
|
||||
}
|
||||
|
||||
// 全部失败 → 给可操作提示（区分"不是 DAV 端点"与"能连但列不出日历"）
|
||||
res.ok = false;
|
||||
const cap: DavCapability = await DavDiscovery.optionsCapability(base, auth);
|
||||
if (cap.status === 405 || (!cap.isDav && cap.allow !== '' && !cap.supportsPropfind)) {
|
||||
res.hint = '该地址不是 CalDAV 端点（服务器不接受 WebDAV 方法，返回 405）。'
|
||||
+ '常见原因是填了网页分享链接、或只填了站点的 DAV 根。'
|
||||
+ 'Nextcloud 请填「日历 → 设置 → 复制私有链接」得到的地址，例如：'
|
||||
+ '`https://你的域名/remote.php/dav/calendars/你的用户名/`';
|
||||
} else if (cap.status === 401) {
|
||||
res.hint = '服务器拒绝凭据（401），请检查用户名与密码。'
|
||||
+ 'Nextcloud 若开启了二次验证，需要使用「应用密码」。';
|
||||
} else if (cap.status === 301 || cap.status === 302) {
|
||||
res.hint = '服务器发生了跳转，通常说明 `.well-known/caldav` 未正确配置'
|
||||
+ '（常见于反向代理或子目录部署）。可请 NAS 管理员把 `.well-known/caldav` '
|
||||
+ '指向 `/remote.php/dav`，或直接填写完整的「日历家目录」地址。';
|
||||
} else {
|
||||
res.hint = '已连接上服务器，但在该地址下未发现任何日历本。'
|
||||
+ '请确认填的是「日历家目录」而不是 DAV 根，例如：'
|
||||
+ '`https://你的域名/remote.php/dav/calendars/你的用户名/`';
|
||||
}
|
||||
return res;
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析 .well-known/caldav：
|
||||
* - 直接返回 207/200 → 该 URL 本身即端点
|
||||
* - 返回 301/302/307/308 → 读 Location 头作为端点
|
||||
* - 返回 401 时也读 Location（Nextcloud 常在认证后跳转）
|
||||
*/
|
||||
static async resolveWellKnown(origin: string, auth: string): Promise<string> {
|
||||
const url: string = `${origin}/.well-known/caldav`;
|
||||
const httpRequest = http.createHttp();
|
||||
try {
|
||||
const resp: http.HttpResponse = await httpRequest.request(url, {
|
||||
method: 'PROPFIND' as http.RequestMethod,
|
||||
header: {
|
||||
'Authorization': auth,
|
||||
'Content-Type': 'application/xml; charset=utf-8',
|
||||
'Depth': '0',
|
||||
'User-Agent': 'SyncCalendar/1.0'
|
||||
},
|
||||
extraData: '<?xml version="1.0" encoding="utf-8"?>' +
|
||||
'<d:propfind xmlns:d="DAV:"><d:prop><d:resourcetype/></d:prop></d:propfind>',
|
||||
connectTimeout: 8000,
|
||||
readTimeout: 12000
|
||||
});
|
||||
LogUtil.write(`HTTP PROPFIND(.well-known) ${url} → ${resp.responseCode}`);
|
||||
if (resp.responseCode === 207 || resp.responseCode === 200) {
|
||||
return url;
|
||||
}
|
||||
if (resp.responseCode === 301 || resp.responseCode === 302
|
||||
|| resp.responseCode === 307 || resp.responseCode === 308 || resp.responseCode === 401) {
|
||||
const headers = resp.header as Record<string, string>;
|
||||
if (headers !== undefined && headers !== null) {
|
||||
const loc = headers['Location'] ?? headers['location'] ?? '';
|
||||
if (typeof loc === 'string' && loc !== '') {
|
||||
const full: string = loc.startsWith('http') ? loc : origin + (loc.startsWith('/') ? '' : '/') + loc;
|
||||
LogUtil.write(`.well-known 跳转到：${full}`);
|
||||
return DavDiscovery.tidy(full);
|
||||
}
|
||||
}
|
||||
}
|
||||
return '';
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`.well-known 探测异常: ${e.code} - ${e.message}`);
|
||||
return '';
|
||||
} finally {
|
||||
httpRequest.destroy();
|
||||
}
|
||||
}
|
||||
|
||||
/** 状态码是否表示"该地址不是 DAV 端点" */
|
||||
static isNotDav(code: number): boolean {
|
||||
return NOT_DAV_CODES.indexOf(code) >= 0;
|
||||
}
|
||||
|
||||
// ───────────────────────── 给用户的"人话提示"（两个页面共用） ─────────────────────────
|
||||
|
||||
/**
|
||||
* ⭐ 把 HTTP 状态码翻译成"人话 + 可操作指引"。
|
||||
* 用户看到"服务器返回 405"无从下手，这里直接告诉他下一步做什么。
|
||||
*/
|
||||
static statusHint(code: number): string {
|
||||
if (code === 405) {
|
||||
return '该地址不是 CalDAV 端点（服务器不接受 WebDAV 方法，返回 405）。\n\n'
|
||||
+ '常见原因：填了「分享链接」（网页地址），或只填到 DAV 根。\n'
|
||||
+ '请填「日历家目录」，例如：\n'
|
||||
+ 'https://你的域名/remote.php/dav/calendars/你的用户名/\n\n'
|
||||
+ 'Nextcloud 可在网页版「日历 → 左下角设置 → 目标日历 → 复制私有链接」拿到这个地址。';
|
||||
}
|
||||
if (code === 401) {
|
||||
return '服务器拒绝凭据（401）：请检查用户名与密码。\n'
|
||||
+ '若服务器开启了二次验证（2FA），需要使用「应用密码」而不是登录密码。';
|
||||
}
|
||||
if (code === 403) {
|
||||
return '服务器拒绝访问（403）：账号可能无权限，或 IP 被限制。请检查账号权限与服务器访问限制。';
|
||||
}
|
||||
if (code === 404) {
|
||||
return '地址不存在（404）：请检查路径是否写错。\n'
|
||||
+ '正确形式通常为 https://你的域名/remote.php/dav/calendars/你的用户名/';
|
||||
}
|
||||
if (code === 301 || code === 302 || code === 307 || code === 308) {
|
||||
return '服务器发生跳转：通常说明 `.well-known/caldav` 未正确配置（常见于反向代理或子目录部署）。\n'
|
||||
+ '请直接填写完整的「日历家目录」地址，或请 NAS 管理员配置 `.well-known/caldav`。';
|
||||
}
|
||||
if (code === 0) {
|
||||
return '无法连接服务器：请确认地址、端口与网络（内网地址需在同一局域网）。';
|
||||
}
|
||||
return `获取日历列表失败，服务器返回：${code}`;
|
||||
}
|
||||
|
||||
/** ⭐ 能连上但"未发现日历本"时的提示：区分"地址差一层"与"确实是空的" */
|
||||
static emptyHint(url: string, username: string): string {
|
||||
if (DavDiscovery.looksIncomplete(url)) {
|
||||
const cands: string[] = DavDiscovery.candidates(url, username);
|
||||
const example: string = cands.length > 0 ? cands[0] : '';
|
||||
return '该地址下没有日历本 —— 多半是地址「少了一层」。\n\n'
|
||||
+ '你填的是服务器根路径，但 CalDAV 需要填到「日历家目录」。请试试：\n'
|
||||
+ (example !== '' ? example + '\n\n' : '\n')
|
||||
+ '（Nextcloud 可在网页版「日历 → 设置 → 复制私有链接」直接拿到）';
|
||||
}
|
||||
return '该地址下未发现日历本。请确认：\n'
|
||||
+ '1) 服务器上确实已创建日历；\n'
|
||||
+ '2) 填的是「日历家目录」（形如 .../remote.php/dav/calendars/用户名/）而不是 DAV 根。';
|
||||
}
|
||||
}
|
||||
|
||||
/** OPTIONS 探测结果 */
|
||||
export class DavCapability {
|
||||
status: number = 0;
|
||||
davHeader: string = ''; // `DAV:` 响应头（含 "1", "2", "calendar-access" 等）
|
||||
allow: string = ''; // `Allow` 头
|
||||
isDav: boolean = false;
|
||||
supportsPropfind: boolean = false;
|
||||
supportsReport: boolean = false;
|
||||
}
|
||||
@@ -470,8 +470,13 @@ export class EventDb {
|
||||
added++;
|
||||
} else if (found.etag !== r.etag || found.rrule !== r.rrule || found.exdate !== r.exdate
|
||||
|| found.reminder !== r.reminder || found.recurring !== r.recurring
|
||||
|| EventDb.remKey(found.reminders) !== EventDb.remKey(r.reminders)) {
|
||||
// 更新（rrule/exdate/recurring 变化也更新，兼容老数据回填）
|
||||
|| EventDb.remKey(found.reminders) !== EventDb.remKey(r.reminders)
|
||||
|| found.href !== href) {
|
||||
// 更新（rrule/exdate/recurring 变化也更新，兼容老数据回填；
|
||||
// href 变化也要更新——服务器上日历本被删除重建后集合 URL 变了，
|
||||
// 行里若残留旧 URL，用户下次编辑该日程会 PUT 到已不存在的集合（404），
|
||||
// 且 pushDirty 按 href 过滤会漏掉它导致永远推不出去）
|
||||
found.href = href;
|
||||
found.title = r.title;
|
||||
found.description = r.description;
|
||||
found.location = r.location;
|
||||
@@ -495,6 +500,15 @@ export class EventDb {
|
||||
updated++;
|
||||
} else {
|
||||
unchanged++;
|
||||
// etag 未变也要校正 href：日历本被删除重建后集合 URL 变化，etag 比对仍然全部命中，
|
||||
// 不在这里刷新的话旧 URL 会一直残留在行上（见上方更新分支的注释）
|
||||
if (found.href !== href) {
|
||||
found.href = href;
|
||||
const hp = new relationalStore.RdbPredicates('events');
|
||||
hp.equalTo('id', found.id);
|
||||
const hb: relationalStore.ValuesBucket = { 'href': href };
|
||||
await store.update(hb, hp);
|
||||
}
|
||||
}
|
||||
}
|
||||
// 删除远端已不存在的（排除本地修改未推送的）
|
||||
@@ -610,6 +624,144 @@ export class EventDb {
|
||||
await store.delete(predicates);
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 取同一个 UID 在同一个日历本下的**全部行**（主事件 + 覆盖实例）。
|
||||
* 用于"重复日程的单次/后续/全部"编辑与删除：重建整个系列后一次性推送。
|
||||
* 只返回未删除的行。
|
||||
*/
|
||||
static async queryByUid(context: common.Context, calKey: string, uid: string): Promise<LocalEvent[]> {
|
||||
const store = await EventDb.getDb(context);
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.equalTo('cal_key', calKey).and().equalTo('uid', uid);
|
||||
predicates.orderByAsc('id');
|
||||
const rs = await store.query(predicates);
|
||||
const list: LocalEvent[] = [];
|
||||
try {
|
||||
while (rs.goToNextRow()) {
|
||||
const e = EventDb.fromRow(rs);
|
||||
if (!e.deleted) {
|
||||
list.push(e);
|
||||
}
|
||||
}
|
||||
} finally {
|
||||
rs.close();
|
||||
}
|
||||
return list;
|
||||
}
|
||||
|
||||
/** 物理删除某 uid 在某个日历本下的全部行（"删除全部"用） */
|
||||
static async purgeByUid(context: common.Context, calKey: string, uid: string): Promise<number> {
|
||||
const store = await EventDb.getDb(context);
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.equalTo('cal_key', calKey).and().equalTo('uid', uid);
|
||||
return await store.delete(predicates);
|
||||
}
|
||||
|
||||
/** 物理删除某 uid 在某个日历本下、开始时间 >= from 的全部行（"此次及以后"删除用） */
|
||||
static async purgeByUidFrom(context: common.Context, calKey: string, uid: string,
|
||||
from: number): Promise<number> {
|
||||
const store = await EventDb.getDb(context);
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.equalTo('cal_key', calKey).and().equalTo('uid', uid)
|
||||
.and().greaterThanOrEqualTo('start_time', from);
|
||||
return await store.delete(predicates);
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 把某个 uid 系列下、开始时间 >= from 的行搬到另一个 uid（"此次及以后"改期的实现）：
|
||||
* 主事件被截断（加 UNTIL）后，剩余部分作为**新的独立系列**存在，否则会被原系列覆盖。
|
||||
* 返回被搬迁的行数。
|
||||
*/
|
||||
static async reassignUidFrom(context: common.Context, calKey: string, oldUid: string,
|
||||
newUid: string, newPath: string, from: number): Promise<number> {
|
||||
const store = await EventDb.getDb(context);
|
||||
const bucket: relationalStore.ValuesBucket = {
|
||||
'uid': newUid,
|
||||
'remote_path': newPath,
|
||||
'etag': '',
|
||||
'dirty': 1
|
||||
};
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.equalTo('cal_key', calKey).and().equalTo('uid', oldUid)
|
||||
.and().greaterThanOrEqualTo('start_time', from);
|
||||
return await store.update(bucket, predicates);
|
||||
}
|
||||
|
||||
/** 给单行写入 EXDATE（"仅删除这一次"→ 排除主事件的该次发生） */
|
||||
static async setExdate(context: common.Context, id: number, exdate: string): Promise<void> {
|
||||
const store = await EventDb.getDb(context);
|
||||
const bucket: relationalStore.ValuesBucket = { 'exdate': exdate, 'dirty': 1 };
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.equalTo('id', id);
|
||||
await store.update(bucket, predicates);
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 把某 uid 系列下、**RECURRENCE-ID >= from** 的覆盖实例行搬到新 uid
|
||||
* （"此次及以后"拆分系列时用；主事件行 recurrenceId=0，天然不会被命中）。
|
||||
*/
|
||||
static async reassignOverridesFrom(context: common.Context, calKey: string, oldUid: string,
|
||||
newUid: string, newPath: string, from: number): Promise<number> {
|
||||
const store = await EventDb.getDb(context);
|
||||
const bucket: relationalStore.ValuesBucket = {
|
||||
'uid': newUid,
|
||||
'remote_path': newPath,
|
||||
'etag': '',
|
||||
'dirty': 1
|
||||
};
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.equalTo('cal_key', calKey).and().equalTo('uid', oldUid)
|
||||
.and().greaterThanOrEqualTo('recurrence_id', from);
|
||||
return await store.update(bucket, predicates);
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 给某个 uid 系列（指定日历本）的主事件写入 RRULE（"此次及以后"截断/改期时用）。
|
||||
* 只作用于有 RRULE 的主事件行。
|
||||
*/
|
||||
static async setRruleForUid(context: common.Context, calKey: string, uid: string,
|
||||
rrule: string): Promise<void> {
|
||||
const store = await EventDb.getDb(context);
|
||||
const bucket: relationalStore.ValuesBucket = { 'rrule': rrule, 'dirty': 1 };
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.equalTo('cal_key', calKey).and().equalTo('uid', uid)
|
||||
.and().notEqualTo('rrule', '');
|
||||
await store.update(bucket, predicates);
|
||||
}
|
||||
|
||||
/** 新增一行（供拆分系列时插入新主事件；已置 dirty） */
|
||||
static async insertRow(context: common.Context, e: LocalEvent): Promise<number> {
|
||||
return await EventDb.insertLocal(context, e);
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 用一份原始快照**还原**某一行的内容（仅内容字段，不动 id）。
|
||||
* 用途：编辑重复日程的"仅这一次 / 此次及以后"时，`doSave` 会把当前行就地写成新值，
|
||||
* 但该行属于"原系列"（被 EXDATE 排除或被 UNTIL 截断），必须还原，
|
||||
* 否则原系列里会残留一条被改过的幽灵行。
|
||||
*/
|
||||
static async restoreRowById(context: common.Context, id: number, src: LocalEvent): Promise<void> {
|
||||
const store = await EventDb.getDb(context);
|
||||
const bucket: relationalStore.ValuesBucket = {
|
||||
'title': src.title,
|
||||
'description': src.description,
|
||||
'location': src.location,
|
||||
'start_time': src.startTime,
|
||||
'end_time': src.endTime,
|
||||
'is_all_day': src.isAllDay ? 1 : 0,
|
||||
'rrule': src.rrule,
|
||||
'exdate': src.exdate,
|
||||
'recurrence_id': src.recurrenceId,
|
||||
'recurring': src.recurring ? 1 : 0,
|
||||
'reminder': src.reminders.length > 0 ? src.reminders[0] : src.reminder,
|
||||
'reminders': src.reminders.map((n: number): string => String(n)).join(','),
|
||||
'dirty': 1
|
||||
};
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.equalTo('id', id);
|
||||
await store.update(bucket, predicates);
|
||||
}
|
||||
|
||||
/**
|
||||
* 清理孤儿行：calKey 既不是本机日历（local）、也不属于任何现有账号（accId_ 前缀）的历史残留数据。
|
||||
* 典型来源：账号删除重建、日历重选后序号变化遗留的旧 calKey（如 `_13`、`acc1789274273124_0_13`）。
|
||||
@@ -645,6 +797,46 @@ export class EventDb {
|
||||
await store.delete(predicates);
|
||||
}
|
||||
|
||||
/**
|
||||
* 删除某账号下、属于指定日历本集合（按 href 匹配）的全部本地日程/待办。
|
||||
*
|
||||
* 用途：日历本在服务器上被删除（同步 REPORT 返回 404）或用户取消勾选时，
|
||||
* 必须在 calKey 序号迁移**之前**先删掉这些行——否则序号收窄后，被移除日历本的
|
||||
* 旧行会与新搬到该序号下的其它日历本行混在同一个 calKey 里（2026-09-29 实测：
|
||||
* 「读书」被服务器删除后重选，其 988 行混进「轻舟」的 calKey）。
|
||||
* 行上自带 href（日历本集合 URL），按 href 删比按 calKey 删更稳——
|
||||
* 历史原因（旧版迁移缺陷）行可能挂在错误的 calKey 下，href 才是行的真实归属。
|
||||
*/
|
||||
static async pruneByHrefs(context: common.Context, accId: string, hrefs: string[]): Promise<number> {
|
||||
if (hrefs.length === 0) {
|
||||
return 0;
|
||||
}
|
||||
const store = await EventDb.getDb(context);
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.like('cal_key', `${accId}_%`);
|
||||
predicates.and().in('href', hrefs);
|
||||
return await store.delete(predicates);
|
||||
}
|
||||
|
||||
/**
|
||||
* 清理「href 已不属于任何已选日历本」的残留行（跨账号兜底清扫）。
|
||||
* 典型：服务器删除日历本后，旧版把其残留行混进其它日历本的 calKey（见 pruneByHrefs 注释），
|
||||
* 这类行 calKey 看似有效、pruneOrphanCalKeys 抓不到，但 href 暴露了真实归属。
|
||||
* ⚠️ 跳过 dirty 行（用户未推送的本地修改绝不能被清扫掉）与 local 行。
|
||||
*/
|
||||
static async pruneStaleHrefs(context: common.Context, validHrefs: string[]): Promise<number> {
|
||||
if (validHrefs.length === 0) {
|
||||
return 0;
|
||||
}
|
||||
const store = await EventDb.getDb(context);
|
||||
const predicates = new relationalStore.RdbPredicates('events');
|
||||
predicates.notEqualTo('cal_key', 'local');
|
||||
predicates.and().notEqualTo('href', '');
|
||||
predicates.and().notIn('href', validHrefs);
|
||||
predicates.and().equalTo('dirty', 0);
|
||||
return await store.delete(predicates);
|
||||
}
|
||||
|
||||
/**
|
||||
* 迁移因「日历本序号变动」而错位的日程行（calKey = `${accId}_${序号}`）。
|
||||
*
|
||||
|
||||
@@ -236,6 +236,42 @@ export class IcsUtil {
|
||||
* 若线上出现"标题被截断"反馈，需在此补 escapeIcsText()。
|
||||
*/
|
||||
static build(e: LocalEvent): string {
|
||||
const now: string = IcsUtil.fmtUtcNow();
|
||||
return 'BEGIN:VCALENDAR\r\n' +
|
||||
'VERSION:2.0\r\n' +
|
||||
'PRODID:-//SyncCalendar//Calendar//CN\r\n' +
|
||||
'CALSCALE:GREGORIAN\r\n' +
|
||||
IcsUtil.vevent(e, now) +
|
||||
'END:VCALENDAR\r\n';
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 构建"一个重复系列"的完整资源：**主事件 + 全部覆盖实例**放在同一个 VCALENDAR 里。
|
||||
*
|
||||
* 为什么必须合在一起：CalDAV 里"重复日程的某一次发生被单独修改"的标准表示法是
|
||||
* 在**同一个 .ics 资源**里放第二个 VEVENT，带 `RECURRENCE-ID` 指向被覆盖的那一次。
|
||||
* 早先 App 直接把每个实例当独立资源 PUT，会破坏服务器上的整个系列，所以那时干脆
|
||||
* 禁止了单次修改（见旧版"重复日程的单次修改暂不支持"）。现在改为重建整份系列后推送。
|
||||
*
|
||||
* @param master 主事件行（含 RRULE / EXDATE）
|
||||
* @param overrides 覆盖实例行（rrule 为空、recurrenceId > 0），已排除 deleted
|
||||
*/
|
||||
static buildSeries(master: LocalEvent, overrides: LocalEvent[]): string {
|
||||
const now: string = IcsUtil.fmtUtcNow();
|
||||
let out: string = 'BEGIN:VCALENDAR\r\n' +
|
||||
'VERSION:2.0\r\n' +
|
||||
'PRODID:-//SyncCalendar//Calendar//CN\r\n' +
|
||||
'CALSCALE:GREGORIAN\r\n' +
|
||||
IcsUtil.vevent(master, now);
|
||||
for (const ov of overrides) {
|
||||
out += IcsUtil.vevent(ov, now);
|
||||
}
|
||||
out += 'END:VCALENDAR\r\n';
|
||||
return out;
|
||||
}
|
||||
|
||||
/** 单个 VEVENT 块（主事件带 RRULE/EXDATE，覆盖行带 RECURRENCE-ID） */
|
||||
private static vevent(e: LocalEvent, now: string): string {
|
||||
const pad = (n: number): string => n < 10 ? '0' + n : String(n);
|
||||
const fmtUtc = (ms: number): string => {
|
||||
const d = new Date(ms);
|
||||
@@ -256,24 +292,88 @@ export class IcsUtil {
|
||||
dtstart = 'DTSTART:' + fmtUtc(e.startTime);
|
||||
dtend = 'DTEND:' + fmtUtc(e.endTime);
|
||||
}
|
||||
const now: string = fmtUtc(Date.now());
|
||||
return 'BEGIN:VCALENDAR\r\n' +
|
||||
'VERSION:2.0\r\n' +
|
||||
'PRODID:-//SyncCalendar//Calendar//CN\r\n' +
|
||||
'CALSCALE:GREGORIAN\r\n' +
|
||||
'BEGIN:VEVENT\r\n' +
|
||||
// ⭐ 覆盖实例（RECURRENCE-ID 行）：必须写出 RECURRENCE-ID，否则服务器无法把它
|
||||
// 关联到主事件的哪一次发生 → 要么整系列被破坏，要么原时间残留成"幽灵日程"。
|
||||
let recId: string = '';
|
||||
if (e.rrule === '' && e.recurrenceId > 0) {
|
||||
recId = e.isAllDay
|
||||
? `RECURRENCE-ID;VALUE=DATE:${fmtDate(e.recurrenceId)}\r\n`
|
||||
: `RECURRENCE-ID:${fmtUtc(e.recurrenceId)}\r\n`;
|
||||
}
|
||||
// ⭐ EXDATE：主事件排除掉的若干次发生（"仅删除这一次"就是往这里加）
|
||||
let exdate: string = '';
|
||||
if (e.exdate !== '') {
|
||||
const vals: string[] = [];
|
||||
for (const raw of e.exdate.split(';')) {
|
||||
const t = IcsUtil.parseTime(raw, !raw.includes('T'));
|
||||
if (t !== null) {
|
||||
vals.push(t.allDay ? fmtDate(t.time) : fmtUtc(t.time));
|
||||
}
|
||||
}
|
||||
if (vals.length > 0) {
|
||||
exdate = e.isAllDay
|
||||
? `EXDATE;VALUE=DATE:${vals.join(',')}\r\n`
|
||||
: `EXDATE:${vals.join(',')}\r\n`;
|
||||
}
|
||||
}
|
||||
return 'BEGIN:VEVENT\r\n' +
|
||||
`UID:${e.uid}\r\n` +
|
||||
`DTSTAMP:${now}\r\n` +
|
||||
`${dtstart}\r\n` +
|
||||
`${dtend}\r\n` +
|
||||
recId +
|
||||
(e.rrule !== '' ? `RRULE:${e.rrule}\r\n` : '') +
|
||||
exdate +
|
||||
`SUMMARY:${IcsUtil.escape(e.title)}\r\n` +
|
||||
(e.location !== '' ? `LOCATION:${IcsUtil.escape(e.location)}\r\n` : '') +
|
||||
(e.description !== '' ? `DESCRIPTION:${IcsUtil.escape(e.description)}\r\n` : '') +
|
||||
IcsUtil.valarms(e.reminders.length > 0 ? e.reminders
|
||||
: (e.reminder > 0 ? [e.reminder] : [])) +
|
||||
'END:VEVENT\r\n' +
|
||||
'END:VCALENDAR\r\n';
|
||||
'END:VEVENT\r\n';
|
||||
}
|
||||
|
||||
/** 当前时刻的 UTC 形式（DTSTAMP） */
|
||||
private static fmtUtcNow(): string {
|
||||
const pad = (n: number): string => n < 10 ? '0' + n : String(n);
|
||||
const d = new Date();
|
||||
return `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}` +
|
||||
`T${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}${pad(d.getUTCSeconds())}Z`;
|
||||
}
|
||||
|
||||
/**
|
||||
* 毫秒时间戳 → 用于 EXDATE / RECURRENCE-ID 的 ICS 时间串。
|
||||
* @param dateOnly 全天日程用 `YYYYMMDD`，否则用 UTC 的 `YYYYMMDDTHHMMSSZ`
|
||||
*/
|
||||
static fmtIcsTime(ms: number, dateOnly: boolean): string {
|
||||
const pad = (n: number): string => n < 10 ? '0' + n : String(n);
|
||||
const d = new Date(ms);
|
||||
if (dateOnly) {
|
||||
return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}`;
|
||||
}
|
||||
return `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}` +
|
||||
`T${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}${pad(d.getUTCSeconds())}Z`;
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 给 RRULE 加上/替换 UNTIL（"此次及以后"改期/删除时，把原系列截断到指定时刻之前）。
|
||||
* - 会**移除 COUNT**（RFC 5545：UNTIL 与 COUNT 不可同时出现）
|
||||
* - UNTIL 用 UTC 形式；`untilMs` 一般是"该次发生的开始时刻 − 1 秒"
|
||||
*/
|
||||
static rruleWithUntil(rrule: string, untilMs: number): string {
|
||||
const pad = (n: number): string => n < 10 ? '0' + n : String(n);
|
||||
const d = new Date(untilMs);
|
||||
const until: string = `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}` +
|
||||
`T${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}${pad(d.getUTCSeconds())}Z`;
|
||||
const kept: string[] = [];
|
||||
for (const part of rrule.split(';')) {
|
||||
const k: string = part.split('=')[0].trim().toUpperCase();
|
||||
if (k === 'UNTIL' || k === 'COUNT' || k === '') {
|
||||
continue;
|
||||
}
|
||||
kept.push(part);
|
||||
}
|
||||
kept.push(`UNTIL=${until}`);
|
||||
return kept.join(';');
|
||||
}
|
||||
|
||||
/** 由提醒分钟数组生成多个 VALARM（已规范化去重） */
|
||||
|
||||
@@ -0,0 +1,80 @@
|
||||
// entry/src/main/ets/common/NetworkSyncWatcher.ets
|
||||
// ⭐ 网络恢复补同步：从"无网"变为"有网"时立刻同步一次。
|
||||
//
|
||||
// 为什么这条最有价值（《定时同步方案调研.md》第 ④ 层）：
|
||||
// 延迟任务最短 2 小时、还会随应用活跃度降级，长时间在外(飞行模式/地铁/弱网)期间
|
||||
// 基本不会跑。用户一旦回到有网环境，**立刻对齐一次**，才能做到
|
||||
// "我要看的时候数据是最新的"。这比追求"进程常驻"实际得多。
|
||||
//
|
||||
// 实现：net.connection 的 netAvailable / netLost 事件 + 去抖，避免网络抖动时连打多次。
|
||||
import { connection } from '@kit.NetworkKit';
|
||||
import { common } from '@kit.AbilityKit';
|
||||
import { BackgroundSyncRunner } from './BackgroundSyncRunner';
|
||||
import { LogUtil } from './LogUtil';
|
||||
|
||||
/** 网络恢复后的去抖间隔：避免弱网下反复"断开→恢复"导致连续同步 */
|
||||
const DEBOUNCE_MS: number = 20 * 1000;
|
||||
|
||||
export class NetworkSyncWatcher {
|
||||
private static netConn: connection.NetConnection | null = null;
|
||||
/** 上一次触发同步的时间，用于去抖 */
|
||||
private static lastTriggerAt: number = 0;
|
||||
/** 当前是否处于"无网"状态（只有从无网恢复才触发，避免频繁切换网络时误触发） */
|
||||
private static offline: boolean = false;
|
||||
|
||||
/** 开始监听网络变化（幂等：重复调用不会重复注册） */
|
||||
static start(context: common.UIAbilityContext): void {
|
||||
if (NetworkSyncWatcher.netConn !== null) {
|
||||
return;
|
||||
}
|
||||
try {
|
||||
const conn: connection.NetConnection = connection.createNetConnection();
|
||||
conn.on('netLost', (): void => {
|
||||
NetworkSyncWatcher.offline = true;
|
||||
LogUtil.write('网络断开：标记为无网状态');
|
||||
});
|
||||
conn.on('netAvailable', (): void => {
|
||||
// ⭐ 只有"从无网恢复"才补同步：单纯切换 Wi-Fi/蜂窝时不重复触发
|
||||
if (!NetworkSyncWatcher.offline) {
|
||||
return;
|
||||
}
|
||||
NetworkSyncWatcher.offline = false;
|
||||
NetworkSyncWatcher.triggerDebounced(context, 'netRecover');
|
||||
});
|
||||
conn.register((): void => {
|
||||
LogUtil.write('网络监听已注册（网络恢复补同步）');
|
||||
});
|
||||
NetworkSyncWatcher.netConn = conn;
|
||||
} catch (err) {
|
||||
LogUtil.write(`网络监听注册失败：${(err as Error).message}`);
|
||||
}
|
||||
}
|
||||
|
||||
/** 停止监听（一般不需要，App 存活期间持续有效） */
|
||||
static stop(): void {
|
||||
if (NetworkSyncWatcher.netConn === null) {
|
||||
return;
|
||||
}
|
||||
try {
|
||||
NetworkSyncWatcher.netConn.unregister((err: object): void => {
|
||||
// 忽略取消失败
|
||||
});
|
||||
} catch (err) {
|
||||
// 忽略
|
||||
}
|
||||
NetworkSyncWatcher.netConn = null;
|
||||
}
|
||||
|
||||
/** 去抖后触发一次同步 */
|
||||
private static triggerDebounced(context: common.UIAbilityContext, tag: string): void {
|
||||
const now: number = Date.now();
|
||||
if (now - NetworkSyncWatcher.lastTriggerAt < DEBOUNCE_MS) {
|
||||
LogUtil.write(`网络恢复补同步：距上次过快（<20s），跳过`);
|
||||
return;
|
||||
}
|
||||
NetworkSyncWatcher.lastTriggerAt = now;
|
||||
LogUtil.write('网络已恢复 → 触发补同步');
|
||||
// 不 await：事件回调里不能阻塞；BackgroundSyncRunner 内部全 try-catch，不会抛出
|
||||
BackgroundSyncRunner.runOnce(context, tag);
|
||||
}
|
||||
}
|
||||
@@ -2,12 +2,29 @@
|
||||
// 双向同步引擎：先推本地修改（PUT/DELETE），再拉远端变更（REPORT + etag 增量）
|
||||
import { common } from '@kit.AbilityKit';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { DavAccount } from './AccountStore';
|
||||
import { DavAccount, AccountStore } from './AccountStore';
|
||||
import { EventDb, LocalEvent, RemoteEvent } from './EventDb';
|
||||
import { IcsUtil } from './IcsUtil';
|
||||
import { DavClient, DavColorEntry, RemoteItem } from './DavClient';
|
||||
import { DavClient, DavColorEntry, DavHttpError, RemoteItem } from './DavClient';
|
||||
import { LogUtil } from './LogUtil';
|
||||
import { AppSettings } from './AppSettings';
|
||||
import { SystemCalendarMirror } from './SystemCalendarMirror';
|
||||
|
||||
/**
|
||||
* ⭐ "已有同步任务正在进行"专用错误类型。
|
||||
*
|
||||
* 背景（用户反馈）：后台同步进行中时，用户再点「手动同步」或在账号管理点「保存并同步」，
|
||||
* 会并发触发第二轮同步；互斥锁把它拦下来，但那时抛的是普通 Error → 界面统一显示
|
||||
* "同步失败：该账号正在同步中，请稍后再试"。用户看到"失败"会误以为出了问题。
|
||||
*
|
||||
* 正确做法：并发被拦下时**不是失败**，而应提示"有同步任务正在进行中，请耐心等待"。
|
||||
* 因此用这个独立类型与真正的同步故障区分开，界面据此改提示语（而非报错）。
|
||||
*/
|
||||
export class SyncBusyError extends Error {
|
||||
constructor() {
|
||||
super('SYNC_BUSY');
|
||||
}
|
||||
}
|
||||
|
||||
export class SyncEngine {
|
||||
/** 正在同步中的账号 id → 开始时间：防止超时后的"僵尸同步"与新一轮同步并发写库 */
|
||||
@@ -15,6 +32,27 @@ export class SyncEngine {
|
||||
/** 互斥锁最长持有时间：超过视为异常残留（如进程挂起后网络停摆），允许抢占 */
|
||||
private static readonly LOCK_STALE_MS: number = 15 * 60 * 1000;
|
||||
|
||||
/** 某账号当前是否正在同步（供界面判断，不触发任何操作） */
|
||||
static isSyncing(accId: string): boolean {
|
||||
const heldSince: number | undefined = SyncEngine.activeSyncs.get(accId);
|
||||
if (heldSince === undefined) {
|
||||
return false;
|
||||
}
|
||||
return Date.now() - heldSince < SyncEngine.LOCK_STALE_MS;
|
||||
}
|
||||
|
||||
/** 当前是否有任意账号正在同步 */
|
||||
static isAnySyncing(): boolean {
|
||||
const now: number = Date.now();
|
||||
for (const id of SyncEngine.activeSyncs.keys()) {
|
||||
const since: number | undefined = SyncEngine.activeSyncs.get(id);
|
||||
if (since !== undefined && now - since < SyncEngine.LOCK_STALE_MS) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* 给异步操作加超时保护，防止网络挂起导致界面一直转圈
|
||||
*/
|
||||
@@ -37,7 +75,8 @@ export class SyncEngine {
|
||||
const heldSince: number | undefined = SyncEngine.activeSyncs.get(acc.id);
|
||||
if (heldSince !== undefined) {
|
||||
if (Date.now() - heldSince < SyncEngine.LOCK_STALE_MS) {
|
||||
throw new Error('该账号正在同步中，请稍后再试');
|
||||
// ⭐ 抛专用类型：界面据此提示"同步进行中，请耐心等待"而非"失败"
|
||||
throw new SyncBusyError();
|
||||
}
|
||||
LogUtil.write(`同步互斥锁超时残留（账号 id=${acc.id}），强制释放并重新同步`);
|
||||
}
|
||||
@@ -70,6 +109,10 @@ export class SyncEngine {
|
||||
LogUtil.write(`同步账号 id=${acc.id} 完成：拉取 ${r} 条日程，耗时 ${Math.round((Date.now() - t0) / 1000)} 秒`);
|
||||
return r;
|
||||
} catch (err) {
|
||||
// ⭐ "正在同步中"原样抛出（界面据此提示"请耐心等待"，不当成失败）
|
||||
if (err instanceof SyncBusyError) {
|
||||
throw err;
|
||||
}
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`同步账号 id=${acc.id} 失败：${e.message}（耗时 ${Math.round((Date.now() - t0) / 1000)} 秒）`);
|
||||
throw new Error(e.message !== '' ? e.message : `错误码 ${e.code}`);
|
||||
@@ -91,13 +134,28 @@ export class SyncEngine {
|
||||
LogUtil.write('一次性全量重拉：忽略 etag 复用，全部资源 GET 完整 ICS');
|
||||
}
|
||||
let changed: number = 0;
|
||||
// 服务器上已不存在的日历本（REPORT 404）：先跳过继续同步其它日历本，
|
||||
// 循环结束后统一从账号移除（见 removeDeadBooks）。
|
||||
// 2026-09-29 实测：服务器上删掉一个日历本后，本地仍勾选它 → 每次同步 404 →
|
||||
// 旧版直接抛错让整个账号同步失败，且后台同步每轮都失败（一天半没同步成功过）。
|
||||
const deadIdxs: number[] = [];
|
||||
for (let i = 0; i < acc.calendarHrefs.length; i++) {
|
||||
const href: string = acc.calendarHrefs[i];
|
||||
const calKey: string = `${acc.id}_${i}`;
|
||||
const calName: string = i < acc.calendarNames.length ? acc.calendarNames[i] : `日历本${i}`;
|
||||
LogUtil.write(`日历本[${i}]「${calName}」开始同步：${href}`);
|
||||
const t1: number = Date.now();
|
||||
const items: RemoteItem[] = await DavClient.reportEtags(href, auth);
|
||||
let items: RemoteItem[] = [];
|
||||
try {
|
||||
items = await DavClient.reportEtags(href, auth);
|
||||
} catch (err) {
|
||||
if (err instanceof DavHttpError && (err as DavHttpError).status === 404) {
|
||||
LogUtil.write(`日历本[${i}]「${calName}」在服务器上已不存在(404)，本轮跳过，收尾时自动从账号移除`);
|
||||
deadIdxs.push(i);
|
||||
continue;
|
||||
}
|
||||
throw err as Error;
|
||||
}
|
||||
LogUtil.write(`日历本[${i}]「${calName}」REPORT 返回 ${items.length} 个资源`);
|
||||
// 现有行按 uid 分组（同一资源的覆盖实例共享 uid 与 etag）
|
||||
const existingRows: LocalEvent[] = await EventDb.queryByCalKey(context, calKey, 'event');
|
||||
@@ -197,9 +255,92 @@ export class SyncEngine {
|
||||
LogUtil.write(`日历本[${i}]「${calName}」拉取待办失败(忽略)：${te.message}`);
|
||||
}
|
||||
}
|
||||
// 收尾：把本轮发现的"服务器上已删除"的日历本从账号移除并清理本地数据。
|
||||
// 放在循环后（而非循环中）是因为移除会让后续序号前移，循环中途改数组会打乱 calKey。
|
||||
if (deadIdxs.length > 0) {
|
||||
await SyncEngine.removeDeadBooks(context, acc, deadIdxs);
|
||||
}
|
||||
return changed;
|
||||
}
|
||||
|
||||
/**
|
||||
* 从账号移除「服务器上已不存在（404）」的日历本：收窄配置、迁移序号、清理本地数据并持久化。
|
||||
* 只要有至少一个日历本保留就自动移除；若全部失效则不动配置（避免把账号清空），
|
||||
* 抛错交给上层提示用户去服务器/编辑账号处理。
|
||||
*/
|
||||
private static async removeDeadBooks(context: common.Context, acc: DavAccount,
|
||||
deadIdxs: number[]): Promise<void> {
|
||||
if (deadIdxs.length >= acc.calendarHrefs.length) {
|
||||
throw new Error('该账号下所有日历本在服务器上均已不存在(404)，请检查服务器或重新编辑账号');
|
||||
}
|
||||
const deadSet: Set<number> = new Set<number>();
|
||||
for (const d of deadIdxs) {
|
||||
deadSet.add(d);
|
||||
}
|
||||
const removedHrefs: string[] = [];
|
||||
const newHrefs: string[] = [];
|
||||
const newNames: string[] = [];
|
||||
const newColors: string[] = [];
|
||||
const newWritable: string[] = [];
|
||||
for (let i = 0; i < acc.calendarHrefs.length; i++) {
|
||||
if (deadSet.has(i)) {
|
||||
removedHrefs.push(acc.calendarHrefs[i]);
|
||||
continue;
|
||||
}
|
||||
newHrefs.push(acc.calendarHrefs[i]);
|
||||
newNames.push(i < acc.calendarNames.length ? acc.calendarNames[i] : `日历本${i}`);
|
||||
newColors.push(i < acc.calendarColors.length ? acc.calendarColors[i] : '');
|
||||
newWritable.push(i < acc.calendarWritable.length ? acc.calendarWritable[i] : '1');
|
||||
}
|
||||
LogUtil.write(`自动移除 ${removedHrefs.length} 个在服务器上不存在的日历本，保留 ${newHrefs.length} 个`);
|
||||
// 1) 先按 href 删掉被移除日历本的本地行——必须在序号迁移之前，
|
||||
// 否则序号收窄后这些行会混进接替该序号的其它日历本（pruneByHrefs 注释详述）
|
||||
await EventDb.pruneByHrefs(context, acc.id, removedHrefs);
|
||||
// 2) 序号迁移：保留的日历本按原顺序收紧（旧序号 → 新序号）
|
||||
const oldHrefs: string[] = acc.calendarHrefs.slice();
|
||||
const pairs: Array<[string, string]> = [];
|
||||
let ni: number = 0;
|
||||
for (let oi = 0; oi < oldHrefs.length; oi++) {
|
||||
if (deadSet.has(oi)) {
|
||||
continue;
|
||||
}
|
||||
if (ni !== oi) {
|
||||
pairs.push([`${acc.id}_${oi}`, `${acc.id}_${ni}`]);
|
||||
}
|
||||
ni++;
|
||||
}
|
||||
if (pairs.length > 0) {
|
||||
const moved: number = await EventDb.remapCalKeys(context, pairs);
|
||||
LogUtil.write(`移除失效日历本后迁移日程 ${moved} 行（${pairs.length} 个日历本序号前移）`);
|
||||
}
|
||||
// 3) 收窄账号配置并持久化
|
||||
acc.calendarHrefs = newHrefs;
|
||||
acc.calendarNames = newNames;
|
||||
acc.calendarColors = newColors;
|
||||
acc.calendarWritable = newWritable;
|
||||
const all: DavAccount[] = await AccountStore.loadAll(context);
|
||||
const idx: number = all.findIndex((a: DavAccount): boolean => a.id === acc.id);
|
||||
if (idx >= 0) {
|
||||
all[idx] = acc;
|
||||
await AccountStore.saveAll(context, all);
|
||||
}
|
||||
// 4) 兜底：该账号下 calKey 不在有效列表的行全部清掉
|
||||
const validKeys: string[] = [];
|
||||
for (let i = 0; i < newHrefs.length; i++) {
|
||||
validKeys.push(`${acc.id}_${i}`);
|
||||
}
|
||||
await EventDb.pruneAccountEvents(context, acc.id, validKeys);
|
||||
// 5) 若被移除的日历本正是「系统日历 → CalDAV」的备份目标，当场判失效并关闭备份
|
||||
try {
|
||||
const backupCheck = await SystemCalendarMirror.checkBackupTarget(context);
|
||||
if (backupCheck.closed) {
|
||||
LogUtil.write('备份目标日历本已在服务器上删除，备份功能已自动关闭');
|
||||
}
|
||||
} catch (err) {
|
||||
// 检查失败不影响主流程
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 刷新服务器端日历本颜色：PROPFIND getcolor → 按集合路径匹配更新 acc.calendarColors
|
||||
* 失败静默（颜色不影响数据正确性）
|
||||
@@ -305,6 +446,9 @@ export class SyncEngine {
|
||||
const dirty: LocalEvent[] = await EventDb.getDirty(context);
|
||||
const mine: LocalEvent[] = dirty.filter((e: LocalEvent): boolean => acc.calendarHrefs.includes(e.href));
|
||||
LogUtil.write(`推送本地修改：全部待推送 ${dirty.length} 条，属于账号 id=${acc.id} 的 ${mine.length} 条`);
|
||||
// ⭐ 同一个重复系列（uid + 日历本）在一次推送里只处理一次：整份 .ics（主事件 + 各覆盖实例）
|
||||
// 一起重建后推送，避免"先 PUT 覆盖实例、后 PUT 主事件"互相覆盖。
|
||||
const pushedSeries: Set<string> = new Set<string>();
|
||||
for (const e of mine) {
|
||||
// 只读日历本：推送必然 403，跳过并保留 dirty（权限恢复后可再推）
|
||||
const bookIdx: number = acc.calendarHrefs.indexOf(e.href);
|
||||
@@ -318,30 +462,111 @@ export class SyncEngine {
|
||||
await EventDb.clearDirty(context, e.id, e.etag);
|
||||
continue;
|
||||
}
|
||||
if (e.recurring && e.rrule === '') {
|
||||
// 重复日程的"单次覆盖实例"（RECURRENCE-ID）推送会破坏服务器整个序列，暂不支持
|
||||
await EventDb.clearDirty(context, e.id, e.etag);
|
||||
LogUtil.write(`推送跳过重复日程实例（标题已脱敏）uid=${e.uid}`);
|
||||
// ⭐ 重复系列（含覆盖实例）：按 uid 取全系列行，重建整份 .ics 后一次性 PUT。
|
||||
// 旧版对"覆盖实例"直接跳过（不推送），导致 App 里的单次改期/删除无法上传到服务器；
|
||||
// 现在支持标准写法（同资源内多 VEVENT + RECURRENCE-ID）。
|
||||
const seriesKey: string = `${e.calKey}|${e.uid}`;
|
||||
if ((e.recurring || e.rrule !== '') && !pushedSeries.has(seriesKey)) {
|
||||
pushedSeries.add(seriesKey);
|
||||
await SyncEngine.pushSeries(context, acc, auth, e);
|
||||
continue;
|
||||
}
|
||||
if (e.recurring) {
|
||||
// 重复主事件（含 RRULE，含本机新建的重复日程）：整条 PUT 覆盖推送
|
||||
LogUtil.write(`推送重复主事件（标题已脱敏）uid=${e.uid}`);
|
||||
if ((e.recurring || e.rrule !== '') && pushedSeries.has(seriesKey)) {
|
||||
continue; // 该系列已在上面整体推送过
|
||||
}
|
||||
const url: string = e.href.endsWith('/') ? e.href + e.remotePath : `${e.href}/${e.remotePath}`;
|
||||
if (e.deleted) {
|
||||
await DavClient.deleteRemote(url, auth);
|
||||
await EventDb.purge(context, e.id);
|
||||
LogUtil.write(`推送删除（标题已脱敏）uid=${e.uid} → ${url}`);
|
||||
} else {
|
||||
const ics: string = IcsUtil.build(e);
|
||||
const etag: string = await DavClient.putEvent(url, auth, ics);
|
||||
await EventDb.clearDirty(context, e.id, etag);
|
||||
LogUtil.write(`推送保存（标题已脱敏）uid=${e.uid} → ${url}（${ics.length} 字节，提醒=${e.reminders.map((n: number): string => String(n)).join('/')}分钟，VALARM=${ics.toUpperCase().includes('BEGIN:VALARM') ? '有' : '无'}）`);
|
||||
try {
|
||||
if (e.deleted) {
|
||||
await DavClient.deleteRemote(url, auth);
|
||||
await EventDb.purge(context, e.id);
|
||||
LogUtil.write(`推送删除（标题已脱敏）uid=${e.uid} → ${url}`);
|
||||
} else {
|
||||
const ics: string = IcsUtil.build(e);
|
||||
const etag: string = await DavClient.putEvent(url, auth, ics);
|
||||
await EventDb.clearDirty(context, e.id, etag);
|
||||
LogUtil.write(`推送保存（标题已脱敏）uid=${e.uid} → ${url}（${ics.length} 字节，提醒=${e.reminders.map((n: number): string => String(n)).join('/')}分钟，VALARM=${ics.toUpperCase().includes('BEGIN:VALARM') ? '有' : '无'}）`);
|
||||
}
|
||||
} catch (err) {
|
||||
// 单条推送失败不再中断整个账号（旧行为：一条 404 就让整个账号同步失败）。
|
||||
// 401（凭据失效）例外：后续每条也必然失败，直接抛出让上层提示。
|
||||
if (err instanceof DavHttpError && (err as DavHttpError).status === 401) {
|
||||
throw err as Error;
|
||||
}
|
||||
const pe = err as Error;
|
||||
LogUtil.write(`推送单条失败(跳过，保留待推送)：uid=${e.uid} → ${pe.message}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 推送一个"重复系列"：取该 uid 下的主事件与全部覆盖实例，合成整份 .ics 后 PUT。
|
||||
*
|
||||
* - 主事件行若被标记删除（deleted）→ 视为"整个系列删除"，DELETE 整个资源并清掉本地该 uid 全部行。
|
||||
* - 否则重建（主事件可能带上了 EXDATE / 被截断的 UNTIL，覆盖实例带 RECURRENCE-ID），
|
||||
* 一次性 PUT 覆盖服务器上的同一资源；成功后清掉本系列全部行的 dirty。
|
||||
*/
|
||||
private static async pushSeries(context: common.Context, acc: DavAccount, auth: string,
|
||||
trigger: LocalEvent): Promise<void> {
|
||||
const calKey: string = trigger.calKey;
|
||||
const uid: string = trigger.uid;
|
||||
const rows: LocalEvent[] = await EventDb.queryByUid(context, calKey, uid);
|
||||
// 主事件：优先取带 RRULE 的行；退而取最早一行
|
||||
let master: LocalEvent | null = null;
|
||||
for (const r of rows) {
|
||||
if (r.rrule !== '') {
|
||||
master = r;
|
||||
break;
|
||||
}
|
||||
}
|
||||
if (master === null && rows.length > 0) {
|
||||
master = rows[0];
|
||||
}
|
||||
if (master === null) {
|
||||
return;
|
||||
}
|
||||
const href: string = master.href;
|
||||
const path: string = master.remotePath !== '' ? master.remotePath : encodeURIComponent(uid) + '.ics';
|
||||
const url: string = href.endsWith('/') ? href + path : `${href}/${path}`;
|
||||
// 整个系列被删除（主事件行 deleted）→ DELETE 资源 + 清掉该 uid 全部本地行
|
||||
if (master.deleted) {
|
||||
try {
|
||||
await DavClient.deleteRemote(url, auth);
|
||||
} catch (err) {
|
||||
if (err instanceof DavHttpError && (err as DavHttpError).status === 401) {
|
||||
throw err as Error;
|
||||
}
|
||||
LogUtil.write(`推送删除重复系列失败：uid=${uid} → ${(err as Error).message}`);
|
||||
return;
|
||||
}
|
||||
await EventDb.purgeByUid(context, calKey, uid);
|
||||
LogUtil.write(`推送删除重复系列（标题已脱敏）uid=${uid} → ${url}`);
|
||||
return;
|
||||
}
|
||||
const overrides: LocalEvent[] = [];
|
||||
for (const r of rows) {
|
||||
if (r.id !== master.id && r.rrule === '' && r.recurrenceId > 0) {
|
||||
overrides.push(r);
|
||||
}
|
||||
}
|
||||
overrides.sort((a: LocalEvent, b: LocalEvent): number => a.recurrenceId - b.recurrenceId);
|
||||
const ics: string = IcsUtil.buildSeries(master, overrides);
|
||||
try {
|
||||
const etag: string = await DavClient.putEvent(url, auth, ics);
|
||||
// 清掉本系列全部行的 dirty（第一条写回 etag）
|
||||
let first: boolean = true;
|
||||
for (const r of rows) {
|
||||
await EventDb.clearDirty(context, r.id, first ? etag : '');
|
||||
first = false;
|
||||
}
|
||||
LogUtil.write(`推送重复系列（标题已脱敏）uid=${uid} → ${url}（${ics.length} 字节，覆盖实例=${overrides.length}）`);
|
||||
} catch (err) {
|
||||
if (err instanceof DavHttpError && (err as DavHttpError).status === 401) {
|
||||
throw err as Error;
|
||||
}
|
||||
LogUtil.write(`推送重复系列失败(保留待推送)：uid=${uid} → ${(err as Error).message}`);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 清理本机虚拟日历（calKey=local）的待推送状态：
|
||||
* 本机事件不参与 DAV 同步，直接落地
|
||||
@@ -388,6 +613,19 @@ export class SyncEngine {
|
||||
if (removed > 0) {
|
||||
LogUtil.write(`清理孤儿日程行：${removed} 条（calKey 不属于任何现有账号）`);
|
||||
}
|
||||
// 兜底清扫：行上 href 已不属于任何已选日历本的残留行（calKey 可能因历史迁移
|
||||
// 缺陷混在有效日历本名下，calKey 维度抓不到，href 才暴露真实归属）。
|
||||
// 典型如服务器删除日历本后残留的"幽灵"数据——不清掉的话镜像会一直把它写进系统日历。
|
||||
const validHrefs: string[] = [];
|
||||
for (const a of accounts) {
|
||||
for (const h of a.calendarHrefs) {
|
||||
validHrefs.push(h);
|
||||
}
|
||||
}
|
||||
const stale: number = await EventDb.pruneStaleHrefs(context, validHrefs);
|
||||
if (stale > 0) {
|
||||
LogUtil.write(`清理失效日历本残留行：${stale} 条（href 已不属于任何已选日历本）`);
|
||||
}
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`清理孤儿日程行失败(忽略)：${e.message}`);
|
||||
|
||||
@@ -320,6 +320,14 @@ export class SystemCalendarMirror {
|
||||
}
|
||||
// ⭐ 选中项一律走**稳定标识** bookId（由服务器 href 派生），并顺带迁移历史 calKey 选中项
|
||||
const refs: BookRef[] = await SystemCalendarMirror.selectedBookRefs(context);
|
||||
// ⭐ 兜底：无论有没有选中本，都顺手清掉"账号已删除"的孤儿镜像账户。
|
||||
// 否则"删掉一个账号后系统日历里还留着它的日历本"永远不会被自动修掉
|
||||
// （旧代码在这里 return 之前根本不做清理，这正是本次要修的 bug）。
|
||||
try {
|
||||
await SystemCalendarMirror.purgeOrphanAccountMirrors(context);
|
||||
} catch (err) {
|
||||
// 兜底清理失败不影响正常镜像
|
||||
}
|
||||
if (refs.length === 0) {
|
||||
LogUtil.write('镜像中止：未选择要镜像的日历本（或全部是备份目标本）');
|
||||
return res;
|
||||
@@ -421,6 +429,175 @@ export class SystemCalendarMirror {
|
||||
return SystemCalendarMirror.removeById(context, bookId);
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 删除**某一个 DAV 账号**名下的全部镜像账户（在 App 里删除该账号时调用）。
|
||||
*
|
||||
* 背景（用户反馈）：删掉一个 CalDAV 账号后，之前镜像进系统日历的那些"日历本"
|
||||
* 仍然留在系统日历里（幽灵账户 + 幽灵日程）。旧代码只清了账号配置与本地库，
|
||||
* 完全没碰系统日历侧；而自动兜底（syncNow 里的 purgeOrphans）在"解析不到任何选中本"时
|
||||
* **会提前 return**，所以删完账号后根本不会触发兜底清理。
|
||||
*
|
||||
* ⭐ **绝不按日历本显示名匹配**：镜像账户名是 `synccalendar.mirror.<bookId>`，
|
||||
* 而 bookId = `<accId>-<href哈希>` 天然带账号前缀。因此这里只按
|
||||
* `synccalendar.mirror.<accId>-` 前缀匹配 —— 即使**不同账号下有同名日历本**
|
||||
* （比如两个账号各有一个「工作」），它们的 bookId 不同、账户名也不同，绝不会删错。
|
||||
*
|
||||
* 幂等；未授权 / 无匹配时返回 0。每个账户独立 try/catch，一个失败不影响其它。
|
||||
*
|
||||
* @returns 成功删除的镜像账户数
|
||||
*/
|
||||
static async removeByAccount(context: common.Context, accId: string): Promise<number> {
|
||||
if (accId === '' || !await SystemCalendarMirror.hasPermission()) {
|
||||
return 0;
|
||||
}
|
||||
// ⭐ 账户名前缀 = 公共前缀 + accId + '-'（bookId 里的分隔符）。
|
||||
// 带尾随 '-' 才不会把 accId「123」错配到 accId「1234」的账户上。
|
||||
// 同时兼容**历史**账户名（旧版用 calKey 做桶 → `synccalendar.mirror.<accId>_<序号>`），
|
||||
// 同样带尾随 '_' 分隔符，宁可多清一批脏账户，也不按显示名乱删。
|
||||
const prefix: string = `${SystemCalendarMirror.ACCOUNT_PREFIX}${accId}-`;
|
||||
const legacyPrefix: string = `${SystemCalendarMirror.ACCOUNT_PREFIX}${accId}_`;
|
||||
let removed: number = 0;
|
||||
const buckets: string[] = [];
|
||||
try {
|
||||
const cm: calendarManager.CalendarManager = calendarManager.getCalendarManager(context);
|
||||
const all: calendarManager.Calendar[] = await cm.getAllCalendars();
|
||||
for (const cal of all) {
|
||||
const name: string = cal.getAccount().name;
|
||||
if (!name.startsWith(prefix) && !name.startsWith(legacyPrefix)) {
|
||||
continue; // 不属于本账号（含其它账号的同名日历本）→ 绝不动
|
||||
}
|
||||
const bucket: string = name.substring(SystemCalendarMirror.ACCOUNT_PREFIX.length);
|
||||
try {
|
||||
await cm.deleteCalendar(cal);
|
||||
removed++;
|
||||
buckets.push(bucket);
|
||||
LogUtil.write(`删除账号 ${accId}：已删除镜像账户 id=${cal.id} name=${name}`);
|
||||
} catch (err) {
|
||||
const e1 = err as BusinessError;
|
||||
LogUtil.write(`删除账号 ${accId}：删除镜像账户失败(重试) id=${cal.id} name=${name}: ${e1.message}`);
|
||||
// 降级：先清空账户内全部日程，再删一次（与 purgeOrphans 同策略）
|
||||
try {
|
||||
const evs: calendarManager.Event[] = await cal.getEvents();
|
||||
const ids: number[] = [];
|
||||
for (const ev of evs) {
|
||||
if (ev.id !== undefined) {
|
||||
ids.push(ev.id);
|
||||
}
|
||||
}
|
||||
if (ids.length > 0) {
|
||||
await cal.deleteEvents(ids);
|
||||
}
|
||||
} catch (err2) {
|
||||
LogUtil.write(`删除账号 ${accId}：清空镜像账户日程失败 id=${cal.id}: ${(err2 as BusinessError).message}`);
|
||||
}
|
||||
try {
|
||||
await cm.deleteCalendar(cal);
|
||||
removed++;
|
||||
buckets.push(bucket);
|
||||
LogUtil.write(`删除账号 ${accId}：已删除镜像账户(清空后重试成功) id=${cal.id} name=${name}`);
|
||||
} catch (err3) {
|
||||
LogUtil.write(`删除账号 ${accId}：镜像账户删除失败(最终) id=${cal.id} name=${name}: ${(err3 as BusinessError).message}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch (err) {
|
||||
LogUtil.write(`删除账号 ${accId}：读取系统日历账户列表失败 ${(err as BusinessError).message}`);
|
||||
}
|
||||
// 清掉这些本在镜像快照里的残留（bucket = bookId）
|
||||
for (const b of buckets) {
|
||||
await MirrorSnapshot.removeByCalKey(context, b);
|
||||
}
|
||||
// 清掉"镜像选中项"里属于本账号的条目（防止残留脏 bookId 干扰下次选择/迁移）。
|
||||
// ⚠️ 用 `${accId}-` / `${accId}_` 前缀过滤（同样带分隔符，避免误伤相似 accId）。
|
||||
try {
|
||||
const ids: string[] = await AppSettings.getMirrorBookIds(context);
|
||||
const kept: string[] = ids.filter((id: string): boolean => !id.startsWith(`${accId}-`));
|
||||
if (kept.length !== ids.length) {
|
||||
await AppSettings.setMirrorBookIds(context, kept);
|
||||
}
|
||||
const legacy: string[] = await AppSettings.getMirrorKeys(context);
|
||||
const keptLegacy: string[] = legacy.filter((k: string): boolean => !k.startsWith(`${accId}_`));
|
||||
if (keptLegacy.length !== legacy.length) {
|
||||
await AppSettings.setMirrorKeys(context, keptLegacy);
|
||||
}
|
||||
} catch (err) {
|
||||
// 设置清理失败不影响账户删除结果，下次同步会再兜底
|
||||
}
|
||||
LogUtil.write(`删除账号 ${accId}：系统日历镜像清理完成，共删除 ${removed} 个镜像账户`);
|
||||
return removed;
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 兜底：清理"账号已不存在"的孤儿镜像账户（同步时调用，防止删除路径万一漏掉）。
|
||||
*
|
||||
* ⚠️ **安全阀**：当前账号列表为空时**直接跳过** —— 无法区分"用户删光了账号"与
|
||||
* "账号存储临时读失败返回空"，后者若照常清理会把所有镜像账户误删。
|
||||
* "删光账号"这种场景已由 `removeByAccount` / 重置账号库两条显式路径覆盖。
|
||||
* 只要还剩至少一个账号，就只清"accId 前缀不在当前账号集合里"的那些 —— 精准、不会误伤。
|
||||
*
|
||||
* @returns 删除的账户数
|
||||
*/
|
||||
static async purgeOrphanAccountMirrors(context: common.Context): Promise<number> {
|
||||
if (!await SystemCalendarMirror.hasPermission()) {
|
||||
return 0;
|
||||
}
|
||||
let accounts: DavAccount[] = [];
|
||||
try {
|
||||
accounts = await AccountStore.loadAll(context);
|
||||
} catch (err) {
|
||||
return 0; // 读失败一律不动
|
||||
}
|
||||
if (accounts.length === 0) {
|
||||
return 0; // 安全阀：见注释
|
||||
}
|
||||
const validAccIds: Set<string> = new Set<string>();
|
||||
for (const a of accounts) {
|
||||
validAccIds.add(a.id);
|
||||
}
|
||||
let removed: number = 0;
|
||||
try {
|
||||
const cm: calendarManager.CalendarManager = calendarManager.getCalendarManager(context);
|
||||
const all: calendarManager.Calendar[] = await cm.getAllCalendars();
|
||||
for (const cal of all) {
|
||||
const name: string = cal.getAccount().name;
|
||||
if (!name.startsWith(SystemCalendarMirror.ACCOUNT_PREFIX)) {
|
||||
continue;
|
||||
}
|
||||
const bucket: string = name.substring(SystemCalendarMirror.ACCOUNT_PREFIX.length);
|
||||
// bucket 形如 `<accId>-<hash>`；也兼容历史 `<accId>_<序号>`
|
||||
const dash: number = bucket.indexOf('-');
|
||||
const under: number = bucket.indexOf('_');
|
||||
let sep: number = -1;
|
||||
if (dash >= 0 && under >= 0) {
|
||||
sep = Math.min(dash, under);
|
||||
} else {
|
||||
sep = dash >= 0 ? dash : under;
|
||||
}
|
||||
if (sep <= 0) {
|
||||
continue; // 解析不出 accId → 不动（宁可留，不误删）
|
||||
}
|
||||
const accId: string = bucket.substring(0, sep);
|
||||
if (validAccIds.has(accId)) {
|
||||
continue;
|
||||
}
|
||||
try {
|
||||
await cm.deleteCalendar(cal);
|
||||
removed++;
|
||||
LogUtil.write(`兜底清理孤儿镜像账户(账号 ${accId} 已删除) id=${cal.id} name=${name}`);
|
||||
} catch (err) {
|
||||
LogUtil.write(`兜底删除孤儿镜像账户失败 id=${cal.id} name=${name}: ${(err as BusinessError).message}`);
|
||||
}
|
||||
await MirrorSnapshot.removeByCalKey(context, bucket);
|
||||
}
|
||||
} catch (err) {
|
||||
LogUtil.write(`兜底清理孤儿镜像账户：读取系统日历账户失败 ${(err as BusinessError).message}`);
|
||||
}
|
||||
if (removed > 0) {
|
||||
LogUtil.write(`兜底清理孤儿镜像账户完成：删除 ${removed} 个`);
|
||||
}
|
||||
return removed;
|
||||
}
|
||||
|
||||
/* ==================== 单个日历本 ==================== */
|
||||
|
||||
/**
|
||||
@@ -1224,6 +1401,18 @@ export class SystemCalendarMirror {
|
||||
return `${(h1 >>> 0).toString(36)}${(h2 >>> 0).toString(36)}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* ⭐ 由 `<accId> + href` 算出稳定标识 bookId（= `<accId>-<href哈希>`）。
|
||||
* 与 `listBooks()` 内部算法**完全一致**，供编辑账号页在"取消勾选某个日历本"时
|
||||
* 立即算出它的 bookId 并删掉对应镜像账户用（此时账号配置已被改写，listBooks 已查不到它）。
|
||||
* href 为空时退回 calKey（与 listBooks 的兜底口径一致）。
|
||||
*/
|
||||
static bookIdOf(accId: string, href: string, fallbackCalKey: string): string {
|
||||
return href !== ''
|
||||
? `${accId}-${SystemCalendarMirror.stableHash(href)}`
|
||||
: fallbackCalKey;
|
||||
}
|
||||
|
||||
/** 用账号信息补全日历本名与颜色（需要异步加载账号） */
|
||||
static async loadBookLabels(context: common.Context, keys: string[]): Promise<BookInfo[]> {
|
||||
const out: BookInfo[] = [];
|
||||
|
||||
@@ -272,38 +272,43 @@ export class TimelineUtil {
|
||||
return out;
|
||||
}
|
||||
|
||||
/** 时间轴"基准可视区"的起止小时：8:00 ~ 18:00 **恒定显示**（与用户确认）。 */
|
||||
static readonly BASE_START_HOUR: number = 8;
|
||||
static readonly BASE_END_HOUR: number = 18;
|
||||
|
||||
/**
|
||||
* 计算"需要显示的小时区间"（视窗截断）：
|
||||
* - 起点 = 最早日程所在整点（无日程默认 8 点），终点 = 最晚日程结束时刻向上取整（无日程默认 20 点）
|
||||
* - includeNowHour=true（今天）时，把当前时刻所在小时并进来，保证红线可见
|
||||
* 计算"需要显示的小时区间"（视窗截断）。规则（与用户确认）：
|
||||
* - **8:00 ~ 18:00 恒定显示**（即使当天没有任何日程，也至少显示这一段，避免"只有一条日程
|
||||
* 就只显示那 1 小时"的奇怪观感）；
|
||||
* - 若某天在 **8 点之前**有日程 → 起点向前扩到最早日程所在整点；否则 8 点之前的刻度不显示；
|
||||
* - 若某天在 **18 点之后**有日程 → 终点向后扩到最晚日程结束时刻向上取整；否则 18 点之后的刻度不显示。
|
||||
* - includeNowHour=true（今天）时，把当前时刻所在小时并进来以保证红线可见 —— 但**仍遵守上面的
|
||||
* "无日程则不显示"约束**：只有当该侧本来就有日程（起点已 <8 / 终点已 >18）时才允许继续向外扩，
|
||||
* 否则不会因为"当前时刻"而把 8 点前 / 18 点后的空档重新显示出来。
|
||||
* 视图渲染与"列表视图按天计算卡片高度"共用这一份逻辑，避免两边算法漂移。
|
||||
*/
|
||||
static viewRange(blocks: TimelineBlock[], includeNowHour: boolean, nowMs: number): ViewRange {
|
||||
const rg = new ViewRange();
|
||||
let s: number = -1;
|
||||
let e: number = -1;
|
||||
// 基准：8~18 恒显示
|
||||
let s: number = TimelineUtil.BASE_START_HOUR;
|
||||
let e: number = TimelineUtil.BASE_END_HOUR;
|
||||
for (const b of blocks) {
|
||||
const bh: number = Math.floor(b.topRatio * 24);
|
||||
const eh: number = Math.ceil((b.topRatio + b.heightRatio) * 24 - 0.0001);
|
||||
if (s < 0 || bh < s) {
|
||||
if (bh < s) {
|
||||
s = bh;
|
||||
}
|
||||
if (e < 0 || eh > e) {
|
||||
if (eh > e) {
|
||||
e = eh;
|
||||
}
|
||||
}
|
||||
if (s < 0) {
|
||||
s = 8;
|
||||
}
|
||||
if (e < 0) {
|
||||
e = 20;
|
||||
}
|
||||
if (includeNowHour) {
|
||||
const nh: number = Math.floor(TimelineUtil.nowRatio(nowMs) * 24);
|
||||
if (nh < s) {
|
||||
// 只有"该侧本来就有日程"时才允许把当前小时并进来（否则会违反"8 点前/18 点后无日程则不显示"）
|
||||
if (nh < s && s < TimelineUtil.BASE_START_HOUR) {
|
||||
s = nh;
|
||||
}
|
||||
if (nh + 1 > e) {
|
||||
if (nh + 1 > e && e > TimelineUtil.BASE_END_HOUR) {
|
||||
e = nh + 1;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2,6 +2,8 @@ import { AbilityConstant, ConfigurationConstant, UIAbility, Want, Configuration,
|
||||
import { hilog } from '@kit.PerformanceAnalysisKit';
|
||||
import { window } from '@kit.ArkUI';
|
||||
import { BackgroundSyncService } from '../common/BackgroundSyncService';
|
||||
import { NetworkSyncWatcher } from '../common/NetworkSyncWatcher';
|
||||
import { BackgroundSyncRunner } from '../common/BackgroundSyncRunner';
|
||||
import { LogUtil } from '../common/LogUtil';
|
||||
|
||||
const DOMAIN = 0x0000;
|
||||
@@ -12,8 +14,11 @@ export default class EntryAbility extends UIAbility {
|
||||
// 文件日志初始化：所有页面的同步日志统一写入 filesDir/sync.log
|
||||
LogUtil.init(this.context);
|
||||
LogUtil.write('---- App 启动 ----');
|
||||
// 后台同步：注册延迟任务兜底 + 按设置恢复长时任务
|
||||
// 后台同步：注册延迟任务兜底（2 小时）＋ 网络恢复补同步监听
|
||||
// ⚠️ 不再申请"长时任务"：dataTransfer 类型有 10 分钟无进度即被取消的一致性校验，
|
||||
// 日历同步不符合该语义、必被取消（详见 BackgroundSyncService 顶部注释）。
|
||||
BackgroundSyncService.initOnLaunch(this.context);
|
||||
NetworkSyncWatcher.start(this.context);
|
||||
// 服务卡片"添加"按钮跳转：把 widgetAction=add 透传给主页面（在 AppStorage 中暂存）
|
||||
this.handleWidgetParam(want);
|
||||
// ⚠️ 这里**不再申请任何权限**（含通知权限）。
|
||||
@@ -189,9 +194,15 @@ export default class EntryAbility extends UIAbility {
|
||||
|
||||
onForeground(): void {
|
||||
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
|
||||
// ⭐ 回到前台：① 归还短时任务配额 ② 立刻补同步一次（用户真正要看时数据必须最新）
|
||||
BackgroundSyncService.cancelTransientSync();
|
||||
BackgroundSyncRunner.runOnce(this.context, 'foreground');
|
||||
}
|
||||
|
||||
onBackground(): void {
|
||||
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
|
||||
// ⭐ 退到后台：申请短时任务，兜住"退后台后那一次"同步能跑完
|
||||
// （必须在退后台 5 秒内申请；单次最长 3 分钟，单日配额 10 分钟）
|
||||
BackgroundSyncService.requestTransientSync('正在同步日历数据');
|
||||
}
|
||||
}
|
||||
@@ -4,12 +4,13 @@ import { curves, router } from '@kit.ArkUI';
|
||||
import { common } from '@kit.AbilityKit';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { DavAccount, AccountStore, TYPE_KEYS, TYPE_CALDAV, TYPE_CARDDAV } from '../common/AccountStore';
|
||||
import { SyncEngine } from '../common/SyncEngine';
|
||||
import { SyncEngine, SyncBusyError } from '../common/SyncEngine';
|
||||
import { EditNavParams } from './EditAccountPage';
|
||||
import { EventDb } from '../common/EventDb';
|
||||
import { LogUtil } from '../common/LogUtil';
|
||||
import { AppSettings } from '../common/AppSettings';
|
||||
import { ScreenKeeper } from '../common/ScreenKeeper';
|
||||
import { SystemCalendarMirror } from '../common/SystemCalendarMirror';
|
||||
|
||||
@Entry
|
||||
@Component
|
||||
@@ -90,6 +91,12 @@ struct AccountsPage {
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: `「${acc.name}」同步完成` });
|
||||
} catch (err) {
|
||||
// ⭐ 已有同步在进行中 → 提示"请耐心等待"，不报"失败"（避免用户误解）
|
||||
if (err instanceof SyncBusyError) {
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: '有同步任务正在进行中，请耐心等待' });
|
||||
return;
|
||||
}
|
||||
const e = err as BusinessError;
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: `「${acc.name}」同步失败：${e.message}` });
|
||||
@@ -142,13 +149,24 @@ struct AccountsPage {
|
||||
});
|
||||
}
|
||||
|
||||
/** 执行删除：账号配置 + 该账号全部本地日程/待办 */
|
||||
/** 执行删除：账号配置 + 该账号全部本地日程/待办 + 该系统日历中该账号的全部镜像日历本 */
|
||||
private async confirmDeleteAccount(acc: DavAccount): Promise<void> {
|
||||
const context = this.getUIContext().getHostContext();
|
||||
if (context === undefined) {
|
||||
return;
|
||||
}
|
||||
try {
|
||||
// ⭐ 先清系统日历里属于**本账号**的镜像日历本（按 bookId 里的 accId 前缀匹配，
|
||||
// 绝不按显示名 → 不同账号的同名日历本不会误删）。
|
||||
// 必须在改账号配置**之前**做：一旦账号配置被删，bookId 就再也解析不出来，
|
||||
// 那些幽灵账户就永远清不掉了（这正是本次要修的 bug）。
|
||||
let mirrored: number = 0;
|
||||
try {
|
||||
mirrored = await SystemCalendarMirror.removeByAccount(context, acc.id);
|
||||
} catch (err) {
|
||||
// 系统日历清理失败不阻断账号删除（用户至少能删掉账号）
|
||||
LogUtil.write(`删除账号 ${acc.id}：清理系统日历镜像失败 ${(err as BusinessError).message}`);
|
||||
}
|
||||
this.accounts = this.accounts.filter((a: DavAccount): boolean => a.id !== acc.id);
|
||||
// force=true：删除最后一个账号时列表为空是合法场景，允许覆盖
|
||||
await AccountStore.saveAll(context, this.accounts, true);
|
||||
@@ -156,7 +174,11 @@ struct AccountsPage {
|
||||
await EventDb.deleteAccountEvents(context, acc.id);
|
||||
await AppSettings.cleanupAccountSettings(context, acc.id);
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: `「${acc.name}」已删除` });
|
||||
.showToast({
|
||||
message: mirrored > 0
|
||||
? `「${acc.name}」已删除，并清除系统日历中 ${mirrored} 个镜像日历本`
|
||||
: `「${acc.name}」已删除`
|
||||
});
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
this.getUIContext().getPromptAction()
|
||||
@@ -268,20 +290,27 @@ struct AccountsPage {
|
||||
@Builder
|
||||
emptyState() {
|
||||
Column({ space: 12 }) {
|
||||
Text('＋')
|
||||
.fontSize(30)
|
||||
.fontColor($r('app.color.text_hint'))
|
||||
.width(72)
|
||||
.height(72)
|
||||
.textAlign(TextAlign.Center)
|
||||
.borderRadius(20)
|
||||
.backgroundColor($r('app.color.card_bg'))
|
||||
.border({ width: 1.5, color: $r('app.color.shadow_color') })
|
||||
// ⭐ 空状态的「＋」本身可点击 → 直接进入添加账号页（此前只是个静态图标，点了没反应）
|
||||
Button() {
|
||||
Text('＋')
|
||||
.fontSize(34)
|
||||
.fontColor($r('app.color.brand'))
|
||||
.fontWeight(FontWeight.Medium)
|
||||
}
|
||||
.width(84)
|
||||
.height(84)
|
||||
.borderRadius(24)
|
||||
.backgroundColor($r('app.color.card_bg'))
|
||||
.border({ width: 1.5, color: $r('app.color.brand') })
|
||||
.shadow({ radius: 8, color: $r('app.color.shadow_color'), offsetX: 0, offsetY: 2 })
|
||||
.onClick(() => {
|
||||
this.openAddPage();
|
||||
})
|
||||
Text('还没有任何 CalDAV 账号')
|
||||
.fontSize(16)
|
||||
.fontWeight(FontWeight.Medium)
|
||||
.fontColor($r('app.color.text_primary'))
|
||||
Text('点击右下角 + 添加 CalDAV 账号')
|
||||
Text('点击上方 + 或右下角 + 添加 CalDAV 账号')
|
||||
.fontSize(13)
|
||||
.fontColor($r('app.color.text_secondary'))
|
||||
.textAlign(TextAlign.Center)
|
||||
|
||||
@@ -6,6 +6,8 @@ import { buffer } from '@kit.ArkTS';
|
||||
import url from '@ohos.url';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { TYPE_CALDAV, TYPE_CARDDAV, TYPE_WEBDAV } from '../common/AccountStore';
|
||||
import { DavDiscovery, DavCapability } from '../common/DavDiscovery';
|
||||
import { LogUtil } from '../common/LogUtil';
|
||||
|
||||
@Entry
|
||||
@Component
|
||||
@@ -107,12 +109,30 @@ struct AddAccountPage {
|
||||
code = await this.sendOnce(serverUrl, http.RequestMethod.GET, authHeader);
|
||||
}
|
||||
if (code === 401) {
|
||||
this.statusMsg = '服务器拒绝凭据(401)，请检查用户名密码';
|
||||
this.statusMsg = '服务器拒绝凭据（401）：请检查用户名与密码。若服务器开启了二次验证，请使用「应用密码」';
|
||||
this.statusOk = false;
|
||||
return false;
|
||||
}
|
||||
// ⭐ 0.0.7：405 是"这里不是 DAV 端点"的典型信号 —— 直接给出可操作指引，
|
||||
// 而不是笼统地报一个状态码让用户去猜。
|
||||
if (code === 405) {
|
||||
const cap: DavCapability = await DavDiscovery.optionsCapability(serverUrl, authHeader);
|
||||
if (!cap.isDav) {
|
||||
this.statusMsg = '这个地址不是 CalDAV 端点（服务器不接受 WebDAV 方法，返回 405）。\n\n'
|
||||
+ '请填写「日历家目录」而不是 DAV 根或网页链接，例如：\n'
|
||||
+ 'https://你的域名/remote.php/dav/calendars/你的用户名/\n\n'
|
||||
+ '（也可以直接填域名，下一步会自动尝试发现）';
|
||||
this.statusOk = false;
|
||||
return false;
|
||||
}
|
||||
}
|
||||
if (code >= 200 && code < 500) {
|
||||
this.statusMsg = '服务器连接成功';
|
||||
// ⭐ 即使可连，也顺手提示"地址看起来不完整"，让用户提前知道下一步会自动补全
|
||||
if (DavDiscovery.looksIncomplete(serverUrl)) {
|
||||
this.statusMsg = '服务器连接成功（该地址看起来是服务器根路径，下一步会自动尝试定位日历家目录）';
|
||||
} else {
|
||||
this.statusMsg = '服务器连接成功';
|
||||
}
|
||||
this.statusOk = true;
|
||||
return true;
|
||||
}
|
||||
@@ -186,6 +206,17 @@ struct AddAccountPage {
|
||||
if (this.isLoading) {
|
||||
return;
|
||||
}
|
||||
// ⭐ 0.0.7：先识别「网页分享链接」——这类地址对 PROPFIND 必定 405，
|
||||
// 提前拦下并给出人话指引，避免用户白跑一趟只看到"服务器返回 405"。
|
||||
const kind: string = DavDiscovery.classify(targetUrl);
|
||||
const shareMsg: string = DavDiscovery.shareHint(kind);
|
||||
if (shareMsg !== '') {
|
||||
this.statusMsg = shareMsg;
|
||||
this.statusOk = false;
|
||||
LogUtil.write(`添加账号：识别为网页分享链接（${kind}），已拦截`);
|
||||
return;
|
||||
}
|
||||
|
||||
this.isLoading = true;
|
||||
this.statusMsg = '正在连接服务器…';
|
||||
this.statusOk = false;
|
||||
@@ -229,7 +260,7 @@ struct AddAccountPage {
|
||||
.width('100%')
|
||||
|
||||
Column({ space: 16 }) {
|
||||
this.formField('服务器地址', '例如：https://nas.example.com/caldav/', this.serverUrl,
|
||||
this.formField('服务器地址', '例如：https://nas.example.com/remote.php/dav/calendars/用户名/（也可只填域名，下一步会自动识别）', this.serverUrl,
|
||||
(value: string) => {
|
||||
this.serverUrl = value;
|
||||
}, false)
|
||||
|
||||
@@ -5,6 +5,7 @@ import { buffer } from '@kit.ArkTS';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { DavAccount, AccountStore, TYPE_CALDAV } from '../common/AccountStore';
|
||||
import { DavClient, DavCalendarDiscovery, DavCalendarEntry } from '../common/DavClient';
|
||||
import { DavDiscovery, DiscoverResult, DavCapability } from '../common/DavDiscovery';
|
||||
import { LogUtil } from '../common/LogUtil';
|
||||
|
||||
/**
|
||||
@@ -98,17 +99,44 @@ struct CalendarListPage {
|
||||
this.statusOk = false;
|
||||
return;
|
||||
}
|
||||
const auth: string = 'Basic ' + token;
|
||||
// ⭐ 0.0.7：先做地址自动发现/智能补全 —— 用户常只填域名或 DAV 根，
|
||||
// 而 Nextcloud 等要求填「日历家目录」。此处自动找对端点，避免"读不出日历"。
|
||||
try {
|
||||
const resolved: DiscoverResult = await DavDiscovery.resolve(
|
||||
this.serverUrl,
|
||||
this.username,
|
||||
auth,
|
||||
async (u: string): Promise<boolean> => {
|
||||
const d: DavCalendarDiscovery = await DavClient.listCalendars(u, auth);
|
||||
return d.entries !== undefined && d.entries.length > 0;
|
||||
});
|
||||
if (resolved.ok && resolved.url !== '' && resolved.url !== this.serverUrl) {
|
||||
LogUtil.write(`服务地址已自动修正：${this.serverUrl} → ${resolved.url}（来源 ${resolved.via}）`);
|
||||
this.serverUrl = resolved.url;
|
||||
} else if (!resolved.ok && resolved.hint !== '') {
|
||||
// 自动发现彻底失败 → 直接把"人话原因"给用户，不再只报一个状态码
|
||||
this.isLoading = false;
|
||||
this.statusMsg = resolved.hint;
|
||||
this.statusOk = false;
|
||||
return;
|
||||
}
|
||||
} catch (err) {
|
||||
// 发现阶段异常不阻塞：继续用原地址走既有流程（保持旧行为兜底）
|
||||
LogUtil.write(`地址发现阶段异常，回退原地址：${(err as BusinessError).message}`);
|
||||
}
|
||||
// PROPFIND 与解析统一走 DavClient.listCalendars（与「编辑账号」页共用同一实现，避免重复正则逻辑）
|
||||
try {
|
||||
const disc: DavCalendarDiscovery = await DavClient.listCalendars(this.serverUrl, 'Basic ' + token);
|
||||
const disc: DavCalendarDiscovery = await DavClient.listCalendars(this.serverUrl, auth);
|
||||
this.isLoading = false;
|
||||
if (disc.statusCode === 401) {
|
||||
this.statusMsg = '登录已失效，请返回重新连接';
|
||||
this.statusMsg = '服务器拒绝凭据（401）：请返回检查用户名与密码。若服务器开启了二次验证，请使用「应用密码」';
|
||||
this.statusOk = false;
|
||||
return;
|
||||
}
|
||||
if (disc.statusCode !== 207 && disc.statusCode !== 200) {
|
||||
this.statusMsg = `获取日历列表失败，服务器返回：${disc.statusCode}`;
|
||||
// ⭐ 0.0.7：把生硬的状态码换成人话 + 可操作指引
|
||||
this.statusMsg = DavDiscovery.statusHint(disc.statusCode);
|
||||
this.statusOk = false;
|
||||
return;
|
||||
}
|
||||
@@ -118,7 +146,8 @@ struct CalendarListPage {
|
||||
LogUtil.write(`发现日历本：「${item.name}」${item.href} 颜色=${item.color === '' ? '(无)' : item.color}`);
|
||||
}
|
||||
if (list.length === 0) {
|
||||
this.statusMsg = '该路径下未发现日历本（没有包含 calendar 资源类型的集合）';
|
||||
// ⭐ 0.0.7：区分"地址层级不对"与"确实没有日历"，并给出正确填法示例
|
||||
this.statusMsg = DavDiscovery.emptyHint(this.serverUrl, this.username);
|
||||
this.statusOk = false;
|
||||
} else {
|
||||
this.calendarList = list;
|
||||
|
||||
@@ -10,6 +10,7 @@ import { common } from '@kit.AbilityKit';
|
||||
import { buffer } from '@kit.ArkTS';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { DavAccount, AccountStore } from '../common/AccountStore';
|
||||
import { DavDiscovery, DiscoverResult } from '../common/DavDiscovery';
|
||||
import { DavClient, DavCalendarDiscovery, DavCalendarEntry } from '../common/DavClient';
|
||||
import { EventDb } from '../common/EventDb';
|
||||
import { BackupTargetCheck, SystemCalendarMirror } from '../common/SystemCalendarMirror';
|
||||
@@ -141,16 +142,39 @@ struct EditAccountPage {
|
||||
return;
|
||||
}
|
||||
// PROPFIND 与解析统一走 DavClient.listCalendars（与「添加账号」页共用同一实现）
|
||||
const auth: string = 'Basic ' + token;
|
||||
// ⭐ 0.0.7：地址自动发现/智能补全（老账号可能当初填的是 DAV 根或已失效的路径）
|
||||
try {
|
||||
const disc: DavCalendarDiscovery = await DavClient.listCalendars(this.acc.serverUrl, 'Basic ' + token);
|
||||
const resolved: DiscoverResult = await DavDiscovery.resolve(
|
||||
this.acc.serverUrl,
|
||||
this.acc.username,
|
||||
auth,
|
||||
async (u: string): Promise<boolean> => {
|
||||
const d: DavCalendarDiscovery = await DavClient.listCalendars(u, auth);
|
||||
return d.entries !== undefined && d.entries.length > 0;
|
||||
});
|
||||
if (resolved.ok && resolved.url !== '' && resolved.url !== this.acc.serverUrl) {
|
||||
LogUtil.write(`编辑账号：服务地址自动修正 ${this.acc.serverUrl} → ${resolved.url}（${resolved.via}）`);
|
||||
this.acc.serverUrl = resolved.url;
|
||||
} else if (!resolved.ok && resolved.hint !== '') {
|
||||
this.isLoading = false;
|
||||
this.statusMsg = resolved.hint;
|
||||
this.statusOk = false;
|
||||
return;
|
||||
}
|
||||
} catch (err) {
|
||||
LogUtil.write(`编辑账号：地址发现异常，回退原地址 ${(err as BusinessError).message}`);
|
||||
}
|
||||
try {
|
||||
const disc: DavCalendarDiscovery = await DavClient.listCalendars(this.acc.serverUrl, auth);
|
||||
this.isLoading = false;
|
||||
if (disc.statusCode === 401) {
|
||||
this.statusMsg = '登录已失效，请检查账号密码';
|
||||
this.statusMsg = '服务器拒绝凭据（401）：请检查用户名与密码。若服务器开启了二次验证，请使用「应用密码」';
|
||||
this.statusOk = false;
|
||||
return;
|
||||
}
|
||||
if (disc.statusCode !== 207 && disc.statusCode !== 200) {
|
||||
this.statusMsg = `获取日历列表失败，服务器返回：${disc.statusCode}`;
|
||||
this.statusMsg = DavDiscovery.statusHint(disc.statusCode);
|
||||
this.statusOk = false;
|
||||
return;
|
||||
}
|
||||
@@ -158,7 +182,7 @@ struct EditAccountPage {
|
||||
new EditCalendarItem(e.href, e.displayName, e.color));
|
||||
if (list.length === 0) {
|
||||
LogUtil.write('编辑账号：未发现任何日历本');
|
||||
this.statusMsg = '该路径下未发现日历本';
|
||||
this.statusMsg = DavDiscovery.emptyHint(this.acc.serverUrl, this.acc.username);
|
||||
this.statusOk = false;
|
||||
} else {
|
||||
// 已勾选的日历本按账号当前配置预选
|
||||
@@ -224,6 +248,39 @@ struct EditAccountPage {
|
||||
target.calendarColors = selectedItems.map((c: EditCalendarItem): string => c.color);
|
||||
LogUtil.write(`编辑账号保存：id=${target.id}，新勾选 ${selectedItems.length}/${this.calendarList.length} 个日历本`);
|
||||
// 按 href 求出「旧序号 → 新序号」，迁移已落库日程到正确的 calKey
|
||||
// ⭐ 迁移前必须先删掉被取消勾选日历本的行（按 href）：
|
||||
// 序号收窄后，被取消本的旧 calKey 会被前面位移下来的本"接管"，
|
||||
// 不先删的话旧行会与新主的行混在同一个 calKey 里（2026-09-29 实测：
|
||||
// 服务器删除「读书」后重选，其 988 行混进「轻舟」的 calKey，镜像一直复活幽灵数据）。
|
||||
const newHrefSet: Set<string> = new Set<string>();
|
||||
for (const c of newHrefs) {
|
||||
newHrefSet.add(c);
|
||||
}
|
||||
const removedHrefs: string[] = [];
|
||||
for (const h of oldHrefs) {
|
||||
if (!newHrefSet.has(h)) {
|
||||
removedHrefs.push(h);
|
||||
}
|
||||
}
|
||||
if (removedHrefs.length > 0) {
|
||||
const pruned: number = await EventDb.pruneByHrefs(context, target.id, removedHrefs);
|
||||
LogUtil.write(`编辑账号保存：取消勾选/已失效 ${removedHrefs.length} 个日历本，清理本地日程 ${pruned} 行`);
|
||||
}
|
||||
// ⭐ 被取消勾选的日历本，其系统日历镜像账户也要一并删掉（否则取消同步后系统日历仍有幽灵账户）。
|
||||
// 此时账号配置即将被改写、listBooks 已解析不到它，故用 href 直接算稳定 bookId（与镜像侧同算法）。
|
||||
// ⚠️ 用稳定 bookId 删 —— 不同账号下有同名日历本时，bookId 里带 accId 前缀，绝不会删错。
|
||||
for (let oi: number = 0; oi < oldHrefs.length; oi++) {
|
||||
const oh: string = oldHrefs[oi];
|
||||
if (newHrefSet.has(oh)) {
|
||||
continue;
|
||||
}
|
||||
const bookId: string = SystemCalendarMirror.bookIdOf(target.id, oh, `${target.id}_${oi}`);
|
||||
try {
|
||||
await SystemCalendarMirror.removeById(context, bookId);
|
||||
} catch (err) {
|
||||
// 镜像账户删除失败不阻断保存（下次镜像前的孤儿清理还会兜底）
|
||||
}
|
||||
}
|
||||
const remapPairs: Array<[string, string]> = [];
|
||||
for (let oi: number = 0; oi < oldHrefs.length; oi++) {
|
||||
const oldNorm: string = DavClient.normalizeHref(oldHrefs[oi]);
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,13 +1,13 @@
|
||||
// entry/src/main/ets/pages/Index.ets
|
||||
// 同步日历主界面：月视图（左右滑动翻月）/ 周视图 / 日视图 / 日程列表
|
||||
// 混合展示 DAV 与系统日历；每分钟自动同步；可"回到今天"
|
||||
import { curves, mediaquery, router } from '@kit.ArkUI';
|
||||
import { curves, display, router, window } from '@kit.ArkUI';
|
||||
import { common, abilityAccessCtrl, bundleManager } from '@kit.AbilityKit';
|
||||
import { geoLocationManager } from '@kit.LocationKit';
|
||||
import { BusinessError, pasteboard } from '@kit.BasicServicesKit';
|
||||
import { DavAccount, AccountStore, CalSource, TYPE_CALDAV } from '../common/AccountStore';
|
||||
import { DisplayEvent, CalendarDataService } from '../common/CalendarDataService';
|
||||
import { SyncEngine } from '../common/SyncEngine';
|
||||
import { SyncEngine, SyncBusyError } from '../common/SyncEngine';
|
||||
import { LogUtil } from '../common/LogUtil';
|
||||
import { LunarUtil } from '../common/LunarUtil';
|
||||
import { CardDataService } from '../common/CardDataService';
|
||||
@@ -54,13 +54,16 @@ struct Index {
|
||||
@State syncing: boolean = false;
|
||||
@State loading: boolean = true;
|
||||
@State menuOpen: boolean = false; // 顶部 ≡ 下拉菜单
|
||||
// 宽屏（平板 / 折叠屏展开态）：月视图切左右双栏（左月历 / 右当日日程）。
|
||||
// 判据是窗口**短边**是否达到大屏断点 840vp：短边在旋转时不变（宽高互换），
|
||||
// 所以横竖屏布局天然保持一致 —— 满足"屏幕比例接近 1:1 的设备，横竖屏布局需保持一致"；
|
||||
// 同时不锁死屏幕方向，折叠屏展开态与平板仍可自由横竖屏切换。
|
||||
// 宽屏（双栏：月视图左月历 / 右当日日程，周视图同理）判据，两条满足其一即双栏：
|
||||
// ① 窗口短边 ≥ 840vp —— 折叠屏展开态 / 平板这类"大屏"。短边在旋转时不变，
|
||||
// 故横竖屏布局天然一致，满足"屏幕比例接近 1:1 的设备，横竖屏布局需保持一致"；
|
||||
// ② 横屏且宽高比 ≥ 1.5 —— 长条形屏幕（普通手机、折叠屏**合上后的外屏**）。
|
||||
// 这类设备比例远离 1:1，旋转应当切换布局（0.0.2 起即如此，用户已习惯）。
|
||||
// 加比例下限是为了兜底"短边不足 840 但比例接近 1:1"的小方屏：旋转依旧不变。
|
||||
// 2026-09-29 修复：上一版只留了判据 ①，导致 Mate X7 合盖后旋转屏幕布局不再变化。
|
||||
@State wideLayout: boolean = false;
|
||||
private widthListener: mediaquery.MediaQueryListener | null = null;
|
||||
private heightListener: mediaquery.MediaQueryListener | null = null;
|
||||
private winObj: window.Window | null = null;
|
||||
private winSizeCallback: ((size: window.Size) => void) | null = null;
|
||||
private accounts: DavAccount[] = [];
|
||||
private sources: CalSource[] = [];
|
||||
private swiperController: SwiperController = new SwiperController();
|
||||
@@ -147,47 +150,57 @@ struct Index {
|
||||
clearInterval(this.nowTimer);
|
||||
this.nowTimer = -1;
|
||||
}
|
||||
if (this.widthListener !== null) {
|
||||
this.widthListener.off('change');
|
||||
this.widthListener = null;
|
||||
}
|
||||
if (this.heightListener !== null) {
|
||||
this.heightListener.off('change');
|
||||
this.heightListener = null;
|
||||
if (this.winObj !== null && this.winSizeCallback !== null) {
|
||||
try {
|
||||
this.winObj.off('windowSizeChange', this.winSizeCallback);
|
||||
} catch (err) {
|
||||
// 窗口可能已销毁（页面退出），忽略
|
||||
}
|
||||
this.winSizeCallback = null;
|
||||
this.winObj = null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 宽屏判据：窗口短边 min(宽, 高) 是否达到大屏断点 840vp。
|
||||
* min(w,h) >= 840vp 等价于 (width >= 840vp) && (height >= 840vp)，用两条 mediaquery 合成。
|
||||
*
|
||||
* 为什么用"短边"而不是"是否横屏"：
|
||||
* 1) 旋转时短边不变 → 横竖屏布局自动保持一致。屏幕比例接近 1:1 的设备（折叠屏展开态、
|
||||
* 平板）在旋转时不会出现"单栏 ⇄ 双栏"的布局跳变；
|
||||
* 2) 不锁死屏幕方向，仍支持折叠屏展开态与平板的横竖屏自由切换显示。
|
||||
* 由窗口实际尺寸（px → vp）计算单栏/双栏。判据见 wideLayout 字段注释：
|
||||
* 短边 ≥ 840vp（大屏，旋转不变）或 横屏且宽高比 ≥ 1.5（长条形屏幕，旋转切换）。
|
||||
*/
|
||||
private applyLayoutMetrics(): void {
|
||||
let wOk: boolean = false;
|
||||
let hOk: boolean = false;
|
||||
if (this.widthListener !== null) {
|
||||
wOk = this.widthListener.matches;
|
||||
private applyLayoutFromWindow(win: window.Window): void {
|
||||
try {
|
||||
const rect = win.getWindowProperties().windowRect;
|
||||
const density: number = display.getDefaultDisplaySync().densityPixels;
|
||||
if (density <= 0) {
|
||||
return;
|
||||
}
|
||||
const w: number = rect.width / density;
|
||||
const h: number = rect.height / density;
|
||||
const shortEdge: number = Math.min(w, h);
|
||||
const ratio: number = h > 0 ? w / h : 1;
|
||||
const wide: boolean = shortEdge >= 840 || (w > h && ratio >= 1.5);
|
||||
LogUtil.write(`窗口尺寸 ${Math.round(w)}x${Math.round(h)}vp（短边 ${Math.round(shortEdge)}，宽高比 ${ratio.toFixed(2)}）→ ${wide ? '双栏' : '单栏'}`);
|
||||
if (wide !== this.wideLayout) {
|
||||
this.wideLayout = wide;
|
||||
}
|
||||
} catch (err) {
|
||||
// 取窗口信息失败时保持现状（罕见：窗口已销毁）
|
||||
}
|
||||
if (this.heightListener !== null) {
|
||||
hOk = this.heightListener.matches;
|
||||
}
|
||||
this.wideLayout = wOk && hOk;
|
||||
}
|
||||
|
||||
private initLayoutListener(): void {
|
||||
const mq = this.getUIContext().getMediaQuery();
|
||||
this.widthListener = mq.matchMediaSync('(width >= 840vp)');
|
||||
this.heightListener = mq.matchMediaSync('(height >= 840vp)');
|
||||
this.applyLayoutMetrics();
|
||||
this.widthListener.on('change', (): void => {
|
||||
this.applyLayoutMetrics();
|
||||
});
|
||||
this.heightListener.on('change', (): void => {
|
||||
this.applyLayoutMetrics();
|
||||
const ctx = this.getUIContext().getHostContext();
|
||||
if (ctx === undefined) {
|
||||
return;
|
||||
}
|
||||
window.getLastWindow(ctx).then((win: window.Window): void => {
|
||||
this.winObj = win;
|
||||
this.applyLayoutFromWindow(win);
|
||||
this.winSizeCallback = (_size: window.Size): void => {
|
||||
// size 参数为 px；重新读取属性并换算（折叠/展开、旋转都会触发）
|
||||
this.applyLayoutFromWindow(win);
|
||||
};
|
||||
win.on('windowSizeChange', this.winSizeCallback);
|
||||
}).catch((err: BusinessError): void => {
|
||||
LogUtil.write(`窗口尺寸监听初始化失败(保持默认单栏)：${err.message}`);
|
||||
});
|
||||
}
|
||||
|
||||
@@ -571,6 +584,12 @@ struct Index {
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: `「${acc.name}」同步完成` });
|
||||
} catch (err) {
|
||||
// ⭐ 已有同步在进行中 → 提示"请耐心等待"，不报"失败"
|
||||
if (err instanceof SyncBusyError) {
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: '有同步任务正在进行中，请耐心等待' });
|
||||
return;
|
||||
}
|
||||
const e = err as BusinessError;
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: `同步失败：${e.message}` });
|
||||
@@ -620,6 +639,8 @@ struct Index {
|
||||
await ScreenKeeper.acquire(context as common.UIAbilityContext);
|
||||
let ok: number = 0;
|
||||
let failMsg: string = '';
|
||||
// ⭐ 是否因为"已有同步在进行"而被跳过（这不算失败，只提示等待）
|
||||
let busySkipped: boolean = false;
|
||||
// 备份模式：先把系统本地日历导入目标日历本（幂等），再随正常同步推送上服务器
|
||||
try {
|
||||
await SystemCalendarImport.importIfNeeded(context);
|
||||
@@ -641,6 +662,11 @@ struct Index {
|
||||
acc.lastSyncTime = this.formatNow();
|
||||
ok++;
|
||||
} catch (err) {
|
||||
// ⭐ 并发被互斥锁拦下：不是失败，只是"已有同步在跑"，稍后自动同步会覆盖，直接略过
|
||||
if (err instanceof SyncBusyError) {
|
||||
busySkipped = true;
|
||||
continue;
|
||||
}
|
||||
const e = err as BusinessError;
|
||||
failMsg = e.message;
|
||||
}
|
||||
@@ -671,6 +697,10 @@ struct Index {
|
||||
if (failMsg !== '') {
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: ok > 0 ? `同步完成 ${ok} 个，失败：${failMsg}` : `同步失败：${failMsg}` });
|
||||
} else if (busySkipped && ok === 0) {
|
||||
// 全部账号都因"已有同步在进行"被跳过 → 只提示等待，不说失败
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: '有同步任务正在进行中，请耐心等待' });
|
||||
} else if (ok > 0 && manual) {
|
||||
this.getUIContext().getPromptAction()
|
||||
.showToast({ message: `同步完成（${ok} 个账号）` });
|
||||
@@ -1000,9 +1030,13 @@ struct Index {
|
||||
.borderRadius(12)
|
||||
.onClick(() => {
|
||||
const id: number = this.detailEvent !== null ? this.detailEvent.id : 0;
|
||||
// ⭐ 把"用户点的是哪一次发生"一起带过去：重复日程展开后所有次共用主事件的 id，
|
||||
// 不带发生时刻的话，编辑页无法知道用户点的是哪一次 → "仅这一次"会算错。
|
||||
const occ: number = this.detailEvent !== null ? this.detailEvent.startTime : 0;
|
||||
this.detailShow = false;
|
||||
if (id > 0) {
|
||||
AppStorage.setOrCreate<number>('pendingEventId', id);
|
||||
AppStorage.setOrCreate<number>('pendingOccurrenceTs', occ);
|
||||
router.pushUrl({ url: 'pages/EventEditPage' });
|
||||
}
|
||||
})
|
||||
|
||||
@@ -566,23 +566,17 @@ struct SettingsPage {
|
||||
if (this.context === undefined) {
|
||||
return;
|
||||
}
|
||||
// 后台持续同步依赖常驻通知 → 在用户主动开启时才申请通知权限（不随启动自动弹窗）
|
||||
if (value) {
|
||||
await this.ensureNotifyPermission();
|
||||
}
|
||||
try {
|
||||
await BackgroundSyncService.setBackgroundSync(
|
||||
this.context as common.UIAbilityContext, value);
|
||||
this.getUIContext().getPromptAction().showToast({
|
||||
message: value
|
||||
? '后台持续同步已开启，通知栏将显示常驻通知'
|
||||
: '后台持续同步已关闭'
|
||||
message: value ? '后台自动同步已开启' : '后台自动同步已关闭'
|
||||
});
|
||||
} catch (err) {
|
||||
this.backgroundSync = !value; // 失败回滚 UI
|
||||
const msg: string = (err as BusinessError).message !== ''
|
||||
? (err as BusinessError).message : '请重试';
|
||||
this.getUIContext().getPromptAction().showToast({ message: `开启失败：${msg}` });
|
||||
this.getUIContext().getPromptAction().showToast({ message: `设置失败：${msg}` });
|
||||
}
|
||||
}
|
||||
|
||||
@@ -682,9 +676,20 @@ struct SettingsPage {
|
||||
return;
|
||||
}
|
||||
try {
|
||||
// ⭐ 账号库整体重置 = 所有账号都没了 → 系统日历里的全部镜像账户也应一并清除
|
||||
// （否则会留下一堆无主的幽灵日历本，且再无人能对应回账号）。
|
||||
// 未授权/无镜像时返回 0，不影响重置本身。
|
||||
let mirrored: number = 0;
|
||||
try {
|
||||
mirrored = await SystemCalendarMirror.removeAll(this.context);
|
||||
} catch (err) {
|
||||
// 清理失败不阻断重置
|
||||
}
|
||||
await AccountStore.resetVault(this.context);
|
||||
this.getUIContext().getPromptAction().showToast({
|
||||
message: '账号库已重置，请重新添加账号'
|
||||
message: mirrored > 0
|
||||
? `账号库已重置，并清除系统日历中 ${mirrored} 个镜像日历本`
|
||||
: '账号库已重置，请重新添加账号'
|
||||
});
|
||||
} catch (err) {
|
||||
this.getUIContext().getPromptAction().showToast({
|
||||
@@ -1186,15 +1191,15 @@ struct SettingsPage {
|
||||
.backgroundColor($r('app.color.card_bg'))
|
||||
.border({ width: 1, color: $r('app.color.shadow_color') })
|
||||
|
||||
// 后台持续同步（长时任务）
|
||||
// 后台自动同步
|
||||
Column({ space: 8 }) {
|
||||
Row({ space: 10 }) {
|
||||
Column({ space: 2 }) {
|
||||
Text('后台持续同步')
|
||||
Text('后台自动同步')
|
||||
.fontSize(15)
|
||||
.fontWeight(FontWeight.Medium)
|
||||
.fontColor($r('app.color.text_primary'))
|
||||
Text('开启后申请后台长时任务，App 退到后台也按设定间隔继续同步（通知栏会显示常驻通知）')
|
||||
Text('开启后，退到后台仍会定时同步（系统最短约 2 小时一次）；回到前台或网络恢复时会立即补同步一次')
|
||||
.fontSize(12)
|
||||
.fontColor($r('app.color.text_secondary'))
|
||||
}
|
||||
|
||||
@@ -110,40 +110,32 @@ struct Widget4x4Card {
|
||||
return r >= 0 && Math.floor(r * 24) === h;
|
||||
}
|
||||
|
||||
/** 视窗范围：最早日程 ~ 最晚日程结束（今天再并入当前时刻）。
|
||||
* 不做"最大跨度截断" —— 现在可以滑动了，没必要砍掉日程。 */
|
||||
/** 视窗范围：**8:00~18:00 恒显示**；仅当 8 点前 / 18 点后有日程时才向该侧扩展。
|
||||
* （与 App 内时间轴 TimelineUtil.viewRange 同一口径，避免两处漂移。） */
|
||||
private w4Range(): W4Range {
|
||||
const rg = new W4Range();
|
||||
const bs: TBlock[] = this.parseBlocks();
|
||||
let s: number = -1;
|
||||
let e: number = -1;
|
||||
let s: number = 8;
|
||||
let e: number = 18;
|
||||
for (const b of bs) {
|
||||
const bh: number = Math.floor(b.topRatio * 24);
|
||||
const eh: number = Math.ceil((b.topRatio + b.heightRatio) * 24 - 0.0001);
|
||||
if (s < 0 || bh < s) {
|
||||
if (bh < s) {
|
||||
s = bh;
|
||||
}
|
||||
if (e < 0 || eh > e) {
|
||||
if (eh > e) {
|
||||
e = eh;
|
||||
}
|
||||
}
|
||||
const r: number = this.w4NowR();
|
||||
// 只有"今天 + 还有未结束的定时日程"时才把当前小时并入视窗（红线会显示）；
|
||||
// 定时日程已全部结束 → 不并入 → 时间刻度直接截断到最晚日程
|
||||
// 且仅在该侧本来就有日程时才允许继续向外扩（不因当前时刻把 8 点前/18 点后空档重新显示）
|
||||
const nh: number = (r >= 0 && !this.w4AllTimedEnded()) ? Math.floor(r * 24) : -1;
|
||||
if (s < 0) {
|
||||
s = nh >= 0 ? nh : 8;
|
||||
if (nh >= 0 && nh < s && s < 8) {
|
||||
s = nh;
|
||||
}
|
||||
if (e < 0) {
|
||||
e = nh >= 0 ? nh + 1 : 20;
|
||||
}
|
||||
if (nh >= 0) {
|
||||
if (nh < s) {
|
||||
s = nh;
|
||||
}
|
||||
if (nh + 1 > e) {
|
||||
e = nh + 1;
|
||||
}
|
||||
if (nh >= 0 && nh + 1 > e && e > 18) {
|
||||
e = nh + 1;
|
||||
}
|
||||
if (s < 0) {
|
||||
s = 0;
|
||||
|
||||
@@ -109,40 +109,32 @@ struct Widget6x4Card {
|
||||
return r >= 0 && Math.floor(r * 24) === h;
|
||||
}
|
||||
|
||||
/** 视窗范围：最早日程 ~ 最晚日程结束（今天再并入当前时刻）。
|
||||
* 不做"最大跨度截断" —— 现在可以滑动了，没必要砍掉日程。 */
|
||||
/** 视窗范围：**8:00~18:00 恒显示**；仅当 8 点前 / 18 点后有日程时才向该侧扩展。
|
||||
* （与 App 内时间轴 TimelineUtil.viewRange 同一口径，避免两处漂移。） */
|
||||
private w6Range(): W6Range {
|
||||
const rg = new W6Range();
|
||||
const bs: TBlock6[] = this.parseBlocks();
|
||||
let s: number = -1;
|
||||
let e: number = -1;
|
||||
let s: number = 8;
|
||||
let e: number = 18;
|
||||
for (const b of bs) {
|
||||
const bh: number = Math.floor(b.topRatio * 24);
|
||||
const eh: number = Math.ceil((b.topRatio + b.heightRatio) * 24 - 0.0001);
|
||||
if (s < 0 || bh < s) {
|
||||
if (bh < s) {
|
||||
s = bh;
|
||||
}
|
||||
if (e < 0 || eh > e) {
|
||||
if (eh > e) {
|
||||
e = eh;
|
||||
}
|
||||
}
|
||||
const r: number = this.w6NowR();
|
||||
// 只有"今天 + 还有未结束的定时日程"时才把当前小时并入视窗（红线会显示）；
|
||||
// 定时日程已全部结束 → 不并入 → 时间刻度直接截断到最晚日程
|
||||
// 且仅在该侧本来就有日程时才允许继续向外扩（不因当前时刻把 8 点前/18 点后空档重新显示）
|
||||
const nh: number = (r >= 0 && !this.w6AllTimedEnded()) ? Math.floor(r * 24) : -1;
|
||||
if (s < 0) {
|
||||
s = nh >= 0 ? nh : 8;
|
||||
if (nh >= 0 && nh < s && s < 8) {
|
||||
s = nh;
|
||||
}
|
||||
if (e < 0) {
|
||||
e = nh >= 0 ? nh + 1 : 20;
|
||||
}
|
||||
if (nh >= 0) {
|
||||
if (nh < s) {
|
||||
s = nh;
|
||||
}
|
||||
if (nh + 1 > e) {
|
||||
e = nh + 1;
|
||||
}
|
||||
if (nh >= 0 && nh + 1 > e && e > 18) {
|
||||
e = nh + 1;
|
||||
}
|
||||
if (s < 0) {
|
||||
s = 0;
|
||||
|
||||
@@ -1,16 +1,13 @@
|
||||
// entry/src/main/ets/syncwork/SyncWorkAbility.ets
|
||||
// 延迟任务兜底同步：App 进程被杀/设备重启后，系统在满足条件（有网络）时拉起本扩展执行同步
|
||||
// 注意：必须幂等——同步本身基于 ETag 全量比对，天然幂等；执行完必须 stopWork，否则系统按超时处理
|
||||
// 延迟任务兜底同步：App 进程被杀/设备重启后，系统在满足条件（有网络）时拉起本扩展执行同步。
|
||||
//
|
||||
// ⚠️ 约束（勿改）：
|
||||
// - 单次回调**上限 2 分钟**，超时进程被系统终止 → 逻辑必须轻量（本类只调 Runner，不做事后处理）。
|
||||
// - 周期由 BackgroundSyncService 设为 2 小时（系统活跃分组下限），此处不再重复设置。
|
||||
// - 必须幂等：同步基于 etag 全量比对 + dirty 标记，天然幂等。
|
||||
// - 必须主动 stopWork，否则系统按超时处理。
|
||||
import { WorkSchedulerExtensionAbility, workScheduler } from '@kit.BackgroundTasksKit';
|
||||
import { BusinessError } from '@kit.BasicServicesKit';
|
||||
import { DavAccount, AccountStore, TYPE_CALDAV } from '../common/AccountStore';
|
||||
import { SyncEngine } from '../common/SyncEngine';
|
||||
import { CardDataService } from '../common/CardDataService';
|
||||
import { ReminderService } from '../common/ReminderService';
|
||||
import { SystemCalendarImport } from '../common/SystemCalendarImport';
|
||||
import { SystemCalendarMirror } from '../common/SystemCalendarMirror';
|
||||
import { MirrorInbound } from '../common/MirrorInbound';
|
||||
import { AppSettings } from '../common/AppSettings';
|
||||
import { BackgroundSyncRunner } from '../common/BackgroundSyncRunner';
|
||||
import { LogUtil } from '../common/LogUtil';
|
||||
|
||||
export default class SyncWorkAbility extends WorkSchedulerExtensionAbility {
|
||||
@@ -26,62 +23,9 @@ export default class SyncWorkAbility extends WorkSchedulerExtensionAbility {
|
||||
|
||||
private async doSync(workInfo: workScheduler.WorkInfo): Promise<void> {
|
||||
try {
|
||||
const context = this.context;
|
||||
const accounts: DavAccount[] = await AccountStore.loadAll(context);
|
||||
// 备份模式：先导入系统本地日历（幂等），再随同步推送
|
||||
try {
|
||||
await SystemCalendarImport.importIfNeeded(context);
|
||||
} catch (err) {
|
||||
// 导入失败不影响正常同步
|
||||
}
|
||||
// 入站对账：把用户在系统日历里的改动读回来置 dirty（必须在同步之前）
|
||||
try {
|
||||
await MirrorInbound.reconcile(context);
|
||||
} catch (err) {
|
||||
// 对账失败不影响正常同步
|
||||
}
|
||||
let ok: number = 0;
|
||||
let attempted: number = 0;
|
||||
for (const acc of accounts) {
|
||||
if (acc.type !== TYPE_CALDAV) {
|
||||
continue;
|
||||
}
|
||||
attempted++;
|
||||
try {
|
||||
// 超时保护由 syncAccount 内部处理（全量重拉 10 分钟 / 常规 5 分钟），不再套外层超时
|
||||
await SyncEngine.syncAccount(context, acc);
|
||||
ok++;
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`延迟任务同步 id=${acc.id} 失败: ${e.message}`);
|
||||
}
|
||||
}
|
||||
// 全部账号同步成功才结束"一次性全量重拉"状态
|
||||
if (attempted > 0 && ok === attempted) {
|
||||
await AppSettings.markFullRefetchDone(context);
|
||||
}
|
||||
await SyncEngine.settleLocalEvents(context);
|
||||
await SyncEngine.pruneOrphanRows(context, accounts);
|
||||
// ⚠️ 必须回写账号：syncAccount 会就地更新 acc（服务器日历本颜色、写权限等）。
|
||||
// 缺了这一步，后台同步刷到的颜色只留在内存里、进程退出即丢失，
|
||||
// 界面下次冷启动仍用旧颜色（表现为"同步之后颜色还是不对"）。
|
||||
await AccountStore.saveAll(context, accounts);
|
||||
// 出站镜像：把服务器最新状态写进系统日历（自动化，无需手点）
|
||||
try {
|
||||
if (await AppSettings.getMirrorEnabled(context) && await SystemCalendarMirror.hasPermission()) {
|
||||
const mr = await SystemCalendarMirror.syncNow(context);
|
||||
LogUtil.write(`延迟任务自动镜像：本=${mr.books} 新增=${mr.added} 更新=${mr.updated} 删除=${mr.deleted}`);
|
||||
}
|
||||
} catch (err) {
|
||||
// 镜像失败不影响同步
|
||||
}
|
||||
// 同步后刷新卡片 + 重建提醒，保证后台同步的成果直接可见
|
||||
await CardDataService.pushToAllForms(context);
|
||||
await ReminderService.refreshReminders(context);
|
||||
LogUtil.write(`延迟任务同步完成：${ok} 个账号`);
|
||||
} catch (err) {
|
||||
const e = err as BusinessError;
|
||||
LogUtil.write(`延迟任务同步失败: ${e.message}`);
|
||||
// 完整的后台同步流程（导入/对账/逐账号同步/镜像/卡片/提醒）统一由 Runner 实现，
|
||||
// 与"网络恢复补同步"、"回到前台补同步"共用同一套逻辑，避免三处实现漂移。
|
||||
await BackgroundSyncRunner.runOnce(this.context, 'deferred');
|
||||
} finally {
|
||||
// 必须主动结束，否则系统按 120 秒超时处理
|
||||
workScheduler.stopWork(workInfo);
|
||||
|
||||
@@ -12,9 +12,6 @@
|
||||
{
|
||||
"name": "ohos.permission.INTERNET"
|
||||
},
|
||||
{
|
||||
"name": "ohos.permission.KEEP_BACKGROUND_RUNNING"
|
||||
},
|
||||
{
|
||||
"name": "ohos.permission.PUBLISH_AGENT_REMINDER"
|
||||
},
|
||||
@@ -83,9 +80,6 @@
|
||||
"startWindowBackground": "$color:start_window_background",
|
||||
"exported": true,
|
||||
"orientation": "auto_rotation_restricted",
|
||||
"backgroundModes": [
|
||||
"dataTransfer"
|
||||
],
|
||||
"skills": [
|
||||
{
|
||||
"entities": [
|
||||
|
||||
Reference in New Issue
Block a user