技术问询：QLPreviewController无法预览.eml文件如何处理

我之前也碰到过QLPreviewController能搞定大部分格式，但就是搞不定.eml文件的情况，试了几个方案，下面是亲测有效的解决步骤：

1. 先在应用的Info.plist里声明支持.eml格式 #

QLPreviewController依赖系统的UTI（统一类型标识符）来识别文件，首先得让系统知道你的应用能处理.eml文件。打开Info.plist，添加以下内容：

<key>CFBundleDocumentTypes</key>
<array>
    <dict>
        <key>CFBundleTypeName</key>
        <string>EML File</string>
        <key>CFBundleTypeRole</key>
        <string>Viewer</string>
        <key>LSHandlerRank</key>
        <string>Alternate</string>
        <key>LSItemContentTypes</key>
        <array>
            <string>com.microsoft.outlook.eml</string>
        </array>
    </dict>
</array>

这段配置告诉系统，你的应用可以作为.eml文件的查看器，QLPreviewController会参考这个配置来识别文件类型。

2. 创建自定义QLPreviewItem指定UTI #

默认的QLPreviewItem可能不会主动识别.eml的UTI，所以我们需要自定义一个预览项，明确指定文件的类型：

Swift示例： #

import QuickLook
import UniformTypeIdentifiers

class EMLPreviewItem: NSObject, QLPreviewItem {
    private let fileURL: URL
    private let itemTitle: String?
    
    init(url: URL, title: String?) {
        self.fileURL = url
        self.itemTitle = title
        super.init()
    }
    
    // 实现QLPreviewItem的必填属性
    var previewItemURL: URL? {
        return fileURL
    }
    
    var previewItemTitle: String? {
        return itemTitle
    }
    
    // 关键：指定.eml对应的UTI
    var previewItemContentType: UTType? {
        // 优先通过扩展名获取UTI， fallback到微软的eml类型
        return UTType(filenameExtension: "eml") ?? UTType("com.microsoft.outlook.eml")
    }
}

Objective-C示例： #

#import <QuickLook/QuickLook.h>
#import <UniformTypeIdentifiers/UniformTypeIdentifiers.h>

@interface EMLPreviewItem : NSObject <QLPreviewItem>
@property (nonatomic, strong) NSURL *fileURL;
@property (nonatomic, copy) NSString *itemTitle;
@end

@implementation EMLPreviewItem

- (instancetype)initWithURL:(NSURL *)url title:(NSString *)title {
    self = [super init];
    if (self) {
        self.fileURL = url;
        self.itemTitle = title;
    }
    return self;
}

- (NSURL *)previewItemURL {
    return self.fileURL;
}

- (NSString *)previewItemTitle {
    return self.itemTitle;
}

- (UTType *)previewItemContentType {
    UTType *type = [UTType typeWithFilenameExtension:@"eml"];
    if (!type) {
        type = [UTType typeWithIdentifier:@"com.microsoft.outlook.eml"];
    }
    return type;
}

@end

3. 用自定义PreviewItem加载QLPreviewController #

接下来在打开预览的时候，用我们自定义的EMLPreviewItem代替直接传URL：

Swift示例： #

// 假设你已经拿到了本地的.eml文件URL
guard let emlFileURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first?.appendingPathComponent("test.eml") else {
    return
}

let previewItem = EMLPreviewItem(url: emlFileURL, title: "邮件预览")
let previewController = QLPreviewController()
previewController.dataSource = self
previewController.currentPreviewItemIndex = 0

// 实现QLPreviewControllerDataSource协议
extension YourViewController: QLPreviewControllerDataSource {
    func numberOfPreviewItems(in controller: QLPreviewController) -> Int {
        return 1
    }
    
    func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
        return previewItem
    }
}

// 弹出预览控制器
present(previewController, animated: true)

这样配置后，QLPreviewController应该就能正确识别并预览.eml文件了，同时保存到文件应用的功能也能正常使用。

备选方案：如果系统预览还是不生效 #

如果上面的方法还是不行，可能是系统本身没有内置.eml的预览服务，这时候可以考虑用第三方库解析.eml内容，比如MailCore，把.eml解析成HTML，然后用WebView展示，同时依然可以通过QLPreviewController的保存功能把原文件导出到文件应用。

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