SimulatorStatusMagic 使用指南

1. 项目介绍

SimulatorStatusMagic 是一个用于清理iOS模拟器状态栏的小工具，帮助开发者在截图时获得与Apple官方网站上展示的一致、完美的屏幕效果。它能够修改模拟器的状态栏，使其显示标准时间（如9:41 AM）、满电量、5格信号以及全WiFi信号。此外，对于iPad模拟器，还会显示日期（例如Tue Jan 9）。自Xcode 11起，虽然苹果引入了simctl status_bar命令行工具，但SimulatorStatusMagic仍然提供了更加便捷的方式来实现这些定制化设置。

2. 项目快速启动

安装

CocoaPods

将以下内容添加到你的Podfile的debug配置中：

target 'YourAppTarget' do
  # ...
  configurations = ['Debug']
  configurations.each do |config|
    if config == 'Debug'
      pod 'SDStatusBarManager'
    end
  end
end

运行pod install进行安装。

集成与使用

在你的代码中，调用以下方法来启用和禁用状态栏的覆盖：

// 启用覆盖
if let statusBarManager = SDStatusBarManager.sharedInstance {
    statusBarManager.enableOverrides()
}

// 恢复原始状态
if let statusBarManager = SDStatusBarManager.sharedInstance {
    statusBarManager.disableOverrides()
}

使用Demo App

1. 克隆仓库：git clone https://github.com/shinydevelopment/SimulatorStatusMagic.git
2. 打开SimulatorStatusMagic.xcodeproj。
3. 在Xcode中选择并运行目标SimulatorStatusMagic，而不是SimulatorStatusMagiciOS。
4. 应用启动后，点击屏幕上唯一的按钮即可。

3. 应用案例和最佳实践

• UI测试：在执行自动化UI测试前，可以启用SimulatorStatusMagic以确保测试时的状态栏与预期一致。
• 演示准备：在向潜在客户或团队展示应用程序之前，可使用此工具优化截图，突出展示应用界面。

最佳实践是只在调试环境中包含SDStatusBarManager，避免发布版本包含不必要的代码。

4. 典型生态项目

SimulatorStatusMagic通常与其他iOS开发工具一起使用，例如：

• Fastlane：自动化截图流程的一部分，可以在截图之前自动调整模拟器的状态栏。
• CocoaPods/Carthage：依赖管理工具，用于集成SDStatusBarManager。
• Xcode插件：一些开发者可能会创建Xcode插件来方便地开启和关闭SimulatorStatusMagic。

---

请注意，随着Xcode的更新，simctl status_bar可能逐渐成为首选的方法，但它并不完全替代SimulatorStatusMagic的功能，尤其是当需要通过代码控制状态栏或者在旧版本Xcode中工作时。