Android应用中实现将手机相册多选照片移动至应用专属数据目录

看起来你已经搞定了相册多选的核心功能，接下来要实现移动而非复制图片到应用专属目录，这里需要重点关注不同Android版本的存储规则差异，尤其是Android 10+的Scoped Storage限制。我会基于你提供的GalleryImagePicker代码，补充完整的移动逻辑：

第一步：补充获取选中图片真实路径的工具方法 #

相册返回的Uri往往是content://格式（而非直接的本地文件路径），我们需要先把它转换成可访问的真实路径：

// 新增工具方法：将相册Uri转换为本地文件路径
private String getRealPathFromUri(Uri uri) {
    String filePath = "";
    if (DocumentsContract.isDocumentUri(cntxt, uri)) {
        // 处理Android 4.4及以上的Document类型Uri
        String docId = DocumentsContract.getDocumentId(uri);
        if ("com.android.providers.media.documents".equals(uri.getAuthority())) {
            String id = docId.split(":")[1];
            String selection = MediaStore.Images.Media._ID + "=" + id;
            filePath = getFilePathFromMediaStore(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, selection);
        } else if ("com.android.providers.downloads.documents".equals(uri.getAuthority())) {
            Uri contentUri = ContentUris.withAppendedId(Uri.parse("content://downloads/public_downloads"), Long.parseLong(docId));
            filePath = getFilePathFromMediaStore(contentUri, null);
        }
    } else if ("content".equalsIgnoreCase(uri.getScheme())) {
        // 处理普通content类型Uri
        filePath = getFilePathFromMediaStore(uri, null);
    } else if ("file".equalsIgnoreCase(uri.getScheme())) {
        // 直接处理文件类型Uri
        filePath = uri.getPath();
    }
    return filePath;
}

// 从MediaStore查询文件路径的辅助方法
private String getFilePathFromMediaStore(Uri uri, String selection) {
    String path = null;
    String[] projection = {MediaStore.Images.Media.DATA};
    Cursor cursor = cntxt.getContentResolver().query(uri, projection, selection, null, null);
    if (cursor != null) {
        if (cursor.moveToFirst()) {
            int columnIndex = cursor.getColumnIndexOrThrow(projection[0]);
            path = cursor.getString(columnIndex);
        }
        cursor.close();
    }
    return path;
}

第二步：实现图片移动核心逻辑 #

根据Android版本差异，我们需要分两种情况处理移动逻辑：Android 10+用Scoped Storage兼容方案，旧版本直接文件操作：

// 新增移动图片到应用专属目录的方法
private boolean moveImageToAppDir(String sourcePath) {
    File sourceFile = new File(sourcePath);
    if (!sourceFile.exists()) {
        Log.e("GalleryPicker", "源文件不存在：" + sourcePath);
        return false;
    }

    // 获取应用专属外部存储目录（卸载时自动删除，无需额外权限）
    File appDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    if (appDir == null) {
        //  fallback到内部存储目录
        appDir = new File(getFilesDir(), "Pictures");
    }
    // 创建目录（如果不存在）
    if (!appDir.exists() && !appDir.mkdirs()) {
        Log.e("GalleryPicker", "无法创建应用专属图片目录");
        return false;
    }

    // 生成唯一目标文件名，避免重复
    String fileName = System.currentTimeMillis() + "_" + sourceFile.getName();
    File targetFile = new File(appDir, fileName);

    try {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            // Android 10+：因Scoped Storage限制，先复制再删除源文件
            ContentResolver resolver = getContentResolver();
            // 复制文件内容
            InputStream inputStream = resolver.openInputStream(Uri.fromFile(sourceFile));
            OutputStream outputStream = new FileOutputStream(targetFile);
            byte[] buffer = new byte[1024];
            int length;
            while ((length = inputStream.read(buffer)) > 0) {
                outputStream.write(buffer, 0, length);
            }
            inputStream.close();
            outputStream.close();

            // 删除源文件（通过MediaStore操作）
            resolver.delete(MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                    MediaStore.Images.Media.DATA + "=?",
                    new String[]{sourcePath});
        } else {
            // Android 9及以下：直接通过renameTo移动文件
            if (!sourceFile.renameTo(targetFile)) {
                // 如果rename失败，降级为复制后删除源文件
                copyFile(sourceFile, targetFile);
                sourceFile.delete();
            }
        }
        Log.d("GalleryPicker", "图片移动成功：" + targetFile.getAbsolutePath());
        return true;
    } catch (IOException e) {
        Log.e("GalleryPicker", "移动图片失败：" + e.getMessage());
        e.printStackTrace();
        return false;
    }
}

// 文件复制辅助方法
private void copyFile(File source, File target) throws IOException {
    InputStream in = new FileInputStream(source);
    OutputStream out = new FileOutputStream(target);
    byte[] buf = new byte[1024];
    int len;
    while ((len = in.read(buf)) > 0) {
        out.write(buf, 0, len);
    }
    in.close();
    out.close();
}

第三步：整合到多选图片处理流程 #

假设你用旧版onActivityResult获取选中图片，可这样调用移动逻辑：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode == RESULT_OK && data != null) {
        // 处理多选图片
        ClipData clipData = data.getClipData();
        if (clipData != null) {
            for (int i = 0; i < clipData.getItemCount(); i++) {
                Uri uri = clipData.getItemAt(i).getUri();
                String sourcePath = getRealPathFromUri(uri);
                if (!TextUtils.isEmpty(sourcePath)) {
                    moveImageToAppDir(sourcePath);
                }
            }
        } else {
            // 处理单选图片
            Uri uri = data.getData();
            String sourcePath = getRealPathFromUri(uri);
            if (!TextUtils.isEmpty(sourcePath)) {
                moveImageToAppDir(sourcePath);
            }
        }
    }
}

关键注意事项 #

• 权限适配：Android 6.0+需要申请READ_EXTERNAL_STORAGE权限；Android 10+使用Scoped Storage时，无需WRITE_EXTERNAL_STORAGE权限。
• 异常防护：务必捕获IO异常，避免应用崩溃，同时通过日志记录便于调试。
• 文件名唯一性：用时间戳拼接原文件名的方式避免目标文件重复，你可根据业务需求调整命名规则。

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