Android 12 快速適配要點

Android 12 需要更新適配點并不多,本篇主要介紹最常見的兩個需要適配的點:android:exportedSplashScreen

一、android:exported

它主要是設置 Activity 是否可由其他應用的組件啟動, “true” 則表示可以,而“false”表示不可以。

若為“false”,則 Activity 只能由同一應用的組件或使用同一用戶 ID 的不同應用啟動。

當然不止是 ActivityServiceReceiver 也會有 exported 的場景。

一般情況下如果使用了 intent-filter,則不能將 exported 設置為“false,不然在 Activity 被調用時系統會拋出 ActivityNotFoundException 異常。

相反如果沒有 intent-filter,那就不應該把 Activityexported 設置為true這可能會在安全掃描時被定義為安全漏洞

而在 Android 12 的平臺上,也就是使用 targetSdkVersion 31 時,那么你就需要注意:

如果 ActivityServiceReceiver 使用 intent-filter ,并且未顯式聲明 android:exported 的值,App 將會無法安裝。

這時候你可能會選擇去 AndroidManifest 一個一個手動修改,但是如果你使用的 SDK 或者第三方庫沒有支持怎么辦?或者你想要打出不同 target 平臺的包?這時候下面這段 gradle 腳本可以給你省心:

com.android.tools.build:gradle:3.4.3 以下版本

/**
 * 修改 Android 12 因為 exported 的構建問題
 */
android.applicationVariants.all { variant ->
    variant.outputs.all { output ->
        output.processResources.doFirst { pm ->
            String manifestPath = output.processResources.manifestFile
            def manifestFile = new File(manifestPath)
            def xml = new XmlParser(false, true).parse(manifestFile)
            def exportedTag = "android:exported"
            ///指定 space
            def androidSpace = new groovy.xml.Namespace('http://schemas.android.com/apk/res/android', 'android')

            def nodes = xml.application[0].'*'.findAll {
                //挑選要修改的節點,沒有指定的 exported 的才需要增加
                (it.name() == 'activity' || it.name() == 'receiver' || it.name() == 'service') && it.attribute(androidSpace.exported) == null

            }
            ///添加 exported,默認 false
            nodes.each {
                def isMain = false
                it.each {
                    if (it.name() == "intent-filter") {
                        it.each {
                            if (it.name() == "action") {
                                if (it.attributes().get(androidSpace.name) == "android.intent.action.MAIN") {
                                    isMain = true
                                    println("......................MAIN FOUND......................")
                                }
                            }
                        }
                    }
                }
                it.attributes().put(exportedTag, "${isMain}")
            }

            PrintWriter pw = new PrintWriter(manifestFile)
            pw.write(groovy.xml.XmlUtil.serialize(xml))
            pw.close()
        }
    }

}

com.android.tools.build:gradle:4.1.0 以上版本

/**
 * 修改 Android 12 因為 exported 的構建問題
 */

android.applicationVariants.all { variant ->
    variant.outputs.each { output ->
        def processManifest = output.getProcessManifestProvider().get()
        processManifest.doLast { task ->
            def outputDir = task.multiApkManifestOutputDirectory
            File outputDirectory
            if (outputDir instanceof File) {
                outputDirectory = outputDir
            } else {
                outputDirectory = outputDir.get().asFile
            }
            File manifestOutFile = file("$outputDirectory/AndroidManifest.xml")
            println("----------- ${manifestOutFile} ----------- ")

            if (manifestOutFile.exists() && manifestOutFile.canRead() && manifestOutFile.canWrite()) {
                def manifestFile = manifestOutFile
                ///這里第二個參數是 false ,所以 namespace 是展開的,所以下面不能用 androidSpace,而是用 nameTag
                def xml = new XmlParser(false, false).parse(manifestFile)
                def exportedTag = "android:exported"
                def nameTag = "android:name"
                ///指定 space
                //def androidSpace = new groovy.xml.Namespace('http://schemas.android.com/apk/res/android', 'android')

                def nodes = xml.application[0].'*'.findAll {
                    //挑選要修改的節點,沒有指定的 exported 的才需要增加
                    //如果 exportedTag 拿不到可以嘗試 it.attribute(androidSpace.exported)
                    (it.name() == 'activity' || it.name() == 'receiver' || it.name() == 'service') && it.attribute(exportedTag) == null

                }
                ///添加 exported,默認 false
                nodes.each {
                    def isMain = false
                    it.each {
                        if (it.name() == "intent-filter") {
                            it.each {
                                if (it.name() == "action") {
                                    //如果 nameTag 拿不到可以嘗試 it.attribute(androidSpace.name)
                                    if (it.attributes().get(nameTag) == "android.intent.action.MAIN") {
                                        isMain = true
                                        println("......................MAIN FOUND......................")
                                    }
                                }
                            }
                        }
                    }
                    it.attributes().put(exportedTag, "${isMain}")
                }

                PrintWriter pw = new PrintWriter(manifestFile)
                pw.write(groovy.xml.XmlUtil.serialize(xml))
                pw.close()

            }

        }
    }
}

com.android.tools.build:gradle:7.0.3 以下版本

調試中,目前 AGP 有奇怪的 Bug,XmlUtil 無法正常序列化。

這段腳本你可以直接放到 app/build.gradle 下執行,也可以單獨放到一個 gradle 文件之后 apply 引入,它的作用就是:

在打包過程中檢索所有沒有設置 exported 的組件,給他們動態配置上 exported。這里有個特殊需要注意的是,因為啟動 Activity 默認就是需要被 Launcher 打開的,所以 "android.intent.action.MAIN" 需要 exported 設置為 true 。(PS:應該是用 LAUNCHER 類別,這里故意用 MAIN

如果有需要,還可以自己增加判斷設置了 "intent-filter" 的才配置 exported

二、SplashScreen

Android 12 新增加了 SplashScreen 的 API,它包括啟動時的進入應用的動作、顯示應用的圖標畫面,以及展示應用本身的過渡效果。

image

它大概由如下 4 個部分組成,這里需要注意:

  • 1 最好是矢量的可繪制對象,當然它可以是靜態或動畫形式。
  • 2 是可選的,也就是圖標的背景。
  • 與自適應圖標一樣,前景的三分之一被遮蓋 (3)。
  • 4 就是窗口背景。

啟動畫面動畫機制由進入動畫和退出動畫組成。

  • 進入動畫由系統視圖到啟動畫面組成,這由系統控制且不可自定義。
  • 退出動畫由隱藏啟動畫面的動畫運行組成。如果要對其進行自定義,可以通過 SplashScreenView 自定義。
image

更詳細的介紹這里就不展開了,有興趣的可以自己看官方的資料: https://developer.android.com/guide/topics/ui/splash-screen ,這里主要介紹下如何適配和使用的問題。

首先不管你的 TargetSDK 什么版本,當你運行到 Android 12 的手機上時,所有的 App 都會增加 SplashScreen 的功能

如果你什么都不做,那 App 的 Launcher 圖標會變成 SplashScreen 界面的那個圖標,而對應的原主題下 windowBackground 屬性指定的顏色,就會成為 SplashScreen 界面的背景顏色。這個啟動效果在所有應用的冷啟動和熱啟動期間會出現。

其實不適配好像也沒啥問題。

關于如何遷移和使用 SplashScreen 可以查閱官方詳細文檔: https://developer.android.com/guide/topics/ui/splash-screen/migrate

另外還可以參考 《Jetpack新成員SplashScreen:打造全新的App啟動畫面》 這篇文章,文章詳細介紹了如果使用官方的 Jetpack 庫來讓這個效果適配到更低的 Target 平臺。

而正常情況下我們可以做的就是:

  • 1、升級 compileSdkVersion 31targetSdkVersion 31 & buildToolsVersion '31.0.0'
  • 2、 添加依賴 implementation "androidx.core:core-splashscreen:1.0.0-alpha02"
  • 3、增加 values-v31 的目錄
  • 4、添加 styles.xml 對應的主題,例如:
<resources>
    <style name="LaunchTheme" parent="Theme.SplashScreen">
        <item name="windowSplashScreenBackground">@color/splashScreenBackground</item>
        <!--<item name="windowSplashScreenAnimatedIcon">@drawable/splash</item>-->
        <item name="windowSplashScreenAnimationDuration">500</item>
        <item name="postSplashScreenTheme">@style/AppTheme</item>
    </style>
</resources>
  • 5、給你的啟動 Activity 添加這個主題,不同目錄下使用不同主題來達到適配效果。

PS: 我個人是一點都不喜歡這個玩意。

三、其他

1、通知中心又又又變了

Android 12 更改了可以完全自定義通知外觀和行為,以前自定義通知能夠使用整個通知區域并提供自己的布局和樣式,現在它行為變了

使用 TargetSDK 為 31 的 App,包含自定義內容視圖的通知將不再使用完整通知區域;而是使用系統標準模板。

此模板可確保自定義通知在所有狀態下都與其他通知長得一模一樣,例如在收起狀態下的通知圖標和展開功能,以及在展開狀態下的通知圖標、應用名稱和收起功能,與 Notification.DecoratedCustomViewStyle 的行為幾乎完全相同。

image

2、Android App Links 驗證

Android App Links 是一種特殊類型的 DeepLink ,用于讓 Web 直接在 Android 應用中打開相應對應 App 內容而無需用戶選擇應用。使用它需要執行以下步驟:

如何使用可查閱:https://developer.android.com/training/app-links/verify-site-associations#auto-verification

使用 TargetSDK 為 31 的 App,系統對 Android App Links 的驗證方式進行了一些調整,這些調整會提升應用鏈接的可靠性。

如果你的 App 是依靠 Android App Links 驗證在應用中打開網頁鏈接,那么在為 Android App Links 驗證添加 intent 過濾器時,請確保使用正確的格式,尤其需要注意的是確保這些 intent-filter 包含 BROWSABLE 類別并支持 https 方案

3、安全和隱私設置

3.1、大致位置

使用 TargetSDK 為 31 的 App,用戶可以請求應用只能訪問大致位置信息

如果 App 請求 ACCESS_COARSE_LOCATION 但未請求 ACCESS_FINE_LOCATION 那么不會有任何影響。

TargetSDK 為 31 的 App 請求 ACCESS_FINE_LOCATION 運行時權限,還必須請求 ACCESS_COARSE_LOCATION 權限。當 App 同時請求這兩個權限時,系統權限對話框將為用戶提供以下新選項:

image

3.2、SameSite Cookie

Cookie 的 SameSite 屬性決定了它是可以與任何請求一起發送,還是只能與同站點請求一起發送。

  • 沒有 SameSite 屬性的 Cookie 被視為 SameSite=Lax
  • 帶有 SameSite=None 的 Cookie 還必須指定 Secure 屬性,這意味著它們需要安全的上下文,需要通過 HTTPS 發送。
  • 站點的 HTTP 版本和 HTTPS 版本之間的鏈接現在被視為跨站點請求,因此除非將 Cookie 正確標記為 SameSite=None; Secure,否則 Cookie 不會被發送。

WebView devtools切換界面標志 webview-enable-modern-cookie-same-site,可以在測試設備上手動啟用 SameSite 行為。

4、應用休眠

Android 12 在 Android 11(API 級別 30)中引入的自動重置權限行為 的基礎上進行了擴展。

如果 TargetSDK 為 31 的 App 用戶幾個月不打開,則系統會自動重置授予的所有權限并將App 置于休眠狀態。

更多可以查閱:https://developer.android.com/topic/performance/app-hibernation

四、最后

大致需要注意的就是這些,基本上其實除了 exprotedSplashScreen 之外,其他基本都不怎么需要適配,事實上 SplashScreen 我個人覺得會很遭產品嫌棄,畢竟 Material Design 在國內的待遇確實有點慘,沒辦法去掉 SplashScreen 這點估計需要和產品扯皮一段時間,不過產品和設計一般沒有 Android 手機,何況 Android 12,所以日后再說吧~

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,797評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,179評論 3 414
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,628評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,642評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,444評論 6 405
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,948評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,040評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,185評論 0 287
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,717評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,602評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,794評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,316評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,045評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,418評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,671評論 1 281
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,414評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,750評論 2 370

推薦閱讀更多精彩內容