Files
pages/docs/design/ja/caldav-davx5-compatibility.md
Anya Tokugawa c1175d389f Implement Knowledge City platform, organizer and DAV integration
Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming.

Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
2026-09-27 14:44:43 +09:00

3.4 KiB
Raw Permalink Blame History

DAVx⁵/Tasks.orgの互換性調査

2026-09-27。利用者指定の公開ソースbitfireAT/davx5-oseを読み、commit 167dc85f211119db6a98596c08f64e5df32ca679(2026-09-25)を基準に確認。インストール済みアプリのバージョンとは同一と仮定しない。Android実機でDAVx⁵を実行した検証ではない。

同期方式

  • core/src/main/kotlin/at/bitfire/davdroid/sync/TasksSyncManager.kt:タスクはPROPFIND_REPORT固定。
  • resource/remote/BaseWebDavCollection.kt:Depth 0のPROPFINDでsupported-report-set、sync-token、getctag等を取得する。
  • resource/remote/ResponseExt.kt:sync-tokenを優先し、なければgetctagを使う。両方なければnull。
  • sync/SyncManager.ktのsyncRequired:状態nullは「同期必要」と判断する。両方ないこと自体で同期を拒否しない。
  • sync/TaskSyncer.ktとresource/remote/CalDavCollection.kt:VTODOのcalendar-queryを送り、ETagで比較し、必要なリソースをcalendar-multigetする。タスクqueryにtime-rangeは指定していない。
  • カレンダーは、期間制限やsync-collection未対応の場合PROPFIND_REPORTを選ぶ。未対応のsync-collectionを広告してはいけない。

したがって、提示されたXTaskApp / CodeSpark / SyncTaskListsSendの「sync-token or ctag必須」というエラーは、調査したDAVx⁵の同期コードの挙動とは異なる。端末上でどのアプリが直接CalDAV接続しているかを区別する必要がある。

PagesWikiとの差分と残件

  • 既存リストの単純VTODO同期に必要なREPORT、ETag、multigetは既存実装にある。実機確認は未完了。
  • DAVx⁵のリスト新規作成はDavCollectionRepository.generateMkColXmlでDAV:resourcetypeを常に付ける。現在のPagesWikiの限定MKCALENDARはこれを未対応propertyとして拒否する。VTODO専用で正しいresourcetypeを受理する回帰試験と実装が必要。
  • 作成時には説明・色・タイムゾーンや複数component-setも付く場合がある。受理する項目は正本保存・PROPFIND往復まで設計し、未知の意味を黙って破棄しない。
  • 時刻付きVTODO、繰り返し、VALARMはPagesWikiの現行限定プロファイルでは未対応。DAVx⁵が生成できる全タスク形式に対応済みではない。
  • リストの削除/属性編集、差分sync-tokenも別途残件。

今回の状態

追加途中だったctagのローカル変更(追加表・更新フック・応答property)は利用者の指示を受け取り下げた。本番には反映していない。取り下げ後の名前付きリスト・認可・原子性テストは成功。本番は0.10.0のまま。

利用者はTasks.orgを試す予定。DAVx⁵経由ではDAVx⁵のタスクアプリにTasksを選択し、同期対象の既存リストを有効化する。同じアカウントをTasks.org側に直接CalDAVとしても追加すると、Tasks.orgはDAVx⁵データを無視するため二重設定に注意する。初回は件名・日付だけのタスクで両方向を確認し、複雑な形式は分ける。

参照