ShareLink for Swift：完整指南与代码示例

ShareLink 是 SwiftUI 框架中的内置结构，专为在 Swift 应用中创建“分享”按钮而设计。它提供了简单直观的接口，让你无需编写复杂的 UIKit 代码即可集成系统分享菜单（UIActivityViewController）。该组件自 iOS 16、macOS 13、tvOS 16 和 watchOS 9 起可用，并已成为现代 SwiftUI 应用中实现内容分享的标准方式。

为什么需要 ShareLink？在当今世界，用户经常分享内容：链接、照片、文本、文件。手动实现分享功能需要创建 UIActivityViewController、配置代理并处理各种数据类型。ShareLink 自动完成所有这些工作，提供一个现成的 SwiftUI 组件，能够自动适配平台和系统设置。这不仅加快了开发速度，还能确保在所有 Apple 设备上提供一致的用户体验。

该组件非常适合：社交应用（分享帖子）、新闻聚合器（分享文章）、照片编辑器（导出图片）、即时通讯工具（发送文件）以及任何需要“分享”功能的应用。ShareLink 支持所有标准数据类型：字符串、URL、图片、文件以及符合 Transferable 协议的自定义元素。

安装

ShareLink 是 SwiftUI 框架的一部分，因此无需通过包管理器单独安装。只需在你的项目中导入 SwiftUI 即可使用：

import SwiftUI

最低系统要求：

• iOS 16.0+ / macOS 13.0+ / tvOS 16.0+ / watchOS 9.0+
• Xcode 14.0+
• Swift 5.7+

如果你使用的是更旧的 iOS 版本，则需要通过 UIViewRepresentable 直接使用 UIActivityViewController。

快速上手

使用 ShareLink 最简单的方式是传入一个字符串或 URL。以下是一个最小工作示例：

import SwiftUI

struct ContentView: View {
    var body: some View {
        ShareLink(item: URL(string: "https://pythonlib.ru")!) {
            Label("分享链接", systemImage: "square.and.arrow.up")
        }
        .padding()
    }
}

这段代码创建了一个带有“分享”图标的按钮。点击后会打开系统分享菜单，用户可以选择用于发送链接的应用。

核心方法与类

ShareLink 提供了多个初始化器和修饰符用于自定义。下面介绍 8 个关键功能。

1. ShareLink(item:)

签名： init(item: T, subject: Text? = nil, message: Text? = nil, @ViewBuilder label: () -> Label)

功能： 为单个元素创建分享按钮。参数 item 可以是字符串、URL、图片或任何符合 Transferable 协议的类型。

ShareLink(item: "你好，世界！") {
    Text("分享文本")
}

2. ShareLink(items:)

签名： init(items: [T], subject: Text? = nil, message: Text? = nil, @ViewBuilder label: () -> Label)

功能： 允许同时分享多个元素（例如一组照片）。

let images = [UIImage(named: "photo1")!, UIImage(named: "photo2")!]
ShareLink(items: images) {
    Label("分享照片", systemImage: "photo.on.rectangle")
}

3. ShareLink(item:preview:)

签名： init(item: T, preview: SharePreview<T>, @ViewBuilder label: () -> Label)

功能： 为分享内容提供预览，让接收方在分享前看到更丰富的信息。