树洞 iOS / macOS 客户端,使用 SwiftUI 开发,支持 T大树洞、未名树洞。
与树洞 HTTP API 相关的实现使用独立的依赖库 HollowCore。
树洞客户端使用 iOS 15 SDK,需要 macOS 11.3+
、Xcode 13+
,适用于 iOS 14.0+
,macOS 11.0+
。
- 用 Xcode 打开
Hollow.xcodeproj
文件 - 等待 Swift Package Manager 加载依赖库
- 点击项目,在 TARGETS - Hollow - Signing & Capabilities 的
Team
中选择你的开发者账号 - 编译、运行
加载依赖库可能会由于网络环境的问题出现失败的情况,可以参考 这篇文章。
有关应用架构的说明,参见 architecture.md。
当前项目源文件目录结构如下:
- Hollow:iOS Target(包括 Catalyst 版 macOS app)
- HollowWidget:iOS 主屏幕小组件,编译 flag 为
WIDGET
原有的 macOS Target 已被删除。
可以通过 Pull Request 和 Issues 参与到树洞 iOS 客户端的开发中。
在添加新功能或修改 bug 之外,十分欢迎对已有代码进行优化,包括但不限于:修改不符合规范的命名、简化啰嗦的代码、优化不好的算法、添加注释、删除无用代码等。
涉及到代码修改的贡献应注意:
- 遵循 Swift 的 API Design Guidelines
- 在关键代码处添加必要的英文注释
以 AGPL-3.0 协议 开源,但不包含: