You need to enable JavaScript to run this app. Swift iOS13+ 如何使用statusBarManager设置StatusBar状态栏颜色
优惠活动
大模型
产品
解决方案
定价
更多

Swift iOS13+ 如何使用statusBarManager设置StatusBar状态栏颜色

iOS13+ 自定义状态栏样式解决方案

你当前使用的UIApplication.shared.statusBarStyle从iOS13开始被官方标记为废弃,因此会触发编译警告,你可以按照以下场景选择适配方案:

全局统一设置状态栏样式

需要先在项目的Info.plist中添加配置:将View controller-based status bar appearance(对应键名UIViewControllerBasedStatusBarAppearance)的值设置为false。

适配SceneDelegate的项目(Xcode11+新建项目默认配置)

在SceneDelegate.swift的scene(_:willConnectTo:options:)方法中添加如下代码:

guard let windowScene = (scene as? UIWindowScene) else { return }
windowScene.statusBarManager?.setStatusBarStyle(.lightContent, animated: false)

未适配SceneDelegate的老项目

在AppDelegate.swift的application(_:didFinishLaunchingWithOptions:)方法中添加如下代码:

if #available(iOS 13.0, *) {
    guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene else { return }
    windowScene.statusBarManager?.setStatusBarStyle(.lightContent, animated: false)
} else {
    // iOS12及以下版本兼容逻辑
    UIApplication.shared.statusBarStyle = .lightContent
}

单个控制器自定义状态栏样式

如果不同页面需要不同的状态栏样式,不需要修改Info.plist配置,直接在对应控制器中重写preferredStatusBarStyle属性即可:

class TargetViewController: UIViewController {
    // 设置当前页面的状态栏样式
    override var preferredStatusBarStyle: UIStatusBarStyle {
        return .lightContent
    }
    
    // 需要动态切换样式时调用该方法触发刷新
    func refreshStatusBarStyle() {
        setNeedsStatusBarAppearanceUpdate()
    }
}

如果控制器嵌套在UINavigationController、UITabBarController等容器控制器中,需要在容器控制器中重写该属性,优先取当前显示的子控制器的样式:

class CustomNavigationController: UINavigationController {
    override var preferredStatusBarStyle: UIStatusBarStyle {
        return topViewController?.preferredStatusBarStyle ?? .default
    }
}

自定义状态栏背景色

如果需要修改状态栏的背景颜色,可以通过添加自定义View实现:

if #available(iOS 13.0, *) {
    guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
          let statusBarFrame = windowScene.statusBarManager?.statusBarFrame else { return }
    let statusBarBgView = UIView(frame: statusBarFrame)
    statusBarBgView.backgroundColor = .systemBlue // 替换为你需要的颜色
    UIApplication.shared.windows.first?.addSubview(statusBarBgView)
}

内容的提问来源于stack exchange,提问作者Gui Reis

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.10 06:24:04