如何在iOS SwiftUI中将长视图转换为多页PDF（iPad适配）

问题场景 #

在iPad端，当SwiftUI视图内容高度超过1500（当前视图尺寸为CGSize(width: 1118.0, height: 1700.0)）时，需要将其拆分为多页PDF，但现有基于ImageRenderer的实现仅能生成单页PDF，无法自动分页。

解决方案代码 #

以下是修改后的实现，支持根据指定高度阈值拆分视图为多页PDF：

@MainActor func renderMultiPagePDF(view: some View) -> URL? {
    guard #available(iOS 16.0, *) else { return nil }
    
    let renderer = ImageRenderer(content: view)
    let documentDirectory = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
    let outputURL = documentDirectory.appendingPathComponent("SwiftUIMultiPagePDF.pdf")
    
    // 定义单页最大高度（根据需求设置为1500）
    let pageMaxHeight: CGFloat = 1500
    
    renderer.render { totalSize, context in
        // 计算总页数
        let totalPages = Int(ceil(totalSize.height / pageMaxHeight))
        var mediaBox = CGRect(x: 0, y: 0, width: totalSize.width, height: pageMaxHeight)
        
        guard let pdfContext = CGContext(outputURL as CFURL, mediaBox: &mediaBox, nil) else {
            return
        }
        
        for pageIndex in 0..<totalPages {
            // 计算当前页需要渲染的Y轴偏移量
            let yOffset = -CGFloat(pageIndex) * pageMaxHeight
            
            // 开始新的PDF页面
            pdfContext.beginPDFPage(nil)
            
            // 平移上下文，让当前页显示对应区域的视图内容
            pdfContext.translateBy(x: 0, y: yOffset)
            
            // 渲染视图内容到当前页
            context(pdfContext)
            
            // 结束当前页面
            pdfContext.endPDFPage()
        }
        
        pdfContext.closePDF()
    }
    
    return outputURL
}

关键逻辑说明 #

• 分页计算：通过总视图高度除以单页最大高度，向上取整得到总页数。
• 上下文平移：每页渲染前，将CGContext沿Y轴负方向平移对应页的偏移量，使视图的对应区域显示在当前PDF页面内。
• 页面尺寸控制：创建PDF上下文时指定单页的媒体盒尺寸为视图宽度+单页最大高度，确保每页尺寸符合要求。

注意事项 #

• 确保视图内容在渲染时已经完全布局完成，避免因布局未完成导致的尺寸计算错误。
• 若需要适配A4标准尺寸（210mm×297mm，对应像素约为1654×2339@72dpi），可将pageMaxHeight替换为对应像素值。

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