iOS分享面板头部圆形图标去除白色背景实现方案问询

问题场景 #

使用LPLinkMetadata配置iOS分享面板（Share Sheet）头部图标时，圆形图标会显示额外的白色方形背景，希望实现类似Apple Maps分享面板的效果：仅显示无背景的纯圆形图标。

解决方案 #

核心是通过LPImageMetadata类包装图标图片，让系统正确识别并保留图片的透明通道，而非直接传入UIImage。

1. 确认图片格式 #

确保你使用的user-profile图标是带透明背景的PNG格式，JPG等不支持透明的格式会自动填充白色背景。

2. 修改元数据配置代码 #

替换activityViewControllerLinkMetadata方法中设置图标的逻辑，改用LPImageMetadata包装图片：

func activityViewControllerLinkMetadata(_ activityViewController: UIActivityViewController) -> LPLinkMetadata? {
    let metadata = LPLinkMetadata()
    metadata.title = self.sheetTitle ?? ""
      
    if let icon = UIImage(named: "user-profile") {
        // 创建LPImageMetadata处理图片元数据
        let imageMetadata = LPImageMetadata()
        imageMetadata.image = icon
        // 设置无限大圆角，强制图标以圆形渲染
        imageMetadata.cornerRadius = .infinity
        // 将包装后的元数据传入ItemProvider
        metadata.imageProvider = NSItemProvider(object: imageMetadata)
    }
        
    return metadata
}

为什么这样有效？ #

• 直接传入UIImage时，系统会默认将图片按普通位图处理，自动补充白色背景；而LPImageMetadata是LinkPresentation框架专为图片元数据设计的类，能让系统正确识别并保留图片的透明属性。
• 设置cornerRadius = .infinity会告诉系统将图标强制渲染为圆形，和Apple Maps的图标表现完全一致。

排查要点 #

如果修改后仍存在白色背景，请检查：

• 图片本身是否真的包含透明通道（用Mac预览打开，背景显示棋盘格则说明透明有效）
• 代码中是否对该UIImage做过withRenderingMode(.alwaysOriginal)之外的渲染模式设置，避免系统自动添加背景色

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