一撰茎、概述

之前項(xiàng)目的新特性適配工作都是同事在做，一直沒有怎么太關(guān)注帮辟，不過類似這些適配的工作還是有必要做一些記錄的速址。

對(duì)于Android 7.0，提供了非常多的變化由驹，詳細(xì)的可以閱讀官方文檔Android 7.0 行為變更芍锚，記得當(dāng)時(shí)做了多窗口支持、FileProvider以及7.1的3D Touch的支持蔓榄，不過和我們開發(fā)者關(guān)聯(lián)最大的并炮，或者說必須要適配的就是去除項(xiàng)目中傳遞file://類似格式的uri了。

在官方7.0的以上的系統(tǒng)中甥郑，嘗試傳遞 file://URI可能會(huì)觸發(fā)FileUriExposedException逃魄。

所以本文主要描述如何適配該問題，沒什么難度壹若，僅做記錄嗅钻。

注：本文targetSdkVersion 25 皂冰，compileSdkVersion 25

二、拍照案例

大家應(yīng)該對(duì)于手機(jī)拍照一定都不陌生养篓，在希望得到一張高清拍照?qǐng)D的時(shí)候秃流，我們通過Intent會(huì)傳遞一個(gè)File的Uri給相機(jī)應(yīng)用。

大致代碼如下:

private static final int REQUEST_CODE_TAKE_PHOTO = 0x110;
    private String mCurrentPhotoPath;

    public void takePhotoNoCompress(View view) {
        Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
        if (takePictureIntent.resolveActivity(getPackageManager()) != null) {

            String filename = new SimpleDateFormat("yyyyMMdd-HHmmss", Locale.CHINA)
                    .format(new Date()) + ".png";
            File file = new File(Environment.getExternalStorageDirectory(), filename);
            mCurrentPhotoPath = file.getAbsolutePath();

            takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(file));
            startActivityForResult(takePictureIntent, REQUEST_CODE_TAKE_PHOTO);
        }
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (resultCode == RESULT_OK && requestCode == REQUEST_CODE_TAKE_PHOTO) {
            mIvPhoto.setImageBitmap(BitmapFactory.decodeFile(mCurrentPhotoPath));
        }
        // else tip?

    }

貼個(gè)效果圖吧~

image

未處理6.0權(quán)限柳弄，有需要的自行處理下舶胀，nexus系列如果未處理连躏，需要手動(dòng)在設(shè)置頁開啟存儲(chǔ)權(quán)限懒棉。

此時(shí)如果我們使用Android 7.0或者以上的原生系統(tǒng)，再次運(yùn)行一下战虏，你會(huì)發(fā)現(xiàn)應(yīng)用直接停止運(yùn)行萍丐，拋出了android.os.FileUriExposedException：

Caused by: android.os.FileUriExposedException: 
    file:///storage/emulated/0/20170601-030254.png 
        exposed beyond app through ClipData.Item.getUri()
    at android.os.StrictMode.onFileUriExposed(StrictMode.java:1932)
    at android.net.Uri.checkFileUriExposed(Uri.java:2348)

所以如果你意識(shí)到自己寫的代碼轩端，在7.0的原生系統(tǒng)的手機(jī)上直接就crash是不是很方~

原因在官網(wǎng)已經(jīng)給了解釋：

對(duì)于面向 Android 7.0 的應(yīng)用，Android 框架執(zhí)行的 StrictMode API 政策禁止在您的應(yīng)用外部公開 file:// URI逝变。如果一項(xiàng)包含文件 URI 的 intent 離開您的應(yīng)用基茵，則應(yīng)用出現(xiàn)故障，并出現(xiàn) FileUriExposedException 異常壳影。

同樣的拱层，官網(wǎng)也給出了解決方案：

要在應(yīng)用間共享文件，您應(yīng)發(fā)送一項(xiàng) content:// URI宴咧，并授予 URI 臨時(shí)訪問權(quán)限根灯。進(jìn)行此授權(quán)的最簡單方式是使用 FileProvider 類。如需了解有關(guān)權(quán)限和共享文件的詳細(xì)信息掺栅，請(qǐng)參閱共享文件烙肺。
https://developer.android.com/about/versions/nougat/android-7.0-changes.html#accessibility

那么下面就看看如何通過FileProvider解決此問題吧。

三氧卧、使用FileProvider兼容拍照

其實(shí)對(duì)于如何使用FileProvider茬高，其實(shí)在FileProvider的API頁面也有詳細(xì)的步驟，有興趣的可以看下假抄。

https://developer.android.com/reference/android/support/v4/content/FileProvider.html

FileProvide實(shí)際上是ContentProvider的一個(gè)子類，它的作用也比較明顯了丽猬，file:///Uri不給用宿饱，那么換個(gè)Uri為content://來替代。

下面我們看下整體的實(shí)現(xiàn)步驟脚祟，并考慮為什么需要怎么做谬以？

3.1 聲明provider

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="com.zhy.android7.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

為什么要聲明呢？因?yàn)镕ileProvider是ContentProvider子類哇~~

注意一點(diǎn)由桌，他需要設(shè)置一個(gè)meta-data为黎，里面指向一個(gè)xml文件邮丰。

3.2 編寫resource xml file

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <root-path name="root" path="" />
    <files-path name="files" path="" />
    <cache-path name="cache" path="" />
    <external-path name="external" path="" />
    <external-files-path name="name" path="path" />
     <external-cache-path name="name" path="path" />
</paths>

在paths節(jié)點(diǎn)內(nèi)部支持以下幾個(gè)子節(jié)點(diǎn)，分別為：

<root-path/> 代表設(shè)備的根目錄new File("/");
<files-path/> 代表context.getFilesDir()
<cache-path/> 代表context.getCacheDir()
<external-path/> 代表Environment.getExternalStorageDirectory()
<external-files-path>代表context.getExternalFilesDirs()
<external-cache-path>代表getExternalCacheDirs()

每個(gè)節(jié)點(diǎn)都支持兩個(gè)屬性：

• name
• path
  path即為代表目錄下的子目錄铭乾，比如：

<external-path
        name="external"
        path="pics" />

代表的目錄即為：Environment.getExternalStorageDirectory()/pics剪廉，其他同理。

當(dāng)這么聲明以后炕檩，代碼可以使用你所聲明的當(dāng)前文件夾以及其子文件夾斗蒋。

本例使用的是SDCard所以這么寫即可：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="external" path="" />
</paths>

為了簡單，我們直接使用SDCard根目錄笛质，所以path里面就不填寫子目錄了~

這里你可能會(huì)有疑問泉沾，為什么要寫這么個(gè)xml文件，有啥用呀妇押？

剛才我們說了跷究，現(xiàn)在要使用content://uri替代file://uri，那么敲霍，content://的uri如何定義呢俊马？總不能使用文件路徑吧，那不是騙自己么~

所以色冀，需要一個(gè)虛擬的路徑對(duì)文件路徑進(jìn)行映射潭袱，所以需要編寫個(gè)xml文件，通過path以及xml節(jié)點(diǎn)確定可訪問的目錄锋恬，通過name屬性來映射真實(shí)的文件路徑屯换。

3.3 使用FileProvider API

好了，接下來就可以通過FileProvider把我們的file轉(zhuǎn)化為content://uri了~

public void takePhotoNoCompress(View view) {
        Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
        if (takePictureIntent.resolveActivity(getPackageManager()) != null) {

            String filename = new SimpleDateFormat("yyyyMMdd-HHmmss", Locale.CHINA)
                    .format(new Date()) + ".png";
            File file = new File(Environment.getExternalStorageDirectory(), filename);
            mCurrentPhotoPath = file.getAbsolutePath();

            Uri fileUri = FileProvider.getUriForFile(this, "com.zhy.android7.fileprovider", file);
            takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, fileUri);
            startActivityForResult(takePictureIntent, REQUEST_CODE_TAKE_PHOTO);
        }
    }

核心代碼就這一行了~

FileProvider.getUriForFile(this, "com.zhy.android7.fileprovider", file);

第二個(gè)參數(shù)就是我們配置的authorities与学，這個(gè)很正常了彤悔，總得映射到確定的ContentProvider吧~所以需要這個(gè)參數(shù)。

然后再看一眼我們生成的uri：

content://com.zhy.android7.fileprovider/external/20170601-041411.png

可以看到格式為：content://authorities/定義的name屬性/文件的相對(duì)路徑索守，即name隱藏了可存儲(chǔ)的文件夾路徑晕窑。

現(xiàn)在拿7.0的原生手機(jī)運(yùn)行就正常啦~

不過事情到此并沒有結(jié)束~~

打開一個(gè)4.4的模擬器，運(yùn)行上述代碼卵佛，你會(huì)發(fā)現(xiàn)又Crash啦,拋出了：Permission Denial~

Caused by: java.lang.SecurityException: Permission Denial: opening provider android.support.v4.content.FileProvider from ProcessRecord{52b029b8 1670:com.android.camera/u0a36} (pid=1670, uid=10036) that is not exported from uid 10052
at android.os.Parcel.readException(Parcel.java:1465)
at android.os.Parcel.readException(Parcel.java:1419)
at android.app.ActivityManagerProxy.getContentProvider(ActivityManagerNative.java:2848)
at android.app.ActivityThread.acquireProvider(ActivityThread.java:4399)

因?yàn)榈桶姹镜南到y(tǒng)杨赤，僅僅是把這個(gè)當(dāng)成一個(gè)普通的Provider在使用，而我們沒有授權(quán)截汪，contentprovider的export設(shè)置的也是false疾牲；導(dǎo)致Permission Denial。

那么衙解，我們是否可以將export設(shè)置為true呢阳柔？

很遺憾是不能的。

在FileProvider的內(nèi)部：

@Override
public void attachInfo(Context context, ProviderInfo info) {
    super.attachInfo(context, info);

    // Sanity check our security
    if (info.exported) {
        throw new SecurityException("Provider must not be exported");
    }
    if (!info.grantUriPermissions) {
        throw new SecurityException("Provider must grant uri permissions");
    }

    mStrategy = getPathStrategy(context, info.authority);
}

確定了exported必須是false蚓峦，grantUriPermissions必須是true ~~

所以唯一的辦法就是授權(quán)了~

context提供了兩個(gè)方法：

• grantUriPermission(String toPackage, Uri uri,
  int modeFlags)
• revokeUriPermission(Uri uri, int modeFlags)

可以看到grantUriPermission需要傳遞一個(gè)包名舌剂，就是你給哪個(gè)應(yīng)用授權(quán)济锄，但是很多時(shí)候，比如分享霍转，我們并不知道最終用戶會(huì)選擇哪個(gè)app荐绝，所以我們可以這樣：

List<ResolveInfo> resInfoList = context.getPackageManager()
            .queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
for (ResolveInfo resolveInfo : resInfoList) {
    String packageName = resolveInfo.activityInfo.packageName;
    context.grantUriPermission(packageName, uri, flag);
}

根據(jù)Intent查詢出的所以符合的應(yīng)用，都給他們授權(quán)~~

恩谴忧，你可以在不需要的時(shí)候通過revokeUriPermission移除權(quán)限~

那么增加了授權(quán)后的代碼是這樣的：

public void takePhotoNoCompress(View view) {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    if (takePictureIntent.resolveActivity(getPackageManager()) != null) {

        String filename = new SimpleDateFormat("yyyyMMdd-HHmmss", Locale.CHINA)
                .format(new Date()) + ".png";
        File file = new File(Environment.getExternalStorageDirectory(), filename);
        mCurrentPhotoPath = file.getAbsolutePath();

        Uri fileUri = FileProvider.getUriForFile(this, "com.zhy.android7.fileprovider", file);

        List<ResolveInfo> resInfoList = getPackageManager()
                .queryIntentActivities(takePictureIntent, PackageManager.MATCH_DEFAULT_ONLY);
        for (ResolveInfo resolveInfo : resInfoList) {
            String packageName = resolveInfo.activityInfo.packageName;
            grantUriPermission(packageName, fileUri, Intent.FLAG_GRANT_READ_URI_PERMISSION
                    | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
        }

        takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, fileUri);
        startActivityForResult(takePictureIntent, REQUEST_CODE_TAKE_PHOTO);
    }
}

這樣就搞定了很泊，不過還是挺麻煩的，如果你僅僅是對(duì)舊系統(tǒng)做兼容沾谓，還是建議做一下版本校驗(yàn)即可委造，也就是說不要管什么授權(quán)了，直接這樣獲取uri

Uri fileUri = null;
if (Build.VERSION.SDK_INT >= 24) {
    fileUri = FileProvider.getUriForFile(this, "com.zhy.android7.fileprovider", file);
} else {
    fileUri = Uri.fromFile(file);
}

這樣會(huì)比較方便_{也避免導(dǎo)致一些問題均驶。當(dāng)然了昏兆，完全使用uri也有一些好處，比如你可以使用私有目錄去存儲(chǔ)拍攝的照片}

文章最后會(huì)給出快速適配的方案~_{不需要這么麻煩}

好像妇穴，還有什么知識(shí)點(diǎn)沒有提到爬虱，再看一個(gè)例子吧~

四、使用FileProvider兼容安裝apk

正常我們?cè)诰帉懓惭bapk的時(shí)候腾它，是這樣的：

public void installApk(View view) {
    File file = new File(Environment.getExternalStorageDirectory(), "testandroid7-debug.apk");

    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setDataAndType(Uri.fromFile(file),
            "application/vnd.android.package-archive");
    startActivity(intent);
}

拿個(gè)7.0的原生手機(jī)跑一下跑筝，android.os.FileUriExposedException又來了~~

android.os.FileUriExposedException: file:///storage/emulated/0/testandroid7-debug.apk exposed beyond app through Intent.getData()

好在有經(jīng)驗(yàn)了，簡單修改下uri的獲取方式瞒滴。

if (Build.VERSION.SDK_INT >= 24) {
    fileUri = FileProvider.getUriForFile(this, "com.zhy.android7.fileprovider", file);
} else {
    fileUri = Uri.fromFile(file);
}

再跑一次曲梗，沒想到還是拋出了異常（警告，沒有Crash）:

java.lang.SecurityException: Permission Denial: 
opening provider android.support.v4.content.FileProvider 
        from ProcessRecord{18570a 27107:com.google.android.packageinstaller/u0a26} (pid=27107, uid=10026) that is not exported from UID 10004

可以看到是權(quán)限問題妓忍，對(duì)于權(quán)限我們剛說了一種方式為grantUriPermission虏两，這種方式當(dāng)然是沒問題的啦~

加上后運(yùn)行即可。

其實(shí)對(duì)于權(quán)限世剖，還提供了一種方式定罢，即：

intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

我們可以在安裝包之前加上上述代碼，再次運(yùn)行正常啦~

現(xiàn)在我有兩個(gè)非常疑惑的問題：

• 問題1：為什么剛才拍照的時(shí)候旁瘫，Android 7的設(shè)備并沒有遇到Permission Denial的問題祖凫？

恩，之所以不需要權(quán)限酬凳，主要是因?yàn)?code>Intent的action為ACTION_IMAGE_CAPTURE蝙场，當(dāng)我們startActivity后，會(huì)輾轉(zhuǎn)調(diào)用Instrumentation的execStartActivity方法粱年，在該方法內(nèi)部，會(huì)調(diào)用intent.migrateExtraStreamToClipData();方法罚拟。

該方法中包含：

if (MediaStore.ACTION_IMAGE_CAPTURE.equals(action)
        || MediaStore.ACTION_IMAGE_CAPTURE_SECURE.equals(action)
        || MediaStore.ACTION_VIDEO_CAPTURE.equals(action)) {
    final Uri output;
    try {
        output = getParcelableExtra(MediaStore.EXTRA_OUTPUT);
    } catch (ClassCastException e) {
        return false;
    }
    if (output != null) {
        setClipData(ClipData.newRawUri("", output));
        addFlags(FLAG_GRANT_WRITE_URI_PERMISSION|FLAG_GRANT_READ_URI_PERMISSION);
        return true;
    }
}

可以看到將我們的EXTRA_OUTPUT台诗，轉(zhuǎn)為了setClipData完箩，并直接給我們添加了WRITE和READ權(quán)限。

注：該部分邏輯應(yīng)該是21之后添加的拉队。

問題2：為什么剛才拍照案例的時(shí)候弊知，Android 4.4設(shè)備遇到權(quán)限問題，不通過addFlags這種方式解決粱快？
因?yàn)閍ddFlags主要用于setData秩彤，setDataAndType以及setClipData（注意：4.4時(shí)，并沒有將ACTION_IMAGE_CAPTURE轉(zhuǎn)為setClipData實(shí)現(xiàn)）這種方式事哭。

所以addFlags方式對(duì)于ACTION_IMAGE_CAPTURE在5.0以下是無效的漫雷，所以需要使用grantUriPermission，如果是正常的通過setData分享的uri鳍咱，使用addFlags是沒有問題的（可以寫個(gè)簡單的例子測試下降盹，兩個(gè)app交互，通過content://）谤辜。

五蓄坏、總結(jié)

終于將知識(shí)點(diǎn)都涵蓋到了~

總結(jié)下，使用content://替代file://丑念，主要需要FileProvider的支持涡戳，而因?yàn)?code>FileProvider是ContentProvider的子類，所以需要在AndroidManifest.xml中注冊(cè)脯倚；
而又因?yàn)樾枰獙?duì)真實(shí)的filepath進(jìn)行映射渔彰，所以需要編寫一個(gè)xml文檔，用于描述可使用的文件夾目錄挠将，以及通過name去映射該文件夾目錄胳岂。

對(duì)于權(quán)限，有兩種方式：

• 方式一為Intent.addFlags舔稀，該方式主要用于針對(duì)intent.setData乳丰，setDataAndType以及setClipData相關(guān)方式傳遞uri的。
• 方式二為grantUriPermission來進(jìn)行授權(quán)

相比來說方式二較為麻煩内贮，因?yàn)樾枰付繕?biāo)應(yīng)用包名产园，很多時(shí)候并不清楚，所以需要通過PackageManager進(jìn)行查找到所有匹配的應(yīng)用夜郁，全部進(jìn)行授權(quán)什燕。不過更為穩(wěn)妥~

方式一較為簡單，對(duì)于intent.setData竞端，setDataAndType正常使用即可屎即，但是對(duì)于setClipData，由于5.0前后Intent#migrateExtraStreamToClipData，代碼發(fā)生變化技俐，需要注意~

好了乘陪，看到現(xiàn)在是不是覺得適配7.0挺麻煩的，其實(shí)一點(diǎn)都不麻煩雕擂，下面給大家總結(jié)一種快速適配的方式啡邑。

六、快速完成適配

6.1 新建一個(gè)module

創(chuàng)建一個(gè)library的module井赌，在其AndroidManifest.xml中完成FileProvider的注冊(cè)谤逼，代碼編寫為：

<application>
    <provider
        android:name="android.support.v4.content.FileProvider"
        android:authorities="${applicationId}.android7.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

注意一點(diǎn)，android:authorities不要寫死仇穗，因?yàn)樵?code>library最終可能會(huì)讓多個(gè)項(xiàng)目引用流部，而android:authorities是不可以重復(fù)的，如果兩個(gè)app中定義了相同的仪缸，則后者無法安裝到手機(jī)中（authority conflict）贵涵。

同樣的的編寫file_paths~

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <root-path
        name="root"
        path="" />
    <files-path
        name="files"
        path="" />

    <cache-path
        name="cache"
        path="" />

    <external-path
        name="external"
        path="" />

    <external-files-path
        name="external_file_path"
        path="" />
    <external-cache-path
        name="external_cache_path"
        path="" />

</paths>

最后再編寫一個(gè)輔助類，例如：

public class FileProvider7 {

    public static Uri getUriForFile(Context context, File file) {
        Uri fileUri = null;
        if (Build.VERSION.SDK_INT >= 24) {
            fileUri = getUriForFile24(context, file);
        } else {
            fileUri = Uri.fromFile(file);
        }
        return fileUri;
    }

    public static Uri getUriForFile24(Context context, File file) {
        Uri fileUri = android.support.v4.content.FileProvider.getUriForFile(context,
                context.getPackageName() + ".android7.fileprovider",
                file);
        return fileUri;
    }

    public static void setIntentDataAndType(Context context,
                                            Intent intent,
                                            String type,
                                            File file,
                                            boolean writeAble) {
        if (Build.VERSION.SDK_INT >= 24) {
            intent.setDataAndType(getUriForFile(context, file), type);
            intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
            if (writeAble) {
                intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
            }
        } else {
            intent.setDataAndType(Uri.fromFile(file), type);
        }
    }
}

可以根據(jù)自己的需求添加方法恰画。

好了宾茂，這樣我們的一個(gè)小庫就寫好了~~

6.2 使用

如果哪個(gè)項(xiàng)目需要適配7.0，那么只需要這樣引用這個(gè)庫拴还，然后只需要改動(dòng)一行代碼即可完成適配啦跨晴，例如：

6.2.1 拍照

public void takePhotoNoCompress(View view) {
        Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
        String filename = new SimpleDateFormat("yyyyMMdd-HHmmss", Locale.CHINA)
                .format(new Date()) + ".png";
        File file = new File(Environment.getExternalStorageDirectory(), filename);
        mCurrentPhotoPath = file.getAbsolutePath();

        Uri fileUri = FileProvider7.getUriForFile(this, file);
        takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, fileUri);
        startActivityForResult(takePictureIntent, REQUEST_CODE_TAKE_PHOTO);
    }
}

只需要改動(dòng)

 Uri fileUri = FileProvider7.getUriForFile(this, file);

即可。

6.2.2 安裝apk

同樣的修改setDataAndType為：

FileProvider7.setIntentDataAndType(this, intent, "application/vnd.android.package-archive", file, true);

即可片林。

ok端盆，繁瑣的重復(fù)性操作終于簡化為一行代碼啦~

源碼地址：
https://github.com/hongyangAndroid/FitAndroid7