如何将通过URI获取的联系人照片复制到自定义文件夹？

嘿，刚好之前做过类似的需求，给你一步步拆解实现方法，分几个关键部分来说：

一、先搞定权限（重要！） #

首先得根据你要保存的目标位置，确认需要的权限：

• 如果是保存到应用私有外部存储目录（比如getExternalFilesDir(Environment.DIRECTORY_PICTURES)）：不需要申请任何权限，系统默认允许，而且卸载应用时会自动删除这些文件，适合存储应用专属的缓存/数据文件，非常推荐这种方式。
• 如果是保存到公共外部目录（比如DCIM、Pictures下的自定义文件夹）：
  • Android 9及以下：需要在Manifest里声明WRITE_EXTERNAL_STORAGE，并且在Android 6.0+动态申请权限。
  • Android 10及以上：如果用MediaStore API写入，不需要WRITE_EXTERNAL_STORAGE权限，但如果要读取其他应用的文件，可能需要READ_EXTERNAL_STORAGE。

二、核心复制逻辑代码 #

下面是完整的工具方法，我先给你最稳妥的私有目录版本：

private void copyContactPhotoToCustomFolder(Uri photoUri, long contactID) {
    ContentResolver resolver = getContentResolver();
    InputStream inputStream = null;
    OutputStream outputStream = null;

    try {
        // 打开联系人照片的输入流
        inputStream = resolver.openInputStream(photoUri);
        if (inputStream == null) {
            // 处理联系人没有照片的情况
            Toast.makeText(this, "该联系人未设置头像", Toast.LENGTH_SHORT).show();
            return;
        }

        // 创建目标文件夹：这里用应用私有图片目录下的自定义子文件夹
        File targetDir = new File(getExternalFilesDir(Environment.DIRECTORY_PICTURES), "MyContactPhotos");
        if (!targetDir.exists()) {
            boolean isCreated = targetDir.mkdirs();
            if (!isCreated) {
                Toast.makeText(this, "文件夹创建失败", Toast.LENGTH_SHORT).show();
                return;
            }
        }

        // 创建目标文件，用contactID命名避免重复
        File targetFile = new File(targetDir, "contact_avatar_" + contactID + ".png");
        outputStream = new FileOutputStream(targetFile);

        // 字节流复制文件
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = inputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, bytesRead);
        }

        // 提示保存成功，也可以在这里做后续操作
        Toast.makeText(this, "头像已保存到: " + targetFile.getAbsolutePath(), Toast.LENGTH_LONG).show();

    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "保存失败: " + e.getMessage(), Toast.LENGTH_SHORT).show();
    } finally {
        // 一定要关闭流，避免资源泄漏
        try {
            if (inputStream != null) inputStream.close();
            if (outputStream != null) outputStream.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

三、Android 10+ 公共目录适配（可选） #

如果你一定要保存到公共目录（比如用户能在相册里看到），就得用MediaStore API来绕过分区存储限制，给你个示例：

private void saveContactPhotoToPublicDir(Uri photoUri, long contactID) {
    ContentResolver resolver = getContentResolver();
    InputStream inputStream = null;
    OutputStream outputStream = null;

    try {
        inputStream = resolver.openInputStream(photoUri);
        if (inputStream == null) {
            Toast.makeText(this, "该联系人未设置头像", Toast.LENGTH_SHORT).show();
            return;
        }

        // 配置MediaStore的元数据
        ContentValues values = new ContentValues();
        values.put(MediaStore.Images.Media.DISPLAY_NAME, "contact_avatar_" + contactID + ".png");
        values.put(MediaStore.Images.Media.MIME_TYPE, "image/png");
        // 指定保存到DCIM下的自定义文件夹
        values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_DCIM + "/MyContactAvatars");

        // 插入到MediaStore，获取输出URI
        Uri outputUri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
        if (outputUri == null) {
            throw new IOException("无法创建输出文件");
        }

        outputStream = resolver.openOutputStream(outputUri);
        if (outputStream == null) {
            // 创建失败，清理已插入的记录
            resolver.delete(outputUri, null, null);
            throw new IOException("无法打开输出流");
        }

        // 复制文件内容
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = inputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, bytesRead);
        }

        Toast.makeText(this, "头像已保存到公共相册", Toast.LENGTH_SHORT).show();

    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "保存失败: " + e.getMessage(), Toast.LENGTH_SHORT).show();
    } finally {
        try {
            if (inputStream != null) inputStream.close();
            if (outputStream != null) outputStream.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

四、调用方法 #

在你用Picasso加载照片的代码之后，直接调用上面的方法就行：

// 加载照片的代码保持不变
Picasso.with(mainUserPhoto.getContext())
    .load(uri)
    .placeholder(R.drawable.image_placeholder)
    .error(R.drawable.folder_placeholder)
    .into(mainUserPhoto);

// 复制照片到自定义文件夹
copyContactPhotoToCustomFolder(uri, Long.valueOf(contactID));

注意：如果是动态申请权限的场景，要先确保权限已经获取到，再调用复制方法哦～

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