如何使用 SwiftUI 构建 iOS PDF 查看器

最新推荐文章于 2024-09-28 18:01:12 发布

ComPDFKit

最新推荐文章于 2024-09-28 18:01:12 发布

阅读量27

点赞数

文章标签： pdf swiftui swift

原文链接：https://www.compdf.com/blog/build-ios-pdf-viewer-with-swiftui

版权

SwiftUI是 Apple 最新的用户界面框架，旨在彻底改变开发者为 iOS、macOS、watchOS 和 tvOS 创建 UI 的方式。SwiftUI 在 WWDC 2019 上推出，它提供了一种现代的声明式语法，让开发者能够以更少的代码和更直观的开发流程构建复杂的 UI。

它广泛用于 Apple 应用程序，包括 PDF 应用程序。在本文中，您将看到 Swift 教程示例，并学习如何使用 ComPDFKit iOS PDF 库构建 SwiftUI PDF 查看器。

步骤 1：Swift UI PDF 库集成的要求

通过 SwiftUI 集成 ComPDFKit iOS PDF 库需要满足以下要求。

iOS 10.0 或更高版本。
适用于 Swift 的 Xcode 13.0 或更新版本。
ComPDFKit iOS PDF 库：访问 GitHub 上的 ComPDFKit iOS PDF 库以获取您的 SwiftUI PDF 程序。
ComPDFKit iOS PDF 库许可证：在 ComPDFKit 网站上申请即可获得 30 天试用许可证。它将通过电子邮件发送。

注意：ComPDFKit 要求使用发布时可用的最新稳定版 Xcode。这是一项硬性要求，因为每个版本的 Xcode 都与特定版本的 iOS Base SDK 捆绑在一起，后者通常定义 UIKit 和其他各种框架的行为方式。

步骤 2：为你的 SwiftUI PDF Viewer 获取 iOS 库包

要使用 Swift 学习 SwiftUI 教程示例，必须下载 Swift 版 ComPDFKit iOS PDF 库。此库可让您将 PDF 查看功能无缝集成到您的 SwiftUI 应用程序中。

访问GitHub上适用于您的 SwiftUI 项目的 iOS PDF 库。

步骤 3：获取 ComPDFKit PDF 库的试用许可证

只需在 ComPDFKit 网站上单击几下即可轻松获得ComPDFKit iOS 库 30 天许可证。无需销售。只需申请适当的许可证，您就会自动收到包含许可证的电子邮件。将 Swift PDF 库无缝集成到您的项目中。

步骤 4：为您的 Swift UI PDF APP 应用许可证密钥

1. 查找许可证密钥

以下是分步教程，可帮助您找到正确的许可证密钥，以将 PDF 查看器库集成到您的 SwiftUI 项目中。

在您收到的电子邮件中，找到包含许可证密钥的XML文件。

打开XML文件，通过online字段判断许可证类型，如果存在则为在线许可证，如果不存在或者存在offline则为离线许可证。

在线许可：

xmlCopy code
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<license version="1">
    <platform>ios</platform>
    <starttime>xxxxxxxx</starttime>
    <endtime>xxxxxxxx</endtime>
    <type>online</type>
    <key>LICENSE_KEY</key>
</license>

离线许可证：

xmlCopy code
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<license version="1">
    <platform>ios</platform>
    <starttime>xxxxxxxx</starttime>
    <endtime>xxxxxxxx</endtime>
    <key>LICENSE_KEY</key>
</license>
Copy the LICENSE_KEY from the <key>LICENSE_KEY</key> field.

2. 应用许可证密钥

前往 ComPDFKit 官方网站的在线销售页面提交试用申请，即可获得 iOS 平台的即时免费试用许可证，有效期为 30 天。在使用任何 ComPDFKit PDF SDK 类之前，您必须执行以下步骤将许可证应用于您的应用程序：

在AppDelegate.swift中，导入头文件 ComPDFKit。
根据上一步获得的身份验证类型（无论是在线还是离线），根据您的要求使用相应的方法初始化许可证。
初始化许可证：

在线许可：

按照以下代码，在func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool中调用方法CPDFKit.verify(withOnlineLicense: "LICENSE_KEY") { code, message in }。您需要将LICENSE_KEY替换为您获得的许可证。

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  // Set your online license key here. ComPDFKit is commercial software.
  // Each ComPDFKit license is bound to a specific app bundle id.
  // com.compdfkit.pdfviewe

    CPDFKit.verify(withOnlineLicense: "YOUR_LICENSE_KEY_GOES_HERE") { code, message in
    }
}

离线许可证：

按照以下代码，在func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool中调用方法CPDFKit.verifyWithKey:"LICENSE_SECRET"。您需要将LICENSE_KEY替换为您获得的许可证。

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  // Set your license key here. ComPDFKit is commercial software.
  // Each ComPDFKit license is bound to a specific app bundle id.
  // com.compdfkit.pdfviewer

    CPDFKit.verify(withKey: "YOUR_LICENSE_KEY_GOES_HERE")
    return true
}

第 5 步：集成 ComPDFKit iOS PDF 库 — SwiftUI 教程

让我们讨论如何在 SwiftUI 框架中集成ComPDFKit for iOS并构建一个 iOS PDF 查看器来显示 PDF。

将CPDFViewController桥接到 SwiftUI

首先，声明符合UIViewControllerRepresentable协议的CPDFSwiftViewController结构，以便您可以从 UIKit 桥接到 SwiftUI。之后，添加CPDFConfiguration类型的属性并实现协议，如下所示：

import ComPDFKit

struct CPDFSwiftViewController: UIViewControllerRepresentable {
    @Environment(\.presentationMode) var presentationMode: Binding<PresentationMode>

    class Coordinator: NSObject,CPDFViewBaseControllerDelete {
        var myview: CPDFSwiftViewController
        init(_ myview: CPDFSwiftViewController) {
            self.myview = myview
        }

        // MARK: - CPDFViewBaseControllerDelete
        func PDFViewBaseControllerDissmiss(_ baseControllerDelete: CPDFViewBaseController) {
            baseControllerDelete.dismiss(animated: true)
        }

    }

    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }

    func makeUIViewController(context: Context) -> CNavigationController {
        CPDFKit.verify(withKey: "LICENSE_KEY")

        let filePath = Bundle.main.path(forResource: "developer_guide_ios", ofType: "pdf")  ?? ""

        let configuration = CPDFConfiguration()

        let vc = CPDFViewController(filePath: filePath, password: nil, configuration: configuration)
        vc.delegate = context.coordinator;
        let navController = CNavigationController(rootViewController: vc)
        navController.modalPresentationStyle = .fullScreen

        return navController
    }

    func updateUIViewController(_ uiViewController: CNavigationController, context: UIViewControllerRepresentableContext<CPDFSwiftViewController>) {

    }

}

2. 在 SwiftUI 中使用ComPDFKitView

在你的 SwiftUI 内容视图中使用CPDFViewController：

struct ContentView: View {
    @State var isPresented: Bool = false

    var body: some View {
        VStack {
            Image(systemName: "globe")
                .imageScale(.large)
                .foregroundColor(.accentColor)
            Text("Hello, world!")

            .toolbar {

                ToolbarItem(placement: .bottomBar) {
                    Button("Click to open the sample PDF") {
                        isPresented = true
                    }
                }
            }
            .fullScreenCover(isPresented: $isPresented) {
                CPDFSwiftViewController()

            }
        }
        .padding()
    }
}

本指南以 iPad 14 设备为例，成功编译 demo 后会打开并显示“developer_guide_ios.pdf”文件。