[[240538]]

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

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

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

小變化 大改善

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

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

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

首先，在 Android Studio 內(nèi)選擇 Tools > SDK Manager。選擇左欄中的 “Android SDK”，確保 “SDK Platforms” 的標簽已打開。

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

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

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

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

配置設置完成后，如果您的代碼違反 Android SDK 中的可空性協(xié)議，您的項目將顯示警告。

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

△ 在 android.graphics.Path API 中，將空值參考作為非空類型傳遞給已注釋的參數(shù)時的 Android Studio 警告

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

即使您的代碼采用的是 Java 編程語言，您依舊可以從新的可空性注解中獲益。在默認狀態(tài)下，Android Studio 會顯示違反可空性協(xié)議的警告，具體示例如下：

△ 編程語言為 Java 時，出現(xiàn)違反可空性協(xié)議的情況時 Android Studio 顯示的警告示例

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

△ 使用設置下方的檢查頁面，以確保 Constant conditions& exceptions 編碼的檢查功能已激活。

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

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

下一步

Android SDK API 的接口眾多，目前為止，我們僅標注了小部分的 API，尚有諸多工作在等著我們。在未來即將發(fā)布的幾個 Android SDK 版本中，我們將繼續(xù)為現(xiàn)有 Android API 增加可空性注解，并確保所有的新增 API 也經(jīng)過注釋這一環(huán)節(jié)。

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