如何在開發專案中設定 Android 支援庫取決於您想要使用的功能，以及您希望應用支援的 Android 平臺版本範圍。

本文件將指導您下載支援庫軟體包以及向開發環境中新增庫。

下載支援庫

Android 支援儲存庫軟體包作為 Android SDK 的輔助元件提供，可以通過 Android SDK 管理器下載。請按照以下說明操作，獲取支援庫檔案。

要通過 SDK 管理器下載支援庫，請執行以下操作：

1. 啟動 Android SDK 管理器。
2. 在 SDK 管理器視窗中，滾動到 Packages 列表末尾，找到 Extras 資料夾並展開（如有必要）以顯示其內容。
3. 選擇 Android Support Repository 項。
4. 點選 Install packages... 按鈕。

圖 1. Android SDK 管理器以及選擇的 Android 支援儲存庫。

下載後，此工具會將支援庫檔案安裝到您現有的 Android SDK 目錄中。庫檔案位於 SDK 的以下子目錄中：<sdk>/extras/android/m2repository/com/android/support/ 目錄。

選擇支援庫

在將支援庫新增到應用之前，確定您想要包含的功能以及希望支援的最低 Android 版本。如需瞭解有關不同庫所提供功能的詳細資訊，請參閱

新增支援庫

要使用支援庫，您必須在開發環境中修改應用專案的類路徑依賴關係。必須針對想要使用的每個支援庫執行該步驟。

要嚮應用專案中新增支援庫，請執行以下操作：

1. 確保已使用 SDK 管理器下載 Android 支援儲存庫。
2. 開啟應用的 build.gradle 檔案。
3. 將支援庫新增到 dependencies 部分。例如，要新增 v4 core-utils 庫，請新增以下行：

   dependencies {
       ...
       compile "com.android.support:support-core-utils:24.2.0"
    
   
   }

注意：使用動態依賴關係（例如 palette-v7:23.0.+）可能會導致意外的版本更新和迴歸不相容問題。我們建議明確指定庫版本（例如 palette-v7:24.2.0）。

使用支援庫 API

為現有框架 API 提供支援的支援庫類與框架類通常具有相同的名稱，但前者位於 android.support 類軟體包中，或帶有 *Compat 字尾。

注意：使用支援庫中的類時，確保從相應的軟體包中匯入類。例如，應用 ActionBar 類時：

• 使用支援庫時為 android.support.v7.app.ActionBar。
• 僅為 API 級別 11 或以上開發時為 android.app.ActionBar。

注：將支援庫新增到應用專案後，我們強烈建議使用 ProGuard 工具準備要釋出的應用 APK。除了保護您的原始碼外，ProGuard 工具還可以從新增到應用的任意庫中移除不使用的類，從而使應用的下載大小盡可能小。如需瞭解詳細資訊，請參閱 ProGuard。

如需使用支援庫某些功能的更多指導，請參見 Android 開發者培訓課程、指南和示例。如需瞭解有關支援庫中各個類和方法的詳細資訊，請參閱 API 參考中的 android.support 軟體包。

清單宣告變更

如果您計劃增加現有應用對帶有支援庫的舊版本 Android API 的向後相容性，請確保更新應用的清單。具體而言，您應將清單中 <uses-sdk> 標記的 android:minSdkVersion 元素更新為較低的新版本號，如下所示：

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

清單設定告知 Google Play 您的應用可以安裝在 Android 4.0（API 級別 14）及更高版本的裝置上。

如果您使用 Gradle 構建檔案，構建檔案中的 minSdkVersion 設定將替換清單設定。

apply plugin: 'com.android.application'

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

在這種情況下，構建檔案設定將告知 Google Play 您應用的預設構建變體可以安裝在 Android 4.1（API 級別 16）及更高版本的裝置上。如需瞭解有關構建變體的詳細資訊，請參閱構建系統概覽。

注：如果新增多個支援庫，則最低的 SDK 版本必須是任意指定庫所要求的最高版本。例如，如果您的應用中包含 v14 Preference 支援庫和 v17 Leanback 庫，則最低的 SDK 版本必須為 17 或更高。