Xcode16 避坑

原创 已于 2025-10-22 14:27:40 修改 · 1.2k 阅读 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
cknow-ai Nick5683

cknow-ai 关注

标签
#ios
分类 开发工具
于 2025-10-14 13:03:52 首次发布

Xcode16 避坑

原文地址

2024-06-17 4,685 阅读3分钟

1、UITabBarController 的 sideBar

iPad 升级到iOS 18 后，底部的 UITabBar 会被系统移动到顶部。（如果你对页面 UI 尺寸做了调整，页面底部可能有空白）

如何把 UITabBar 移到底部？

iPadOS 18.1 + Xcode 16.1 仅仅设置self.mode = UITabBarControllerModeTabBar不起作用

// 在UITabBarController子类里

#if __IPHONE_OS_VERSION_MAX_ALLOWED >= 180000
    if (@available(iOS 18.0, *)) {
        if (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad) {
            self.mode = UITabBarControllerModeTabBar;
            self.traitOverrides.horizontalSizeClass = UIUserInterfaceSizeClassCompact;
            [self.view addSubview:self.tabBar];
            NSString *tabContainerClassName = [NSString stringWithFormat:@"%@%@%@", @"_UITab", @"Container", @"View"];
            for (UIView *subview in self.view.subviews) {
                if ([NSStringFromClass(subview.class) isEqualToString:tabContainerClassName]) {
                    [subview setHidden:YES];
                }
            }
        }
    }
#endif

2、第一次断点po慢，输出 Debugging will be degraded due to missing types.

unable to locate module needed for external types

error:
‘/xxxxx/ModuleCache.noindex/C499AKLJ8KAG/ObjectiveC-1KD62J152BYGO.pcm’ does
not exist

Debugging will be degraded due to missing types. Rebuilding the project will
regenerate the needed module files.warning: (arm64)

Debugging will be degraded due to missing types. Rebuilding the project will
regenerate the needed module files.warning: (arm64)

1. 创建或者编辑文件echo "settings set target.experimental.swift-enable-cxx-interop false" >> ~/.lldbinit
2 重启进程killall lldb-rpc-server
3. 打开Xcode重新debug

似乎在 Build Settings - Build Options里设置 DEBUG_INFORMATION_FORMAT = "dwarf- with-dsym" 有效

XCode15 debugger is working really slow with iOS 17.0.2
forums.developer.apple.com/forums/thre…

3、自定义组件的 maskView 崩溃

Terminating app due to uncaught exception ‘NSInternalInconsistencyException’,
reason: 'Set maskView (<UIView: 0x1155af800; …) to nil before adding it as
a subview of xxx

原因: UIView有自带属性 maskView, iOS 18 对 UIView的maskView
增加了断言，导致如果业务代码里有同名属性可能导致触发该断言。自定义组件相当于重写了系统属性。

解决方法：将自定义组件的 maskView 重名名。

// UIView.h
@interface UIView(UIViewRendering)
@property(nullable, nonatomic,strong) UIView *maskView API_AVAILABLE(ios(8.0));
#end

4、git仓库有大量的staged文件, 导致Xcode Not Responding

当前版本：Xcode Version 16.1 (16B40), 已经向苹果反馈。

出现问题的场景：

1）当前项目初始化了git仓库，有大量的staged文件但是没有提交（比如5000个）。

Xcode重新打开项目时也无响应。其实Xcode在处理文件导致不能操作, 可能10分钟后才处理完毕。

解决方法：git commit 即可

5、Xcode 编辑支持的设备方向时崩溃

图片)

旧版本创建的Xcode项目，支持的设备方向的字段在info.plist文件中，Xcode 16
移除了info.plist中的字段，改为project中配置所以尝试编辑时崩溃。

解决方法：

1). 找到info.plist文件，先备份 2). 右键点击，选择open as source code，删除所有key value，保留如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
</dict>
</plist>

3). 重新打开项目，可以看到支持的设备方向已经清空了，现在可以重新选择支持的方向

图片

4). 把需要的key value 重新添加到info.plist里面

这些在项目配置中有的key就不要添加到info.plist，否则修改支持的设备方向还是会崩溃
图片

6、openURL 废弃 (无法打开微信等第三方APP)

BUG IN CLIENT OF UIKIT: The caller of UIApplication.openURL(_:) needs to
migrate to the non-deprecated
UIApplication.open(_:options:completionHandler:). Force returning false
(NO).

UIApplication.shared.open(URL) 替换成 UIApplication.shared.open(URL, options: [:], completionHandler: nil)

7、iOS 18 PHAsset URL from requestAVAsset

获取相册文件PHImageManager.default().requestAVAsset(forVideo...)

Xcode 16/15 + iOS 18 返回的absoluteString包含一段奇怪的固定代码
#YnBsaXN0MDDRAQJfEBtSZWNvbW1lbmRlZEZvckltbWVyc2l2ZU1vZGUQAAgLKQAAAAAAAAEBAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAAr

PHCachingImageManager().requestAVAsset(  
    forVideo: userPhoto.imageAsset,  
    options: options ) { asset, _, _ in  
    	if let asset = asset as? AVURLAsset {  
	   		 print(asset.url.absoluteString)  
	   		 // file:///var/mobile/Media/DCIM/100APPLE/IMG_0768.MP4#YnBsaXN0MDDRAQJfEBtSZWNvbW1lbmRlZEZvckltbWVyc2l2ZU1vZGUQAAgLKQAAAAAAAAEBAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAAr 
	      
	   		 print(asset.url.relativePath)  
	    		// /var/mobile/Media/DCIM/100APPLE/IMG_0768.MP4
	    }  
}

检查文件是否存在

let relativePath = someUrl.relativePath
let absolutePath = someUrl.absoluteString

FileManager.default.fileExists(atPath: relativePath) // true
FileManager.default.fileExists(atPath: absolutePath) // false

解决方法: 用relativePath替换absoluteString

8、UICollectionView两次dequeueReusableCell闪退

Xcode 16.2 + iOS 18.3.2, 以下代码会崩溃(神不神奇,意不意外?)

let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "Identifier1", for: indexPath)
if condition {
    let cell2 = collectionView.dequeueReusableCell(withReuseIdentifier: "Identifier2", for: indexPath)
    return cell2
}
return cell

有崩溃堆栈, 但是xcode无法定位到具体的崩溃地址
在这里插入图片描述

解决方法:

if condition {
    let cell2 = collectionView.dequeueReusableCell(withReuseIdentifier: "Identifier2", for: indexPath)
    return cell2
} else {
    let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "Identifier1", for: indexPath)
    return cell
}

9、Xcode 16.3 Failed to find or create execution context

Xcode 16.3 打开旧项目编译报错:

xxx.xib: Failed to find or create execution context for description
‘<IBCocoaTouchPlatformToolDescription: 0x6000037d36a0> System content for
IBCocoaTouchFramework-ThirteenAndLater <IBScaleFactorDeviceTypeDescription:
0x6000037d3d20> scaleFactor=2x, renderMode.identifier=(null)’.
图片描述

原因未知

解决方法 :

sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService

xcrun simctl erase all


        for (UIView *subview in self.view.subviews) {
            if ([NSStringFromClass(subview.class) isEqualToString:tabContainerClassName]) {
                [subview setHidden:YES];
            }
        }
    }
}

#endif

2、第一次断点po慢，输出 Debugging will be degraded due to missing types.

unable to locate module needed for external types
error: ‘/xxxxx/ModuleCache.noindex/C499AKLJ8KAG/ObjectiveC-1KD62J152BYGO.pcm’ does not exist
Debugging will be degraded due to missing types. Rebuilding the project will regenerate the needed module files.warning: (arm64)

Debugging will be degraded due to missing types. Rebuilding the project will regenerate the needed module files.warning: (arm64)

  1. 创建或者编辑文件 echo “settings set target.experimental.swift-enable-cxx-interop false” >> ~/.lldbinit
    2 重启进程 killall lldb-rpc-server
  2. 打开Xcode重新debug
    似乎在 Build Settings - Build Options里设置 DEBUG_INFORMATION_FORMAT = “dwarf-with-dsym” 有效

XCode15 debugger is working really slow with iOS 17.0.2
forums.developer.apple.com/forums/thre…

3、自定义组件的 maskView 崩溃
Terminating app due to uncaught exception ‘NSInternalInconsistencyException’, reason: 'Set maskView (<UIView: 0x1155af800; …) to nil before adding it as a subview of xxx
原因: UIView有自带属性 maskView, iOS 18 对 UIView的maskView 增加了断言，导致如果业务代码里有同名属性可能导致触发该断言。自定义组件相当于重写了系统属性。
解决方法：将自定义组件的 maskView 重名名。
objc 体验AI代码助手 代码解读复制代码// UIView.h
@interface UIView(UIViewRendering)
@property(nullable, nonatomic,strong) UIView *maskView API_AVAILABLE(ios(8.0));
#end

4、git仓库有大量的staged文件, 导致Xcode Not Responding
当前版本：Xcode Version 16.1 (16B40), 已经向苹果反馈。
出现问题的场景：
1）当前项目初始化了git仓库，有大量的staged文件但是没有提交（比如5000个）。
Xcode重新打开项目时也无响应。其实Xcode在处理文件导致不能操作, 可能10分钟后才处理完毕。
解决方法：git commit 即可
5、Xcode 编辑支持的设备方向时崩溃

旧版本创建的Xcode项目，支持的设备方向的字段在info.plist文件中，Xcode 16 移除了info.plist中的字段，改为project中配置所以尝试编辑时崩溃。

解决方法：
1). 找到info.plist文件，先备份
2). 右键点击，选择open as source code，删除所有key value，保留如下
xml 体验AI代码助手 代码解读复制代码<?xml version="1.0" encoding="UTF-8"?>

3). 重新打开项目，可以看到支持的设备方向已经清空了，现在可以重新选择支持的方向

4). 把需要的key value 重新添加到info.plist里面

这些在项目配置中有的key就不要添加到info.plist，否则修改支持的设备方向还是会崩溃

6、openURL 废弃 (无法打开微信等第三方APP)

BUG IN CLIENT OF UIKIT: The caller of UIApplication.openURL(😃 needs to migrate to the non-deprecated UIApplication.open(:options:completionHandler:). Force returning false (NO).

UIApplication.shared.open(URL)
替换成
UIApplication.shared.open(URL, options: [:], completionHandler: nil)
7、iOS 18 PHAsset URL from requestAVAsset
获取相册文件PHImageManager.default().requestAVAsset(forVideo…)
Xcode 16/15 + iOS 18 返回的absoluteString包含一段奇怪的固定代码
#YnBsaXN0MDDRAQJfEBtSZWNvbW1lbmRlZEZvckltbWVyc2l2ZU1vZGUQAAgLKQAAAAAAAAEBAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAAr
swift 体验AI代码助手 代码解读复制代码PHCachingImageManager().requestAVAsset(
forVideo: userPhoto.imageAsset,
options: options
) { asset, _, _ in
if let asset = asset as? AVURLAsset {
print(asset.url.absoluteString)
// file:///var/mobile/Media/DCIM/100APPLE/IMG_0768.MP4#YnBsaXN0MDDRAQJfEBtSZWNvbW1lbmRlZEZvckltbWVyc2l2ZU1vZGUQAAgLKQAAAAAAAAEBAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAAr

print(asset.url.relativePath)
// /var/mobile/Media/DCIM/100APPLE/IMG_0768.MP4
}
}

检查文件是否存在
swift 体验AI代码助手 代码解读复制代码let relativePath = someUrl.relativePath
let absolutePath = someUrl.absoluteString

swift 体验AI代码助手 代码解读复制代码FileManager.default.fileExists(atPath: relativePath) // true
FileManager.default.fileExists(atPath: absolutePath) // false

解决方法: 用relativePath替换absoluteString
8、UICollectionView两次dequeueReusableCell闪退
Xcode 16.2 + iOS 18.3.2, 以下代码会崩溃(神不神奇,意不意外?)
swift 体验AI代码助手 代码解读复制代码let cell = collectionView.dequeueReusableCell(withReuseIdentifier: “Identifier1”, for: indexPath)
if condition {
let cell2 = collectionView.dequeueReusableCell(withReuseIdentifier: “Identifier2”, for: indexPath)
return cell2
}
return cell

有崩溃堆栈, 但是xcode无法定位到具体的崩溃地址

解决方法:
swift 体验AI代码助手 代码解读复制代码
if condition {
let cell2 = collectionView.dequeueReusableCell(withReuseIdentifier: “Identifier2”, for: indexPath)
return cell2
} else {
let cell = collectionView.dequeueReusableCell(withReuseIdentifier: “Identifier1”, for: indexPath)
return cell
}

9、Xcode 16.3 Failed to find or create execution context
Xcode 16.3 打开旧项目编译报错:
xxx.xib: Failed to find or create execution context for description ‘<IBCocoaTouchPlatformToolDescription: 0x6000037d36a0> System content for IBCocoaTouchFramework-ThirteenAndLater <IBScaleFactorDeviceTypeDescription: 0x6000037d3d20> scaleFactor=2x, renderMode.identifier=(null)’.

原因未知
解决方法:
zsh 体验AI代码助手 代码解读复制代码sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService

xcrun simctl erase all

作者：erick_yim
链接：https://juejin.cn/post/7381347654767689737
来源：稀土掘金
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

点赞 点赞 28
评论 0
书签 书签 21
Scale Manager1.00.0018(30291348)Bplus管理软件
03-14
源码链接： https://pan.quark.cn/s/39d20ff3b9b7 对于商店内各式电子秤的维护管理感到困扰吗？对于每日电子秤营收数据的统计感到烦忧吗？现在为大家呈现一款由梅特勒-托利多独立研发的软件产品——Scale Manager，它扮演着卓越的数据管理角色。Scale Manager，其名称便直观表明了其作为电子秤管理解决方案的特性。只要您使用的是梅特勒-托利多的电子秤设备，便可通过Scale Manager对秤上的信息进行操控。现在，让我们共同探索这款软件的功能特性。 梅特勒-托利多Scale Manager功能详解 1. 核心数据传输商品信息/附加说明等基础资料经常需要更新，面对这些变动，是否考虑在秤体上直接调整？当然不是，我们提供更为高效的处理途径。通过进入梅特勒-托利多Scale Manager的数据管理模块，选取需要传输至电子秤的数据，随后点击传输键，即可将选定的信息高效地送达至店铺内的电子秤设备上。
Adding and Removing Subviews（增加和删除子视图的官方文档）
zon的专栏
08-16 1708
现在觉得看官方文档很又用，几乎你所有的问题都可以通过官方文档解决。视图架构和展现在网上很少有介绍，就算有也不太清晰。现在把官方的文档放上来，备案，读着清晰多了。 Adding and Removing Subviews Interface Builder is the most convenient way to build view hierarchies because you a
iOS 26 开始强制 UIScene ，你的 Flutter 插件准备好迁移支持了吗？
恋猫de小郭的博客
10-28 3338
如果你之前在。
iOS 26.1 (iOS 18.4+) 上 Flutter Debug 模式的已知问题及解决方案
smileKH的博客
01-28 1224
摘要： iOS 26.1（iOS 18.4+）的新内存保护机制导致Flutter Debug模式在真机运行时出现mprotect权限错误，影响JIT编译功能。解决方案包括：1) 在真机上改用Profile/Release模式；2) 在模拟器上使用Debug模式；3) 更新项目配置支持现代iOS生命周期。该问题不影响Release/Profile模式及模拟器运行，Flutter团队正在修复。建议开发期间根据需求灵活选择构建模式，模拟器调试与真机测试相结合，同时保持开发环境更新至最新稳定版本。（149字）
Xcode报错：“Set `maskView` to `nil` before adding it as a subview of ZFMaskView
humiaor的博客
05-14 799
嗯，坑爹的IOS18，当你基于UIView实现的自己的子类中定义一个属性并。因为UIVIEW本身就有这个属性，你又定义一个！触发UIVIEW内部的。
idea调试代码错误_通过调试进行指导：如何将代码错误转化为学习经验
weixin_26737625的博客
09-08 536
idea调试代码错误⛰ ???? ???? ???? ???? ???? ???????????? Here at Guild, we like to foster a welcoming and inclusive engineering environment. In this series we will explore some ways to be an effective mentor as well as an effectiv...
iOS 16屏幕旋转适配全解析：从Xcode配置到实战避坑指南
nn3456的博客
02-16 243
本文全面解析iOS 16屏幕旋转适配的核心变化与实战方案。针对Xcode 14编译环境下UIDevice.orientation私有方法失效的问题，详细介绍了使用UIWindowScene.requestGeometryUpdate新API的正确流程，包括获取场景、创建几何偏好、调用关键控制器方法setNeedsUpdateOfSupportedInterfaceOrientations等步骤，并提供了兼容iOS 16前后系统及不同Xcode版本的健壮代码示例与避坑指南。
iOS 16屏幕旋转适配全攻略：从Xcode 13到Xcode 14的避坑指南
weixin_29207439的博客
02-24 438
本文详细解析了iOS 16屏幕旋转适配的核心变化，即从`UIDevice`转向`UIWindowScene`的范式转移。针对Xcode 13与Xcode 14的编译差异，提供了包含条件编译与运行时检查的完整兼容性解决方案，帮助开发者平稳实现屏幕旋转功能，避免常见陷阱。
iOS18适配避坑指南：Xcode16下YYCache崩溃与ADClient废弃的实战解决方案
最新发布
weixin_33737774的博客
04-06 435
本文详细解析了iOS18和Xcode16适配中的常见问题，包括YYCache因sqlite3_stmt未释放导致的崩溃以及ADClient API废弃的替代方案。通过实战经验提供经过验证的解决方案，帮助开发者高效完成iOS18适配，避免编译和运行时错误。
iOS18适配避坑指南：Xcode16编译报错全解析（含YYCache、ADClient修复方案）
weixin_28839439的博客
03-26 163
本文详细解析了iOS18适配过程中Xcode16常见的编译报错问题，包括ADClient废弃、YYCache崩溃、maskView命名冲突等，并提供了经过实战验证的修复方案。特别针对iOS18和Xcode16的适配问题，帮助开发者快速解决升级过程中的技术难题。
Xcode报错：“Set `maskView` to `nil` before adding it as a subview of
MyLife_New的博客
07-01 185
以前的旧项目使用了maskView，但本身UIView存在maskView,修改项目中的maskView为baseView。
解决“Cradle project sync failed. Basic functionality(e.g.editing.debugging)”will not work properly
m0_37678146的博客
03-30 1103
把Android studio版本升级之后，再导入原来的项目就会报错，gradle失败，显示“Cradle project sync failed. Basic functionality(e.g.editing.debugging)”will not work properly 同时在Messages中显示  XXXX\cache.properties(系统找不到指定的文件。）   解决方法：删...
Xcode 升级后，常常遇到的遇到的警告、错误，解决方法
weixin_34203426的博客
03-31 358
Xcode 升级后，常常遇到的遇到的警告、错误，解决方法从sdk3.2.5升级到sdk 7.1中间废弃了很多的方法，还有一些逻辑关系更加严谨了。1，警告：“xoxoxoxo” is deprecated解决办法：查看xoxoxoxo的这个方法的文档，替换掉这个方法即可。2，警告：Declaration of "struct sockaddr" will not be vis...
VC学习笔记
core的博客
09-22 770
VC学习笔记
UITabBarController的使用 和 modal的使用方式
shengyuCSDN的博客
07-18 376
iOS 自用
Terminating app due to uncaught exception ‘NSInternalInconsistencyException‘, reason: ‘Set `maskView
carbonzhao的专栏
10-09 1324
嗯，坑爹的IOS18，当你在你的UI(uiview或uiviewcontroller的子类)类中定义一个属性并初始化时就会出现崩溃！因为UIVIEW本身就有这个属性，你又定义一个！触发UIVIEW内部的断言出现崩溃！
UITabBarController的使用详解及其自定义
沸腾的泪水的专栏
09-02 4445
转载自: https://www.jianshu.com/p/2f74a5d93faa 简介 UITabBarController - 选项卡控制器，与导航控制器一样，也被广泛用于各种ios应用程序。顾名思义，选项卡控制器在屏幕底部显示一系列“选显卡”，这些选项卡表示为图标和文本，用户触摸它们将在不同的场景间切换。和UINavigationController类似，UITabBarContro...
Xcode26新特性与iOS26适配指南
BianHuanShiZhe的专栏
06-25 4167
同样在 WWDC25 上 Apple 发布了 iOS 26，引入了一个名为 Liquid Glass 的时尚新设计，同时推出了一些新的内容。在掌握了基于 iOS 18 开发的基础上，只要学习以下的新特性就能轻松过渡到 iOS 26。在 WWDC25 上 Apple 推出了 Xcode 26，相比较 Xcode 16，它有如下的变化。
iOS18+Xcode16: openURL弃用导致微信分享无响应的问题
热门推荐
学习笔记
12-09 1万+
iOS 18 + Xcode 16: openURL弃用导致微信分享无响应的问题
iOS13适配之SceneDelegte
阿党的专栏
12-04 3723
老项目升级到了XCode11 + iOS13，但是通过第三方平台还是收集到了崩溃信息。以这个最为棘手： 崩溃时发生的异常： 崩溃调用栈： 0 CoreFoundation ___exceptionPreprocess + 220 1 libobjc.A.dylib objc_exception_throw + 56 2 CoreFoundation +[_CFXNotificationToken...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Nick5683

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值