嘿，这个需求我之前做过好几次，其实拆解下来很清晰，我一步步给你讲怎么实现：

要把截图保存到外部存储，首先得申请文件读写权限。不同Android版本的权限要求不一样：

• Android 12及以下：需要WRITE_EXTERNAL_STORAGE权限
• Android 13及以上：只需要READ_MEDIA_IMAGES（如果用MediaStore保存图片，甚至可以不用申请传统存储权限，体验更友好）

先在Manifest里声明权限：

<!-- Android 12及以下需要 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13+ 需要 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

点击按钮前要先检查权限，没权限就请求，通过后再执行截图逻辑。

这里有两种常用方法，分别适配不同场景：

方法1：通用View绘制法（全版本兼容） #

让目标View自己绘制到Bitmap上，简单直接：

private fun captureView(view: View): Bitmap? {
    // 创建和View尺寸一致的Bitmap
    val bitmap = Bitmap.createBitmap(view.width, view.height, Bitmap.Config.ARGB_8888)
    // 关联Canvas和Bitmap
    val canvas = Canvas(bitmap)
    // 让View把内容绘制到Canvas上
    view.draw(canvas)
    return bitmap
}

注意：这个方法要求View已经完成布局（width和height不为0），因为是点击按钮触发，所以没问题，但刚启动就调用可能拿到空Bitmap。

方法2：Android O及以上推荐的PixelCopy API（更准确） #

如果你的APP最低版本是Android 8.0（API 26），用PixelCopy更靠谱，尤其是处理带SurfaceView、硬件加速的View：

private fun captureViewWithPixelCopy(view: View, callback: (Bitmap?) -> Unit) {
    val window = (view.context as Activity).window
    val bitmap = Bitmap.createBitmap(view.width, view.height, Bitmap.Config.ARGB_8888)
    
    PixelCopy.request(window, view, bitmap, { result ->
        if (result == PixelCopy.SUCCESS) {
            callback(bitmap)
        } else {
            callback(null)
        }
    }, Handler(Looper.getMainLooper()))
}

拿到Bitmap后，就可以写入文件了，这是通用的保存方法：

private fun saveBitmapToFile(bitmap: Bitmap, targetPath: String): Boolean {
    return try {
        val file = File(targetPath)
        // 创建父目录（如果不存在）
        file.parentFile?.mkdirs()
        // 输出流写入文件
        val outputStream = FileOutputStream(file)
        // 压缩Bitmap为JPEG，质量80（范围0-100）
        bitmap.compress(Bitmap.CompressFormat.JPEG, 80, outputStream)
        // 刷新并关闭流
        outputStream.flush()
        outputStream.close()
        // 通知系统媒体库更新，图库能立刻看到截图
        MediaScannerConnection.scanFile(
            bitmap.context,
            arrayOf(targetPath),
            arrayOf("image/jpeg"),
            null
        )
        true
    } catch (e: IOException) {
        e.printStackTrace()
        false
    }
}

假设按钮id是btnCapture，目标布局id是captureMe，Activity里的代码：

btnCapture.setOnClickListener {
    // 检查权限（以Android 12及以下为例，13+可简化）
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
        != PackageManager.PERMISSION_GRANTED
    ) {
        ActivityCompat.requestPermissions(
            this,
            arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE),
            REQUEST_CODE_STORAGE_PERMISSION
        )
        return@setOnClickListener
    }

    // 获取目标布局
    val captureView = findViewById<LinearLayout>(R.id.captureMe)
    // 方法1：用View绘制法
    val bitmap = captureView(captureView)
    bitmap?.let {
        // 指定保存路径，比如外部存储Pictures目录下的截图
        val targetPath = "${externalMediaDirs.firstOrNull()?.absolutePath}/capture_${System.currentTimeMillis()}.jpg"
        val isSaved = saveBitmapToFile(it, targetPath)
        Toast.makeText(this, if (isSaved) "截图保存成功" else "保存失败", Toast.LENGTH_SHORT).show()
        // 回收Bitmap，避免内存泄漏
        it.recycle()
    }

    // 方法2：用PixelCopy的调用方式
    /*
    captureViewWithPixelCopy(captureView) { bitmap ->
        bitmap?.let {
            val targetPath = "${externalMediaDirs.firstOrNull()?.absolutePath}/capture_${System.currentTimeMillis()}.jpg"
            val isSaved = saveBitmapToFile(it, targetPath)
            Toast.makeText(this, if (isSaved) "截图保存成功" else "保存失败", Toast.LENGTH_SHORT).show()
            it.recycle()
        } ?: Toast.makeText(this, "截图失败", Toast.LENGTH_SHORT).show()
    }
    */
}

// 处理权限请求结果
override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == REQUEST_CODE_STORAGE_PERMISSION) {
        if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限通过，重新执行截图
            btnCapture.performClick()
        } else {
            Toast.makeText(this, "需要存储权限才能保存截图", Toast.LENGTH_SHORT).show()
        }
    }
}

// 权限请求码
companion object {
    private const val REQUEST_CODE_STORAGE_PERMISSION = 1001
}

• View必须可见：如果目标LinearLayout是GONE状态或者在屏幕外，根本捕获不到内容，确保它是VISIBLE且布局完成。
• 内存问题：如果View尺寸很大，Bitmap会占不少内存，用完记得调用bitmap.recycle()释放。
• Android 13+适配：推荐用MediaStore插入图片，不用弹存储权限弹窗，用户体验更好。
• 硬件加速控件：像WebView这类带硬件加速的控件，用View.draw()可能有显示问题，换PixelCopy就解决了。

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