安卓存储与加载本地文件

安卓本地文件存储与加载详解

安卓本地存储的分类

安卓系统提供了多种本地存储方式,开发者可根据数据类型和需求选择：

文件存储与加载的核心操作

内部存储操作

• 写入文件

  // 获取内部存储目录
  File file = new File(getFilesDir(), "example.txt");
  try (FileOutputStream fos = new FileOutputStream(file)) {
      fos.write("Hello Android".getBytes());
  } catch (IOException e) {
      e.printStackTrace();
  }

• 读取文件

  File file = new File(getFilesDir(), "example.txt");
  try (FileInputStream fis = new FileInputStream(file)) {
      int size = fis.available();
      byte[] buffer = new byte[size];
      fis.read(buffer);
      String content = new String(buffer);
  } catch (IOException e) {
      e.printStackTrace();
  }

外部存储操作（Android 10+适配）

• 通过MediaStore API写入

  // 创建公共图片文件（Android 10+推荐）
  ContentValues values = new ContentValues();
  values.put(MediaStore.Images.Media.DISPLAY_NAME, "example.png");
  values.put(MediaStore.Images.Media.MIME_TYPE, "image/png");
  Uri uri = getContentResolver().insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
  try (OutputStream os = getContentResolver().openOutputStream(uri)) {
      // 写入文件内容（如Bitmap压缩）
  } catch (IOException e) {
      e.printStackTrace();
  }

• 通过文件路径写入（需权限）

  // 获取外部存储路径（需处理Android 10+限制）
  File externalDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
  File file = new File(externalDir, "example.txt");

SQLite数据库操作

• 创建与升级数据库

  

  public class MyDBHelper extends SQLiteOpenHelper {
      private static final String DATABASE_NAME = "app.db";
      private static final int VERSION = 1;
      @Override
      public void onCreate(SQLiteDatabase db) {
          db.execSQL("CREATE TABLE user (id INTEGER PRIMARY KEY, name TEXT)");
      }
      @Override
      public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
          // 处理数据库升级逻辑
      }
  }

• 增删改查操作

  SQLiteDatabase db = helper.getWritableDatabase();
  // 插入数据
  ContentValues values = new ContentValues();
  values.put("name", "John");
  db.insert("user", null, values);
  // 查询数据
  Cursor cursor = db.query("user", null, null, null, null, null, null);

SharedPreferences操作

• 保存数据

  SharedPreferences prefs = getSharedPreferences("config", MODE_PRIVATE);
  SharedPreferences.Editor editor = prefs.edit();
  editor.putString("username", "admin");
  editor.apply(); // 异步提交

• 读取数据

  SharedPreferences prefs = getSharedPreferences("config", MODE_PRIVATE);
  String username = prefs.getString("username", "default");

权限与兼容性处理

1. 运行时权限申请（Android 6.0+）

   

   // 检查并申请权限
   if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
       ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_CODE);
   }

2. Android 10+分区存储适配

   • 使用Scoped Storage：通过MediaStore或Storage Access Framework操作外部存储。
   • 请求MANAGE_EXTERNAL_STORAGE权限：仅适用于极端场景,需引导用户手动开启。

常见问题与解决方案

相关问题与解答

问题1：如何在Android 11+中申请MANAGE_EXTERNAL_STORAGE权限？

解答：

• 风险提示：此权限属于高危权限，Google Play可能拒绝上架滥用此权限的应用。
• 申请步骤：
  1. 在AndroidManifest.xml中声明权限：

     <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

  2. 引导用户跳转至系统设置页手动开启：

     Intent intent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);
     startActivity(intent);

• 替代方案：优先使用MediaStore或Storage Access Framework（Intent.ACTION_OPEN_DOCUMENT）。

问题2：如何兼容不同Android版本的外部存储路径？

解答：

• 判断SDK版本：

  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
      // Android 10+：使用Scoped Storage或应用专属目录
      File externalDir = getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS);
  } else {
      // Android 9-：直接使用公共目录
      File externalDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
  }

• 关键原则：
  • 避免硬编码路径：使用getExternalFilesDir()、MediaStore等API。
  • 处理权限差异：Android 6.0+需动态申请权限，Android 10+需适配分区