Swift Academy · 课时

UIViewControllerRepresentable

Q: 「UIViewControllerRepresentable」这节课中我会学到什么？

在 SwiftUI 中嵌入 UIImagePickerController 等完整的 UIKit 视图控制器。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

在 SwiftUI 中嵌入 UIImagePickerController 等完整的 UIKit 视图控制器。

UIViewControllerRepresentable 是 CoddyKit 上的免费 Swift Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。

什么是 UIViewControllerRepresentable？

它类似于 UIViewRepresentable，但会封装完整的 UIViewController，以便在 SwiftUI 中使用。

struct ImagePickerView: UIViewControllerRepresentable {
  @Binding var image: UIImage?
}

makeUIViewController

创建并配置 UIKit 视图控制器。SwiftUI 首次渲染表示器时调用一次。

func makeUIViewController(context: Context) -> UIImagePickerController {
  let vc = UIImagePickerController()
  vc.delegate = context.coordinator
  return vc
}

updateUIViewController

每当 SwiftUI 状态发生变化时调用。将更新后的值推送到现有的视图控制器中。

func updateUIViewController(_ vc: UIImagePickerController, context: Context) {
  // Update vc if needed (e.g., change source type)
}

dismantleUIViewController

在视图控制器从层级结构中移除之前调用的静态清理方法。

static func dismantleUIViewController(_ vc: UIImagePickerController, coordinator: Coordinator) {
  vc.dismiss(animated: false)
}

封装 UIDocumentPickerViewController

示例：封装文档选择器，让用户选择文件，并将 URL 传回 SwiftUI。

struct DocumentPicker: UIViewControllerRepresentable {
  @Binding var url: URL?
  func makeUIViewController(context: Context) -> UIDocumentPickerViewController {
    let picker = UIDocumentPickerViewController(forOpeningContentTypes: [.pdf])
    picker.delegate = context.coordinator
    return picker
  }
  func updateUIViewController(_ vc: UIDocumentPickerViewController, context: Context) {}
}

以模态方式呈现

将 UIViewControllerRepresentable 嵌入 .sheet，以便以模态方式呈现。

@State private var showPicker = false
var body: some View {
  Button("Pick Image") { showPicker = true }
    .sheet(isPresented: $showPicker) {
      ImagePickerView(image: $selectedImage)
    }
}

邮件编辑器示例

封装 MFMailComposeViewController，以便从 SwiftUI 呈现邮件编辑界面。

struct MailView: UIViewControllerRepresentable {
  @Binding var isShowing: Bool
  func makeUIViewController(context: Context) -> MFMailComposeViewController {
    let vc = MFMailComposeViewController()
    vc.mailComposeDelegate = context.coordinator
    vc.setSubject("Hello from SwiftUI")
    return vc
  }
  func updateUIViewController(_ vc: MFMailComposeViewController, context: Context) {}
}

全屏呈现

对于必须填满屏幕的视图控制器，请应用 .fullScreenCover。

.fullScreenCover(isPresented: $showCamera) {
  CameraViewController()
}

传递回调闭包

不要使用绑定，而是将回调闭包传递给表示器，以便通知事件。

struct VideoPlayer: UIViewControllerRepresentable {
  let url: URL
  var onFinish: () -> Void
  // Coordinator calls onFinish when playback ends
}

固有大小

UIKit 视图控制器会决定自身大小。请使用 SwiftUI 的 frame 修饰器，或使用视图控制器的首选内容大小。

struct Popover: UIViewControllerRepresentable {
  func makeUIViewController(context: Context) -> UIViewController {
    let vc = UIViewController()
    vc.preferredContentSize = CGSize(width: 300, height: 200)
    return vc
  }
  func updateUIViewController(_ vc: UIViewController, context: Context) {}
}

常见使用场景

UIViewControllerRepresentable 的常见用途包括：UIImagePickerController、MFMailComposeViewController、AVPlayerViewController、UIDocumentPickerViewController 和 SFSafariViewController。

import SafariServices
struct SafariView: UIViewControllerRepresentable {
  let url: URL
  func makeUIViewController(context: Context) -> SFSafariViewController {
    SFSafariViewController(url: url)
  }
  func updateUIViewController(_ vc: SFSafariViewController, context: Context) {}
}

快速检查

每当表示器的 SwiftUI 输入发生变化时，SwiftUI 会调用哪个方法？

课程回顾

UIViewControllerRepresentable 用于封装完整的 UIKit 视图控制器。实现 makeUIViewController（创建一次）、updateUIViewController（同步状态），并可选择实现 dismantleUIViewController（清理）。使用 Coordinator 处理代理回调。

常见问题解答

「UIViewControllerRepresentable」课时是免费的吗？

是的 — 「UIViewControllerRepresentable」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。

「UIViewControllerRepresentable」这节课中我会学到什么？

在 SwiftUI 中嵌入 UIImagePickerController 等完整的 UIKit 视图控制器。你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「UIViewControllerRepresentable」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Swift Academy