Android开发：无法通过编程方式在邮件中附加图片的问题求助

看起来你已经搞定了截图保存的核心逻辑，但卡在了邮件附件这一步——这在Android开发里很常见，主要是文件URI安全限制和文件名合法性这两个坑导致的。下面给你一步步的解决方案：

第一步：先修复截图文件名的问题 #

你当前代码里直接用Date对象拼接文件名，会生成带空格、冒号的非法文件名，邮件应用根本找不到这个文件。先把日期格式化改成文件名友好的格式：

Date now = new Date();
// 把冒号换成减号，避免文件名包含非法字符
String timestamp = android.text.format.DateFormat.format("yyyy-MM-dd_hh-mm-ss", now).toString();
String mPath = Environment.getExternalStorageDirectory().toString() + "/" + timestamp + ".png";

第二步：适配Android 7.0+的文件URI规则 #

从Android 7.0开始，直接使用file:// URI传递文件会触发FileUriExposedException，必须用FileProvider生成安全的content:// URI。

1. 注册FileProvider到Manifest #

在AndroidManifest.xml的<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>

2. 创建文件路径配置文件 #

在res/xml目录下新建file_paths.xml（如果没有xml目录就手动创建），内容如下：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 允许共享外部存储根目录下的所有文件 -->
    <external-path name="external_files" path="." />
</paths>

3. 编写邮件附件的Intent逻辑 #

现在可以生成合法的URI并调用邮件应用了，把这段代码加到你的截图完成逻辑后面：

File screenshotFile = new File(mPath);
if (!screenshotFile.exists()) {
    Toast.makeText(this, "截图文件生成失败，请检查存储权限", Toast.LENGTH_SHORT).show();
    return;
}

// 根据系统版本生成对应的文件URI
Uri fileUri;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    // Android 7.0+用FileProvider生成content URI
    fileUri = FileProvider.getUriForFile(this, getPackageName() + ".fileprovider", screenshotFile);
} else {
    // 低版本直接用file URI
    fileUri = Uri.fromFile(screenshotFile);
}

// 构建发送邮件的Intent
Intent emailIntent = new Intent(Intent.ACTION_SEND);
emailIntent.setType("image/png"); // 指定附件类型为PNG图片
emailIntent.putExtra(Intent.EXTRA_SUBJECT, "自动截取的屏幕截图");
emailIntent.putExtra(Intent.EXTRA_TEXT, "这是通过应用自动截取的屏幕截图");
// 添加附件URI
emailIntent.putExtra(Intent.EXTRA_STREAM, fileUri);
// 给邮件应用临时授权读取这个文件
emailIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

// 弹出应用选择器让用户选邮件应用
startActivity(Intent.createChooser(emailIntent, "选择邮件应用发送截图"));

第三步：确保存储权限正确申请 #

Android 6.0+需要动态申请存储权限，否则截图无法保存到外部存储。在你的Activity里添加权限检查逻辑：

// 在执行截图前检查权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 100);
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 100) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限获取成功，执行截图和邮件逻辑
            takeScreenshotAndSendEmail(); // 这里替换成你自己的截图方法
        } else {
            Toast.makeText(this, "需要存储权限才能保存和发送截图", Toast.LENGTH_SHORT).show();
        }
    }
}

额外提示（针对Android 10+） #

如果你的应用目标SDK是29及以上，默认不能直接访问外部存储根目录，要么在AndroidManifest.xml的<application>标签里添加android:requestLegacyExternalStorage="true"来兼容旧逻辑，要么改用MediaStore来保存截图文件。

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