Breeze

💖 鸣谢与赞助

感谢以下组织对开源社区的支持：

	本项目由 Sentry 提供全方位的错误监控赞助，其 Sponsored Business 计划帮助我们更快速地捕获并修复崩溃，提升用户体验。

必读⚠️

• Breeze 是一款安卓的哔咔及禁漫的三方客户端，基于 flutter 开发。
• 本应用包含限制级内容（如色情、血腥、暴力、毒品相关场景）。18 岁以下用户应在家长监督下使用，并请遵守当地法律法规。

功能

• 用户
  • 登录 / 注册 / 获取个人信息 / 自动签到
  • 修改密码 / 签名 / 头像
• 漫画
  • 分类 / 搜索 / 随机漫画 / 也在看此漫画 / 排行榜
  • 在分类中搜索 / 按“分类 / 标签 / 创作者 / 汉化组”搜索
  • 漫画详情 / 章节 / 查看图片 / 保存图片到相册
  • 收藏 / 点赞
  • 获取评论 / 发送评论 / 回复评论
• 下载
  • 导出 / 导出为 zip
• 缓存 / 自动清理

---

项目开发指南

1. 环境准备

在开始之前，请确保你的开发环境已安装以下工具：

• Flutter SDK: 请参考 Flutter 官方安装指南 完成配置，并确保 flutter doctor 检测通过。
• Rust Toolchain: 请参考 Rust 官方安装指南 安装 rustup 及最新的稳定版工具链。
• 各平台编译依赖:
  • Android: 需要安装 Android SDK 和 NDK。

2. 项目初始化

确定配置好开发环境后，使用以下命令生成相关代码：

flutter pub get
dart ./script/code_generate.dart

相关代码生成完毕后，即可开始开发。

---

🚀 如何安装

📱 Android

• 前往 Releases 页面 下载 app-arm64-v8a-release.apk。
• 提示：安装时若提示“风险来源”，请在设置中允许“安装未知应用”。

🪟 Windows

• 下载 windows-installer.exe 后直接运行即可完成安装。

🐧 Linux (Flatpak)

Linux 版本通过 Flatpak 分发，以确保在不同发行版上的兼容性。

1. 准备环境

如果你的系统尚未配置 Flatpak，请先参考 Flatpak 快速设置指南 完成基础安装。

加速建议：中国大陆用户建议配置 CERNET 镜像源 以提升下载速度。

2. 安装运行时 (Runtime)

本项目基于 Freedesktop 24.08 构建。在安装应用前，请确保系统中存在对应的运行时环境：

flatpak install flathub org.freedesktop.Platform//24.08

3. 安装应用

下载 Release 界面的 breeze.flatpak 文件，在终端执行：

# 安装至用户目录下
flatpak install --user breeze.flatpak

4. 运行程序

安装完成后，你可以通过应用菜单找到 Breeze，或者在终端输入：

flatpak run io.github.windy.breeze

💻 macOS

macOS 用户推荐使用 Homebrew 来安装和管理 Breeze。当然，你也可以直接下载 DMG 文件手动安装。

方法 1: 使用 Homebrew 安装（推荐）

1. 添加软件源 (Tap) 首先，将本仓库添加到你的 Homebrew 源列表中：

brew tap deretame/breeze

2. 安装 Breeze 执行以下命令，Homebrew 会自动下载并安装最新版本到你的“应用程序”目录：

brew install --cask breeze

3. 更新 Breeze 当 Breeze 发布新版本后，你可以通过以下命令一键升级：

brew upgrade breeze

4. 彻底卸载 如果你需要卸载 Breeze，并希望同时清理底层的数据库、缓存和配置文件，请务必加上 --zap 参数（注意：这不会删除你手动导出的文件，但会清空 App 内部数据）：

brew uninstall --zap breeze

方法 2: 手动下载 DMG 安装

1. 前往 Releases 页面 下载最新的 Breeze-macOS.dmg。
2. 双击打开 .dmg 文件，将 Breeze.app 拖入 Applications（应用程序）文件夹。

⚠️ 首次启动注意事项 (macOS Gatekeeper) 由于本项目为开源免费软件，未进行 Apple 开发者签名。首次打开时，如果系统提示 “应用已损坏” 或 “无法验证开发者”，请在终端中执行以下命令予以放行，之后即可正常使用：

xattr -cr /Applications/Breeze.app

(备选方法：在“应用程序”文件夹中找到 Breeze，按住 Control 键点击应用图标，然后在弹出的菜单中选择“打开”。)

📱 iOS / iPadOS

由于 iOS 系统的封闭性，未上架 App Store 的应用需要通过“侧载 (Sideloading)”并自行签名才能安装。请前往 Releases 页面 下载无签名的 Breeze-iOS.ipa 文件，并使用以下工具之一进行安装：

🌟 推荐方案：AltStore

AltStore 是目前最稳定且对新手友好的 iOS 侧载工具，支持通过同一局域网下的电脑实现应用自动续签。

• 官网下载：AltStore 官方网站
• 使用教程：
• AltStore 官方图文指南（英文）
• 知乎：基于 AltStore 的越狱工具自签教程

🔧 其他自签/免签备选方案

如果你由于某些原因无法使用 AltStore，也可以考虑以下途径：

• Sideloadly：免越狱、支持 Windows 和 macOS 的强大桌面自签工具。(官网与教程)
• TrollStore (巨魔商店)：如果你的 iOS 系统版本在特定的漏洞支持范围内，强烈推荐使用巨魔商店实现永久免签安装，永不掉签。(TrollStore 支持版本及安装指南)

---

开源项目免责声明

1. 项目性质与声明 本项目为开源软件，由本人独立开发并维护。项目以“原样”形式提供，开发者不对项目的功能完整性、稳定性、安全性或适用性作出任何明示或暗示的担保。
2. 责任限制 开发者对因使用、修改或分发本项目（包括但不限于直接使用、二次开发或集成至其他项目）而导致的任何直接、间接、特殊、附带或后果性损害不承担任何责任。这些损害可能包括但不限于数据丢失、设备损坏、业务中断、利润损失或其他经济损失。
3. 用户责任 用户在使用本项目时，应自行评估其适用性并承担所有风险。用户须确保其使用行为符合所在国家或地区的法律法规及道德规范。开发者不对用户因违反法律法规或不当使用本项目而导致的任何后果负责。
4. 第三方依赖与资源 本项目可能依赖或引用第三方库、工具、服务或其他资源。开发者不对这些第三方资源的内容、功能、安全性或合法性负责。用户应自行评估并承担使用第三方资源的风险。
5. 无担保声明 开发者明确声明不对本项目提供任何形式的担保，包括但不限于：

• 适销性担保；
• 特定用途适用性担保；
• 不侵犯第三方权利担保；
• 无错误或无中断运行担保。

6. 项目修改与终止 开发者保留随时修改、暂停或终止本项目的权利，且无需提前通知用户。开发者不对因项目修改、暂停或终止而导致的任何后果负责。
7. 贡献者责任 如果本项目接受外部贡献，贡献者的行为仅代表其个人立场，不代表开发者的观点或立场。开发者对贡献者的行为及其贡献内容不承担责任。
8. 法律合规性 用户在使用本项目时，应确保其行为符合所在国家或地区的法律法规。开发者不对用户因违反法律法规而导致的任何后果负责。

---

重要提示 在使用本项目之前，请仔细阅读并理解本免责声明。如果您不同意本声明的任何条款，请立即停止使用本项目。继续使用本项目即表示您已阅读、理解并同意本免责声明的全部内容。

---

开发者信息

• 开发者：windy
• 项目仓库：Breeze
• 联系方式：telegram(电报)