Android官方開發文檔之從Eclipse遷移到Android Studio開發篇

1、前言

從Eclipse遷移項目到Android Studio需要適應一個新的項目結構，建立系統和IDE的功能。為了簡化遷移過程，Android Studio提供了重要工具使你可以快速地將現有代碼移動到Android Studio項目基礎建設的文件和工具。

2、Android Studio的基礎（Android Studio Basics）

當你將Eclipse項目遷移到Android Studio時，你應該在這裡需要知道一些關鍵的差異。

（1）項目與模塊組織（Project and module organization）

Android Studio是基於IntelliJ IDEA的IDE。

Android Studio不使用工作區，所以單獨的項目在不同的Android Studio打開窗口。Android Studio組織代碼到項目，其中包含的一切，定義你的安卓應用程序，從應用程序源代碼，以建立配置和測試代碼。每個項目包含一個或多個模塊，允許您將項目劃分為離散的功能單元。模塊可以獨立完成，測試和調試。

有關安卓工作室項目和模塊的更多信息，參見Projects Overview。

（2）基於Gradle構建系統（Gradle-based build system）

Android Studio的構建系統是基於Gradle和使用通過使用易於擴展和定制的Groovy語法來寫的配置構建文件。

有關使用和配置Gradle工具的更多信息，請看Configure Your Build篇。

（3）依賴庫（Dependencies）

在使用Android Studio工具依賴聲明和Maven依賴當地知名的源代碼和二進制庫Maven庫依賴庫。

（4）測試代碼（Test code）

Eclipse的ADT，測試都寫在單獨的項目，通過在你的manifest文件中的元素標簽來集成。Android Studio提供了一個androidtest /directory在您的項目的主要sourceset，所以你可以很容易地添加和維護您的測試代碼相同的項目視圖中。Android Studio還提供了測試/目錄在您的項目的主要sourceset本地JVM測試。

3、遷移的先決條件（Migration Prerequisites）

在將應用程序遷移到Android Studio之前，請檢查以下步驟以確保您的項目已准備好進行轉換，並驗證您是否有在Android Studio所需的工具配置：

（1）在Eclipse ADT中：

確保Eclipse ADT的根目錄包含AndroidManifest.xml文件。另外，根目錄必須包含的項目和.classpath文件從Eclipse或res/和src/目錄。 建立你的項目來確保你的新工作空間和項目更新保存並列入進口。 在Eclipse ADT工作區的庫文件中or.classpath project.properties注釋。您可以在build.gradle文件導入後添加這些引用。 它可能會記錄您的工作區目錄，路徑變量和任何實際路徑圖，可以用來指定任何未解決的相對路徑、路徑變量和鏈接資源引用。Android Studio允許您手動指定在導入過程中的任何未解決的路徑。

（2）在Android Studio中：

如果你沒有下載Android Studio，首先先去下載Android Studio。如果你已經下載安裝好了Android Studio，你可以通過點擊 Help > Check for Updates (on Mac, Android Studio > Check for Updates).來驗證當前版本是不是最新的穩定發布版本。 因為Android Studio沒有遷移任何第三方Eclipse ADT的插件，使你在Eclipse中使用任何第三方插件的一個注記。你可以在Android Studio中或在IntelliJ Android Studio插件庫搜索等同特征兼容的插件。使用 File > Settings > Plugins菜單選項來管理安卓工作室的插件。 如果你打算運行Android Studio防火牆後面，一定要為Android Studio設置代理服務器設置和SDK管理器。Android Studio需要安裝向導同步上網，第三方庫的訪問，訪問遠程存儲庫，Gradle初始化和同步，Android Studio版本更新。

3、導入工程到Android Studio中

你應該決定根據其結構如何將現有的Eclipse ADT的項目導入到Android Studio中：

如果你有多個相關項目在Eclipse ADT共享相同的工作空間，導入第一個項目作為Project，之後在該項目中添加後續相關的項目作為模塊。 如果你的Eclipse ADT項目共享的依賴關系在相同的工作空間而不是其他關系，輸入每個項目單獨成Android Eclipse ADT工作室作為一個單獨的項目。Android Studio作為新創建的項目的一部分來共享的依賴關系。

（1）作為一個工程項目導入

打開Android Studio和關閉其它打開的Android Studio工程項目。 從Android Studio菜單中點擊File > New > Import Project。
或者，從歡迎屏幕，點擊Import project (Eclipse ADT, Gradle, etc.)。 選擇Eclipse ADT的項目文件夾的AndroidManifest.xml文件，單擊“確定”。

選擇目標文件夾，然後單擊“下一步”。

選擇導入選項並單擊“完成”。 導入過程中提示您遷移任何庫和項目依賴到Android Studio，並添加依賴聲明的build.gradle文件。導入過程也取代任何著名的源庫的二進制庫，與Maven的依賴已經知道Maven坐標的JAR文件，所以你不再需要手動去添加依賴。導入選項允許您輸入的工作區路徑和任何實際路徑，映射到處理任何未解決的相對路徑,路徑變量,和鏈接的資源引用。

Android Studio導入應用程序，並顯示項目導入摘要。匯總審查項目結構調整和導入過程的詳細信息。

在從Eclipse ADT導入項目到Android Studio後，在Android Studio中每一個app的模塊文件夾包含該模塊的完整源代碼集，其中包括src/main和src/androidTest/目錄，資源文件，構建文件和應用程序清單文件。在app開始開發之前，您應該解決項目導入摘要中所顯示的任何問題，以確保項目重新構建和導入過程正確完成。

（2）作為模塊導入

開啟Android Studio和打開您需要添加模塊的工程項目。 從Android Studio菜單上點擊File > New > Import Module。 選擇Eclipse ADT工程文件中的AndroidManifest.xml文件並點擊OK。 如果需要的話可以修改模塊的名稱，並且點擊下一步。 導入過程中提示您遷移任何庫和項目依賴到Android Studio，並添加依賴聲明的build.gradle文件。導入過程也取代任何著名的源庫的二進制庫，與Maven的依賴已經知道Maven坐標的JAR文件，所以你不再需要手動去添加依賴。導入選項允許您輸入的工作區路徑和任何實際路徑，映射到處理任何未解決的相對路徑,路徑變量,和鏈接的資源引用。 點擊完成。

（3）驗證導入的項目

完成導入過程之後，使用Android Studio構建和運行菜單操作來構建你的工程項目並且輸出。如果您的項目不正確，請檢查以下設置：

驗證安裝版本的工具與Eclipse項目的設置，通過打開SDK管理器（點擊Android Studio中Android SDK Manager按鈕或者點擊 Tools > Android > SDK Manager）。 驗證Android Studio其它設置，點擊File > Project Structure並且檢查以下內容：
在Android SDK位置驗證項目能正確的訪問到SDK，NDK，和JDK的位置和版本。
在項目下驗證工具的版本，Android的插件版本，以及相關的庫文件。
在模塊下驗證應用程序和模塊設置，如簽名配置和庫依賴項 如果你的項目工程依賴其它的工程項目，確保在應用程序模塊的文件夾下的build.gradle中正確定義了。

如果在你檢查這些設置之後，再構建和運行Android Studio項目工程時還有意想不到的問題時，考慮修改並重新啟動Eclipse ADT的項目導入過程。

注意：導入Eclipse ADT的項目，Android Studio創建一個新的Android Studio項目並不會影響現有的Eclipse ADT項目。

4、下面的步驟（Next Steps）

根據您的項目和工作流程，您可能希望閱讀更多關於使用版本控制、管理依賴、簽名和打包您的應用程序，或配置和更新Android Studio。

（1）配置版本控制

Android Studio支持多種版本控制系統，包括Git，GitHub，CVS，Subversion，Mercurial，和谷歌雲源庫。

在您導入應用程序到Android Studio之後，使用Android Studio VCS菜單操作來啟動所支持的版本控制系統創建一個版本庫，導入新的文件到版本庫中並且執行其它版本控制的操作：

從Android Studio版本控制菜單上點擊Enable Version Control Integration。 選擇一個版本控制系統與從下拉菜單中的項目根關聯，然後單擊“確定”。VCS的菜單現在顯示了一些基於你選擇的系統版本控制選項。
注意：您還可以使用File > Settings > Version Control菜單選項來設置和修改版本控制設置。

（2）Android支持庫和Google Play服務庫

當Eclipse ADT使用Android支持庫和谷歌服務庫,Android Studio在導入Android支持庫和谷歌Android庫保持兼容的功能和支持新特性。Android Studio添加這些依賴Maven依賴使用已知的Maven庫，所以這些依賴關系，不需要手動更新。

在Eclipse中，為了使用支持庫，您一定要在您希望使用的每個支持庫的開發環境中修改您工程項目的類路徑依賴。在Android Studio中，您不再需要將庫源復制到您自己的項目中，您可以簡單地聲明一個依賴項，並將該庫自動下載並合並到您的項目中。這包括自動合並資源，清單條目，混淆打包規則和在構建時自定義Lint規則。

（3）App簽名

如果你的應用程序使用一個調試Eclipse ADT的證書，Android Studio可以繼續使用該證書。然而，調試配置使用的是Android Studio自己生成一個已知的密碼和一個已知的密碼位於$ HOME / Android / debug.keystore默認密鑰的debug keystore。當您在Android Studio中運行或調試您的項目時，調試構建類型將自動使用此調試配置。

當構建你的發布版本的應用程序時，Android Studio將使用Eclipse ADT發布版本的證書。在導入工程的時候如果沒有發布版本證書，那麼在build.gradle文件下配置發布版本的簽名信息或者使用Build > Generate Signed APK菜單操作來打開生成簽名APK。

（4）調整Android Studio的堆的最大值

默認情況下，Android Studio有1280mb最大堆大小。如果您正在使用一個大型項目，或者您的系統有很多內存，您可以通過增加Android Studio的虛擬機選項中的最大堆大小來提高性能。

（5）軟件更新

Android Studio更新分別從Gradle插件，構建工具和SDK工具。您可以指定您想使用的哪個版本與Android Studio。

默認情況下，當一個新的穩定版本發布時，安卓提供了自動更新，但你可以選擇更頻繁地更新，也可以接受預覽或測試版本的更新。