UIActivityViewController分享UIImage时触发布局约束冲突错误求助

问题重现 #

执行以下代码分享图片时：

let activityViewController = UIActivityViewController(activityItems: [UIImage(named: "image")], applicationActivities: nil)

出现布局约束冲突日志：

2023-10-11 09:45:33.759783+0200 Neview[16037:1721794] [LayoutConstraints] Unable to simultaneously satisfy constraints.
Probably at least one of the constraints in the following list is one you don't want.
Try this:
(1) look at each constraint and try to figure out which you don't expect;
(2) find the code that added the unwanted constraint or constraints and fix it.
(
"<NSLayoutConstraint:0x6000006c60d0 _UIActivityActionCellTitleLabel:0x15c5a3750.height >= 22 (active)>",
"<NSLayoutConstraint:0x6000006c5b80 _UICollectionViewListCellContentView:0x15c5a1ec0.height >= _UIActivityActionCellTitleLabel:0x15c5a3750.height + 30 (active)>",
"<NSLayoutConstraint:0x6000006c2850 'UIView-Encapsulated-Layout-Height' _UICollectionViewListCellContentView:0x15c5a1ec0.height == 30 (active)>"
)

Will attempt to recover by breaking constraint
<NSLayoutConstraint:0x6000006c60d0 _UIActivityActionCellTitleLabel:0x15c5a3750.height >= 22 (active)>

Make a symbolic breakpoint at UIViewAlertForUnsatisfiableConstraints to catch this in the debugger.
The methods in the UIConstraintBasedLayoutDebugging category on UIView listed in <UIKitCore/UIView.h> may also be helpful.

但将activityItems替换为自定义UIView等非UIImage类型时，约束冲突消失：

let activityViewController = UIActivityViewController(activityItems: [MyCustomUIView()], applicationActivities: nil)

原因分析 #

从约束日志能明确核心冲突逻辑：

• 系统要求分享选项单元格的标题标签高度至少为22
• 单元格内容视图高度至少是标题高度+30（即最小高度为52）
• 但同时被强制设置内容视图高度为30

这种矛盾是因为UIActivityViewController在处理UIImage类型的分享项时，会加载专门的图片分享选项单元格，而这些单元格的布局约束在特定系统版本/设备场景下存在UIKit内部bug。当传入自定义UIView时，系统会使用通用的分享单元格模板，其约束逻辑正常，不会触发冲突。

常见触发场景包括：

• iOS 16.x部分子版本的UIKit布局逻辑漏洞
• iPad设备上的popover布局适配问题

解决办法 #

1. 包装图片为数据类型
   把UIImage转换成Data传入，让系统使用通用分享单元格，避免加载有bug的图片专用单元格：

   guard let image = UIImage(named: "image"), let imageData = image.pngData() else { return }
   let activityViewController = UIActivityViewController(activityItems: [imageData], applicationActivities: nil)
   

2. 使用自定义UIActivityItemSource
   实现自定义分享数据源，控制系统加载的单元格类型：

   class ImageShareItem: NSObject, UIActivityItemSource {
       private let image: UIImage
       
       init(image: UIImage) {
           self.image = image
           super.init()
       }
       
       func activityViewControllerPlaceholderItem(_ activityViewController: UIActivityViewController) -> Any {
           return image
       }
       
       func activityViewController(_ activityViewController: UIActivityViewController, itemForActivityType activityType: UIActivity.ActivityType?) -> Any? {
           return image
       }
   }
   
   // 使用方式
   guard let image = UIImage(named: "image") else { return }
   let shareItem = ImageShareItem(image: image)
   let activityViewController = UIActivityViewController(activityItems: [shareItem], applicationActivities: nil)
   

3. 升级系统版本
   如果是系统版本bug，升级到最新iOS版本通常能修复UIKit的内部约束问题。

4. iPad适配调整
   如果是iPad上的问题，确保正确设置popover的展示源：

   if let popover = activityViewController.popoverPresentationController {
       popover.sourceView = sender // 替换为触发分享的视图
       popover.sourceRect = sender.bounds
   }
   

内容的提问来源于stack exchange，提问作者siflJebatkundy