Objective-C能否在macOS的Preview应用中打开PDF并定位到指定标题？

可行性说明 #

可以实现该需求。由于Preview.app未对外暴露直接通过大纲标题跳转的官方接口，因此需要先通过本地解析PDF的大纲（即左侧面板展示的标题目录）拿到目标标题对应的页码，再调用Preview的页码跳转能力，最终实现和手动点击左侧标题完全一致的定位效果。

实现步骤 #

1. 用PDFKit解析PDF大纲，匹配目标标题对应的页码 #

macOS系统自带PDFKit框架，可直接读取PDF的全量大纲结构，遍历匹配目标标题后获取其关联的页码：

#import <PDFKit/PDFKit.h>

// 传入PDF路径、目标标题，返回对应页码（从1开始计数，符合Preview的页码规则）
- (NSInteger)getPageNumberForTitle:(NSString *)targetTitle inPDFAtPath:(NSString *)pdfPath {
    NSURL *pdfURL = [NSURL fileURLWithPath:pdfPath];
    PDFDocument *pdfDoc = [[PDFDocument alloc] initWithURL:pdfURL];
    PDFOutline *rootOutline = pdfDoc.outlineRoot;
    
    // 递归遍历所有大纲节点
    __block NSInteger targetPage = -1;
    void (^traverseOutline)(PDFOutline *) = ^(PDFOutline *outlineNode) {
        if (targetPage != -1) return;
        for (NSInteger i = 0; i < outlineNode.numberOfChildren; i++) {
            PDFOutline *child = [outlineNode childAtIndex:i];
            if ([child.label isEqualToString:targetTitle]) {
                PDFPage *page = child.destination.page;
                targetPage = [pdfDoc indexForPage:page] + 1; // 转成1开始的页码
                return;
            }
            traverseOutline(child);
        }
    };
    traverseOutline(rootOutline);
    return targetPage;
}

2. 调用Preview打开PDF并跳转到对应页码 #

拿到目标页码后，通过AppleScript脚本调用Preview执行跳转，也可以和现有跳页逻辑直接复用：

- (void)openPDFAtPath:(NSString *)pdfPath toPage:(NSInteger)pageNum {
    NSString *scriptStr = [NSString stringWithFormat:
        @"tell application \"Preview\"\n"
        @"activate\n"
        @"open POSIX file \"%@\"\n"
        @"tell document 1\n"
        @"go to page %ld\n"
        @"end tell\n"
        @"end tell",
        pdfPath, (long)pageNum
    ];
    NSAppleScript *appleScript = [[NSAppleScript alloc] initWithSource:scriptStr];
    [appleScript executeAndReturnError:nil];
}

注意事项 #

• 如果PDF的大纲节点存在同名标题，可以自行增加层级匹配逻辑，避免定位错误
• 部分加密PDF需要先处理权限才能正常解析大纲结构
• 该方案适配所有支持PDFKit的macOS版本，无第三方依赖

内容的提问来源于stack exchange，提问作者Arthur Rees