Android Compatibility package 相容性開發套件
新版 Android SDK 下載安裝中文教學課程講義，歡迎延伸點閱！
我們的《Android 手機應用程式開發教學課程免費講義》網路讀者俱樂部會員(請點選此連結)，歡迎您的加入，謝謝！
本講義目前網路連載發表有：Android手機程式開發教學講義懶人包、Android 教學講義第一講、Android 教學講義第二講、Android 教學講義第三講、Android 教學講義第四講、Android 教學講義第五講、Android 教學講義第六講、Android 教學講義第七講上篇、Android 教學講義第七講下篇、Android 2.3補充教材1、Android 2.3補充教材2、Android 3.0平板電腦完整功能搶先看(From T-Mobile)、Android 3.0 平板電腦應用程式開發：第一講、Android 3.0 SDK 正式版登場、Android 嵌入式系統最新開發應用 - SAAB IQon 車用電腦、Android 2.3 補充教材3、Android 3.0 平板電腦應用程式開發：第二講、Android 教學講義第八講上篇、Android 教學講義第八講中篇(1)、Android 4.0 SDK 開發功能介紹與下載網址、 Android 4.0 SDK 下載安裝完整教學、 Android 4.0 模擬器安裝設定教學課程講義、Android 4.0 的 Holo theme 佈景主題介紹與設定教學課程講義、Android 4.2 升級功能簡介、Android 4.2 SDK & ADT Bundle 下載安裝教學、2013年第1講： Android Application Project 之建立、2013年最新 Android Studio 開發工具下載安裝教學、最新 Android App 網路連線程式設計範例 (第一講) - Volley HTTP Library 入門教學、Android App 與 Android Application Project 是什麼？、Android 4.4 KitKat 與 Android 4.4 SDK 開發功能介紹、Android SDK 下載安裝中文教學課程講義 ( 2013年11月新版，ADT Bundle )
以下為本篇 Android 教學講義的開始。
我們認為 Android 3.0 平板電腦作業系統在美國時間 2011 年2月22日的正式推出，對於 Android 手機應用程式開發者所象徵的意涵是：
過往大家所開發過的 Android 手機應用程式，除了可以在 Android 智慧型手機作業系統之上運行外，也因為 Android 3.0 平板電腦作業系統的向下相容之故，致使這些 Android 手機應用程式亦能跨足到 Android 平板電腦作業系統的新領域之中。
然而，Android 官方認為這還不夠！
假若，專為 Android 3.0 平板電腦作業系統所開發的應用程式，能夠相容於其它 Android 智慧型手機作業系統之中，那麼 Android 應用程式開發市場的廣大疆域才可以真正地被開啟。
但是，問題來了！
Android 3.0 SDK 有很多專為平板電腦使用者介面所發展出來的 API ，這些新的 API 並沒有被定義在目前的 Android 智慧型手機作業系統之中。
除非，每一位 Android 智慧型手機的用戶都有辦法下載更新 Android 3.0 SDK 裡頭的 API 使用，要不然，這些 Android 平板電腦應用程式到了 Android 智慧型手機之上，就只能望機心嘆了！
但是，全面性地更新 Android 智慧型手機作業系統版本，談何容易！
這個困境肇因於 Android 的開放性。
因為，目前全球市售的 Android 智慧型手機從 Android 1.6 、 Android 2.1 、 Android 2.2 、甚至 Android 2.3 ，什麼版本的 Android 智慧型手機都有。
再加上，不同的 Android 智慧型手機硬體業者為了要建立自身的產品差異性之故，似乎常會自行變更其中的系統程式內容。導致 Android 平板電腦應用程式要與 Android 智慧型手機作業系統相容的目標，在短期之內非常難以達成。
那怎麼辦呢？
Android 官方想出了一個好辦法！
什麼是 Android Compatibility package ？
他們在2011年3月3日推出了一個名為 Android Compatibility package 的 Android 相容性套件。
Android 手機應用程式開發者可以透過 Android SDK and AVD Manager 工具軟體來下載安裝 Android Compatibility package 。
至於， Android Compatibility package 有何用途呢？
它最主要的作用是， Android Compatibility package 裡頭有一個 android-support-v4.jar 的檔案。(註： .jar 檔案格式全名為 Java Archive ，為 Java 程式開發者利用 JDK 所提供的 JAR 檔案壓縮工具( jar.exe )，將多個 Java 類別檔案( .class )壓縮後的檔案格式。)
這個檔案壓縮了 Android 3.0 的一些 API 類別檔案。
其中，它主要包括了 Fragments 、 LoaderManager 以及其它 Android 3.0 相關的 API 類別檔案。(註： android-support-v4.jar 檔案的詳細 API 類別檔案清單，如下圖所示)
Android 手機應用程式開發者可放置 android-support-v4.jar 檔案到各自所開發的 Android 手機應用程式當中，成為它的靜態函式庫(static library)。
此靜態函式庫可以與 Android 手機應用程式原始碼一併壓縮包裏成為單一的 Android 封裝檔(副檔名為 .apk，Android application package)，以供人下載安裝。
當 Android 智慧型手機執行到該應用程式中的一些 Android 3.0 API 之程式碼時，它可以直接從此靜態函式庫之中取用 Android 3.0 相關的 API 類別檔案，以便執行原本在 Android 3.0 才有的一些程式碼。
所以，我們認為 Android Compatibility package 的出現，的確為 Android 應用程式疆土的一統，露出了一絲的曙光。
然而，它有一個很重要的限制，亦即 Android Compatibility package 目前只支援 Android 1.6 (含) 以上的 Android 智慧型手機作業系統版本。更早以前的版本則無法使用該套件所提供的靜態函式庫。
講到這兒，您一定迫不急待想要下載安裝 Android Compatibility package 了吧？
由於，這個消息比較新、加上 Android Developers 官網並沒有提供 Android Compatibility package 下載安裝的步驟說明。因此，我們目前在網路上幾乎找不到完整的 Android Compatibility package 下載安裝之參考資料。
基於此理由，我們希望藉由此篇 Android 3.0 教學講義，來協助台灣、中國大陸與港澳地區有需要這個 Android 相容性套件的讀者朋友，盡快進行 Android Compatibility package 的下載安裝動作。
我們在此要特別強調地是，本篇 Android 3.0 教學講義只會講述 Android Compatibility package 的下載安裝步驟。
至於，該如何撰寫使用 Fragments 、 LoaderManager 或者其它 Android 3.0 相關的 API 之完整程式碼呢？
我們礙於篇幅之故，因此，會在日後的教學講義當中再陸續發表。
在您進行本篇 Android 教學講義之操作步驟前，我們建議您先閱讀本研究室所撰寫的 Android 教學講義懶人包，以便對 Android 應用程式開發有較進一步的暸解。
我們的 Android 教學講義，目前網路連載發表有：Android手機程式開發教學講義懶人包、Android 教學講義第一講、Android 教學講義第二講、Android 教學講義第三講、Android 教學講義第四講、Android 教學講義第五講、Android 教學講義第六講、Android 教學講義第七講上篇、Android 教學講義第七講下篇、Android 2.3補充教材1、Android 2.3補充教材2、Android 3.0平板電腦完整功能搶先看(From T-Mobile)、Android 3.0 平板電腦應用程式開發：第一講、Android 3.0 SDK 正式版登場、Android 嵌入式系統最新開發應用 - SAAB IQon 車用電腦、Android 2.3 補充教材3、Android 3.0 平板電腦應用程式開發：第二講、Android 教學講義第八講上篇、Android 教學講義第八講中篇(1)、Android 4.0 SDK 開發功能介紹與下載網址、 Android 4.0 SDK 下載安裝完整教學
Android Compatibility package 的下載與安裝
【孫傳雄研究室 編著】以下，我們便開始透過圖文說明的方式，教大家如何下載安裝 Android Compatibility package 。
首先，請您開啟 Eclipse IDE 。
並且，請您在 Eclipse IDE 點選 Windows 下拉式功能表之中的 Android SDK and AVD Manager 選項。以便開啟 Android SDK and AVD Manager 工具程式。(如下圖紅框處所示)
當出現 Android SDK and AVD Manager 對話視窗時，請您點選該視窗左側的 Available packages 頁籤。(如下圖紅框處所示)
Available packages 偵測可下載套件中…。(如下圖所示)
當 Android SDK and AVD Manager 對話視窗的右側出現 Available packages 子視窗後。
請您在 Packages available for download 勾選欄位之中，點選 Android Repository 選項前面的 > 圖示。(如下圖箭頭1處所示)
此時會出現 Android Repository 選項之子選項 Android Compatibility package, revision 1 時，請您直接勾選此子選項。(如下圖箭頭2處所示)
最後，請您按下 Install Selected 按鈕。(如下圖箭頭3處所示)
在您看到 Choose Packages to Install 對話視窗時，請您在該對話視窗中點選 Accept 選項，並按下 Install 按鈕。(如下圖箭頭1與箭頭2處所示)
Android Compatibility package 正在下載中…^_^ (如下圖所示)
Android Compatibility package 正在安裝中…^_______________^ (如下圖所示)
耶！Android Compatibility package 下載安裝完成了！
請您按下 Installing Archives 對話視窗中的 Close 按鈕。(如下圖紅框處所示)
當您回到 Android SDK and AVD Manager 對話視窗時，可以按下該視窗左側的 Installed packages 頁籤，以便檢視 Android Compatibility package 是否已下載安裝成功？。(如下圖箭頭1處所示)
在您按下 Installed packages 頁籤之後，它會在 Android SDK and AVD Manager 對話視窗右側列示目前您已安裝的各項 Android SDK 相關套件列表。
此時，您應該會在此列表之中看到 Android Compatibility package, revision 1 項目，若有則代表您已成功下載安裝 Android Compatibility package 。(如下圖箭頭2處所示)
當您確定成功下載安裝 Android Compatibility package 後，請按下 Android SDK and AVD Manager 對話視窗右上角的 X 按鈕，以便關閉該對話視窗。(如下圖箭頭3處所示)
android-support-v4.jar 置入 Android 手機應用程式開發專案
隨後，您還需要將 Android Compatibility package 當中的 android-support-v4.jar 檔案，放置到您那個會使用 Android 3.0 SDK 相關的 API 之 Android 手機應用程式開發專案之中。
不過，在您放置 android-support-v4.jar 檔案之前，還需要在該 Android 應用程式開發專案中，新增一個能夠放置這個 android-support-v4.jar 檔案的子資料夾 libs。
因此，請您至 Project Explorer 子視窗中，點選該 Android 應用程式開發專案名稱。(如下圖箭頭1處所示)
並且，請您在此專案名稱按下滑鼠右鍵。當出現彈出式功能表時，請您點選 New 選項當中的 Folder 子選項。(如下圖箭頭2與箭頭3處所示)
當出現 New Folder 對話視窗後，請您在該對話視窗的 Folder name 文字輸入欄位之中，輸入 libs 文字。(如下圖箭頭1處所示)
隨後，請按下 Finish 按鈕。(如下圖箭頭2處所示)
此時，您會在該 Android 應用程式開發專案名稱之下，看到多了一個名為 libs 的子資料夾。
請您點選此 libs 子資料夾名稱。(如下圖箭頭1處所示)
並且，請您在此子資料夾名稱按下滑鼠右鍵。
當出現彈出式功能表時，請您點選 Import 選項。以便匯入 android-support-v4.jar 檔案至 libs 子資料夾之中。(如下圖箭頭2處所示)
在您看到 Import 對話視窗時，請您在該視窗的功能欄位內，點選 General 選項中的 File System 子選項。(如下圖箭頭1處所示)
並且，請您按下 Next > 按鈕。(如下圖箭頭2處所示)
之後，您會看到讓您選擇要匯入哪一個檔案的 Import 對話視窗。
請您按下該對話視窗中的 Browse… 按鈕。(如下圖箭頭1處所示)
當出現 Import from directory 對話視窗時，請您點選 android-support-v4.jar 檔案所在的實體檔案路徑。
通常來說，如果您使用 Android SDK 的預設安裝路徑的話， android-support-v4.jar 檔案應該會被安裝在 C:\Program Files\Android\android-sdk-windows\extras\android\compatibility\v4 當中。
若您也是使用此預設安裝路徑，請在此對話視窗中依該路徑點選至 v4 子資料夾。(如下圖箭頭1處所示)
並且，請您按下 確定 按鈕。(如下圖箭頭2處所示)
當回到 Import 對話視窗後，請您開啟該對話視窗左側的v4子資料夾。並且在該對話視窗的右側勾選v4子資料夾中的 android-support-v4.jar 檔案名稱。(如下圖箭頭1處所示)
在此要請您注意的是：由於，我們只需要 android-support-v4.jar 檔案，因此，請您不要勾選該對話視窗左側的 v4 子資料夾名稱。
最後，請您按下 Finish 按鈕。(如下圖箭頭2處所示)
android-support-v4.jar 的建置路徑設定
此時，您會在 libs 子資料夾之下看到 android-support-v4.jar 檔案已成功匯入。
不過，除了將 android-support-v4.jar 檔案匯入 libs 子資料夾之外，您還必需要設定 android-support-v4.jar 檔案的建置路徑( Build Path )。
如此作法才能讓 Android 手機應用程式開發專案在被編譯器編譯時，正確納入 android-support-v4.jar 所提供的 Android 3.0 相關的 API 類別檔案。
所以，請您點選在 Project Explorer 子視窗中的 android-support-v4.jar 檔案名稱。(如下圖箭頭1處所示)
並且，請您在此檔案名稱按下滑鼠右鍵。
當出現彈出式功能表時，請您點選 Build Path 選項當中的 Add to Build Path 子選項。(如下圖箭頭2與箭頭3處所示)
耶！ android-support-v4.jar 檔案的建置路徑設定成功！(如下圖紅框處所示)
android-support-v4.jar 檔案裡頭包括了相當多的 Android 3.0 的 API 類別檔案。(如下圖所示)
import android.support.v4.*;
當您撰寫到 Android 3.0 的相關 API 程式碼時，則只需同時按下鍵盤上的 Ctrl + Shift + O 按鈕，Eclipse便會自動幫您加上匯入 android-support-v4.jar 的 API 類別檔案之程式碼。(如下圖紅框處所示)
不過，我們在此要提醒您的是： android-support-v4.jar 並非支援全部的 Android 3.0 相關 API 哦！
至於，如何撰寫 Android 3.0 相關的手機或平板電腦應用程式呢？
我們日後會再陸續發表 Android 3.0 相關的網路教學文章，歡迎您長期鎖定閱讀本研究室的 Android 教學講義，謝謝！
喜歡閱讀我們的講義嗎？歡迎加入我們所成立的《Android 手機程式開發教學課程免費講義》網路讀者俱樂部會員(請點選此連結)，謝謝！
如果您對於 Android 手機與平板電腦應用程式開發有興趣，歡迎閱讀我們在網路上發表的 Android 手機與平板電腦應用程式開發教學系列講義。
本講義目前網路連載發表有：Android手機程式開發教學講義懶人包、Android 教學講義第一講、Android 教學講義第二講、Android 教學講義第三講、Android 教學講義第四講、Android 教學講義第五講、Android 教學講義第六講、Android 教學講義第七講上篇、Android 教學講義第七講下篇、Android 2.3補充教材1、Android 2.3補充教材2、Android 3.0平板電腦完整功能搶先看(From T-Mobile)、Android 3.0 平板電腦應用程式開發：第一講、Android 3.0 SDK 正式版登場、Android 嵌入式系統最新開發應用 - SAAB IQon 車用電腦、Android 2.3 補充教材3、Android 3.0 平板電腦應用程式開發：第二講、Android 教學講義第八講上篇、Android 教學講義第八講中篇(1)、Android 4.0 SDK 開發功能介紹與下載網址、 Android 4.0 SDK 下載安裝完整教學、 Android 4.0 模擬器安裝設定教學課程講義、Android 4.0 的 Holo theme 佈景主題介紹與設定教學課程講義、Android 4.2 升級功能簡介、Android 4.2 SDK & ADT Bundle 下載安裝教學、2013年第1講： Android Application Project 之建立、2013年最新 Android Studio 開發工具下載安裝教學、最新 Android App 網路連線程式設計範例 (第一講) - Volley HTTP Library 入門教學、Android App 與 Android Application Project 是什麼？、Android 4.4 KitKat 與 Android 4.4 SDK 開發功能介紹、Android SDK 下載安裝中文教學課程講義 ( 2013年11月新版，ADT Bundle )
此篇講義的主要參考文獻來源：Android Developers 官網
著作權聲明
本講義之內文、排版等著作權或其他智慧財產權歸屬 孫傳雄 與 孫傳雄研究室 所有，非經書面同意禁止任何形式之翻印、全文轉貼或者授課使用行為。但例外允許在網際網路上引用此講義之網址連結。
本講義之內文所提及或者引用的公司名稱、產品名稱以及所引用的文字、商標、Youtube短片、產品相片或者網站頁面，均為其所屬公司所擁有，特以聲明。
