长理星球

长理星球是为大学生打造的校园服务助手，让您的校园生活更便捷高效。通过本应用，您可以随时查询课表、考试成绩和考试安排，实时掌握宿舍电量情况并接收低电量提醒，快速查看课程作业和作业截止日期

长理星球的校园网络库由CSUSTKit提供支持

支持iOS及iPadOS最低17.0版本，macOS最低14.0版本，visionOS最低1.0版本

安装

• 通过App Store下载安装
• 通过TestFlight加入测试

构建

Important

构建要求：由于长理星球集成了一些特定的 App Capabilities，构建本项目需要具备 Apple Developer Program 会员资格。使用免费开发者账号可能导致签名失败或无法正常编译

步骤

1. 克隆项目

   git clone https://github.com/zHElEARN/CSUSTPlanet.git
   cd CSUSTPlanet

2. 安装依赖

   本项目使用 Bundler 管理 Ruby 依赖（包括 CocoaPods 和 Fastlane）

   gem install bundler

   安装项目所需的 Ruby gems并安装 iOS 依赖库

   bundle install
   bundle exec pod install

3. 项目配置

   长理星球使用了 .xcconfig 文件和环境变量来管理构建配置和敏感信息。在构建前，你需要完成以下两个配置文件的设置：

   • 构建配置 (User.xcconfig)

     复制构建配置模板文件，并填入你的开发者团队信息：

     cp Configs/User.xcconfig.template Configs/User.xcconfig
     

   • 环境变量 (.env)

     复制环境变量模板，用于 Fastlane 的签名管理，在 .env 文件中填入相应的 Apple ID 和密钥信息：

     cp .env.template .env

4. 运行项目

   使用 Xcode 打开工作空间文件 CSUSTPlanet.xcworkspace，即可构建并运行项目

许可证

本项目采用 Mozilla Public License 2.0 (MPL-2.0) 许可证。

这意味着：

• 您可以自由地使用、修改和分发本项目的源代码。
• 如果您修改了本项目的文件，则必须公开这些文件的源代码（即使您的项目是闭源的）。
• 详见 LICENSE 文件。

贡献

欢迎并鼓励大家为 长理星球 做出贡献，您可以 Fork 项目，进行修改并提交 Pull

如果您在使用过程中遇到问题，或对 长理星球 有任何建议，也欢迎提交 Issue来告知我们！

同时，也可以通过邮箱联系我们：personal@zhelearn.com

---

免责声明: 本项目仅供学习与技术研究使用，请勿用于任何非法用途。在使用过程中请遵守学校相关网络安全规定。