注意：9.0（API level 28）隨新版本的支持庫(kù)發(fā)布，屬于該庫(kù)。該庫(kù)除了現(xiàn)有的支持庫(kù)外還包含最新的組件。

p>

您可以繼續(xù)使用此支持庫(kù)過去的工件（在這種情況下，版本 27 和更早版本，并打包為 ..*）在 Maven 中仍然可用。但是，所有新的庫(kù)開發(fā)都將在庫(kù)中進(jìn)行。

我們建議在所有新項(xiàng)目中使用該庫(kù)。您還應(yīng)該考慮將現(xiàn)有項(xiàng)目遷移到。

在開發(fā)支持多個(gè) API 版本的應(yīng)用程序時(shí)，您可能需要一種標(biāo)準(zhǔn)方法來為系統(tǒng)的早期版本提供新功能，或者優(yōu)雅地回退到等效功能。您可以利用這些庫(kù)來提供適當(dāng)?shù)募嫒菪詫樱鵁o需編譯代碼來處理平臺(tái)的早期版本。此外，支持庫(kù)還提供了標(biāo)準(zhǔn) API 中沒有的附加工具類和功能，使開發(fā)和支持更多設(shè)備變得更加容易。

支持庫(kù)最初是用于各種應(yīng)用程序的單個(gè)二進(jìn)制庫(kù)，但已演變成一套用于應(yīng)用程序開發(fā)的庫(kù)。在應(yīng)用程序開發(fā)過程中，如果沒有必要，現(xiàn)在強(qiáng)烈推薦其中許多庫(kù)。

本文概述了支持庫(kù)，以幫助您了解其組件以及如何在您的應(yīng)用程序中有效地使用它們。

注意：從支持庫(kù)版本 26.0.0（2017 年 7 月）開始，大多數(shù)支持庫(kù)支持的最低 API 級(jí)別已提升到 4.0（API 級(jí)別 1 4）。有關(guān)詳細(xì)信息，請(qǐng)參閱本文檔中的部分。

支持庫(kù)的目的

支持庫(kù)有一些獨(dú)特的用途，平臺(tái)早期版本的向后兼容類只是其中之一。下表提供了應(yīng)用程序中使用支持庫(kù)的完整列表：

使用 API 和使用 API

支持庫(kù)提供的類和方法與框架中的 API 非常相似。考慮到這一點(diǎn)，您可能需要決定是應(yīng)該使用 API 的框架版本，還是使用等效的支持庫(kù)。以下指南描述了何時(shí)應(yīng)使用支持庫(kù)類而不是 API：

由于主機(jī)設(shè)備平臺(tái)版本的限制，提供平臺(tái) API 類的兼容實(shí)現(xiàn)的支持庫(kù)類可能無法在最新版本中提供完整的功能集。在這種情況下it支持，支持庫(kù)類會(huì)優(yōu)雅地降級(jí)，并且可能無法提供當(dāng)前平臺(tái) API 的所有功能或數(shù)據(jù)。因此，您應(yīng)該查看您正在使用的庫(kù)類和方法的參考文檔，并在運(yùn)行您的應(yīng)用支持的最早版本平臺(tái)的設(shè)備上進(jìn)行徹底測(cè)試。

注意：支持庫(kù)并不為每個(gè)框架 API 提供等效的類和方法。在某些情況下，您可能需要將框架方法調(diào)用放入顯式 SDK 版本檢查塊中，并提供替代代碼來處理設(shè)備上不可用的方法。有關(guān)在代碼中使用版本檢查的更多信息，請(qǐng)參閱支持不同的平臺(tái)版本。

版本支持和包名稱

部分支持庫(kù)包的名稱表示它最初支持的最低 API 級(jí)別。這些名稱使用 v# 表示法，例如 -v4 包。從支持庫(kù)版本 26.0.0（2017 年 7 月發(fā)布）開始，所有支持庫(kù)包支持的最低 API 級(jí)別已更改為 4.0（API 級(jí)別 14）. 因此，當(dāng)使用任何最新版本的支持庫(kù)時(shí)，您不應(yīng)假設(shè) v# 包符號(hào)會(huì)指示最低 API 支持級(jí)別。最新版本中的這種更改也意味著名稱分別為 v4 和 v7 庫(kù) for 本質(zhì)上等價(jià)于其支持的最低 API 級(jí)別，例如對(duì)于 26.0.0 及更高支持庫(kù)，-v4 和 -v7 包支持的最低 API 級(jí)別均為 14 .

支持庫(kù)版本

支持的庫(kù)的發(fā)布版本（例如 24.2.0 或 25.0.1） 不同于任何庫(kù)支持的最低版本對(duì)應(yīng)的版本 API 級(jí)別。發(fā)布版本號(hào)可以指示該版本是針對(duì)哪個(gè)平臺(tái) API 版本編譯的，因此，該版本的庫(kù)中可能包含哪些最新的 API。

具體來說，發(fā)布版本號(hào)的第一部分（例如，版本號(hào) 24.2.0 中的 24））通常對(duì)應(yīng)于當(dāng)時(shí)可用的平臺(tái) API 版本發(fā)布了相應(yīng)的版本。支持庫(kù)的發(fā)布版本級(jí)別可以表明該版本集成了相應(yīng)API級(jí)別的一些功能，但不應(yīng)假設(shè)它兼容新平臺(tái)API版本中發(fā)布的所有功能。

庫(kù)依賴項(xiàng)

支持庫(kù)套件中的大多數(shù)庫(kù)都依賴于一個(gè)或多個(gè)庫(kù)。例如it支持，幾乎所有的支持庫(kù)都依賴于 - 包。通常，您無需擔(dān)心支持庫(kù)依賴項(xiàng)，因?yàn)闃?gòu)建工具通過自動(dòng)包含依賴庫(kù)來為您管理庫(kù)依賴項(xiàng)。

如果您想查看您的應(yīng)用中包含哪些庫(kù)和庫(kù)依賴項(xiàng)，請(qǐng)?jiān)谀膽?yīng)用開發(fā)項(xiàng)目的構(gòu)建根目錄中運(yùn)行以下命令以獲取有關(guān)此項(xiàng)目的依賴項(xiàng)的報(bào)告，包括支持庫(kù)和其他庫(kù)：

    gradle -q dependencies your-app-project:dependencies
    

有關(guān)如何使用將支持庫(kù)添加到您的開發(fā)項(xiàng)目的詳細(xì)信息，請(qǐng)參閱支持庫(kù)設(shè)置。使用方法詳見配置構(gòu)建系統(tǒng)。

請(qǐng)注意，所有支持庫(kù)也依賴于一些基礎(chǔ)平臺(tái)。對(duì)于最新版本，它取決于 4.0（API 級(jí)別 14） 或更高。