• 开源软件研究

  TriliumDroid：Trilium Notes的非官方安卓客户端

  發布人 Brave 2025-10-09 04:42

  TriliumDroid 是一款针对自托管笔记应用 Trilium Notes 开发的非官方、开源安卓客户端。该项目旨在为安卓用户提供一个移动解决方案，以便访问和管理其 Trilium 服务器上的笔记数据。本文将根据其官方项目资料，对 TriliumDroid 的功能、系统集成、安装要求、开发测试及社区贡献现状进行客观介绍。

  一、核心功能

  TriliumDroid 实现了 Trilium Notes 桌面版的多种核心功能，以便在移动设备上提供连贯的使用体验。

  • 服务器同步：应用通过与用户自建的 Trilium 同步服务器（要求 0.97 或更高版本）连接，实现笔记数据的同步。
  • 树状结构：支持 Trilium 标志性的无限层级树状笔记结构，且允许单篇笔记放置在树状结构中的多个不同位置。
  • 笔记编辑：内置基于 CKEditor 的所见即所得（WYSIWYG）编辑器，用于富文本内容的创建和修改。
  • 笔记类型：
    • 画布笔记 (Canvas Notes)：集成了 Excalidraw，支持用户创建自由形态的图表和示意图。
    • 地理地图笔记 (Geo Map Notes)：通过 Leaflet 和 OpenStreetMap (OSM) 数据，支持创建包含地理位置信息的笔记。
  • 知识管理：支持笔记属性（Attributes）和关系（Relations），可用于笔记的组织、查询和脚本化操作。
  • 版本控制与安全：提供笔记自动版本控制功能，并支持以单篇笔记为单位进行加密。
  • 导航与视图：提供笔记间的快速导航、笔记地图视图以及通过对话框快速跳转到指定笔记的功能。
  • 脚本支持：提供脚本 API，允许用户编写脚本以实现任务自动化或发送通知。

  二、安卓系统集成

  为了提供更贴近原生应用的体验，TriliumDroid 进行了一系列安卓系统层面的集成。

  • 内容分享：支持安卓系统的分享菜单。用户可以将 TriliumDroid 中的笔记内容分享至其他应用，也可以从其他应用接收分享的内容并将其创建为新的笔记。
  • 主题适配：应用界面支持浅色（Light）与深色（Dark）主题，并可根据安卓系统的全局设置自动切换。
  • 用户界面翻译状态 (Translation Status)：该项目的用户界面已进行国际化处理。根据现有资料，目前已支持的语言包括英语（English）、德语（German）、土耳其语（Turkish）和简体中文（Chinese, Simplified Han script）。翻译工作通过 Weblate 平台进行，并对社区贡献者开放。

  三、系统要求与安装方式

  用户在安装和使用 TriliumDroid 前需满足以下条件：

  • 服务器：一个正在运行的 Trilium 同步服务器，版本需为 0.97 或更高。
  • 安卓版本：设备系统需为 Android 7.0 或更高版本。

  项目提供了两种主要的安装途径：

  1. 通过 F-Droid：用户可以在 F-Droid 应用的设置中添加 IzzyOnDroid 的 F-Droid 软件源，之后便可直接搜索并安装 TriliumDroid。
  2. 手动安装 APK：用户可从 IzzyOnDroid 网站下载 .apk 安装包文件，然后在设备上进行手动安装（此操作需要系统开启“允许安装来自未知来源的应用”权限）。

  安装完成后，用户需在应用内配置其 Trilium 服务器的地址、端口及密码，等待初次同步完成即可开始使用。

  四、开发、测试与社区贡献

  TriliumDroid 是一个社区驱动的开源项目，其开发和维护遵循标准流程。

  • 测试工作流 (Test Workflow)：为保证应用质量，项目采用了结合单元测试 (Unit Tests) 和模拟器测试 (Emulator Tests) 的测试策略。这套流程旨在验证代码逻辑的正确性以及应用在模拟环境中的实际运行表现。
  • 开源许可：该项目主要遵循 GNU Affero General Public License v3 (AGPL-3.0) 许可证。其代码部分衍生自 Trilium Notes 和 TriliumNext Notes。项目中也捆绑了多个第三方库，如 Excalidraw (MIT)、CKEditor (GPL-2.0 or later)、boxicons (MIT) 等，这些库均遵循其各自的开源许可证。
  • 社区贡献：项目欢迎社区用户通过多种方式参与贡献：
    • 问题报告：通过 GitHub Issues 或 Matrix 聊天室 (#triliumdroid:matrix.org) 提交 Bug 报告或功能建议。
    • 翻译：通过 Weblate 平台参与用户界面的翻译工作。
    • 代码贡献：熟悉 Kotlin 和安卓开发的开发者可以通过提交代码来直接参与项目开发。

  总结

  TriliumDroid 作为 Trilium Notes 的一个非官方安卓客户端，为用户提供了在移动设备上访问其知识库的能力。它通过实现核心功能、集成安卓系统特性，并依托开源社区的协作模式进行开发、测试和国际化。对于在安卓平台上使用 Trilium Notes 的用户而言，TriliumDroid 提供了一个可行的移动端解决方案。

  Brave 回复 1 week, 1 day ago 1 成員 · 0 回复
• 0 回复

登入後即可回复