Android故事创作应用：如何将Fragment页面转为PDF并邮件分享？

当然有可行的方案！我来一步步帮你实现把Fragment内容转成PDF并通过邮件分享的功能：

1. 捕获Fragment的视图内容 #

首先你需要把Fragment的整个视图转换成可用于PDF的Bitmap，这里可以通过View的绘制能力来实现：

• 确保Fragment的视图已经完全渲染（比如在onViewCreated之后，或者用view.post()延迟执行，避免视图还没加载完成就捕获）
• 创建与视图尺寸一致的Bitmap，然后用Canvas将视图内容绘制到Bitmap上

示例代码：

// 在你的Fragment类中
fun captureFragmentView(): Bitmap? {
    val rootView = view ?: return null
    // 创建和视图尺寸相同的Bitmap
    val bitmap = Bitmap.createBitmap(rootView.width, rootView.height, Bitmap.Config.ARGB_8888)
    val canvas = Canvas(bitmap)
    // 绘制视图内容到Bitmap
    rootView.draw(canvas)
    return bitmap
}

2. 将Bitmap生成PDF文件 #

接下来用Android系统自带的PdfDocument类来生成PDF文件，不需要依赖第三方库（如果需要更复杂的排版，比如文字可选中、多页自动拆分，也可以考虑iText、PdfBox等第三方库）：

• 创建PdfDocument实例，定义PDF页面的尺寸
• 将捕获到的Bitmap绘制到PDF页面上
• 将PDF保存到应用的私有存储目录（避免不必要的存储权限申请）

示例代码：

fun bitmapToPdf(bitmap: Bitmap, context: Context): File? {
    val pdfDocument = PdfDocument()
    // 定义PDF页面尺寸，这里和Bitmap尺寸一致，保证内容不拉伸
    val pageInfo = PdfDocument.PageInfo.Builder(bitmap.width, bitmap.height, 1).create()
    val page = pdfDocument.startPage(pageInfo)
    val canvas = page.canvas
    
    // 将Bitmap绘制到PDF页面
    canvas.drawBitmap(bitmap, 0f, 0f, null)
    
    pdfDocument.finishPage(page)
    
    // 保存PDF到应用私有目录
    val pdfFile = File(context.filesDir, "story_fragment.pdf")
    return try {
        pdfDocument.writeTo(FileOutputStream(pdfFile))
        pdfDocument.close()
        pdfFile
    } catch (e: IOException) {
        e.printStackTrace()
        null
    }
}

3. 通过邮件分享PDF文件 #

最后用系统分享Intent来发送邮件，注意Android 10及以上版本需要用FileProvider来获取文件的Uri，避免文件暴露的安全问题：

步骤3.1 配置FileProvider #

在AndroidManifest.xml中添加FileProvider的注册：

<application ...>
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

然后在res/xml目录下创建file_paths.xml文件：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <files-path name="pdf_files" path="." />
</paths>

步骤3.2 发送邮件的代码 #

fun sharePdfViaEmail(context: Context, pdfFile: File) {
    // 获取PDF文件的Uri
    val pdfUri = FileProvider.getUriForFile(
        context,
        "${context.packageName}.fileprovider",
        pdfFile
    )
    
    // 创建分享Intent
    val intent = Intent(Intent.ACTION_SEND).apply {
        type = "application/pdf"
        putExtra(Intent.EXTRA_STREAM, pdfUri)
        putExtra(Intent.EXTRA_SUBJECT, "我的故事创作")
        putExtra(Intent.EXTRA_TEXT, "这是我创作的故事内容，以PDF形式分享给你！")
        // 授予临时权限给邮件应用，确保它能读取文件
        addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
    }
    
    // 启动邮件应用选择器
    val chooser = Intent.createChooser(intent, "选择邮件应用分享")
    if (intent.resolveActivity(context.packageManager) != null) {
        context.startActivity(chooser)
    }
}

整合调用示例 #

在你的Fragment中可以这样整合调用（比如绑定到一个分享按钮的点击事件）：

// 假设你有一个分享按钮
shareButton.setOnClickListener {
    view?.post { // 确保视图已经渲染完成
        val bitmap = captureFragmentView()
        bitmap?.let {
            val pdfFile = bitmapToPdf(it, requireContext())
            pdfFile?.let { file ->
                sharePdfViaEmail(requireContext(), file)
            }
        }
    }
}

额外注意事项 #

• 如果Fragment的内容是长页面（超过一屏），上面的方法只会捕获当前可见区域，若要捕获完整内容，需要先测量视图的完整滚动高度，再创建对应尺寸的Bitmap
• 我们用的是应用私有目录存储PDF，Android 10及以上不需要申请外部存储权限
• 如果需要更专业的PDF排版（比如保留文字格式、添加页码），可以考虑集成iText等第三方库

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