摘要：適配的原則是優(yōu)先黑名單和深灰名單，淺灰名單在官方未有替代之前可以暫時不適配，在上運行也不會有任何問題。除上面兩種適配方式外，音樂目前采用了另外一種方式。隱私安全保護標識修改在中，對隱私保護又做了更加嚴格的要求。

歡迎大家前往騰訊云+社區(qū)，獲取更多騰訊海量技術(shù)實踐干貨哦~

本文由QQ音樂技術(shù)團隊發(fā)表于云+社區(qū)專欄

Android P 這次有很多行為變更，其中不乏一些需要亟需適配的變更。

在 Android 8.0 時代各個手機廠商就開始發(fā)布自己的全面屏手機，但是此時 Android 官方并未支持到該功能，所以各個廠商都各自實現(xiàn)了一套全面屏判斷邏輯，對于開發(fā)者來說甚是麻煩。終于在 Android P 里官方收歸了該功能的判斷邏輯，Android P 和之后的版本完全可以使用官方 API 來判斷全面屏，當然前提是第三方廠商按照 google 官方接口去實現(xiàn)。Android P 版本判斷全面屏代碼很簡單，但是在適配過程中你可能會在網(wǎng)上發(fā)現(xiàn)如下判斷代碼：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
    decorView.setOnApplyWindowInsetsListener(new View.OnApplyWindowInsetsListener() {
        @RequiresApi(api = 28)
        @Override
        public WindowInsets onApplyWindowInsets(View view, WindowInsets windowInsets) {
            if (windowInsets != null) {
                DisplayCutout cutout = windowInsets.getDisplayCutout();
                if (cutout != null) {
                    List rects = cutout.getBoundingRects();
                    //通過判斷是否存在rects來確定是否全面屏手機
                    if (rects != null && rects.size() > 0) {
                        isNotchScreen = true;
                    }
                }
            }
            return windowInsets;
        }
    });
}

這段代碼確實可以判斷出全面屏與否，但是會造成一個很嚴重的后果，就是在某些手機（pixel 和 vivo x21 均出現(xiàn)該情況）上底部導(dǎo)航欄會透明，導(dǎo)致應(yīng)用內(nèi)容會透到導(dǎo)航欄從而被遮擋，大大影響內(nèi)容展示。最后經(jīng)過仔細排查發(fā)現(xiàn)僅僅因為在上面那段代碼中調(diào)用了 setOnApplyWindowInsetsListener 函數(shù)，該函數(shù)在 Android 官網(wǎng)有詳細介紹，是用來在 Android 21 版本之后代替 fitSystemWindows 函數(shù)，目的是讓 View 根據(jù) Window 的縮進進行相應(yīng)處理，調(diào)用后會影響系統(tǒng)狀態(tài)欄和導(dǎo)航欄對應(yīng)用內(nèi)容的展示，對此的介紹資料網(wǎng)上有很多，就不贅述了。真正完美判斷全面屏的代碼如下：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
    WindowInsets windowInsets = decorView.getRootWindowInsets();
    if (windowInsets != null) {
        DisplayCutout displayCutout = windowInsets.getDisplayCutout();
        if (displayCutout != null) {
            List rects = displayCutout.getBoundingRects();
            //通過判斷是否存在rects來確定是否劉海屏手機
            if (rects != null && rects.size() > 0) {
                isNotchScreen = true;
            }
        }
    }
}

Android P 版本最大最嚴格的特性變更應(yīng)該非 SDK 接口限制莫屬了。對于非 SDK API 里面的部分名單來說，就算在不修改 targetSdkVersion 的前提下，不管是直接、反射還是通過 JNI 調(diào)用都會造成調(diào)用失敗、拋出 NoSuchFieldException或 NoSuchMethodException 等嚴重后果，該行為影響范圍波及所有調(diào)用此接口的應(yīng)用。

非 SDK API 名單總共分為三類：light grey list （淺灰名單）、dark grey list （深灰名單）、dark list（黑名單），詳情：

2.2 非 SDK API 名單掃描

所以對于我們應(yīng)用開發(fā)者來說，當前首要任務(wù)是適配深灰名單和黑名單。目前 google 官方提供了一個可以實時查詢?nèi)齻€名單里面 API 列表的網(wǎng)站：https://android.googlesource....。在之前 DP 版本時開發(fā)者如果遇到了不得不使用的黑名單或者深灰名單 API，需要向 google 官方及時提出反饋（反饋url：https://issuetracker.google.c...），申請將其移動到淺灰名單中，但是目前正式版本已經(jīng)發(fā)布，未得知該申請通道是否仍有效。

詳細了解了非 SDK API 之后，下一步當然是將應(yīng)用代碼里面的深灰名單和黑名單 API 調(diào)用找出來一一修改。目前官方提供了一個非常實用的掃描工具，該工具可以把應(yīng)用里面三個類型名單的 API 調(diào)用都掃描出來（但是可能會有遺漏），使用方法也很簡單：

打包一個應(yīng)用 APK，建議使用 release 包，排除一些未使用到的單元測試類或者其他因素的影響，將 APK 放到工具指定目錄下；

執(zhí)行命令 ./appcompat.sh --dex-file=test.apk，在終端上會輸出三個名單每個 API 的詳細調(diào)用處: #1: Linking dark greylist Landroid/os/SystemProperties;->get(Ljava/lang/String;)Ljava/lang/String; use(s): Ltmsdkobf/gv;->a(Ljava/lang/String;)Ljava/lang/String; #2: Linking dark greylist Landroid/os/SystemProperties;->get(Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String; use(s): Ltmsdkobf/gp;->b(Landroid/content/Context;)Ljava/lang/String; ....

經(jīng)過上一步掃描出應(yīng)用內(nèi)非 SDK API 調(diào)用之后，接下來就可以直接開始適配。適配的原則是優(yōu)先黑名單和深灰名單，淺灰名單在官方未有替代 API 之前可以暫時不適配，在 Android P 上運行也不會有任何問題。掃描完成之后，不出意外大家應(yīng)該會有三類需要適配的 API 調(diào)用：

應(yīng)用代碼本身調(diào)用到了非 SDK API 接口； 針對應(yīng)用代碼本身調(diào)用到了非 SDK API 接口，用的比較頻繁的例如 SystemProperties.get，就需要去尋找另外一個可以替代的合法 API，如果找不到就只能認為該 API 調(diào)用失敗從而走失敗邏輯，如果實在必須要用到該 API 就盡早去向 google 申請移動到淺灰名單中。

第三方庫調(diào)用到了非 SDK API 接口； 針對第三方庫調(diào)用到了非 SDK API 接口，解決辦法當然是直接查詢相關(guān)資料或者聯(lián)系庫提供方，確認是否有適配 Android P 新版本的 SDK。還有需要提到的一點，就算更換適配完成的第三方 SDK 后，仍然可能會在同一地方掃描出非 SDK API 的調(diào)用，這是因為適配工程師只是在調(diào)用處加了一個 try-catch 保護邏輯，雖然這樣也勉強叫做適配完成，但是還是強烈建議大家使用如下的適配方式： if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) { // Android P or above } else { // below Android P } 嚴格按照上面的適配方案，掃描工具就不會再掃描出此處的非 SDK API 調(diào)用，我們也無需每次都去確認所有非 SDK API 調(diào)用處都加了保護邏輯。 當然如果第三方庫沒有適配也沒有近期適配的意向，目前有兩種方法：第一種是屏蔽入口；第二種是反編譯 SDK，在關(guān)鍵地方加上適配代碼；

Android 官方庫調(diào)用到了非 SDK API 接口； 沒錯！Android 官方庫也會被掃描出非 SDK API 調(diào)用，針對這種情況，需要分情況討論：

該 API 調(diào)用查看 v7 support 包源碼可以發(fā)現(xiàn)已經(jīng)被 try-catch 住了，測試了相關(guān)類也可以正常運行，而且在適配過程中升級 rc 版本的 support-v7 包會導(dǎo)致應(yīng)用編譯不過，所以目前 QQ 音樂暫時認定無需升級到最新版本的 support-v7。除上面介紹的特殊情況之外還是建議更換最新版本的官方 SDK。

Android P 上對電源管理又做了一系列的改進措施，不管應(yīng)用 targetApi 版本是否已經(jīng)升級到 P，系統(tǒng)都會依據(jù)應(yīng)用最近的使用時間和頻率來給應(yīng)用進行待機分組，然后根據(jù)應(yīng)用所屬群組限制應(yīng)用可以訪問的資源，目前總共有五類分組：

活躍： 一般為正在使用或者在前臺運行的應(yīng)用，例如：

應(yīng)用啟動一個 Activity；

應(yīng)用正在運行前臺 Service；

應(yīng)用的同步適配器關(guān)聯(lián)上了一個前臺應(yīng)用；

用戶點擊了應(yīng)用的一個通知； 系統(tǒng)不會對該類應(yīng)用有任何的限制；

工作集： 應(yīng)用經(jīng)常運行，但是當前未屬于活躍狀態(tài)就會被歸屬于工作集，該群組的應(yīng)用在運行作業(yè)和觸發(fā)鬧鐘方面會被施加輕度的限制；

常用： 應(yīng)用如果被定期使用，但不是每天的話就會被歸到該工作群組。該群組的應(yīng)用在運行作業(yè)和觸發(fā)鬧鐘方面會被施加較強的限制，F(xiàn)CM 消息數(shù)量也會有相關(guān)限制；

極少使用： 應(yīng)用如果不經(jīng)常使用就會被歸到該工作群組，系統(tǒng)會對該群組應(yīng)用運行作業(yè)、觸發(fā)鬧鐘和接收高優(yōu)先級別 FCM 的消息能力方面有嚴格的限制；

從未使用： 安裝但從未被使用過的應(yīng)用會被歸到該工作群組，該工作群組的應(yīng)用會被施加極其嚴格的限制；

更加詳細的表述可以參考官網(wǎng)：App Standby Buckets(https://developer.android.com...，不同群組的限制的詳細表現(xiàn)見：Power management restrictions（鏈接：https://developer.android.com...）。系統(tǒng)會動態(tài)的將手機里面的應(yīng)用分配到這五類群組里面，也會根據(jù)需要變化應(yīng)用群組，同時借助了機器學(xué)習來將一個應(yīng)用放到更合適的群組里。目前應(yīng)用可以通過 UsageStatsManager.getAppStandbyBucket() 函數(shù)來獲取當前所屬的應(yīng)用群組，借助這個結(jié)果來更好的提升自己的打開頻率，同時可以借助此來模擬處于不同群組能否正常工作。另外，位于低電耗模式白名單中的應(yīng)用不適用基于應(yīng)用待機群組的限制。

Android 9 對省電模式又做了很多改進，開啟省電模式之后會有如下限制：

系統(tǒng)會更加積極的將應(yīng)用置于待機模式，不管應(yīng)用是否空閑；

后臺執(zhí)行限制將適用于所有應(yīng)用，無論他們的 targetApi 是多少；

屏幕關(guān)閉時，位置服務(wù)可能被停用；

后臺應(yīng)用沒有網(wǎng)絡(luò)訪問權(quán)限；

這里需要重點介紹一下后臺執(zhí)行限制，該限制于 Android O 版本引入，主要是為了優(yōu)化 Android 在多應(yīng)用多服務(wù)運行時，系統(tǒng)負載過大會殺死后臺音樂播放等服務(wù)導(dǎo)致用戶體驗下降的問題，它默認只對 targetApi 大于等于 26 的應(yīng)用生效。目前用戶可以通過設(shè)置頁面對任意應(yīng)用施加后臺執(zhí)行限制，后臺執(zhí)行限制會對應(yīng)用有兩方面的影響：

后臺服務(wù)限制： 處于前臺（可見、具有前臺服務(wù)或者關(guān)聯(lián)到前臺應(yīng)用）或臨時白名單（處理高優(yōu)先級 FCM、接收短信等廣播或者執(zhí)行通知的 PendingIntent）時，應(yīng)用可以自由創(chuàng)建和運行前臺與后臺服務(wù)。 進入后臺時，在一個持續(xù)數(shù)分鐘的時間窗內(nèi)，應(yīng)用仍可以創(chuàng)建和使用服務(wù)，但是超過該時間之后再通過 startService 去啟動一個服務(wù)就會拋出 java.lang.IllegalStateException: Not allowed to start service Intent 的錯誤，解決辦法是使用 startForegroundService 或者 JobIntentService；

廣播限制: 針對 Android O 和之上的應(yīng)用無法繼續(xù)在其清單中為隱式廣播注冊廣播接收器。

將 compileSdkVersion 升級到 28 之后，如果在項目中用到了 Apache HTTP client 的相關(guān)類，就會拋出找不到這些類的錯誤。這是因為官方已經(jīng)在 Android P 的啟動類加載器中將其移除，如果仍然需要使用 Apache HTTP client，可以在 Manifest 文件中加入：

或者也可以直接將 Apache HTTP client 的相關(guān)類打包進 APK 中。

除上面兩種適配方式外，QQ 音樂目前采用了另外一種方式。在音樂項目中，我們已經(jīng)將使用 Apache HTTP client 的模塊多帶帶抽離到了一個 module 中，所以暫時只需要保持 module 中的 compileSdkVersion 在 28 以下即可正常編譯運行。

在 Android P 中，如果 targeSdkVersion 升級到 28，使用前臺 Service 必須要申請 FOREGROUND_SERVICE 權(quán)限，如果沒有申請該權(quán)限，系統(tǒng)會拋出 SecurityException，該權(quán)限為普通權(quán)限，申請自動授予應(yīng)用。

Build.SERIAL 標識修改：在 Android P 中，對隱私保護又做了更加嚴格的要求。在某些應(yīng)用中為了識別手機的唯一性可能會用到 Build.SERIAL 這個標識，但這個標識在 Android P 中已經(jīng)被設(shè)置成了 UNKNOWN，所以會直接導(dǎo)致該功能出現(xiàn)異常。

多進程 webview 信息訪問限制：在 Android P 中為了提升系統(tǒng)的安全性，用戶無法在多進程的 webview 中共享數(shù)據(jù)目錄，該目錄下存儲的是一些 cookies、Http 緩存和其他一些永久、臨時的緩存。當下不少應(yīng)用會把 webview 放在另一個進程中打開以避免內(nèi)存泄漏，但是他們 cookies 的設(shè)置往往還是在主進程中，所以開發(fā)者需要仔細排查自己的應(yīng)用是否有這么使用，webview 相關(guān)運行是否正常等。

升級到 28 之后，應(yīng)用編譯后拋出 com.android.internal 包下面有些類找不到的異常，經(jīng)過查找發(fā)現(xiàn)這些類已經(jīng)從 SDK 中移除。針對這種情況目前有兩種處理辦法：

移除該類的調(diào)用邏輯；

在應(yīng)用中新建一個同名類，將被移除類的所有代碼邏輯復(fù)制到新建類中（必要時可能需要將被移除類相關(guān)類同時拷貝一份到應(yīng)用中），然后將應(yīng)用中所有相關(guān) import 引用直接修改成新建類的包名引用即可；

Android P 這次當然也有很多豐富的特性，總結(jié)了兩個對于第三方應(yīng)用開發(fā)者比較實用的特性

。

HEIF（High Efficiency Image Format），高幀率圖片格式，采用的是 HEVC 編碼格式。蘋果于 iOS11 版本開始支持該圖片格式，而 Android 則是在 Android O MR1 版本開始支持 HEIF 靜態(tài)圖的軟解碼，在 P 版本上完全支持該格式的軟編解碼。HEIF 格式的壓縮率是 JPEG 的 2.39 倍，同等大小質(zhì)量的圖片可節(jié)省 50% 的空間和網(wǎng)絡(luò)傳輸流量，而且支持動圖。HEIF 格式比起 GIF 格式來說有著更好的圖片展示效果，所以 HEIF 格式圖片的目標是用來代替 JPEG 成為主流的圖片壓縮格式。HEIF 格式圖片的擴展名為 .heif 或者 .heic：

看上去很美好，但是目前還不是所有的 Android P 機型都會支持 HEIF 格式硬編解碼，因為這需要特殊的硬件支持同時還需要繳納一定的專利費，所以在編解碼效率上就會有機型差異，同時 Android P 軟編解碼也只能支持靜態(tài) HEIF 格式圖片。目前開發(fā)者可以通過版本來判斷是否支持 HEIF 編解碼，判斷邏輯如下：

fun supportHEIF() = Build.VERSION.SDK_INT >= Build.VERSION_CODES.P

解碼代碼也很簡單，支持將 HEIF 格式圖片解碼成 Bitmap 和 Drawable：

@TargetApi(28)
fun decodeHEIFDrawable(filePath: String): Drawable? {
    if (!supportHEIF()) {
        return null
    }
    var source: ImageDecoder.Source = ImageDecoder.createSource(File(filePath))
    return ImageDecoder.decodeDrawable(source)
}

@RequiresApi(28)
fun decodeHEIFBitmap(filePath: String): Bitmap? {
    if (!supportHEIF()) {
        return null
    }
    var source: ImageDecoder.Source = ImageDecoder.createSource(File(filePath))
    return ImageDecoder.decodeBitmap(source)
}

另外掃描本地圖片則繼續(xù)使用 ContentResolver 即可，如果設(shè)備支持 HEIF 格式，系統(tǒng)會自動掃描上 HEIF 格式的圖片：

var cursor : Cursor = getContext().getContentResolver().query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, null, null, null, null)

但是這樣還遠遠沒有適配完成，第三方應(yīng)用適配 HEIF 格式圖片有一個很困難的地方是本地雖然可以識別解碼 HEIF 格式的圖片，但是如果某個用戶將其設(shè)置為頭像上傳到后臺，后臺將其下發(fā)給其他不支持 HEIF 圖片格式解碼的手機，這些手機就肯定有展示問題。解決這個問題目前有兩種思路：

終端在上傳之前將其轉(zhuǎn)碼成 JPEG 格式的圖片，但是這樣就根本沒有充分利用到 HEIF 圖片的高壓縮率的優(yōu)勢；

在到達后端之后，后端將其轉(zhuǎn)碼成 JPEG 圖片，同時保存一份 HEIF 和 JEPG，到時候根據(jù)用戶是否可以解碼 HEIF 下發(fā)不同格式圖片。該方案可以充分利用 HEIF 的優(yōu)點，但是大大增加了后端存儲空間和開發(fā)工作量。

上面已經(jīng)介紹到了 ImageDecoder 在解碼 HEIF 圖片中的應(yīng)用，但是實際它的功能完全不僅于此，在 Android P 中它可以完全替代 BitmapFactory 和 BitmapFactory.Options 相關(guān)類。ImageDocoder 類可以通過字節(jié)數(shù)據(jù)、文件和 URI 來解碼一張圖片。用法和之前一樣，首先通過 createSource 方法創(chuàng)建一個圖片文件的 ImageDecoder.Source 對象，然后調(diào)用 decodeDrawable 或者 decodeBitmap 方法傳入之前的 ImageDecoder.Source 對象就能生成圖片的 Drawable 或者 Bitmap 對象引用。ImageDecoder 支持 PNG、JPEG、WEBP、GIF 和 HEIF 多種格式圖片的解碼，另外解碼 GIF 或者 WEBP 格式圖片得到的是一個 AnimatedImageDrawable 對象，AnimatedImageDrawable 類的工作原理和 AnimatedVectorDrawable 類似，都是使用一個工作線程來解碼，所以解碼線程和顯示線程互不干擾。AnimatedImageDrawable 用法也很簡單：

var drawable: Drawable = ImageDecoder.decodeDrawable(source);
if (drawable is AnimatedImageDrawable){
    image.setImageDrawable(drawable)
    drawable.start()
}

ImageDecoder 除了基礎(chǔ)的解碼功能之外，還有很多非常實用的方法，比如通過設(shè)置 OnHeaderDecodedListener 就可以在解析圖片之前獲取到圖片的寬高等信息，同時還可以根據(jù)需要設(shè)置采樣率：

val listener = object : OnHeaderDecodedListener {
    fun onHeaderDecoded(decoder: ImageDecoder, info: ImageInfo, source: Source) {
        decoder.setTargetSampleSize(2)
    }
}
val drawable = ImageDecoder.decodeDrawable(source, listener)

另外還可以通過 setPostProcessor 方法來添加一些自定義的效果，比如最常用的切圓角：

var drawable = ImageDecoder.decodeDrawable(source) { decoder, info, src ->
    decoder.setPostProcessor { canvas ->
        val path = Path()
        path.setFillType(Path.FillType.INVERSE_EVEN_ODD)
        val width = canvas.getWidth()
        val height = canvas.getHeight()
        path.addRoundRect(0, 0, width, height, 20, 20, Path.Direction.CW)
        val paint = Paint()
        paint.setAntiAlias(true)
        paint.setColor(Color.TRANSPARENT)
        paint.setXfermode(PorterDuffXfermode(PorterDuff.Mode.SRC))
        canvas.drawPath(path, paint)
        PixelFormat.TRANSLUCENT
    }
}

非常便捷。用法遠不僅于此，有了 Canvas 對象，開發(fā)者完全可以發(fā)揮想象去實現(xiàn)自己想要的炫酷效果。另外如果解碼的圖片不完整或者包含錯誤，一般情況下會拋出 DecodeException，但是如果這個時候通過 setOnPartialImageListener 函數(shù)傳遞一個 OnPartialImageListener 對象，并且在 onPartialImage 函數(shù)中返回 true，則圖片就會只展示解析成功的一部分而不會拋出 DecodeException：

var drawable = ImageDecoder.decodeDrawable(source) { decoder, info, src ->
    decoder.setOnPartialImageListener { e: ImageDecoder.DecodeException ->
        true
    }
}

https://developer.android.goo... https://mp.weixin.qq.com/s/03ospQEdY5HLdYqxEiDX1g https://blog.csdn.net/GenlanF... https://developer.android.com/about/versions/pie/power https://segmentfault.com/a/11...
問答
Android - 如何修復(fù)權(quán)限異常？
相關(guān)閱讀
Android音頻系統(tǒng)
Android 基本常識
Android全局異常處理 
【每日課程推薦】機器學(xué)習實戰(zhàn)！快速入門在線廣告業(yè)務(wù)及CTR相應(yīng)知識

此文已由作者授權(quán)騰訊云+社區(qū)發(fā)布，更多原文請點擊

搜索關(guān)注公眾號「云加社區(qū)」，第一時間獲取技術(shù)干貨，關(guān)注后回復(fù)1024 送你一份技術(shù)課程大禮包！

海量技術(shù)實踐經(jīng)驗，盡在云加社區(qū)！