API 24下图片保存失效问题修复咨询（无需大幅改动代码）

嘿，我帮你分析了下问题，核心原因是API24属于Android 7.0，而从Android 6.0（API23）开始就需要动态申请WRITE_EXTERNAL_STORAGE权限才能写入外部存储，你的代码里完全没处理动态权限逻辑，这是导致API24下保存失败的关键。另外还有几个小细节需要调整，下面是改动极小的修复方案：

1. 新增动态权限检查逻辑 #

先把保存图片的代码抽成独立方法，然后在点击下载按钮时先检查权限：

// 在你的Activity类里添加权限相关常量和方法
private static final int REQUEST_STORAGE_PERMISSION = 1001;

// 点击下载按钮时先调用这个方法
private void handleSaveImage() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        // 检查是否拥有存储写入权限
        int permissionStatus = ContextCompat.checkSelfPermission(this, 
                Manifest.permission.WRITE_EXTERNAL_STORAGE);
        if (permissionStatus != PackageManager.PERMISSION_GRANTED) {
            // 申请权限
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
                    REQUEST_STORAGE_PERMISSION);
            return;
        }
    }
    // 权限已通过，执行保存逻辑
    saveSignatureToGallery();
}

// 处理权限申请的回调
@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) {
            // 用户同意权限，执行保存
            saveSignatureToGallery();
        } else {
            Toast.makeText(this, "需要存储权限才能保存图片哦", Toast.LENGTH_SHORT).show();
        }
    }
}

然后把原来case R.id.action_download:里的代码替换成调用这个方法：

case R.id.action_download:
    handleSaveImage();
    return true;

2. 确保保存目录存在 #

在创建文件输出流之前，先检查并创建目标目录，避免因为目录不存在导致写入失败：

// 原来的目录创建代码后添加这几行
File directory = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
if (!directory.exists()) {
    directory.mkdirs(); // 递归创建目录
}
File file = new File(directory, System.currentTimeMillis() + ".png");

3. 调整Toast和错误提示逻辑 #

原来的代码不管保存成功与否都会弹出成功Toast，这会误导用户。建议把成功Toast移到写入成功的分支里，同时在catch块里添加错误提示：

// 把原来的try-finally块改成这样
FileOutputStream out = null;
Bitmap bitmap = signatureView.getSignatureBitmap();
try {
    out = new FileOutputStream(file);
    if (bitmap != null) {
        boolean saveSuccess = bitmap.compress(Bitmap.CompressFormat.PNG, 100, out);
        if (saveSuccess) {
            // 保存成功才弹提示
            Toast.makeText(getApplicationContext(), 
                    "Image saved successfully at " + file.getPath(), 
                    Toast.LENGTH_LONG).show();
            // 通知图库扫描图片
            if (Build.VERSION.SDK_INT < Build.VERSION_CODES.KITKAT) {
                new MyMediaScanner(this, file);
            } else {
                MediaScannerConnection.scanFile(this, 
                        new String[]{file.getAbsolutePath()}, 
                        null, 
                        (scannedPath, uri) -> {
                            // 可选：扫描完成后的回调，不需要可以留空
                        });
            }
        } else {
            throw new IOException("Failed to compress bitmap to file");
        }
    } else {
        throw new FileNotFoundException("Signature bitmap is null");
    }
} catch (Exception e) {
    e.printStackTrace();
    // 保存失败弹错误提示
    Toast.makeText(getApplicationContext(), 
            "Failed to save image: " + e.getMessage(), 
            Toast.LENGTH_LONG).show();
} finally {
    try {
        if (out != null) {
            out.flush();
            out.close();
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
}

4. 确认清单文件已添加权限 #

确保你的AndroidManifest.xml里已经声明了存储权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 如果你的targetSdkVersion>=29，还需要添加读取权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

因为Android 4.4（API19）及以下的系统不需要动态申请权限，只要在清单文件里声明了权限，系统就会自动授予，所以你的代码能正常写入外部存储。而从Android 6.0（API23）开始引入了动态权限机制，必须在运行时向用户申请敏感权限才能访问对应的资源，这就是API24下失败的根本原因。

这样改动的代码量非常小，只是把原有逻辑做了拆分和补充，完全不需要大幅改动项目结构就能解决问题。

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