1、背景

最近對(duì)我的應(yīng)用做了一些小的改動(dòng)尼桶，準(zhǔn)備上架 Google Play. 本以為小事一樁鸟缕，沒想到要做非常多的改動(dòng)。其中一個(gè)改動(dòng)是谷歌要求 billing 庫升級(jí)到 4.0 及以上版本蜕径。此外，另一個(gè)比較大的改動(dòng)是要求升級(jí)目標(biāo)版本到 31.

我之前從 29 升級(jí)到 30 那次改動(dòng)已經(jīng)非常大了败京。這次應(yīng)該不會(huì)太多改動(dòng)兜喻，沒想到總歸還是 too young too simple, sometimes naive. 升級(jí)目標(biāo)版本到 31 也不是那么簡單。下面是谷歌官方提供的兩個(gè)文章赡麦，分別詳細(xì)列舉了升級(jí)到版本的變更以及升級(jí)到 Android 12 的詳細(xì)的變更：

符合 Google Play 的目標(biāo) API 級(jí)別要求

行為變更：以 Android 12 為目標(biāo)平臺(tái)的應(yīng)用

谷歌官方已經(jīng)給了詳細(xì)的說明朴皆，這里我分享我在適配過程中遇到的問題和解決思路。

2泛粹、exported 屬性

本次適配需要做的最明顯的一個(gè)變更是修改 exported 屬性遂铡。這個(gè)屬性是之前就存在。我之前只在個(gè)別幾個(gè) Service 屬性中使用了它晶姊。在 31 上開始要求開發(fā)者明確指定組件的 exported 屬性扒接。

對(duì)于沒有聲明 exported 屬性的應(yīng)用，在啟動(dòng)的過程中就會(huì)拋出如下異常们衙，

對(duì)于 exported 屬性钾怔，你可以查看谷歌官方文檔的詳細(xì)解釋：android:exported

適配這個(gè)屬性并不難，只需要在 manifest 中明確指定每個(gè)組件的 exported 屬性即可砍艾。一般來說，遵循如下原則：如果組件中使用了 intent-filter 等屬性巍举，那么它大概率是需要對(duì)外暴露的脆荷，此時(shí)需要將 exported 屬性直為 true，其他情況下置為 false 即可懊悯。蜓谋。

對(duì)于引用的三方類庫中的 xml 屬性也可以通過覆寫聲明方式增加 exported 以兼容處理，

<activity android:name="com.squareup.leakcanary.internal.DisplayLeakActivity"
    android:exported="false"/>

3炭分、PendingIntent 的變動(dòng)

這是一個(gè)隱藏的變動(dòng)桃焕，非常坑又不像 exported 屬性那樣容易被察覺捧毛。這邊變動(dòng)主要是要求開發(fā)者指定在創(chuàng)建 PendingIntent 的時(shí)候傳入的 flags 參數(shù)的可變性观堂。

這可以通過在之前的 flags 基礎(chǔ)上增加 FLAG_MUTABLE 和 FLAG_IMMUTABLE 兩個(gè)屬性來完成让网。比如，之前我的 flags 是师痕，PendingIntent.FLAG_CANCEL_CURRENT溃睹，當(dāng)我想將其修改為不可變的時(shí)候，就可以使用如下方式進(jìn)行修改：

val flags = PendingIntent.FLAG_CANCEL_CURRENT or PendingIntent.FLAG_IMMUTABLE

它可能是需要改動(dòng)最多的一個(gè)變動(dòng)胰坟，根據(jù)我在項(xiàng)目中修改的情況來看因篇，以下幾個(gè)場景需要排查：

• 桌面小控件 Appwidget
• 通知 Notification
• 桌面快捷方式 Shortcut

同時(shí)從幾個(gè)方向來檢索項(xiàng)目中需要改動(dòng)的地方：

• 直接檢索 PendingIntent 的 flags 的調(diào)用，比如 FLAG_ONE_SHOT, FLAG_NO_CREATE, FLAG_CANCEL_CURRENT 和 FLAG_UPDATE_CURRENT 等笔横，建議查看源碼之后進(jìn)行檢索
• PendingIntent 的靜態(tài)方法工廠竞滓，比如 PendingIntent.getBroadcast()、PendingIntent.getActivity() 等吹缔。因?yàn)樯逃樱@取 PendingIntent 的時(shí)候需要指定 flags 參數(shù)。

那么涛菠，另一個(gè)問題來了莉御，究竟什么時(shí)候該選擇 FLAG_MUTABLE，什么時(shí)候該選擇 FLAG_IMMUTABLE 呢俗冻？

它的注釋是這么說的礁叔，

Flag indicating that the created PendingIntent should be immutable. This means that the additional intent argument passed to the send methods to fill in unpopulated properties of this intent will be ignored. FLAG_IMMUTABLE only limits the ability to alter the semantics of the intent that is sent by send by the invoker of send. The creator of the PendingIntent can always update the PendingIntent itself via FLAG_UPDATE_CURRENT.

也就是說，FLAG_IMMUTABLE 的“不可變”指的是迄薄，當(dāng) PendingIntent 設(shè)置了 flags 為“不可變”之后琅关，調(diào)用它的 send 方法時(shí)傳入的 Intent 將會(huì)被忽略。

這里舉一個(gè)具體的場景讥蔽，比如在列表類的 Appwidget 里涣易，我們會(huì)使用 PendingIntent 設(shè)置列表的某一項(xiàng)的點(diǎn)擊事件∫鄙。考慮到列表量比較大新症，為每一個(gè)列表?xiàng)l目都聲明一個(gè) PendingIntent 顯然開銷太大。所以响禽，Android 的處理機(jī)制是徒爹，

val views = RemoteViews(context.packageName, R.layout.layout_appwidget_note_list)
val i = Intent(context, MainActivity::class.java)
i.action = ACTION_APPWIDGET_NOTE_CLICK
val pi = PendingIntent.getActivity(context, 0, i, FLAG_CANCEL_CURRENT_MUTABLE)
views.setPendingIntentTemplate(R.id.lv, pi)

如上所示，首先定一個(gè)一個(gè) PendingIntent芋类，并調(diào)用 RemoteViews 的 setPendingIntentTemplate 方法傳入隆嗅，作為一個(gè)模版。然后在 RemoteViewsFactory 的 getViewAt 方法中為每個(gè)列表項(xiàng)設(shè)置點(diǎn)擊時(shí)的 Intent侯繁，

val row = RemoteViews(context.packageName, R.layout.item_appwidget_note)
val i = Intent().putExtras(extras)
row.setOnClickFillInIntent(R.id.root, i)

當(dāng)用戶觸發(fā)了點(diǎn)擊事件的時(shí)候胖喳，系統(tǒng)會(huì)在調(diào)用 PendingIntent 的 send 方法時(shí)將 Intent 傳入并喚起組件。此時(shí)贮竟，如果我們將 PendingIntent 的 flags 設(shè)置為 FLAG_IMMUTABLE丽焊，那么這里發(fā)送時(shí)傳入的 Intent 參數(shù)將被忽略较剃，因此可能導(dǎo)致雖然喚起了其他組件，但是參數(shù)丟失的情況粹懒。而對(duì)于那種重付，聲明 PendingIntent 時(shí)就傳入了 Intent 的時(shí)候，一般來說不需要設(shè)置為 FLAG_MUTABLE 的凫乖。

以上是 PendingIntent 的改動(dòng)确垫，剛好在我的項(xiàng)目里兩種情況都有遇到，所以詳細(xì)分析了一下帽芽。

4删掀、構(gòu)建項(xiàng)目 JDK 需要升級(jí)

當(dāng)將項(xiàng)目的 targetSdkVersion 升級(jí)到了 31 之后，構(gòu)建項(xiàng)目的時(shí)候可能會(huì)遇到如下異常导街，

當(dāng)然你也可能不會(huì)遇到這個(gè)問題披泪。那主要的原因是，你的 Android Studio 里 Gradle 構(gòu)建時(shí)用到的版本已經(jīng)是 Java 11 的了搬瑰】钇保可以通過 Preference->Build->Gradle 查看當(dāng)前 Android Studio 中使用的 JDK 版本，

在 Gradle JDK 處修改構(gòu)建時(shí)用的 JDK 版本即可泽论。

以上是針對(duì) Android Studio 構(gòu)建時(shí)的情況艾少。但當(dāng)我們使用腳本或者命令行構(gòu)建項(xiàng)目的時(shí)候需要用到的就不是 Android Studio 的 JDK 版本了。此時(shí)翼悴，可以通過 java --version 查看環(huán)境變量中配置的 JDK 版本缚够。

我們不能直接修改環(huán)境變量中的 JDK 版本解決上述編譯問題。因?yàn)楫吘钩碎_發(fā)鹦赎，我們可能還有很多其他應(yīng)用在使用 JDK 環(huán)境谍椅。此時(shí)，我們可以通過 Gradle 構(gòu)建時(shí)的命令來指定構(gòu)建時(shí)使用的 JDK古话。

gradlew -Dorg.gradle.java.home=你的 JDK 路徑

對(duì)于打包腳本的修改我也更新到了項(xiàng)目 autopackage 中雏吭。

總結(jié)

以上是個(gè)人升級(jí)項(xiàng)目的目標(biāo)版本到 31 過程中遇到的一些典型的問題。此外陪踩，在適配的過程中可能還有許多其他細(xì)節(jié)需要修改杖们，對(duì)此，參考文首的幾個(gè)鏈接了解即可膊毁。升級(jí) 31 雖然沒有升級(jí)到 30 改動(dòng)多胀莹，但是對(duì)大型的項(xiàng)目來說基跑，需要改動(dòng)的點(diǎn)應(yīng)該還是挺多的婚温。

如有疑問，歡迎交流媳否！??

作者：開發(fā)者如是說
鏈接：https://juejin.cn/post/7176273227558158393