iOS SDK - 以编程方式生成 PDF 文件

Question

老实说，当涉及到以编程方式绘制 PDF 文件时，使用 CoreGraphics 框架是一项乏味的工作。

我想以编程方式创建一个 PDF，使用整个应用程序视图中的各种对象。

我很想知道是否有任何关于 iOS SDK 的好的 PDF 教程，也许是库中的一个。

我看过这个教程，PDF 创建教程< /a>，但它主要是用 C 编写的。寻找更多 Objective-C 风格。这似乎也是一种可笑的写入 PDF 文件的方式，必须计算线条和其他对象的放置位置。

void CreatePDFFile (CGRect pageRect, const char *filename) 
{   
    // This code block sets up our PDF Context so that we can draw to it
    CGContextRef pdfContext;
    CFStringRef path;
    CFURLRef url;
    CFMutableDictionaryRef myDictionary = NULL;

    // Create a CFString from the filename we provide to this method when we call it
    path = CFStringCreateWithCString (NULL, filename,
                                      kCFStringEncodingUTF8);

    // Create a CFURL using the CFString we just defined
    url = CFURLCreateWithFileSystemPath (NULL, path,
                                         kCFURLPOSIXPathStyle, 0);
    CFRelease (path);
    // This dictionary contains extra options mostly for 'signing' the PDF
    myDictionary = CFDictionaryCreateMutable(NULL, 0,
                                             &kCFTypeDictionaryKeyCallBacks,
                                             &kCFTypeDictionaryValueCallBacks);

    CFDictionarySetValue(myDictionary, kCGPDFContextTitle, CFSTR("My PDF File"));
    CFDictionarySetValue(myDictionary, kCGPDFContextCreator, CFSTR("My Name"));
    // Create our PDF Context with the CFURL, the CGRect we provide, and the above defined dictionary
    pdfContext = CGPDFContextCreateWithURL (url, &pageRect, myDictionary);
    // Cleanup our mess
    CFRelease(myDictionary);
    CFRelease(url);
    // Done creating our PDF Context, now it's time to draw to it

    // Starts our first page
    CGContextBeginPage (pdfContext, &pageRect);

    // Draws a black rectangle around the page inset by 50 on all sides
    CGContextStrokeRect(pdfContext, CGRectMake(50, 50, pageRect.size.width - 100, pageRect.size.height - 100));

    // This code block will create an image that we then draw to the page
    const char *picture = "Picture";
    CGImageRef image;
    CGDataProviderRef provider;
    CFStringRef picturePath;
    CFURLRef pictureURL;

    picturePath = CFStringCreateWithCString (NULL, picture,
                                             kCFStringEncodingUTF8);
    pictureURL = CFBundleCopyResourceURL(CFBundleGetMainBundle(), picturePath, CFSTR("png"), NULL);
    CFRelease(picturePath);
    provider = CGDataProviderCreateWithURL (pictureURL);
    CFRelease (pictureURL);
    image = CGImageCreateWithPNGDataProvider (provider, NULL, true, kCGRenderingIntentDefault);
    CGDataProviderRelease (provider);
    CGContextDrawImage (pdfContext, CGRectMake(200, 200, 207, 385),image);
    CGImageRelease (image);
    // End image code

    // Adding some text on top of the image we just added
    CGContextSelectFont (pdfContext, "Helvetica", 16, kCGEncodingMacRoman);
    CGContextSetTextDrawingMode (pdfContext, kCGTextFill);
    CGContextSetRGBFillColor (pdfContext, 0, 0, 0, 1);
    const char *text = "Hello World!";
    CGContextShowTextAtPoint (pdfContext, 260, 390, text, strlen(text));
    // End text

    // We are done drawing to this page, let's end it
    // We could add as many pages as we wanted using CGContextBeginPage/CGContextEndPage
    CGContextEndPage (pdfContext);

    // We are done with our context now, so we release it
    CGContextRelease (pdfContext);
}

编辑：这是 GitHub 使用 libHaru 的示例在 iPhone 项目中。

Answer 1

有几件事......

首先，iOS 中的 CoreGraphics PDF 生成存在一个错误，会导致 PDF 损坏。我知道这个问题在 iOS 4.1 之前都存在（我还没有测试过 iOS 4.2）。该问题与字体有关，并且仅当您在 PDF 中包含文本时才会出现。症状是，在生成 PDF 时，您会在调试控制台中看到如下所示的错误：

<Error>: can't get CIDs for glyphs for 'TimesNewRomanPSMT'

棘手的方面是，生成的 PDF 在某些 PDF 阅读器中可以正常渲染，但在其他地方无法渲染。因此，如果您可以控制用于打开 PDF 的软件，则可以忽略此问题（例如，如果您只想在 iPhone 或 Mac 桌面上显示 PDF，那么您应该可以使用核心图形）。但是，如果您需要创建可在任何地方使用的 PDF，那么您应该仔细研究这个问题。以下是一些附加信息：

http://www.iphonedevsdk.com/forum/iphone-sdk-development/15505-pdf-font-problem-cant-get-cids-glyphs.html#post97854

作为解决方法，我已在 iPhone 上成功使用 libHaru 作为 CoreGraphics PDF 生成的替代品。最初让 libHaru 与我的项目一起构建有点棘手，但是一旦我正确设置了项目，它就可以很好地满足我的需求。

其次，根据 PDF 的格式/布局，您可能会考虑使用 Interface Builder 创建一个视图作为 PDF 输出的“模板”。然后，您将编写代码来加载视图，填充任何数据（例如，为 UILabels 设置文本等），然后将视图的各个元素渲染到 PDF 中。换句话说，使用IB指定坐标、字体、图像等，并编写代码以通用方式渲染各种元素（例如，UILabel、UIImageView等）这样您就不必对所有内容进行硬编码。我使用了这种方法，它非常适合我的需求。同样，这对于您的情况可能有意义也可能没有意义，具体取决于 PDF 的格式/布局需求。

编辑：（对第一条评论的回应）

我的实现是商业产品的一部分，这意味着我无法共享完整的代码，但我可以给出一个总体轮廓：

我创建了一个 .xib 文件，其中包含视图并将视图大小调整为 850 x 1100（我的 PDF 的目标尺寸为 8.5 x 11 英寸，因此这使得可以轻松地与设计时坐标进行转换）。

在代码中，我加载视图：

- (UIView *)loadTemplate
{
    NSArray *nib = [[NSBundle mainBundle] loadNibNamed:@"ReportTemplate" owner:self options:nil];
    for (id view in nib) {
        if ([view isKindOfClass: [UIView class]]) {
            return view;
        }
    }

    return nil;
}

然后填充各种元素。我使用标签来查找适当的元素，但您也可以通过其他方式执行此操作。示例：

UILabel *label = (UILabel *)[templateView viewWithTag:TAG_FIRST_NAME];
if (label != nil) {
    label.text = (firstName != nil) ? firstName : @"None";

然后我调用一个函数将视图渲染到 PDF 文件。该函数递归地遍历视图层次结构并渲染每个子视图。对于我的项目，我只需要支持 Label、ImageView 和 View（对于嵌套视图）：

- (void)addObject:(UIView *)view
{
    if (view != nil && !view.hidden) {
        if ([view isKindOfClass:[UILabel class]]) {
            [self addLabel:(UILabel *)view];
        } else if ([view isKindOfClass:[UIImageView class]]) {
            [self addImageView:(UIImageView *)view];
        } else if ([view isKindOfClass:[UIView class]]) {
            [self addContainer:view];
        }
    }
}

作为示例，这是我的 addImageView 实现（HPDF_ 函数来自 libHaru）：

- (void)addImageView:(UIImageView *)imageView
{
    NSData *pngData = UIImagePNGRepresentation(imageView.image);
    if (pngData != nil) {
        HPDF_Image image = HPDF_LoadPngImageFromMem(_pdf, [pngData bytes], [pngData length]);
        if (image != NULL) {
            CGRect destRect = [self rectToPDF:imageView.frame];

            float x = destRect.origin.x;
            float y = destRect.origin.y - destRect.size.height;
            float width = destRect.size.width;
            float height = destRect.size.height;

            HPDF_Page page = HPDF_GetCurrentPage(_pdf);
            HPDF_Page_DrawImage(page, image, x, y, width, height);
        }
    }
}

希望这能给您带来启发。

Answer 2

这是一个迟到的答复，但由于我在 pdf 生成方面遇到了很多困难，我认为值得分享我的观点。您还可以使用 UIKit 方法来生成 pdf，而不是使用 Core Graphics 创建上下文。

Apple 已在 绘图和打印指南。

Answer 3

iOS 上的 PDF 功能都是基于 CoreGraphics 的，这是有道理的，因为 iOS 中的绘制基元也是基于 CoreGraphics 的。如果您想将 2D 图元直接渲染为 PDF，则必须使用 CoreGraphics。

UIKit 中的对象也有一些快捷方式，例如图像。将 PNG 绘制到 PDF 上下文仍然需要调用 CGContextDrawImage ，但您可以使用从 UIImage 获取的 CGImage 来完成此操作，例如：

UIImage * myPNG = [UIImage imageNamed:@"mypng.png"];
CGContextDrawImage (pdfContext, CGRectMake(200, 200, 207, 385), [myPNG CGImage]);

如果您需要有关整体设计的更多指导，请更明确地说明“应用程序中的各种对象”的含义以及您想要实现的目标。

Answer 4

迟到了，但可能对其他人有帮助。听起来 PDF 模板操作风格可能是您想要的方法，而不是在代码中构建 PDF。由于您无论如何都想通过电子邮件发送，因此您已连接到网络，因此您可以使用 Docmosis 云服务之类的东西这实际上是一种邮件合并服务。向其发送数据/图像以与您的模板合并。这种方法的优点是代码少得多，并且可以从 iPad 应用程序中卸载大部分处理。我见过它在 iPad 应用程序中使用，效果很好。