Android Pie SDK 與 Kotlin 更合拍

Android Pie SDK 與 Kotlin 更合拍

在使用 Java 編程語言時,最常見的痛處之一是在存取空引用 (null reference) 成員時,系統會報出 NullPointerException。Kotlin 可有效地避免這問題的發生,它通過將可空類型 (nullable type) 與非空類型 (non-nullable type) 匯入類型系統,幫助您消除代碼中的 NullPointerException 錯誤,從而提升 app 的整體質量。Kotlin 代碼調用寫入 Java 語言中的 API 時,會依靠上述 API 中的可空性註解來決定每個參數的可空性,以及返回值類型。未註解的參數和返回值類型將被視為平臺類型,從而弱化 Kotlin 的空值安全保證。

最新的 Android 9 包含了 Android SDK 的更新,為一系列最常用的 API 加上了可空性註解。您的 Kotlin 代碼在調用 SDK 中任一已註解的 API 時,可完好保留空值安全保證。即使在使用 Java 編程語言時,您依舊可以通過使用 Android Studio 檢測可空性協議違規,並從這些註解中獲益。

新的 Android SDK 作為 Android 9 連帶發佈的一部分,包含了一些常用 API 的可空性註解,當 Kotlin 調用了 SDK 中任何帶有註解的 API 時,它能預留出空安全性 (null-safety) 保障。而使用 Java 的開發者也可以利用 Android Studio 捕捉可空合約違規行為,從而有效利用這些可空性註解。

小變化 大改善

通常情況下,Kotlin 中違反可空性協議時會導致編譯錯誤。為保證已包含註解的 API 可與您的現有代碼兼容,我們採用了一個由 Kotlin 編譯器團隊提供的內部機制來對最新註釋的 API 進行註解。新註釋的 API 僅觸發警告,而不會導致 Kotlin 編譯器報錯。這必須使用 Kotlin 插件 1.2.60 或更新版本。

近期加入的可空性註解只會產生警告而非錯誤,但在下一年度的 Android SDK 中 ,我們將提高錯誤嚴重等級。此舉的目的是為了給開發者預留出足夠時間調整代碼。

如何使用更與 Kotlin 更合拍的 SDK

首先,在 Android Studio 內選擇 Tools > SDK Manager。選擇左欄中的 “Android SDK”,確保 “SDK Platforms” 的標籤已打開。

Android Pie SDK 與 Kotlin 更合拍

使用 Android Studio中的 SDK Manager來為 API 28 級第 6 版安裝

檢查 Android 8.+ (P) 並點擊 OK。通過該步驟,可實現 Android SDK 平臺 28 級第 6 版的安裝 (若之前尚未安裝)。此後,將項目的編譯 SDK 版本設置為 API 28 級,來激活新款 Android Pie SDK 的可空性註釋。

Android Pie SDK 與 Kotlin 更合拍

使用項目結構對話,將項目的編譯 SDK 版本變更為 API 28

如果您當前的 Kotlin 插件尚未更新到最新版本,您需要通過 Android Studio 對其進行更新。請選擇 “Tools Kotlin > Configure Kotlin Plugin Updates” 檢查並確保 Kotlin 插件版本是 1.2.60 或更新版本。

配置設置完成後,如果您的代碼違反 Android SDK 中的可空性協議,您的項目將顯示警告,具體示例如下:

Android Pie SDK 與 Kotlin 更合拍

凹口編碼違反 Android SDK 中新添加的可空性協議時, Kotlin 編譯器所顯示的警告示例

此外,如果您調用的 Android API 不符合可空性要求,Android Studio 的代碼編輯器上同樣會顯示相關警告。具體示例如下:

Android Pie SDK 與 Kotlin 更合拍

在 android.graphics.Path API 中,將空值參考作為非空類型傳遞給已註釋的參數

利用 Java 編程語言中的可空性註解

即使您的代碼採用的是 Java 編程語言,您依舊可以從新的可空性註解中獲益。在默認狀態下,Android Studio 會顯示違反可空性協議的警告,具體示例如下:

Android Pie SDK 與 Kotlin 更合拍

編程語言為 Java 時,出現違反可空性協議的情況時 Android Studio 顯示的警告示例

為保證您已激活該檢查功能,您可訪問 IDE 的設置頁面並搜索 “Constant conditions& exceptions” 檢查,並確保相關項已經過檢查。

Android Pie SDK 與 Kotlin 更合拍

使用設置下方的檢查頁面,以確保 Constant conditions& exceptions 編碼

如果您使用的是 Java 編程語言,違反可空性協議的將不會產生任何編譯器警告或報錯。僅 IDE 的代碼檢查功能可檢示這些問題。

此外,您可在整個項目中檢查代碼,並審閱總體結果。點擊 “Analyze>Inspect Code...” 來開始該過程。

下一步

Android SDK API 的接口眾多,目前為止,我們僅標註了小部分的 API,尚有諸多工作在等著我們。在未來即將發佈的幾個 Android SDK 版本中,我們將繼續為現有 Android API 增加可空性註解,並確保所有的新增 API 也經過註釋這一環節。

具備與 Kotlin 更合拍的 Android SDK、AndroidX 中的可空性註解 (Jetpack 系列的一部分) 以及 Android KTX 之後,我們將繼續為使用 Kotlin 的開發者改進 Android API 。如果您尚未嘗試 Kotlin,我們希望您試用一下。Kotlin 不僅能讓您的代碼更加簡潔,還能提升您 app 的穩定性。


分享到:


相關文章: