hongguo-macos-port

项目概述

这是红果短剧 Flutter 客户端的 macOS（Apple Silicon）移植工程成果。上游仓库没有任何 LICENSE 声明，按著作权默认规则不能转发其源码，因此本仓库只发布作者自己编写的移植成果：macOS 平台工程配置、改动补丁、构建与签名脚本、移植文档，以及打好的 arm64 安装包。

移植补丁解决了三个实测播放问题：progressive MP4 被误按 HLS 解析导致「暂时无法播放」、mpv 属性并发读写引发的进程崩溃、播放加载期间重复点击互相挤掉请求；同时打通了局域网追剧同步与窗口管理。

项目	内容
平台	macOS（Apple Silicon）
上游基线	guoapp 0.2.64+71
验证环境	macOS 27、Apple M6、Flutter 3.47.6、Go 1.24.6
仓库性质	移植工程与安装包，不含上游应用源码

上游不授权就无人能转发源码，这个仓库用补丁和脚本把红果短剧合法地带上了 Mac。

主要功能

• macOS 原生移植：完整的 macOS 平台工程，窗口默认 1180×760 并支持最小尺寸限制
• 播放链路修复：修正 MP4 流式透传、播放器空闲等待与重复点击问题
• 局域网同步：通过 Bonjour 服务实现跨设备追剧进度同步
• 全屏支持：播放页全屏逻辑扩展到 macOS，并关闭硬件加速规避渲染崩溃
• 构建脚本：一键编译 Go 原生核心 libduanju_core.dylib 并注入 App 包
• 安装包分发：Releases 提供打好的 arm64 应用压缩包

适用人群

• 想在 Apple Silicon Mac 上看红果短剧的用户
• 有 Flutter 与 Go 环境、想自行构建的开发者
• 研究 Flutter 应用跨平台移植的工程师

快速上手

1. 从 Releases 下载 duanjuapp-macos-arm64-v0.2.64.zip 并解压
2. 将应用拖入「应用程序」目录后直接运行
3. 想自行构建：克隆上游 zhoufuweigg/guoapp 仓库到指定基线 commit
4. 套用本仓库 patches/ 补丁，放入 macos-platform/ 工程目录
5. 用 Flutter 3.47.6 执行构建脚本，先用 scripts/build_native.py --platform darwin 编译原生核心

核心优势

• 合法合规：不复制、不再分发上游源码，只发布自有移植成果
• 开箱可用：Release 提供现成的 arm64 应用包，解压即用
• 实测修复：三个播放崩溃与无响应问题均经真机定位并修复
• 文档详尽：移植步骤、踩坑记录与验证环境全部公开

系统要求

项目	要求
操作系统	macOS（Apple Silicon）
硬件	Apple M 系列芯片
构建环境	Xcode 27、Flutter 3.47.6 stable、Go 1.24+、CocoaPods 1.16+

注意事项

• 不含应用源码：仓库仅提供安装包与移植工程文件，不包含应用源码
• 上游随时可能删库：作者声明上游随时可能删除，建议尽早自行备份上游仓库
• 勿转发上游源码：在上游补充明确许可协议之前，请不要重新分发其源码