SideStore 开发者实战指南：从架构到配置全解析

项目架构全景图

SideStore 作为 AltStore 的衍生项目，采用模块化结构设计，核心目录与文件分布如下：

路径	功能说明	重要程度
AltStore/	主应用模块，包含 UI 组件与业务逻辑	★★★
Dependencies/	第三方依赖库，如 libimobiledevice 等	★★☆
SideStore/	项目核心功能实现，含工具类与测试代码	★★★
xcconfigs/	Xcode 构建配置文件集合	★☆☆

SideStore 应用图标：采用渐变蓝紫底色与白色箭头标识，象征应用的核心功能定位

核心文件功能解析

🌟 构建与部署基石

Makefile

• 功能定位：自动化构建脚本，定义编译、测试、打包等流程
• 使用场景：在 CI/CD 管道中通过 make build 命令触发标准化构建，确保开发环境一致性
• 常见问题：Q: 如何添加自定义构建步骤？A: 在 Makefile 中新增目标规则并指定依赖关系

CodeSigning.xcconfig.sample

• 功能定位：代码签名配置模板，包含证书与配置文件信息
• 使用场景：开发团队需复制为 CodeSigning.xcconfig 并填入实际签名信息
• 常见问题：Q: 配置文件缺失会导致什么问题？A: 无法通过 Xcode 代码签名验证，应用无法安装

🔧 系统配置核心

SideStore.conf

• 功能定位：应用运行时配置文件，存储服务器地址、端口等关键参数
• 使用场景：修改服务器地址时无需重新编译，直接编辑该文件即可生效
• 常见问题：Q: 配置项格式错误如何排查？A: 查看应用启动日志中的解析错误提示

trustedapps.json

• 功能定位：受信任应用白名单，控制允许安装的应用来源
• 使用场景：企业部署时添加内部应用的唯一标识符（Bundle ID）
• 常见问题：Q: 如何添加新的可信应用？A: 在 JSON 数组中追加应用信息对象

快速上手指南

环境准备

1. 克隆项目仓库：

   git clone https://gitcode.com/gh_mirrors/si/SideStore
   

2. 配置代码签名：

   cp CodeSigning.xcconfig.sample CodeSigning.xcconfig
   

   编辑文件填入开发者账号信息

3. 执行构建：

   make release
   

💡 性能优化提示：通过 make clean && make build -j4 启用多线程编译，可将构建时间缩短 40%

延伸学习

1. AGPLv3 许可证：SideStore 采用的强 copyleft 开源协议，要求修改后的衍生作品必须以相同协议开源
2. Xcode 配置文件（xcconfig）：通过文本文件集中管理编译设置，支持条件配置与继承机制

注意事项

• 开发环境需安装 Xcode 13.0+ 及 Command Line Tools
• 修改 trustedapps.json 后需重启应用使配置生效
• 生产环境部署前应移除配置文件中的测试服务器地址