一手遮天 Android - 存储: Android 11 通过 MediaStore 管理文件
一手遮天 Android - 存储: Android 11 通过 MediaStore 管理文件
示例如下:
/storage/Android11Demo2.java
/**
* 本例用于演示 Android 11 通过 MediaStore 管理文件
*
* 通过 MediaStore 可以在指定的公共目录中管理文件，包括图片目录，视频目录，音频目录，下载目录
* 文档目录等其他公共目录是不能通过 MediaStore 管理的
* 通过 MediaStore 保存的数据，卸载 app 后不会被删除
* 通过 MediaStore 保存或读取数据全部由程序管理，不需要用户选择（通过 Storage Access Framework 管理文件是需要用户选择的）
* 通过 MediaStore 保存文件时要注意，系统是通过你指定的 mime 来判断文件类型的
* 图片目录只能保存图片类型的文件
* 视频目录只能保存视频类型的文件
* 音频目录只能保存音频类型的文件
* 下载目录可以保存任意类型的文件
*
* 注：
* 1、如果你卸载 app 后再重装 app，则会失去卸载 app 之前通过 MediaStore 创建的文件的所有权
* 对于你有所有权的文件可以通过 MediaStore 访问和删除
* 对于你没有所有权的文件，不可以通过 MediaStore 删除，但是可以通过 MediaStore 访问（前提是先要申请 READ_EXTERNAL_STORAGE 权限）
* 2、各种公共目录并不是物理文件夹，而是将其他相关文件夹中的相关文件集中管理
* 比如视频目录会包括 DCIM 文件夹, Movies 文件夹, Pictures 文件夹中的视频文件
*/
package com.webabcd.androiddemo.storage;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import android.Manifest;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.graphics.drawable.BitmapDrawable;
import android.net.Uri;
import android.os.Bundle;
import android.os.Environment;
import android.provider.MediaStore;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
import com.webabcd.androiddemo.R;
import java.io.OutputStream;
import java.util.Locale;
public class Android11Demo2 extends AppCompatActivity {
private final String LOG_TAG = "Android11Demo2";
private Button _button0;
private Button _button1;
private Button _button2;
private Button _button3;
private Button _button4;
private ImageView _imageView1;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_storage_android11demo2);
_button0 = findViewById(R.id.button0);
_button1 = findViewById(R.id.button1);
_button2 = findViewById(R.id.button2);
_button3 = findViewById(R.id.button3);
_button4 = findViewById(R.id.button4);
_imageView1 = findViewById(R.id.imageView1);
sample();
}
private void sample() {
_button0.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
requestPermission();
}
});
_button1.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
createFile();
}
});
_button2.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
queryFileFirst();
}
});
_button3.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
showFile();
}
});
_button4.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
deleteFileFirst();
}
});
}
// 请求“通过 MediaStore 读取非本 app 创建的文件”的权限
// 先在 AndroidManifest.xml 中配置 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
// 然后按照如下方式请求（注：WRITE_EXTERNAL_STORAGE 权限已经无效了）
private void requestPermission() {
String[] storagePermissions = { Manifest.permission.READ_EXTERNAL_STORAGE };
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(this, storagePermissions, 123);
}
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
for (int i = 0; i < permissions.length; i++) {
Log.i(LOG_TAG, "申请的权限为：" + permissions[i] + "，申请结果：" + grantResults[i]);
}
}
// 通过 MediaStore 在图片目录新建一个图片文件
private void createFile() {
// 需要创建的图片对象
BitmapDrawable bitmapDrawable = (BitmapDrawable) getResources().getDrawable(R.drawable.son01, null);
Bitmap bitmap = bitmapDrawable.getBitmap();
ContentValues contentValues = new ContentValues();
// 指定文件保存的文件夹名称
// Environment.DIRECTORY_PICTURES 值为 Pictures
// Environment.DIRECTORY_DCIM 值为 DCIM
// Environment.DIRECTORY_MOVIES 值为 Movies
// Environment.DIRECTORY_MUSIC 值为 Music
// Environment.DIRECTORY_DOWNLOADS 值为 Download
// 如果想获取上述文件夹的真实地址可以通过这样的方式 Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES).getAbsolutePath() 获取，他返回的值类似 /storage/emulated/0/Pictures
contentValues.put(MediaStore.Images.ImageColumns.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/wanglei_test/");
// 指定文件名
contentValues.put(MediaStore.Images.ImageColumns.DISPLAY_NAME, "son");
// 指定文件的 mime（比如 image/jpeg, application/vnd.android.package-archive 之类的）
contentValues.put(MediaStore.Images.ImageColumns.MIME_TYPE, "image/jpeg");
contentValues.put(MediaStore.Images.ImageColumns.WIDTH, bitmap.getWidth());
contentValues.put(MediaStore.Images.ImageColumns.HEIGHT, bitmap.getHeight());
ContentResolver contentResolver = this.getContentResolver();
// 通过 ContentResolver 在指定的公共目录下按照指定的 ContentValues 创建文件，会返回文件的 content uri（类似这样的地址 content://media/external/images/media/102）
// 可以通过 MediaStore 保存文件的公共目录有：
// MediaStore.Images.Media.EXTERNAL_CONTENT_URI - 图片目录，只能保存 mime 为图片类型的文件
// 图片目录包括 Environment.DIRECTORY_PICTURES, Environment.DIRECTORY_DCIM 文件夹
// MediaStore.Audio.Media.EXTERNAL_CONTENT_URI - 音频目录，只能保存 mime 为音频类型的文件
// 音频目录包括 Environment.DIRECTORY_MUSIC, Environment.DIRECTORY_RINGTONES 等等文件夹
// MediaStore.Video.Media.EXTERNAL_CONTENT_URI - 视频目录，只能保存 mime 为视频类型的文件
// 视频目录包括 DIRECTORY_MOVIES, Environment.DIRECTORY_PICTURES, Environment.DIRECTORY_DCIM 文件夹
// MediaStore.Downloads.EXTERNAL_CONTENT_URI - 下载目录，可以保存任意类型的文件
// 下载目录包括 Environment.DIRECTORY_DOWNLOADS 文件夹
Uri uri = contentResolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, contentValues);
if (uri == null) {
Log.d(LOG_TAG, "创建文件失败");
} else {
Log.d(LOG_TAG, "创建文件成功：" + uri.toString());
}
// 写入图片数据
OutputStream outputStream = null;
try {
outputStream = contentResolver.openOutputStream(uri);
bitmap.compress(Bitmap.CompressFormat.JPEG, 85, outputStream);
} catch (Exception ex) {
Log.d(LOG_TAG, "写入数据失败：" + ex.toString());
} finally {
try {
if (outputStream != null) {
outputStream.flush();
outputStream.close();
}
} catch (Exception ex) {
}
}
}
// 通过 MediaStore 在图片目录遍历图片文件
// 注：
// 1、如果你想遍历出非本 app 创建的文件，则需要先申请 READ_EXTERNAL_STORAGE 权限
// 2、如果你的 app 卸载后再重装的话系统不会认为是同一个 app（也就是你卸载之前创建的文件，再次安装 app 后必须先申请 READ_EXTERNAL_STORAGE 权限后才能获取到）
private int queryFileFirst() {
int contentId = -1;
// 通过 ContentResolver 遍历指定公共目录中的文件
ContentResolver contentResolver = this.getContentResolver();
// 第 2 个参数（projection）：指定需要返回的字段，null 会返回所有字段
// 第 3 个参数（selection）：查询的 where 语句，类似 xxx = ?
// 第 4 个参数（selectionArgs）：查询的 where 语句的值，类似 new String[] { xxx }
// 第 5 个参数（selectionArgs）：排序语句，类似 xxx DESC
Cursor cursor = contentResolver.query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, null, null, null, null);
Log.d(LOG_TAG, "count:" + cursor.getCount());
while (cursor.moveToNext()) {
// 比如这个地址 content://media/external/images/media/102 它的后面的 102 就是它的 id
int id = cursor.getInt(cursor.getColumnIndex(MediaStore.MediaColumns._ID));
// 获取文件名
String title = cursor.getString(cursor.getColumnIndex(MediaStore.MediaColumns.TITLE));
// 获取文件的真实路径，类似 /storage/emulated/0/Pictures/wanglei_test/son.jpg
String path = cursor.getString(cursor.getColumnIndex(MediaStore.Images.Media.DATA));
Log.d(LOG_TAG, String.format("id:%d, title:%s, path:%s", id, title, path));
contentId = id;
}
cursor.close();
// 返回指定的公共目录中的第一个文件的 id
return contentId;
}
// 通过 MediaStore 读取图片目录中的图片，并显示
private void showFile() {
// 先拿到需要显示的图片的 content uri（类似这样的地址 content://media/external/images/media/102）
int contentId = queryFileFirst();
Uri contentUri = Uri.parse(MediaStore.Images.Media.EXTERNAL_CONTENT_URI + "/" + contentId);
Log.d(LOG_TAG, "show uri:" + contentUri);
Cursor cursor = null;
try {
String[] projection = { MediaStore.Images.Media.DATA };
cursor = this.getContentResolver().query(contentUri, projection, null, null, null);
cursor.moveToFirst();
// 拿到指定的 content uri 的真实路径
String path = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA));
Log.d(LOG_TAG, String.format(Locale.ENGLISH, "contentUri:%s, path:%s", contentUri, path));
// 显示指定路径的图片
Bitmap bitmap = BitmapFactory.decodeFile(path);
_imageView1.setImageBitmap(bitmap);
} catch (Exception ex) {
Log.e(LOG_TAG, ex.toString());
}
finally {
if (cursor != null) {
cursor.close();
}
}
}
// 通过 MediaStore 删除图片目录中的图片文件（只能删除本 app 创建的文件）
// 注：如果你的 app 卸载后再重装的话系统不会认为是同一个 app（也就是你卸载之前创建的文件，再次安装 app 后是无法通过这种方式删除它的）
private void deleteFileFirst() {
try {
// 先拿到需要删除的图片的 content uri（类似这样的地址 content://media/external/images/media/102）
int contentId = queryFileFirst();
Uri contentUri = Uri.parse(MediaStore.Images.Media.EXTERNAL_CONTENT_URI + "/" + contentId);
Log.d(LOG_TAG, "delete uri:" + contentUri);
// 通过 ContentResolver 删除指定的 content uri 的文件
ContentResolver contentResolver = this.getContentResolver();
int deleteCount = contentResolver.delete(contentUri, null);
Log.d(LOG_TAG, "delete count:" + deleteCount);
} catch (Exception ex) {
// 如果你想删除非本 app 创建的文件，就会收到类似这样的异常 android.app.RecoverableSecurityException: com.webabcd.androiddemo has no access to content://media/external/images/media/102
Log.e(LOG_TAG, "delete error:" + ex.toString());
}
}
}
/layout/activity_storage_android11demo2.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<Button
android:id="@+id/button0"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textAllCaps="false"
android:text="请求“通过 MediaStore 读取非本 app 创建的文件”的权限" />
<Button
android:id="@+id/button1"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textAllCaps="false"
android:text="通过 MediaStore 在图片目录新建一个图片文件" />
<Button
android:id="@+id/button2"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textAllCaps="false"
android:text="通过 MediaStore 在图片目录遍历图片文件" />
<Button
android:id="@+id/button3"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textAllCaps="false"
android:text="通过 MediaStore 读取图片目录中的图片，并显示" />
<Button
android:id="@+id/button4"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textAllCaps="false"
android:text="通过 MediaStore 删除图片目录中的图片文件" />
<ImageView
android:id="@+id/imageView1"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="5dp" />
</LinearLayout>
