1. UITabBarButtonItem 液态玻璃效果
兼容处理
方式一(不推荐): 关闭所有 UITabBarButtonItem 的液态玻璃效果。
if (@available(iOS 26.0, *)) {
self.navigationItem.rightBarButtonItem.hidesSharedBackground = YES;
self.navigationItem.leftBarButtonItem.hidesSharedBackground = YES;
} else {
// Fallback on earlier versions
}
方式二: 所有导航栏按钮全部采用 UITabBarButtonItem,支持液态玻璃效果。
方式三: 降低 Xcode 版本到 Xcode 25 及以下版本,然后再打包。
方式四: 使用兼容模式显示传统 UI 风格,取消 TabBar 液态玻璃效果。 打开 Info.plist,添加一个 Boolean 键值对,添加完成后重新运行,UITabBar 恢复旧的样式:
<key>UIDesignRequiresCompatibility</key>
<true/>
2. navigationItem.titleView 尺寸问题
在 iOS 26 上,采用 UILayoutFittingExpandedSize 设置自定义的 navigationItem.titleView 内容尺寸时高度偏大,变为屏幕高度,预期应为导航栏高度。
原因: iOS 26 之前 UILayoutFittingExpandedSize 最大尺寸限制在导航栏范围内,而在 iOS 26 则允许充斥整个屏幕。
- (CGSize)intrinsicContentSize { return UILayoutFittingExpandedSize; }
兼容处理: 修改 intrinsicContentSize,指定 titleView 的尺寸大小为导航栏大小。
#define SCREEN_WIDTH [[UIScreen mainScreen] bounds].size.width
- (CGSize)intrinsicContentSize { return CGSizeMake(SCREEN_WIDTH, 44); }
3. UITabBarController KVC 注入失效
调用 self.setValue(yourTabBar, forKey: "tabBar") 自定义 tabBar 失效。
原因: iOS 26 之后对 UITabBarController 的 KVC 注入限制,导致无效,但不会 crash。
兼容处理:
- 方案 1: 使用兼容模式显示传统 UI 风格,取消 TabBar 液态玻璃效果。打开 Info.plist,添加 Boolean 键值对
<key>UIDesignRequiresCompatibility</key><true/>。 - 方案 2: 改为使用系统的 UITabBarItem 组件,能够支持新系统的液态玻璃效果。
- 方案 3: 降低 Xcode 版本到 Xcode 25 及以下版本,然后再打包。
4. AVAssetExportSession 转码报错
创建由 URL 标识的代表任何资源的 asset 对象时报错:

