关于实现当前Activity截图并邮件发送功能的技术问询

我来帮你把这个功能落地，结合你给出的代码片段，咱们一步步完善：

1. 完成截图逻辑 #

你已经写出了截图的核心代码，我帮你补全文件写入、异常处理的部分，同时适配更高版本的Android存储规则：

private void takeScreenshot() {
    // 生成文件名，用当前时间避免重复
    String now = new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(new Date());
    // Android 10+推荐使用应用专属外部存储目录，不需要WRITE权限
    File storageDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    String mPath = storageDir.getAbsolutePath() + "/" + now + ".jpg";

    try {
        // 获取当前Activity的根View
        View v1 = getWindow().getDecorView().getRootView();
        v1.setDrawingCacheEnabled(true);
        // 创建截图Bitmap
        Bitmap bitmap = Bitmap.createBitmap(v1.getDrawingCache());
        v1.setDrawingCacheEnabled(false);

        // 将Bitmap写入文件
        File imageFile = new File(mPath);
        FileOutputStream outputStream = new FileOutputStream(imageFile);
        // 以JPG格式压缩保存，质量80
        bitmap.compress(Bitmap.CompressFormat.JPEG, 80, outputStream);
        outputStream.flush();
        outputStream.close();

        // 截图完成后调用邮件发送方法
        sendScreenshotByEmail(mPath);
    } catch (IOException e) {
        e.printStackTrace();
        // 这里可以添加错误提示，比如Toast
        Toast.makeText(this, "截图失败", Toast.LENGTH_SHORT).show();
    }
}

2. 实现邮件发送功能 #

咱们直接调用系统自带的邮件应用来发送，这样省去了自己配置SMTP服务器的麻烦，用户使用起来也更熟悉：

private void sendScreenshotByEmail(String imagePath) {
    Intent emailIntent = new Intent(Intent.ACTION_SEND);
    emailIntent.setType("image/jpeg");
    // 设置邮件主题
    emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Activity截图");
    // 设置邮件正文
    emailIntent.putExtra(Intent.EXTRA_TEXT, "这是当前页面的截图，请查收");
    // 添加截图附件
    Uri imageUri = FileProvider.getUriForFile(this, getPackageName() + ".fileprovider", new File(imagePath));
    emailIntent.putExtra(Intent.EXTRA_STREAM, imageUri);
    // 允许邮件应用读取附件
    emailIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

    // 检查是否有能处理该Intent的应用
    if (emailIntent.resolveActivity(getPackageManager()) != null) {
        startActivity(Intent.createChooser(emailIntent, "选择邮件应用"));
    } else {
        Toast.makeText(this, "未找到邮件应用", Toast.LENGTH_SHORT).show();
    }
}

3. 必要的配置 #

3.1 清单文件配置 #

需要添加FileProvider的配置（Android 7.0+必须用FileProvider来分享文件），以及存储权限（仅Android 9.0及以下需要）：

<!-- Android 9.0及以下需要的存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28"/>
<!-- 允许读取媒体文件，Android 10+可选 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>

<application ...>
    <!-- FileProvider配置 -->
    <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>

3.2 创建FileProvider路径配置文件 #

在res/xml目录下创建file_paths.xml文件，内容如下：

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

3.3 动态权限申请（Android 6.0-9.0） #

如果你的应用需要兼容Android 6.0到9.0，需要在调用截图方法前动态申请存储权限：

private static final int REQUEST_STORAGE_PERMISSION = 100;

private void checkPermissionAndTakeScreenshot() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
        requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_STORAGE_PERMISSION);
    } else {
        takeScreenshot();
    }
}

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_STORAGE_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            takeScreenshot();
        } else {
            Toast.makeText(this, "需要存储权限才能完成截图", Toast.LENGTH_SHORT).show();
        }
    }
}

关键注意事项 #

• 存储路径适配：Android 10及以上禁止直接写入外部公共目录，使用getExternalFilesDir()获取应用专属目录，无需申请WRITE权限
• 截图时机：确保View已经完全绘制，比如可以在onWindowFocusChanged(boolean hasFocus)方法中调用截图，或者用postDelayed延迟执行
• FileProvider：Android 7.0+分享文件必须用FileProvider，不能直接用文件Uri，否则会抛出FileUriExposedException
• 应用兼容性：调用邮件Intent前一定要检查是否有可用的应用，避免崩溃

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