Sparkle 2

macOS 的安全可靠的软件更新框架。

Sparkle 2 增加了对应用沙箱、自定义用户界面、更新外部 bundle 以及更现代架构的支持，其中包括更快更可靠的安装。

预发布版本（如果可用）可以在 Sparkle 的发布页面 或您喜欢的包管理器上找到。更多每晚构建版本可以通过选择最近的 workflow 运行 并下载相应的 Sparkle-distribution artifact 来下载。

Sparkle 未来版本的当前状态由 其路线图 跟踪。

请访问 Sparkle 的网站 以获取关于使用和迁移到 Sparkle 2 的最新文档。有关更详细的更改列表，请参阅 Changelog。有关该项目更多内部设计文档，请在存储库的 Documentation 下找到。

• 无缝体验。没有提及 Sparkle；使用的是您的图标和应用名称。
• 安全可靠。更新通过 EdDSA 签名和 Apple 代码签名进行验证。Sparkle 2 中支持沙盒应用。
• 快速。支持增量更新，仅修补已更改的文件和原子安全安装。
• 易于安装。Sparkle 在您的应用中无需任何代码，只需要 Web 服务器上的静态文件。
• 可自定义。Sparkle 2 支持插入用于更新的自定义 UI。
• 灵活。支持应用程序、程序包安装程序、偏好设置面板和其他插件。Sparkle 2 支持更新外部 bundle。
• 处理权限、隔离，并在需要时自动请求身份验证。
• 使用基于 RSS 的 appcast 获取发布信息。Appcast 是事实上的标准，受第三方更新跟踪程序和网站支持。
• 在第二次启动前保持隐藏，以获得更好的第一印象。
• 真正的自更新 — 用户可以选择在后台自动下载和安装所有更新。
• 能够使用渠道进行 beta 更新（在 Sparkle 2 中），为用户添加分阶段发布，并将更新标记为关键或主要更新。
• 为主机应用提供进度和状态通知。

• 运行时：macOS 10.13 或更高版本。
• 构建：最新的主要 Xcode（稳定版或 beta 版，以最新的为准）以及一个主要版本之前的版本。
• 用于提供更新的 HTTPS 服务器（请参阅 应用传输安全）

请参阅入门指南。无需代码，但需要一些配置。

• 请在您的应用程序下检查 Console.app 中的日志。Sparkle 在那里打印有关其遇到的所有问题的详细信息。它通常还会为问题提出解决方案，因此请仔细阅读 Sparkle 的日志消息。

• 使用 generate_appcast 工具，该工具会自动创建 appcast 文件、正确的签名和增量更新。

• 确保 SUFeedURL 中指定的 URL 有效（拼写错误/404 错误是常见错误！），并且它使用现代 TLS (进行测试)。

Sparkle 使用 -fvisibility=hidden -fvisibility-inlines-hidden 构建，这意味着默认情况下不导出任何符号。如果您要向公共 API 添加符号，则必须使用 SU_EXPORT 宏修饰声明（在源代码中 grep 查找示例）。

通常您不需要构建 Sparkle 发行包，除非您要更改 Sparkle 本身。

要构建 Sparkle 发行包，请 cd 到 Sparkle 源代码树的根目录并运行 make release。构建完成后，Sparkle-VERSION.tar.xz 将被创建并在 Finder 中显示。

或者，在 Xcode UI 中构建 Distribution scheme。

我们承诺提供开放和友好的环境。请参阅我们的行为准则。