Android 11 外部存儲權(quán)限適配指南及方案

前言

  • 首先 Android 的權(quán)限大致分為三種：

  • 普通權(quán)限：只需要在清單文件中注冊即可

  • 危險權(quán)限：需要在代碼中動態(tài)申請，以彈系統(tǒng) Dialog 的形式進行請求

  • 特殊權(quán)限：需要在代碼中動態(tài)申請，以跳系統(tǒng) Activity 的形式進行請求

  • 而我們今天要講的主題，是關(guān)于存儲權(quán)限，在 Android 6.0 之后就變成了危險權(quán)限，而到了 Android 11 上面變成了特殊權(quán)限，而最明顯的區(qū)別是一個是通過 Dialog 展示給用戶看，另外一個是通過 Activity 展現(xiàn)給用戶看。

  • 從危險權(quán)限到特殊權(quán)限，這不單單是權(quán)限的屬性發(fā)生了變化，還是申請方式的發(fā)生了不同

Android 10.0 以下外部存儲權(quán)限適配

  • 升級 targetSdkVersion
android 
    defaultConfig {
        targetSdkVersion 23
    }
}
  • 添加清單權(quán)限
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  • 代碼動態(tài)申請
public final class PermissionActivity extends AppCompatActivity {

    private static final int REQUEST_CODE = 1024;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        requestPermission();
    }

    private void requestPermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            // 先判斷有沒有權(quán)限
            if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED &&
                    ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED) {
                writeFile();
            } else {
                ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE, Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_CODE);
            }
        } else {
            writeFile();
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == REQUEST_CODE) {
            if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED &&
                    ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED) {
                writeFile();
            } else {
                ToastUtils.show("存儲權(quán)限獲取失敗");
            }
        }
    }

    /**
     * 模擬文件寫入
     */
    private void writeFile() {
        ToastUtils.show("寫入文件成功");
    }
}
  • 需要注意的是，如果 targetSdkVersion >= 29 上，還需要在清單文件中加上
<application
    android:requestLegacyExternalStorage="true">
  • 否則就算申請了存儲權(quán)限，在安卓 10.0 的設(shè)備上將無法正常讀寫外部存儲上的文件

Android 11 及以上申請外部存儲權(quán)限

  • 升級 targetSdkVersion
android 
    defaultConfig {
        targetSdkVersion 30
    }
}
  • 添加清單權(quán)限
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
  • 代碼動態(tài)申請
public final class PermissionActivity extends AppCompatActivity {

    private static final int REQUEST_CODE = 1024;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        requestPermission();
    }

    private void requestPermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            // 先判斷有沒有權(quán)限
            if (Environment.isExternalStorageManager()) {
                writeFile();
            } else {
                Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
                intent.setData(Uri.parse("package:" + context.getPackageName()));
                startActivityForResult(intent, REQUEST_CODE);
            }
        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            // 先判斷有沒有權(quán)限
            if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED &&
                    ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED) {
                writeFile();
            } else {
                ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE, Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_CODE);
            }
        } else {
            writeFile();
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == REQUEST_CODE) {
            if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED &&
                    ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED) {
                writeFile();
            } else {
                ToastUtils.show("存儲權(quán)限獲取失敗");
            }
        }
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == REQUEST_CODE && Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            if (Environment.isExternalStorageManager()) {
                writeFile();
            } else {
                ToastUtils.show("存儲權(quán)限獲取失敗");
            }
        }
    }

    /**
     * 模擬文件寫入
     */
    private void writeFile() {
        ToastUtils.show("寫入文件成功");
    }
}

解決方案

  • 看到這里，可能大家心里就會有一些想法了：

    • 申請個權(quán)限還要寫那么多代碼，感覺心好累！

    • 為什么那么麻煩？有沒有更簡單的寫法或方式？

  • 答案當然是有了，并且還是一句代碼就能搞定

XXPermissions.with(this)
        // 不適配 Android 11 可以這樣寫
        //.permission(Permission.Group.STORAGE)
        // 適配 Android 11 需要這樣寫，這里無需再寫 Permission.Group.STORAGE
        .permission(Permission.MANAGE_EXTERNAL_STORAGE)
        .request(new OnPermissionCallback() {

            @Override
            public void onGranted(List<String> permissions, boolean all) {
                if (all) {
                    toast("獲取存儲權(quán)限成功");
                }
            }

            @Override
            public void onDenied(List<String> permissions, boolean never) {
                if (never) {
                    toast("被永久拒絕授權(quán)，請手動授予存儲權(quán)限");
                    // 如果是被永久拒絕就跳轉(zhuǎn)到應用權(quán)限系統(tǒng)設(shè)置頁面
                    XXPermissions.startPermissionActivity(MainActivity.this, permissions);
                } else {
                    toast("獲取存儲權(quán)限失敗");
                }
            }
        });
  • 驚不驚喜意不意外開不開心？有了這款框架，你幾乎可以零成本適配 Android 11 外部存儲新特性，萬萬沒想到版本適配原來可以這么簡單。

框架地址

Android 技術(shù)討論 Q 群：10047167

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容