LiveContainer 使用指南：无需安装即可运行未签名 iOS 应用

LiveContainer 是一款为 iOS 开发者和测试人员打造的创新工具，它突破传统应用安装限制，让你无需通过 App Store 或复杂证书配置，即可直接运行未签名的 iOS 应用。无论是调试自定义 tweak、测试第三方应用，还是体验未上架的开发版应用，LiveContainer 都能提供安全、高效的沙盒运行环境，极大简化移动开发工作流。

一、核心价值：为什么选择 LiveContainer？

在 iOS 开发过程中，未签名应用的测试往往受限于证书管理和设备绑定。LiveContainer 通过以下核心优势解决这一痛点：

• 免安装运行：直接加载 IPA 文件或应用目录，无需经过系统安装流程，节省测试时间
• 沙盒隔离：所有应用在独立容器中运行，不会影响系统稳定性或其他应用数据
• Tweak 动态注入：支持实时加载 CydiaSubstrate 插件，快速测试功能修改效果
• 多场景适配：无论是开发调试、教育演示还是企业内部应用测试，均能提供一致体验

二、功能模块：掌握核心操作流程

🔧 应用管理中心：一站式应用生命周期控制

功能定位：作为 LiveContainer 的核心入口，应用管理中心提供应用的添加、启动、删除和信息查看功能。

关键路径：

1. 点击主界面底部「Apps」图标进入应用列表
2. 点击右上角「+」按钮选择本地 IPA 文件或应用目录
3. 选择应用卡片即可启动，长按卡片可呼出管理菜单

使用示例：
当需要测试新开发的应用时，只需将编译生成的 IPA 文件通过文件分享功能导入 LiveContainer，即可在应用列表中看到新增条目，点击即可启动运行，无需进行复杂的签名或设备信任设置。

🔧 Tweak 加载器：动态扩展应用功能

功能定位：Tweak 加载器是实现应用功能定制的核心模块，负责注入 CydiaSubstrate 运行时并加载自定义 tweak。

关键路径：

1. 在底部导航栏选择「Tweaks」进入插件管理界面
2. 开启需要加载的 tweak 开关（首次使用需授予文件访问权限）
3. 重启目标应用使 tweak 生效

使用示例：
开发人员可以将修改后的 NSBundle+FixCydiaSubstrate.m 等 tweak 文件放置在 Tweaks 目录，通过界面开关控制加载状态，实时测试不同 tweak 组合对应用行为的影响，大大提高调试效率。

🔧 多容器管理：隔离不同测试环境

功能定位：多容器管理允许创建独立的运行环境，实现不同应用配置的隔离存储。

关键路径：

1. 在「Settings」界面选择「容器管理」
2. 点击「新建容器」并命名（如 "测试环境 A"）
3. 在应用列表中长按应用选择「移动到容器」

使用示例：
当需要同时测试应用的两个版本时，可创建两个独立容器，分别安装不同版本应用和对应的 tweak 配置，避免版本冲突和数据干扰，实现并行测试。

三、配置指南：定制你的运行环境

⚙️ 3步完成基础配置

1. 准备配置文件
   从项目目录获取默认配置模板：
   xcconfigs/Global.xcconfig
   entitlements.xml

2. 修改核心参数
   编辑配置文件设置应用沙盒路径、JIT 模式等关键参数：

   • CONTAINER_ROOT：设置容器数据存储路径
   • ENABLE_JIT：控制是否启用 JIT 编译（true/false）
   • TWEAK_LOAD_PATH：指定 tweak 加载目录

3. 应用配置生效
   保存修改后，在「Settings」→「高级设置」中点击「刷新配置」，重启 LiveContainer 使新配置生效。

⚙️ 如何优化 JIT-less 模式性能？

JIT-less 模式允许在不支持 JIT 的设备上运行应用，通过以下配置提升性能：

1. 打开配置文件 LiveContainer/Tweaks/NSUserDefaults.m
2. 找到 kJITLessMemoryLimit 配置项，根据设备内存调整数值（建议 512-1024MB）
3. 启用内存缓存优化：

   [defaults setBool:YES forKey:@"EnableMemoryCache"];
   

⚙️ 常见配置问题排查

• Q：Tweak 无法加载怎么办？
  A：检查 TweakLoader/utils.h 中的路径配置，确保 TWEAK_BUNDLE_PATH 指向正确的 tweak 目录，并验证 tweak 文件权限是否可读。

• Q：应用启动闪退如何处理？
  A：查看容器日志文件 LiveContainer/main.c 中的错误输出，重点检查动态库加载和权限相关报错，尝试在安全模式下启动（长按应用图标选择「安全模式」）。

四、快速上手：从安装到运行的5分钟指南

1. 获取项目代码

   git clone https://gitcode.com/gh_mirrors/li/LiveContainer
   

2. 编译项目
   打开 Xcode 项目 LiveContainer.xcodeproj/project.pbxproj，选择目标设备后点击「Build」按钮。

3. 添加测试应用
   将待测试的 IPA 文件拖入 LiveContainer 主界面，或通过「+」按钮选择文件。

4. 配置必要 tweak
   在「Tweaks」界面启用基础兼容性 tweak（如 NSBundle+FixCydiaSubstrate）。

5. 启动应用
   在应用列表中点击目标应用图标，首次启动会显示权限请求，允许后即可正常运行。

通过以上步骤，你已经掌握了 LiveContainer 的核心使用方法。无论是日常开发调试还是多环境测试，LiveContainer 都能成为你 iOS 开发工具箱中的得力助手，让未签名应用的运行和测试变得前所未有的简单高效。