Joplin iOS 版本演进全解从 Changelog 看移动客户端的功能、同步与安全演进【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin本文基于 Joplin 仓库中的 iOS 变更日志覆盖 ios-v12.6.2 至 ios-v13.7.5时间跨度 2021-12 至 2026-09系统梳理 Joplin iOS 客户端的版本编号体系、功能里程碑、同步与加密演进并结合 移动端源码包、Xcode 工程 与 iOS 发布脚本 说明如何自行构建运行该应用。读完本文你可以快速判断某次升级带来了哪些能力变化、同步兼容性约束在哪里以及如何从零构建 Joplin iOS 应用。一、版本编号体系ios-v 标签与核心版本号的关系readme/about/changelog/ios.md 中每个版本条目均以形如ios-v13.7.5的发布标签开头并附带发布日期例如最新条目## ios-v13.7.5 - 2026-09-10T19:10:44Z - Improved: Remove sync wizard button from config screen (#16458) (#16442) - Fixed: Fix WebDAV sync error Protocol https: not supported on servers that redirect (#16488) - Fixed: Fix WebDAV sync failing with 409 errors after 3.7 upgrade (#16471) - Fixed: Fix keyboard navigation issues related to level-1 headings (#16409)从变更日志可以读出三点关键信息iOS 应用版本与核心库版本解耦。移动端包 packages/app-mobile/package.json 中version: 3.7.0而 iOS 应用发布标签已经是13.x系列。这正是 13.7.4 条目中 “Support syncing with Joplin v3.7” 出现的背景iOS 客户端 13.x 承载的是 Joplin 核心 3.7 的数据与同步协议应用版本号独立递增。版本号由 Xcode 工程字段驱动。packages/tools/release-ios.ts 中的updateCodeProjVersions函数在每次发版时自动递增工程文件里的MARKETING_VERSION如13.7.4→13.7.5与CURRENT_PROJECT_VERSION构建号注释明确指出该逻辑会同时更新包括 ShareExtension 在内的所有扩展目标。条目按 New / Improved / Fixed / Security 分类。每条变更都带有对应的 PR 或 issue 编号如#16488和贡献者方便追溯具体改动。二、iOS 端功能里程碑时间线按时间顺序提炼 changelog 中的 “New / Improved” 条目可以勾勒出 iOS 客户端约五年的功能演进主线。1. 12.612.10 时代基础能力补齐2021-12 2023-01ios-v12.6.22021-12-17引入更快的内置同步锁sync locks、E2EE 开启时共享笔记、笔记图标支持并把最低支持 iOS 版本设为 13.0。ios-v12.9.12022-12-04移动端引入Markdown 工具栏、键盘触发的格式命令加粗/斜体、长按提示、笔记栏note bar附件大小上限提升到 200MB支持一次性附加多个文件。ios-v12.10.22023-01-20三个重要新特性——生物识别锁屏、多资料集profiles、实时搜索同时升级 React Native 至 0.70并把新的文本编辑器设为默认。2. 12.1112.13 时代加密升级与画板2023-05 2023-10ios-v12.11.3实现笔记本的父子层级parenting of notebooks。ios-v12.11.52023-06-25E2EE 加密方法升级为AES-256重置主密码时会同时创建新的主密钥。ios-v12.12.22023-09-01新增JEX 导出、Joplin Cloud “邮件转笔记”email to note、共享权限升级 React Native 至 0.71。ios-v12.13.22023-10-24支持绘图drawing pictures基于 js-draw 库实现同期修复了 WebDAV 与 Stackstorage 的同步问题、UTF-8 写入乱码等。3. 13.013.3 时代回收站、插件生态与工具栏重做2024-04 2025-02ios-v13.0.12024-04-20移动端补齐回收站含长按清空、插件面板与对话框、JEX 导入、Joplin Cloud 共享接收Joplin Cloud 登录流程改为支持通过浏览器完成 MFA。ios-v13.0.5明确将同步的最低版本要求设为3.0.0Set min version for synchronising to 3.0.0。ios-v13.1.6支持移动端永久删除笔记自动检测并使用操作系统主题。ios-v13.2.22024-12-12新增基于原生加密库的新加密方法、Markdown 编辑器覆盖模式overwrite mode、可滚动且可增删按钮的工具栏pCloud 同步重新启用。ios-v13.3.12025-02-19插件编辑器视图支持、S3 同步目标移出 beta、支持附加音视频录制的附件。ios-v13.3.2将ocr.enabled设置迁移、生物识别功能稳定化并修复语音录制崩溃。4. 13.413.6 时代富文本编辑器与同步体验重构2025-08 2026-04ios-v13.4.12025-08-10是本阶段最大的一次功能发布新增富文本编辑器RTE、Joplin Server SAML 支持、笔记修订revisions查看器、多页文档扫描、Joplin Cloud/Server 发布笔记支持。ios-v13.4.2新增“高亮当前行”设置RTE 支持details折叠块编辑器内 Markdown 渲染默认关闭可在 设置 笔记 中重新开启。ios-v13.5.12025-11-29同步向导sync wizard、混合大小写标签、标签列表搜索、文档扫描器增加 “Recognise text” 选项超过 10 万字符的笔记分享改为以文件形式分享。ios-v13.6.12026-02-04支持FrontMatter 块渲染、外部嵌入如 YouTube 视频、行内 HTML 渲染彩色文本、上下标、删除线React Native 升级至 0.81。ios-v13.6.3移动端支持按笔记本设置排序、应用打开/恢复时自动开始同步修复 OneDrive 授权码双重编码问题。ios-v13.6.4工具栏按钮上下移动重排、笔记附件管理界面修复更新主密码后加密笔记无法解密的问题。ios-v13.6.8新增“跳转笔记开头/结尾”工具栏按钮新增选择默认查看/编辑状态的设置项修复 JEX 导入。ios-v13.6.2新增 txt 导入功能编辑器内渲染in-editor rendering默认开启编辑器设置迁移到独立的编辑器分区React Native 升级至 0.81.6与当前 packages/app-mobile/package.json 中react-native: 0.81.6一致。5. 13.7 时代对齐 Joplin v3.7 核心2026-07 至今ios-v13.7.12026-07-13设置界面新增笔记本排序选项重构原生 Crypto 模块以提升移动端加密性能加载插件脚本改为直接从文件系统读取不再经过 bridge以加快启动修复 HTML 笔记的 XSS 漏洞移除 S3/Dropbox 同步的旧 workaround。ios-v13.7.2新增笔记锁定配置区、修复 Koofr 的 WebDAV 兼容。ios-v13.7.42026-09-05这是当前最新功能版本要点包括支持同步 Joplin v3.7数据格式对齐核心 3.7移动端 RTE 实现只读状态只读笔记禁用 MDE 交互式表格编辑全新设计的“新建笔记”菜单与笔记本长按菜单同步更新当前打开的笔记时刷新编辑器状态防止同步覆盖正在输入的远端内容#16193启用新的笔记本共享密钥格式修复编辑器编辑部分加载文档时的崩溃、Markdown 编辑器选区问题、E2EE 开启时笔记刷新不彻底等十余项编辑器/同步问题。ios-v13.7.52026-09-10最新移除设置界面中的同步向导按钮修复服务器发生重定向时 WebDAV 同步报 “Protocol https: not supported”修复升级到 3.7 后 WebDAV 同步出现 409 错误修复一级标题相关的键盘导航问题。三、同步能力演进各同步目标的历史修复脉络同步是 Joplin 的核心价值changelog 中 “Fixed/Improved” 条目里大量与同步目标Joplin Cloud、Joplin Server、WebDAV、Dropbox、OneDrive、S3、文件系统相关的修复其脉络值得单独梳理WebDAV问题最集中。早期修复了 Stackstorage 兼容12.13.2、非 ASCII 路径 URL 编码差异13.1.6#1107613.1.3 修复移动端 WebDAV 同步#1084913.5.1 增加 Apache Tomcat 兼容性#1361413.4.4 将默认 content-type 改为application/octet-stream#13053解决 Tomcat 400 错误的后续处理13.6.2 修复 Tomcat 400 错误13.7.2 修复 Koofr 兼容最新的 13.7.5 则修复了服务器重定向导致的 “Protocol https: not supported”以及3.7 升级后的 409 冲突——这两条对自建 WebDAV 服务器的用户尤为关键。Dropbox13.0.2 修复大文件集合同步#1039613.2.2 处理payload_too_large错误13.7.1 移除了旧 workaround 以提升性能。OneDrive12.11.2 起持续修复 null 调用崩溃、非 ASCII URI 编码13.6.3 修复授权码双重编码13.2.2 期间曾标记 OneDrive 旧同步方式弃用后又恢复Removed deprecation notice on OneDrive sync method。Joplin Server/Cloud13.4.1 起支持 SAML 单点登录与发布笔记13.5.1 增加 SAML 会话过期自动打开连接界面、共享笔记本与 SAML 的问题修复13.7.4 支持 v3.7 同步协议并启用新的笔记本共享密钥格式13.0.5 设定了同步最低版本 3.0.0 的门槛。数据一致性类修复13.5.1 “防止文件系统/WebDAV 同步时漏掉变更”#13054对应 issue #651713.7.1 “修复单个服务端对象 updated_time 在未来时导致的静默同步失败”#1526213.2.2 修复粘贴前后可能丢数据的竞态#1133413.7.4 又进一步在长 delta 步骤期间防止变更丢失#16208。这些条目集中体现了同步引擎对时钟偏差、竞态条件等边界场景的持续加固。四、编辑器与渲染技术栈从 changelog 的依赖升级记录可以还原移动端编辑器的技术栈演进CodeMirror 6移动端 Markdown 编辑器基于 CodeMirror 6 构建changelog 中多次出现版本升降级如 13.1.6 为修复 Android 回归而降级、13.7.2 升级codemirror/view至 6.43.6、13.7.1 升级至 6.42.1并伴随 “in-editor rendering”编辑器内渲染能力13.4.2 默认关闭、13.6.2 默认开启支持行内 HTML 渲染、代码块高亮与视图对齐、表格/数学/mermaid 支持。仓库中 packages/editor 目录即该编辑器CodeMirror/ProseMirror 实现的源码所在。js-draw 绘图自 12.13.2 引入后版本持续升级changelog 中可见 1.13.2 → 1.20.3 → 1.27.2 → 1.30.1 → 1.33.0 的记录用于笔记中的手绘图片。渲染依赖KaTeX数学、Mermaid图表13.4.2 中 RTE 增强 Mermaid 代码块支持、highlight.js语法高亮、tesseract.jsOCR对应文档扫描 “Recognise text” 功能。当前 packages/app-mobile/package.json 的依赖清单react-native 0.81.6、expo 54.0.35、react-native-quick-crypto 1.1.4 等与 13.6.x/13.7.x 时期的升级记录相衔接。五、安全与隐私修复史changelog 中显式标注Security:的条目不多但分量很重建议按时间关注ios-v12.13.2 / 12.11.2修复链接中特殊编码字符串导致的 XSS禁用编辑器中的 SVG 标签防止 XSS净化特定 HTML 属性修复部分设备上指纹锁可被绕过的漏洞。ios-v13.0.112.10.1修复向渲染器传入特殊构造字符串时的 XSS。ios-v13.2.2前后引入基于原生加密库的新加密方法Add new encryption methods based on native crypto libraries#1069613.7.1 又对其做了性能导向的重构“Refactor (native) Crypto module to improve encryption performance on mobile”。ios-v13.5.2修复 ABC 乐谱等设置的翻译错误ios-v13.7.1修复 HTML 笔记 XSS 漏洞#15435。隐私相关13.0.2 新增Privacy Manifest文件对应 packages/app-mobile/ios/PrivacyInfo.xcprivacy13.7.1 将ITSAppUsesNonExemptEncryption置为 false配合其纯端侧加密、非豁免加密声明。六、构建与运行 Joplin iOS 应用如果你想基于当前仓库源码自行构建 iOS 客户端readme/dev/BUILD.md 给出了标准流程# 方式一安装依赖时顺带执行 pod install cd packages/app-mobile RUN_POD_INSTALL1 yarn install # 方式二手动执行 cd packages/app-mobile/ios pod install之后在 Xcode 中打开packages/app-mobile/ios/Joplin.xcworkspace运行如果 Metro bundler 没有自动启动在packages/app-mobile下执行yarn start。packages/app-mobile/package.json 中engines要求 Node 20postinstall会运行jetify。工程层面的两个事实来自源码packages/app-mobile/ios/Joplin.xcodeproj/project.pbxproj 中主应用目标的IPHONEOS_DEPLOYMENT_TARGET为15.6部分目标为 18.6。这与 packages/tools/release-ios.ts 中checkDeploymentTargets的校验逻辑呼应——发布流程会检查各目标部署版本是否一致不一致时构建会失败该脚本注释引用了历史 issue #4945。发布脚本release-ios.ts在发版前会提示先执行yarn install yarn buildParallel并自动递增MARKETING_VERSION与CURRENT_PROJECT_VERSION包括 ShareExtension 等扩展目标。此外移动端还可通过yarn serve-web在浏览器中运行同一套 React Native 代码开发服务器端口 8088详见 readme/dev/BUILD.md 的 Web 小节。七、升级与同步兼容性建议结合 changelog 与仓库现状使用 Joplin iOS 客户端时建议注意跨端版本对齐13.7.4 才正式 “Support syncing with Joplin v3.7”如果你把其他端升级到 3.7 系列核心iOS 端应同步升级到 13.7.4 及以上以免出现协议不匹配。13.7.5 专门修复了 3.7 升级后的 WebDAV 409 问题使用自建 WebDAV 的用户优先升级。同步版本下限自 13.0.5 起同步要求的最低版本为 3.0.0Set min version for synchronising to 3.0.0更老的客户端将无法与新版数据互通。加密用户注意12.11.5 起 E2EE 升级为 AES-25613.2.2 引入基于原生库的加密方法并在 13.4.1 “Set new encryption methods as default”13.6.4 修复了主密码更新后无法解密的问题启用 E2EE 的用户在跨版本升级时应确保两端版本都不低于这些修复点。共享笔记本13.7.4 启用了新的笔记本共享密钥格式共享双方都升级到 13.7.4 可获得最完整的共享行为早期版本对共享只读状态、接受新格式密钥等问题有多轮修复见 13.5.1、13.6.3 条目。追踪具体变更每条 changelog 条目都携带 PR/issue 编号可对照 readme/about/changelog 下的 android、desktop、server 等兄弟文档交叉查看同一问题在不同平台端的修复情况。八、小结Joplin iOS 客户端的 changelog 记录了一条清晰的演进路径从 12.6 时代的同步锁与 E2EE 共享到 12.10 的生物识别与多资料集13.0 的回收站与插件面板13.4 的富文本编辑器与 SAML直至 13.7 对齐 Joplin v3.7 核心并加固 WebDAV 等同步目标。版本编号由 release-ios.ts 自动管理、部署目标与工程配置在 Xcode 工程文件 中可查证而 readme/dev/BUILD.md 与 packages/app-mobile/package.json 则提供了完整的自行构建路径。对于维护自建同步服务器Joplin Server/WebDAV或启用 E2EE 的用户本文第三节与第五节的条目是最直接的升级决策依据。【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
