Android开发：如何在Fragment中兼容显示PDF与图片文件？

嘿，我之前刚好做过类似的需求，把分散的图片和PDF显示逻辑整合起来其实没那么复杂，核心就是先统一文件选择的入口，再根据文件类型分支处理显示逻辑，下面一步步给你拆解：

1. 先搞定必要的权限申请 #

因为要读取外部存储的文件，Android 6.0（API 23）及以上得动态申请权限——Android 13+可以用更细分的媒体权限，低版本就用通用的存储权限就行：

private val REQUEST_PERMISSION_CODE = 1001
private val REQUIRED_PERMISSIONS = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    arrayOf(Manifest.permission.READ_MEDIA_IMAGES, Manifest.permission.READ_MEDIA_DOCUMENTS)
} else {
    arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE)
}

// 检查权限是否已授予
private fun checkPermissions(): Boolean {
    return REQUIRED_PERMISSIONS.all {
        ContextCompat.checkSelfPermission(requireContext(), it) == PackageManager.PERMISSION_GRANTED
    }
}

// 请求权限
private fun requestPermissions() {
    ActivityCompat.requestPermissions(requireActivity(), REQUIRED_PERMISSIONS, REQUEST_PERMISSION_CODE)
}

// 处理权限申请结果
override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == REQUEST_PERMISSION_CODE && grantResults.all { it == PackageManager.PERMISSION_GRANTED }) {
        // 权限通过，打开文件选择器
        openFilePicker()
    } else {
        Toast.makeText(requireContext(), "需要权限才能访问本地文件哦", Toast.LENGTH_SHORT).show()
    }
}

2. 统一文件选择入口，不用分开调用图库和文件管理器 #

直接用系统的文件选择器，还能精准指定允许选择的文件类型（图片+PDF），用户体验更统一：

private val REQUEST_FILE_PICKER = 1002

private fun openFilePicker() {
    val intent = Intent(Intent.ACTION_GET_CONTENT).apply {
        type = "*/*"
        addCategory(Intent.CATEGORY_OPENABLE)
        // 只允许选择图片和PDF，避免用户选到其他不支持的文件
        val allowedMimeTypes = arrayOf("image/jpeg", "image/jpg", "application/pdf")
        putExtra(Intent.EXTRA_MIME_TYPES, allowedMimeTypes)
    }
    startActivityForResult(Intent.createChooser(intent, "请选择文件"), REQUEST_FILE_PICKER)
}

// 处理文件选择后的回调
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_FILE_PICKER && resultCode == Activity.RESULT_OK && data != null) {
        val fileUri = data.data ?: return
        // 拿到文件Uri后，判断类型并对应显示
        handleFileDisplay(fileUri)
    }
}

3. 根据文件类型分支处理显示逻辑 #

先在Fragment的布局里准备两个控件：ImageView用来显示图片，PDFView（用第三方库AndroidPdfViewer）用来显示PDF，初始都设为隐藏，根据文件类型切换可见性。

布局示例（fragment_file_display.xml）：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <!-- 图片显示控件 -->
    <ImageView
        android:id="@+id/iv_image"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:visibility="gone"
        android:scaleType="fitCenter"/>

    <!-- PDF显示控件 -->
    <com.github.barteksc.pdfviewer.PDFView
        android:id="@+id/pdf_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:visibility="gone"/>

    <!-- 触发文件选择的按钮 -->
    <Button
        android:id="@+id/btn_select_file"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="选择文件"
        android:layout_gravity="center"
        android:layout_marginTop="20dp"/>
</LinearLayout>

然后在Fragment代码里处理显示逻辑：

private lateinit var ivImage: ImageView
private lateinit var pdfView: PDFView

override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
    val view = inflater.inflate(R.layout.fragment_file_display, container, false)
    ivImage = view.findViewById(R.id.iv_image)
    pdfView = view.findViewById(R.id.pdf_view)
    
    // 绑定文件选择按钮的点击事件
    view.findViewById<Button>(R.id.btn_select_file).setOnClickListener {
        if (checkPermissions()) {
            openFilePicker()
        } else {
            requestPermissions()
        }
    }
    return view
}

private fun handleFileDisplay(uri: Uri) {
    val mimeType = requireContext().contentResolver.getType(uri)
    when (mimeType) {
        // 处理图片文件
        "image/jpeg", "image/jpg" -> {
            pdfView.visibility = View.GONE
            ivImage.visibility = View.VISIBLE
            // 用Glide加载图片（也可以用Picasso或系统原生方法）
            Glide.with(this)
                .load(uri)
                .into(ivImage)
        }
        // 处理PDF文件
        "application/pdf" -> {
            ivImage.visibility = View.GONE
            pdfView.visibility = View.VISIBLE
            // 用AndroidPdfViewer加载PDF，还可以添加缩放、翻页等自定义配置
            pdfView.fromUri(uri)
                .defaultPage(0)
                .enableSwipe(true)
                .swipeHorizontal(false)
                .enableDoubletap(true)
                .load()
        }
        else -> {
            Toast.makeText(requireContext(), "暂不支持该文件类型", Toast.LENGTH_SHORT).show()
        }
    }
}

4. 依赖配置（如果用AndroidPdfViewer） #

在app模块的build.gradle里添加依赖：

dependencies {
    // PDF显示库
    implementation 'com.github.barteksc:android-pdf-viewer:3.2.0-beta.1'
    // 图片加载库（可选，也可以不用）
    implementation 'com.github.bumptech.glide:glide:4.15.1'
}

几个小提醒 #

• Android 10+尽量用ContentResolver操作Uri，不要直接获取文件路径，避免权限问题；
• 大文件加载时可以加个进度条，提升用户体验；
• PDF显示可以根据需求自定义，比如添加页码显示、夜间模式等；
• 测试时记得覆盖不同版本的Android系统，确保权限和文件选择逻辑正常。

这样整个流程就打通了：权限检查→文件选择→类型判断→对应控件显示，完美整合图片和PDF的显示逻辑~

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