FastPdfKit iOS 库启动和配置教程

1. 项目的目录结构及介绍

FastPdfKit 是一个 iOS 开源库，用于在 iOS 应用程序中显示 PDF 文档。以下是项目的目录结构及其简要介绍：

• Classes: 包含 FastPdfKit 的核心类文件。
• Doc: 存放项目的文档资料。
• Extensions: 包含对 FastPdfKit 的扩展类。
• FastPdfKit.xcodeproj: FastPdfKit 的 Xcode 项目文件。
• FastPdfKitFramework: 包含 FastPdfKit 框架的文件。
• KioskApp: 一个展示 FastPdfKit 功能的示例 Kiosk 应用。
• OtherSources: 其他辅助源文件。
• Reader: 一个包含阅读器功能的示例项目。
• Resources: 存放资源文件，如图标、图片等。
• SimpleApp: 一个简单的 FastPdfKit 集成示例应用。
• ThirdParties: 第三方依赖库。
• .gitignore: 指定 Git 忽略的文件列表。
• LICENSE.txt: 项目许可证文件。
• README.md: 项目说明文件。

2. 项目的启动文件介绍

项目的启动文件主要是 Xcode 项目文件 FastPdfKit.xcodeproj，你可以使用 Xcode 打开这个文件来编译和运行 FastPdfKit 相关的示例项目。

• FastPdfKit: 这个 target 包含了 FastPdfKit 框架的所有必要组件。
• FPKKioskApp: 一个完整的 Kiosk 应用示例，展示了如何使用 FastPdfKit。
• FPKSimpleApp: 一个简单的应用示例，展示了基本的 FastPdfKit 集成。
• FPKReaderLib: 一个静态库，包含了 ReaderViewController 和其依赖。
• FPKKioskLib: 一个静态库，包含了 Kiosk 应用的类。
• FPKioskBundle: Kiosk 应用所需的资源包。
• FPReaderBundle: ReaderViewController 所需的资源包。

3. 项目的配置文件介绍

项目的配置主要通过 Xcode 项目设置进行，以下是一些关键的配置文件：

• Info.plist: 这个文件包含了应用的基本配置，如应用名称、图标、支持的设备方向等。
• Build Settings: 在这里你可以配置编译选项，比如指定 SDK 版本、架构等。
• Scheme: 这是 Xcode 中的一个概念，用于指定如何构建和运行项目。你可以为不同的 target 创建不同的 scheme。

在集成 FastPdfKit 到你的项目中时，你需要确保你的项目配置正确，以下是一些步骤：

1. 将 FastPdfKit.embeddedframework 添加到你的 Xcode 工作区。
2. 继承项目选项：选择项目的 Project，然后在 info tab 的 configurations 行选择 FastPdfKitFramework。
3. 在你的控制器接口中导入 FastPdfKit 头文件，并实现打开文档的方法。

#import <FastPdfKit/FastPdfKit.h>

@class MFDocumentManager;

-(IBAction)actionOpenPlainDocument:(id)sender;

在控制器实现中，添加以下代码：

-(IBAction)actionOpenPlainDocument:(id)sender {
    // 设置文档名称
    NSString *documentName = @"Manual";
    // 获取临时目录以保存缩略图
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    // 设置缩略图路径
    NSString *thumbnailsPath = [[paths objectAtIndex:0] stringByAppendingPathComponent:[NSString stringWithFormat:@"%@",documentName]];
    // 从应用包中获取文档
    NSURL *documentUrl = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:documentName ofType:@"pdf"]];
    // 实例化文档管理器
    MFDocumentManager *documentManager = [[MFDocumentManager alloc]initWithFileUrl:documentUrl];
    // 实例化阅读器视图控制器
    ReaderViewController *readerViewController = [[ReaderViewController alloc]initWithDocumentManager:documentManager thumbnailsPath:thumbnailsPath];
    // 显示阅读器视图控制器
    [self presentViewController:readerViewController animated:YES completion:nil];
}

确保你已经按照以上步骤操作，这样你就可以在你的 iOS 应用中成功集成和使用 FastPdfKit。