Android N系列適配---FileProvider
Android 7.0的適配，主要包含方面：
- Android 7.0 主要功能的diff---介紹主要Android7.0功能以及行為變更
- Android 7.0 最重要的一環(huán)適配---FileProvider的適配
- Android 7.0 對(duì)常規(guī)三方的影響---UIL為例
Android 7.0 功能diff---詳細(xì)介紹Android7.0擁有的功能
- 多窗口支持：
- 用戶(hù)可以一次在屏幕上打開(kāi)兩個(gè)應(yīng)用，或者處于分屏模式時(shí)一個(gè)應(yīng)用位于另一個(gè)應(yīng)用之上。 用戶(hù)可以通過(guò)拖動(dòng)兩個(gè)應(yīng)用之間的分隔線來(lái)調(diào)整應(yīng)用。
- 在 Android TV 設(shè)備上，應(yīng)用可以將自身置于畫(huà)中畫(huà)模式，從而讓它們可以在用戶(hù)瀏覽或與其他應(yīng)用交互時(shí)繼續(xù)顯示內(nèi)容。
- 可以指定app Activity大小，防止用戶(hù)調(diào)整到該尺寸以下
- 通知增強(qiáng)功能：
- 模板更新
- 少量代碼調(diào)整，即可使用新的通知模版開(kāi)發(fā)
- 消息樣式更新
- MessageStyle 類(lèi)，可配置消息，會(huì)話(huà)標(biāo)題，以及內(nèi)容視圖
- 捆綁通知
- 系統(tǒng)可以將消息按一定規(guī)律給組合，如消息主題，用戶(hù)可以適當(dāng)?shù)倪M(jìn)行Dismiss和Archive等操作
- 直接回復(fù)
- 即時(shí)通訊應(yīng)用，支持用戶(hù)直接在通知界面中快速回復(fù)消息
- 自定義視圖
- 兩個(gè)新的 API，使用自定義視圖時(shí)可以充分利用系統(tǒng)裝飾元素，如通知標(biāo)題和操作
- 模板更新
- Project Svelte 后臺(tái)優(yōu)化：
- 刪除了三個(gè)常用隱式廣播，繼續(xù)擴(kuò)展 JobScheduler 和 GCMNetworkManager
- apk signature scheme V2
- 新的應(yīng)用簽名方案
- Android Studio 2.2 和 Android Gradle 2.2 插件會(huì)使用 APK
- 附上官方鏈接：
https://developer.android.com/about/versions/nougat/android-7.0.html#multi-window_support
行為變更和影響
- 當(dāng)設(shè)備處于低電耗，首先會(huì)限制，關(guān)閉應(yīng)用網(wǎng)絡(luò)訪問(wèn)，推遲作業(yè)和同步，一定時(shí)間后，會(huì)對(duì)除去PowerManager.WakeLock和Alarmmanager鬧鈴，GPS和WIFI掃描以外的進(jìn)行低電耗限制
- 后臺(tái)優(yōu)化，刪除了三個(gè)隱式廣播，如果app用到了，需要及時(shí)的解除關(guān)系
- 應(yīng)用間共享文件的修改
- 無(wú)障礙改進(jìn)，屏幕縮放，設(shè)置向?qū)е幸曈X(jué)設(shè)置
- 附上官方鏈接：
https://developer.android.com/about/versions/nougat/android-7.0-changes.html
Android 7.0 FileProvider的適配
- 是什么
- 關(guān)于安卓7.0的適配，其中變更最大的就是FileProvider，關(guān)于FileProvider并不是最新出來(lái)的東西，而是以前就已經(jīng)存在，由于Android的安全機(jī)制 ，一個(gè)進(jìn)程默認(rèn)不能影響另外一個(gè)進(jìn)程的，如讀取私有數(shù)據(jù) 。 那么對(duì)于進(jìn)程間的文件的共享 ，出于安全考慮，用FileProvider。FileProvider會(huì)基于manifest中的定義定義的一個(gè)xml文件（xml目錄 下），為所有定義的文件生成content URIs，這樣外部的應(yīng)用在沒(méi)有權(quán)限的情況下，可以通過(guò)授予臨時(shí)權(quán)限的content uri，讀取相應(yīng)的文件。
FileProvider是v4 support中的類(lèi) ， 就繼承ContentProvider。也就是說(shuō)content:// Uri 代替了 file:/// Uri. 在Android7.0時(shí)候，為了安全，谷歌把它作為了一個(gè)強(qiáng)制使用而已。針對(duì)file://URI，需要通過(guò)FileProvider來(lái)轉(zhuǎn)換成content://URI進(jìn)行訪問(wèn)。
- 關(guān)于安卓7.0的適配，其中變更最大的就是FileProvider，關(guān)于FileProvider并不是最新出來(lái)的東西，而是以前就已經(jīng)存在，由于Android的安全機(jī)制 ，一個(gè)進(jìn)程默認(rèn)不能影響另外一個(gè)進(jìn)程的，如讀取私有數(shù)據(jù) 。 那么對(duì)于進(jìn)程間的文件的共享 ，出于安全考慮，用FileProvider。FileProvider會(huì)基于manifest中的定義定義的一個(gè)xml文件（xml目錄 下），為所有定義的文件生成content URIs，這樣外部的應(yīng)用在沒(méi)有權(quán)限的情況下，可以通過(guò)授予臨時(shí)權(quán)限的content uri，讀取相應(yīng)的文件。
- 限制
- 那么會(huì)有人要問(wèn)，是否所有需要從本地存儲(chǔ)的東西都會(huì)被限制呢，其實(shí)不然，谷歌做這項(xiàng)規(guī)定主要是針對(duì)，包含文件 URI 的 Intent 離開(kāi)你的應(yīng)用，換句話(huà)說(shuō)，如果你的Intent中用到了Uri，這個(gè)時(shí)候你就需要提防一下了，比如說(shuō)，你使用到了圖片裁剪等功能。
- 怎么做
-
第一步：
- 全局找出項(xiàng)目中，需要修改的地方，如下：
- Uri.parse、Uri.fromFile、file://、content://、Context.getFilesDir()、Environment.getExternalStorageDirectory()、getCacheDir()以及最終要的intent.setDataAndType(為什么需要找這個(gè)，因?yàn)檫@個(gè)會(huì)攜帶uri進(jìn)行傳遞，這個(gè)是重頭戲)
-
第二步：
- 找到罪魁禍?zhǔn)字?，需要按照步驟適配了，依次順序是，清單文件的修改，資源文件的修改，以及Java代碼中的修改
-
第三步：
-
清單文件的修改---清單文件中，添加provider標(biāo)簽即可
<provider android:exported="false" android:grantUriPermissions="true" android:authorities="com.***.fileprovider" android:name="android.support.v4.content.FileProvider"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths" ></meta-data> </provider>
-
-
第四步：
-
創(chuàng)建res/xml/filepaths.xml文件
< paths xmlns:android="http://schemas.android.com/apk/res/android"> <external-path path="" name="external-path" /> <files-path path="" name="files_path" /> <cache-path path="" name="cache-path" /> </paths> 在這個(gè)文件中，為每個(gè)目錄添加一個(gè)XML元素指定目錄。paths 可以添加多個(gè)子路徑：< files-path> 分享app內(nèi)部的存儲(chǔ)；< external-path> 分享外部的存儲(chǔ);< cache-path> 分享內(nèi)部緩存目錄。
< files-path >
代表目錄為：Context.getFilesDir()<external-path>
代表目錄為:Environment.getExternalStorageDirectory()<cache-path>
代表目錄為：getCacheDir()那么又存在了一個(gè)問(wèn)題，國(guó)內(nèi)由于rom眾多，會(huì)產(chǎn)生各種路徑，比如華為的/system/media/，以及外置sdcard,像此類(lèi)路徑該如何適配呢？
< root-path path="" name="root-path" />
在這里又有人要問(wèn)了，為什么要加root_path就管用，下面我們就一起再追蹤一下源碼
-
我們打開(kāi)FileProvider的源碼
public class FileProvider extends ContentProvider -
開(kāi)篇就能看見(jiàn)幾個(gè)變量
private static final String TAG_ROOT_PATH = "root-path"; private static final String TAG_FILES_PATH = "files-path"; private static final String TAG_CACHE_PATH = "cache-path"; private static final String TAG_EXTERNAL = "external-path"; -
里面有個(gè)重要方法parsePathStrategy，從xml我們定義臨時(shí)授權(quán)的路徑file_paths.xml中，解析以及對(duì)比路徑
while ((type = in.next()) != END_DOCUMENT) { if (type == START_TAG) { final String tag = in.getName(); final String name = in.getAttributeValue(null, ATTR_NAME); String path = in.getAttributeValue(null, ATTR_PATH); File target = null; if (TAG_ROOT_PATH.equals(tag)) { target = buildPath(DEVICE_ROOT, path); } else if (TAG_FILES_PATH.equals(tag)) { target = buildPath(context.getFilesDir(), path); } else if (TAG_CACHE_PATH.equals(tag)) { target = buildPath(context.getCacheDir(), path); } else if (TAG_EXTERNAL.equals(tag)) { target = buildPath(Environment.getExternalStorageDirectory(), path); } if (target != null) { strat.addRoot(name, target); } } } -
buildPath(DEVICE_ROOT, path)這個(gè)方法甚是晃眼
private static final File DEVICE_ROOT = new File("/"); -
到這里，我們應(yīng)該就明白了，這個(gè)root代表的是根路徑，如果還不明白，我們可以進(jìn)入adb試一下
MacBook-Pro:~ baidu$ adb shell bullhead:/ $ cd / bullhead:/ $ ls -
然后出現(xiàn)的路徑是
acct config dev mnt property_contexts sbin sys cache d etc oem res sdcard system charger data firmware proc root storage vendor 然后我們就看到了熟悉的system 以及sdcard等,到這里我們就徹底明白，root_path是為我們的根路徑進(jìn)行了臨時(shí)授權(quán)，如果要訪問(wèn)系統(tǒng)system以及外置sdcard的話(huà)，在這里將得到授權(quán)。
那么又有個(gè)問(wèn)題，如果我寫(xiě)了root_path的話(huà)，其他的file_path等是不是就不用寫(xiě)了呢，答案是可以的，已經(jīng)試驗(yàn)，確實(shí)可以。不過(guò)反過(guò)來(lái)想，如果每次都對(duì)根路徑進(jìn)行授權(quán)，那么這個(gè)FileProvider是不是意義就不大了呢，相當(dāng)于安全性還是沒(méi)有防護(hù)，所以，谷歌的良苦用心，我們還需要理解，大家授權(quán)的時(shí)候，還是要把所有的路徑，能詳細(xì)的，盡量詳細(xì)一下。
附：至于為何path="",這里要寫(xiě)空，原因是空表示根目錄都可以進(jìn)行查找，當(dāng)然如果路徑確定，可以寫(xiě)成path="images/"，這表示直接適配了images這個(gè)文件夾，也就是可以在這個(gè)文件夾下查找，而在這個(gè)文件夾外，照舊會(huì)報(bào)錯(cuò)。后面尾隨的這個(gè)name，則可以隨意寫(xiě)，當(dāng)FileProvider轉(zhuǎn)換路徑的時(shí)候，就會(huì)用此name代替，比如
content://com.***.fileprovider/myimages/default_image.jpg
-
-
第五步：
- 在java代碼中使用
//得到緩存路徑的Uri Uri contentUri = FileProvider.getUriForFile(getActivity(), "com.***.fileprovider", file); //獲取壁紙 Intent intent = WallpaperManager.getInstance(getActivity()).getCropAndSetWallpaperIntent(contentUri); //開(kāi)啟一個(gè)Activity顯示圖片，可以將圖片設(shè)置為壁紙。調(diào)用的是系統(tǒng)的壁紙管理。 getActivity().startActivityForResult(intent, ViewerActivity.REQUEST_CODE_SET_WALLPAPER);
這樣是否大功告成？？？
-
java中使用，需要的權(quán)限，intent攜帶的讀寫(xiě)權(quán)限
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION); 你以為這樣就真的完事兒了？
-
在適配過(guò)程中，發(fā)現(xiàn)有時(shí)候addFlag并不能完全的擁有權(quán)限，需要grantUriPermission獲取權(quán)限
context.grantUriPermission(packageName, uri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION); -
附上福利工具類(lèi)
/** * Android N 適配工具類(lèi) */ public class NougatTools { /** * 將普通uri轉(zhuǎn)化成適應(yīng)7.0的content://形式 針對(duì)文件格式 * * @param context 上下文 * @param file 文件路徑 * @param intent intent * @param type 圖片或者文件,0表示圖片,1表示文件 * @param intentType intent.setDataAndType * @return */ public static Intent formatFileProviderIntent( Context context, File file, Intent intent, String intentType) { Uri uri = FileProvider.getUriForFile(context, GlobalDef.nougatFileProvider, file); // 表示文件類(lèi)型 intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION); intent.setDataAndType(uri, intentType); return intent; } /** * 將普通uri轉(zhuǎn)化成適應(yīng)7.0的content://形式 針對(duì)圖片格式 * * @param context 上下文 * @param file 文件路徑 * @param intent intent * @param intentType intent.setDataAndType * @return */ public static Intent formatFileProviderPicIntent( Context context, File file, Intent intent) { Uri uri = FileProvider.getUriForFile(context, GlobalDef.nougatFileProvider, file); List<ResolveInfo> resInfoList = context.getPackageManager().queryIntentActivities( intent, PackageManager.MATCH_DEFAULT_ONLY); for (ResolveInfo resolveInfo : resInfoList) { String packageName = resolveInfo.activityInfo.packageName; context.grantUriPermission(packageName, uri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION); } // 表示圖片類(lèi)型 intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); return intent; } /** * 將普通uri轉(zhuǎn)化成適應(yīng)7.0的content://形式 * * @return */ public static Uri formatFileProviderUri(Context context, File file) { Uri uri = FileProvider.getUriForFile(context, GlobalDef.nougatFileProvider, file); return uri; } }
-
Android 7.0對(duì)三方工具的影響
UIL(Universal-Image-Loader)為例
關(guān)于imageloader適配，加載了本地圖片，竟然沒(méi)有問(wèn)題
final ImageView imageView = (ImageView) LayoutInflater.from(context).inflate(R.layout.view_banner, null);
String imageUri = "/mnt/sdcard/image.png";
ImageLoader.getInstance().displayImage("file://"+imageUri, imageView);
-
如果想找到為何沒(méi)有影響，需要讀imageloader源碼，直接從imageloader中的加載圖片displayImage方法入手
public void displayImage(String uri, ImageAware imageAware, DisplayImageOptions options, ImageLoadingListener listener, ImageLoadingProgressListener progressListener) -
找到bmp != null && !bmp.isRecycled()判斷，如果沒(méi)有從本地找到或者被回收掉了的話(huà)，直接走LoadAndDisplayImageTask，去加載圖片
Bitmap bmp = configuration.memoryCache.get(memoryCacheKey); if (bmp != null && !bmp.isRecycled()) { L.d(LOG_LOAD_IMAGE_FROM_MEMORY_CACHE, memoryCacheKey); if (options.shouldPostProcess()) { ImageLoadingInfo imageLoadingInfo = new ImageLoadingInfo(uri, imageAware, targetSize, memoryCacheKey, options, listener, progressListener, engine.getLockForUri(uri)); ProcessAndDisplayImageTask displayTask = new ProcessAndDisplayImageTask(engine, bmp, imageLoadingInfo, defineHandler(options)); if (options.isSyncLoading()) { displayTask.run(); } else { engine.submit(displayTask); } } else { options.getDisplayer().display(bmp, imageAware, LoadedFrom.MEMORY_CACHE); listener.onLoadingComplete(uri, imageAware.getWrappedView(), bmp); } } else { if (options.shouldShowImageOnLoading()) { imageAware.setImageDrawable(options.getImageOnLoading(configuration.resources)); } else if (options.isResetViewBeforeLoading()) { imageAware.setImageDrawable(null); } ImageLoadingInfo imageLoadingInfo = new ImageLoadingInfo(uri, imageAware, targetSize, memoryCacheKey, options, listener, progressListener, engine.getLockForUri(uri)); LoadAndDisplayImageTask displayTask = new LoadAndDisplayImageTask(engine, imageLoadingInfo, defineHandler(options)); if (options.isSyncLoading()) { displayTask.run(); } else { engine.submit(displayTask); } } -
在LoadAndDisplayImageTask的run方法中，會(huì)判斷是否bitmap為空，這樣的話(huà)，就會(huì)嘗試load Bitmap
if (bmp == null || bmp.isRecycled()) { bmp = tryLoadBitmap(); -
這里才是加載圖片的關(guān)鍵，首先去判斷磁盤(pán)是否存在圖片，如果存在，則直接從磁盤(pán)加載圖片，如果本地沒(méi)有，則取網(wǎng)絡(luò)獲取圖片。
private Bitmap tryLoadBitmap() throws TaskCancelledException { Bitmap bitmap = null; try { File imageFile = configuration.diskCache.get(uri); if (imageFile != null && imageFile.exists() && imageFile.length() > 0) { L.d(LOG_LOAD_IMAGE_FROM_DISK_CACHE, memoryCacheKey); loadedFrom = LoadedFrom.DISC_CACHE; checkTaskNotActual(); bitmap = decodeImage(Scheme.FILE.wrap(imageFile.getAbsolutePath())); } if (bitmap == null || bitmap.getWidth() <= 0 || bitmap.getHeight() <= 0) { L.d(LOG_LOAD_IMAGE_FROM_NETWORK, memoryCacheKey); loadedFrom = LoadedFrom.NETWORK; String imageUriForDecoding = uri; if (options.isCacheOnDisk() && tryCacheImageOnDisk()) { imageFile = configuration.diskCache.get(uri); if (imageFile != null) { imageUriForDecoding = Scheme.FILE.wrap(imageFile.getAbsolutePath()); } } checkTaskNotActual(); bitmap = decodeImage(imageUriForDecoding); if (bitmap == null || bitmap.getWidth() <= 0 || bitmap.getHeight() <= 0) { fireFailEvent(FailType.DECODING_ERROR, null); } } } catch (IllegalStateException e) { fireFailEvent(FailType.NETWORK_DENIED, null); } catch (TaskCancelledException e) { throw e; } catch (IOException e) { L.e(e); fireFailEvent(FailType.IO_ERROR, e); } catch (OutOfMemoryError e) { L.e(e); fireFailEvent(FailType.OUT_OF_MEMORY, e); } catch (Throwable e) { L.e(e); fireFailEvent(FailType.UNKNOWN, e); } return bitmap; } -
首次進(jìn)入肯定是bitmap是空的，找到tryCacheImageOnDisk方法
private boolean tryCacheImageOnDisk() throws TaskCancelledException { L.d(LOG_CACHE_IMAGE_ON_DISK, memoryCacheKey); boolean loaded; try { loaded = downloadImage(); if (loaded) { int width = configuration.maxImageWidthForDiskCache; int height = configuration.maxImageHeightForDiskCache; if (width > 0 || height > 0) { L.d(LOG_RESIZE_CACHED_IMAGE_FILE, memoryCacheKey); resizeAndSaveImage(width, height); // TODO : process boolean result } } } catch (IOException e) { L.e(e); loaded = false; } return loaded; } -
里面清晰的可以看見(jiàn)，有個(gè)downloadImage方法
private boolean downloadImage() throws IOException { InputStream is = getDownloader().getStream(uri, options.getExtraForDownloader()); if (is == null) { L.e(ERROR_NO_IMAGE_STREAM, memoryCacheKey); return false; } else { try { return configuration.diskCache.save(uri, is, this); } finally { IoUtils.closeSilently(is); } } } downloadImage方法中，獲取到了一個(gè)Downloader，通過(guò)uri獲取流
-
看看downloader是啥，有個(gè)子類(lèi)BaseImageDownloader，看里面的getStream方法
public InputStream getStream(String imageUri, Object extra) throws IOException { switch (Scheme.ofUri(imageUri)) { case HTTP: case HTTPS: return getStreamFromNetwork(imageUri, extra); case FILE: return getStreamFromFile(imageUri, extra); case CONTENT: return getStreamFromContent(imageUri, extra); case ASSETS: return getStreamFromAssets(imageUri, extra); case DRAWABLE: return getStreamFromDrawable(imageUri, extra); case UNKNOWN: default: return getStreamFromOtherSource(imageUri, extra); } } -
那么問(wèn)題就來(lái)了，我們傳入的是file：//前綴，會(huì)最終到downloader中獲取stream，繼續(xù)看看getStreamFromFile
protected InputStream getStreamFromFile(String imageUri, Object extra) throws IOException { String filePath = Scheme.FILE.crop(imageUri); if (isVideoFileUri(imageUri)) { return getVideoThumbnailStream(filePath); } else { BufferedInputStream imageStream = new BufferedInputStream(new FileInputStream(filePath), BUFFER_SIZE); return new ContentLengthInputStream(imageStream, (int) new File(filePath).length()); } } -
顯而易見(jiàn)，crop方法有問(wèn)題
public String crop(String uri) { if (!belongsTo(uri)) { throw new IllegalArgumentException(String.format("URI [%1$s] doesn't have expected scheme [%2$s]", uri, scheme)); } return uri.substring(uriPrefix.length()); } -
uri.substring，有點(diǎn)意思，從uriPrefix的長(zhǎng)度開(kāi)始截取
Scheme(String scheme) { this.scheme = scheme; uriPrefix = scheme + "://"; } 這樣就很明白了，UIL這個(gè)框架，直接從"file:// "往后，把具體的地址截取出來(lái)了，而且它直接用后面的地址獲取到了InputStream，這樣就可以避免7.0這個(gè)file://需要換成content://的問(wèn)題，而避免了使用FileProvider。
-
最后附上一個(gè)沒(méi)問(wèn)題的例子。
FileInputStream fileInputStream = new FileInputStream("/storage/emulated/0/Download/com.***.apk");
