laoyang/SyncCalendar
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
121 Commits 1 Branch 11 Tags
ab718fc00f3738f4aa52752707c21614b54674f6
Commit Graph
8 Commits
Author SHA1 Message Date
laoyang 09e2373965 docs(README): 更新到 0.2.0 现状，补「自行编译上架需申请哪些权限」 
README 停留在 0.1.0 且有多处与代码不符，本次逐项核对后更新。
所有结论均以 module.json5 / AppScope / SettingsPage.ets / release profile 实测为准。

## 修正的过时内容

- 版本号 0.1.0 (10000) → **0.2.0 (10200)**
- 待办（VTODO）描述错误：「只读展示，不参与推送」
  → 实际 0.2.0 已由 `TodoService` 实现新建/编辑/打勾/删除全量双向推送，
     且写回时先 GET 原 .ics 原地改写，保留服务端未知属性
- 设置项一览与界面对不上
  → 按 SettingsPage.ets 实际分组重写为「系统日历 / 通用 / 数据 / 关于」四组，
     补上此前漏掉的「系统日历中的显示名称」「清除系统日历数据」「日历本只读·静音」

## 新增

### 📝 最近更新
补 v0.2.0 与 v0.1.0 两个版本条目，让版本变化可追溯。v0.2.0 记录：
待办双向同步、3 项同步核心修复（删除 404 / 防复活 / 404 物理清库）、反馈渠道迁移。

### 🔐 权限清单与用途（独立小节）
用表格列清 5 个权限的类型、用途、申请时机。之前只在技术要点里一行带过，
读者无法判断哪些要额外动作。

### 🔑 自行编译并上架：权限要怎么处理
这是本次重点。回答「fork 后自己上架需要申请哪些权限」：

1. **必须自己重走的**：READ_WHOLE_CALENDAR（ACL）、PUBLISH_AGENT_REMINDER。
   并明确一个大坑：**ACL 绑定 bundleName**，本项目已获批的 ACL 只对
   `synccalendar.yangyq.net` 有效；fork 后改了包名（几乎必然要改）就立即失效，
   必须用新包名重新申请。很多人会误以为代码里声明了就自动继承。

2. **ACL 怎么验证落地**：给出 openssl 解 p7b + 读 allowed-acls 的命令。
   ACL 不在 module.json5 里，而在签名 Profile 里——这正是我自己这次判断失误的地方，
   写进文档避免后来者重蹈。

3. **不想申请 ACL 的替代方案**：删掉权限，日历经 READ_CALENDAR 仍可读本应用写入的日历，
   只是看不到其他来源。社区实践过的合规绕行。

4. **其他审核注意点**：图标 alpha 通道要求、审核员无 CalDAV 账号需 Demo 模式、
   隐私政策与 module.json5 必须一致。

## 未改动
- 构建/签名章节（与当前 build-profile.json5 一致）
- 隐私、功能特性正文、相关链接（链接已是新的 Feedlite 地址）

README 353 → 479 行。
 2026-11-03 09:55:06 +08:00
laoyang 23b5d4cb9e docs(README): 修正权限描述 —— 移除已删的 LOCATION，标注 READ_WHOLE_CALENDAR 为受限权限需 ACL 2026-11-02 22:59:31 +08:00
laoyang 37062cc75b feat(0.2.0): 待办同步、事件标记、反馈系统迁移、版本升 0.2.0 #5 #6 
## 版本
versionCode 10200 / versionName 0.2.0（原 10000 / 0.1.0）

## 新增
- **VTODO 待办完整支持**：同步、展示、勾选完成、编辑、循环待办。
  关键修复：待办此前**从未被同步过** —— 同步主循环只处理 VEVENT，
  `DavClient.reportTodos()` 写了却零调用（死代码）。现已在
  `SyncEngine.syncAccountInner` 接入，并对未知类型本也拉一次
  （服务器多半不声明 supported-calendar-component-set，宁多拉不漏）。
  整段包 try/catch，单本失败不影响日程同步。
- **日历本类型图标**：`supported-calendar-component-set` 解析出
  event/todo/both/unknown，账号页在颜色前显示对应 SVG 图标。
  unknown 按日历对待（服务器不声明时不能武断判成待办）。
- **问题反馈入口**：设置页新增卡片，指向 FeedLite
  （https://feedlite.yangyq.net/?sw=synccalendar）。

## 改进
- 月视图事件标记：农历下方浅红点，每日期最多一个
- 选中/今天改为正圆底，周视图复用月视图 `dayCellCircle`
- 「今天」按钮状态化（在不在今天，视觉可辨）
- 待办页签按需显示（只看 todos.length，不依赖可能缺失的 comps）
- 新建非今天日程默认 09:00（统一 DEFAULT_START_HOUR）

## 修复
- 首屏农历不变色：外层 ForEach key 缺数据版本 → 整树复用不重绘
- 翻月闪跳：async 未等待 + @State 同栈不可读 → 改 rebuildPagesFor(y,m) 显式传参
- 翻月后整月无选中：选中日未随月迁移，且钳制导致日号漂移 → 加 preferredDay
- 周视图颜色过浅/选中不变白/星期标签丢失：复用组件时未设 inMonth

## 官网
- sf.html 新增「三、待办清单」章节（原三~八顺延为四~九）
- index.html 版本号 V0.1.0 → V0.2.0

## 工单
关闭 #3 #4 #5 #6；新建 #7 记录「VTODO 无法镜像到系统待办」的技术限制。

## 未做（技术限制）
镜像到系统日历「待办」页签：鸿蒙未开放待办 API，不可行。见 #7。
 2026-11-02 22:58:30 +08:00
laoyang 63b1a75b03 docs: README 更新至 0.1.0，补齐 0.0.7~0.1.0 缺失内容 
README 的版本信息此前停在 0.0.6（versionCode 600），已滞后 4 个版本。

- 版本行：0.0.6/600 -> 0.1.0/10000
- 补「地点搜索补全」「一键导航」「必填项校验强提醒」（0.1.0）
- 新增「CalDAV 地址自动发现」小节（0.0.7：.well-known 发现 + 人话错误提示）
- 隐私段落：明确「不申请定位权限」，补充华为地图服务说明与
  AES-256-GCM / HUKS 凭据加密细节
 2026-10-28 23:18:48 +08:00
laoyang 68329c57a0 docs: README 补充自行构建的签名配置说明，并修正过时描述 
用户诉求：仓库为安全起见把含密钥/口令的构建配置排除在版本库外，
但他人克隆代码后需要自行补齐才能构建，应在说明文件里讲清：
补什么文件、什么格式、在哪个文件里填、这些信息怎么申请。

新增内容：
- README「📦 构建与运行」重写为四节：准备工程 / 首次构建补签名配置 /
  编译运行 / 打上架包(.app)
- 「首次构建」一节详述：
  · 需要的 4 个文件（.p12 密钥库 / .cer 证书 / .p7b Profile / 两个口令）
  · 两条申请途径 —— 途径A DevEco「Automatically generate signature」自动生成
    （真机调试用，只需实名认证的华为开发者账号）；途径B 在 AGC 后台申请
    发布证书与发布 Profile（上架用，含 keytool 生成 CSR 的说明）
  · 填写位置与字段说明（signingConfigs[].material.* + products[0].signingConfig）
  · 明确「根 build-profile.json5 已 gitignore、勿提交；entry/build-profile.json5
    是模块级配置、必须保留」这一易混淆点
  · 附完整可抄的 JSON5 示例
- 新增 build-profile.example.json5 模板（占位符形式，无任何真实密钥与个人路径），
  用户可直接复制改名使用
- 打 .app 上架包章节补充 verify-app 需带 -inForm zip（否则误报 codesign block）

顺带修正 README 中已过时的描述（与上一轮代码改动保持一致）：
- 版本号 0.0.3 → 0.0.6
- 「后台持续同步/长时任务 dataTransfer/常驻通知」→ 分层调度说明
  （前台按间隔 + 后台定时唤起(最短约2小时) + 回前台/网络恢复即时补同步）
- 权限列表移除已删除的 KEEP_BACKGROUND_RUNNING
- 目录结构中后台同步模块改为 BackgroundSyncRunner/BackgroundSyncService/
  NetworkSyncWatcher

安全：已扫描确认 README 与模板不含任何口令、密钥或本机绝对路径。
 2026-10-11 21:39:11 +08:00
laoyang 8b5519bc31 更新 README：补充系统日历镜像、后台同步与备份、深色/沉浸式/大屏横竖屏与转场适配、设置项一览、隐私与权限策略、工程结构、构建说明、截图与相关链接；按现状修正视图与卡片描述 2026-09-28 15:23:54 +08:00
laoyang a7503a7a1f 更改了readme 
Signed-off-by: Yang Yongquan <i@yangyq.net>
 2026-09-14 22:02:03 +08:00
laoyang 7091cc9535 增加了readme文档。 2026-09-13 16:12:19 +08:00