將項目遷移至 Android Studio 需要適應新的項目結(jié)構(gòu),、構(gòu)建系統(tǒng)和 IDE 功能。 為了簡化遷移過程,，Android Studio 提供了導入工具,，您可以將現(xiàn)有代碼快速移至 Android Studio 項目和基于 Gradle 的構(gòu)建文件。

Android Studio 基礎(chǔ)知識

在準備遷移至 Android Studio 時您需要了解以下關(guān)鍵區(qū)別,。

項目和模塊組織

Android Studio 基于 IntelliJ IDEA IDE,。 如需了解 IDE 基礎(chǔ)知識，例如導航,、代碼自動完成和鍵盤快捷鍵,，請參閱探索 Android Studio。

Android Studio 不使用工作區(qū),，因此各個項目在單獨的 Android Studio 窗口中打開,。 Android Studio 將代碼組織到項目中,，其中包含從應用源代碼到構(gòu)建配置和測試代碼等定義 Android 應用的所有信息。每個項目包含一個或多個模塊,，您可以將項目分成獨立的功能單元,。模塊可獨立構(gòu)建、測試和調(diào)試,。

如需了解有關(guān) Android Studio 項目和模塊的詳細信息,，請參閱項目概覽。

基于 Gradle 的構(gòu)建系統(tǒng)

Android Studio 的構(gòu)建系統(tǒng)基于 Gradle,，并使用以 Groovy 語法編寫的構(gòu)建配置文件,，以便于擴展和自定義。

如需了解有關(guān)使用和配置 Gradle 的詳細信息,，請參閱配置構(gòu)建,。

依賴關(guān)系

在 Android Studio 中,，庫依賴關(guān)系使用依賴關(guān)系聲明，對于具有 Maven 坐標的已知本地源代碼和二進制庫,，則使用 Maven 依賴關(guān)系,。如需了解詳細信息,，請參閱配置構(gòu)建變體,。

測試代碼

通過使用 Eclipse ADT，可在不同的項目中編寫儀器測試,，并通過清單文件中的 <instrumentation> 元素進行集成,。Android Studio 在項目的主源代碼集中提供 androidTest/ 目錄，因此您可以在同一項目視圖中輕松添加和維護儀器測試代碼,。 Android Studio 在項目的主源代碼集中還提供了 test/ 目錄,，用于本地 JVM 測試。

遷移先決條件

在將您的應用遷移到 Android Studio 前,，請瀏覽以下步驟,，確保您的項目已做好轉(zhuǎn)換的準備，同時確認 Android Studio 中有您需要的工具配置：

在 Eclipse ADT 中：

• 確保 Eclipse ADT 根目錄包含 AndroidManifest.xml 文件,。 此外,，根目錄必須包含 Eclipse 的 .project 和 .classpath 文件或 res/ 和 src/ 目錄。
• 構(gòu)建您的項目,，以確保導入時保存并包含了最新的工作區(qū)和項目更新,。
• 在需要導入的 project.properties 或.classpath 文件中注釋掉對 Eclipse ADT 工作區(qū)庫文件的任何引用。 您可以在導入后在 build.gradle 文件中添加這些引用,。 如需了解詳細信息,，請參閱配置構(gòu)建,。
• 記錄工作區(qū)目錄,、路徑變量和任何實際路徑映射可能會有所幫助,，這些內(nèi)容可用于指定任何未解析的相對路徑、路徑變量和鏈接的資源引用,。Android Studio 允許您在導入過程中手動指定任何未解析的路徑。

在 Android Studio 中：

• 如果您尚未安裝,，點擊此處下載 Android Studio,。 如果您已經(jīng)安裝了 Android Studio，請點擊 Help > Check for Updates（在 Mac 上,，點擊 Android Studio > Check for Updates），驗證其是否是最新的穩(wěn)定版本,。
• 因為 Android Studio 無法遷移任何第三方 Eclipse ADT 插件，請記下您在 Eclipse 中使用的任何第三方插件,。 您可以查看 Android Studio 中的相同功能,，或在 IntelliJ Android Studio 插件存儲庫中搜索兼容的插件。 使用 File > Settings > Plugins 菜單選項管理 Android Studio 中的插件,。
• 如果您計劃在防火墻后面運行 Android Studio,，則必須為 Android Studio 和 SDK 管理器設(shè)置代理。 Android Studio 設(shè)置向?qū)?、第三方庫訪問,、訪問遠程存儲庫、Gradle 初始化和同步以及 Android Studio 版本更新需要互聯(lián)網(wǎng)連接,。如需了解詳細信息,，請參閱代理設(shè)置。

將項目導入 Android Studio

您應根據(jù)現(xiàn)有 Eclipse ADT 項目的結(jié)構(gòu)確定其導入方式：

• 如果您在 Eclipse ADT 中有多個關(guān)聯(lián)項目共享同一個工作區(qū),，請將第一個項目作為項目導入,，然后添加隨后的關(guān)聯(lián)項目作為該項目中的模塊。
• 如果您的 Eclipse ADT 項目在同一個工作區(qū)中共享依賴關(guān)系,，但并不關(guān)聯(lián),，請將每個 Eclipse ADT 項目作為獨立的項目逐個導入 Android Studio,。在導入過程中 Android Studio 將在新創(chuàng)建的項目之間維持這些共享的依賴關(guān)系,。

作為項目導入：

1. 啟動 Android Studio，并關(guān)閉任何打開的 Android Studio 項目,。
2. 在 Android Studio 菜單中點擊 File > New > Import Project,。
   • 或在“Welcome”屏幕中點擊 Import project (Eclipse ADT, Gradle, etc.),。
3. 選擇包含 AndroidManifest.xml 文件的 Eclipse ADT 項目文件夾，并點擊 Ok,。

4. 選擇目標文件夾,，并點擊 Next。

5. 選擇導入選項,，并點擊 Finish,。

6. 導入過程中會提示您將任何庫和項目依賴關(guān)系遷移到 Android Studio，并將依賴關(guān)系聲明添加到 build.gradle 文件,。如需了解有關(guān)此過程的詳細信息,，請參閱創(chuàng)建 Android 庫。

   導入過程中還將用 Maven 依賴關(guān)系替換具有已知 Maven 坐標的任何已知源代碼庫,、二進制庫和 JAR 文件,，因此您無需手動保留這些依賴關(guān)系。導入選項還允許您輸入工作區(qū)目錄和任何實際路徑映射,，以處理任何未解析的相對路徑,、路徑變量和鏈接的資源引用。

1. Android Studio 導入應用并顯示項目導入摘要,。 查看摘要,，了解項目重組和導入過程的詳細信息。

將項目從 Eclipse ADT 導入 Android Studio 后,，Android Studio 中的每個應用模塊文件夾都包含該模塊的完整源代碼集,，包括 src/main/ 和src/androidTest/目錄、資源,、構(gòu)建文件以及 Android 清單,。在開始應用開發(fā)前，您應解決項目導入摘要中顯示的所有問題,，確保項目重組和導入過程成功完成,。

作為模塊導入：

1. 啟動 Android Studio，并打開想要添加模塊的項目,。
2. 在 Android Studio 菜單中點擊 File > New > Import Module,。
3. 選擇包含 AndroidManifest.xml 文件的 Eclipse ADT 項目文件夾，并點擊 Ok,。
4. 如果需要,，可修改模塊名稱，并點擊 Next,。
5. 導入過程中會提示您將任何庫和項目依賴關(guān)系遷移到 Android Studio,，并將依賴關(guān)系聲明添加到 build.gradle 文件。如需了解有關(guān)遷移庫和項目依賴關(guān)系的詳細信息,，請參閱創(chuàng)建 Android 庫,。導入過程中還將用 Maven 依賴關(guān)系替換具有已知 Maven 坐標的任何已知源代碼庫,、二進制庫和 JAR 文件，因此您無需手動保留這些依賴關(guān)系,。導入選項還允許您輸入工作區(qū)目錄和任何實際路徑映射,，以處理任何未解析的相對路徑、路徑變量和鏈接的資源引用,。
6. 點擊 Finish,。

驗證導入的項目

完成導入過程后，使用 Android Studio 的 Build 和 Run 菜單選項構(gòu)建您的項目,，并驗證輸出,。若項目未正確構(gòu)建，請檢查以下設(shè)置：

• 打開 SDK 管理器（點擊 Android Studio 中的“Android SDK Manager”按鈕或 Tools > Android > SDK Manager）,，驗證您安裝的工具版本是否匹配 Eclipse 項目的設(shè)置,。Android Studio 從您導入的 Eclipse 項目繼承 SDK 管理器和 JDK 設(shè)置。
• 要驗證其他 Android Studio 設(shè)置,，請點擊 File > Project Structure 并檢查以下設(shè)置：
  • 在 SDK Location 項下,，驗證 Android Studio 是否可以訪問正確的 SDK、NDK 和 JDK 位置和版本,。
  • 在 Project 項下,，驗證 Gradle 版本、Android 插件版本和相關(guān)存儲庫,。
  • 在 Modules 項下,，驗證應用和模塊設(shè)置，例如簽署配置和庫依賴關(guān)系,。
• 如果您的項目依賴另一個項目,，則確保在應用模塊文件夾中的 build.gradle 文件中正確定義該依賴關(guān)系。如需了解有關(guān)定義依賴關(guān)系的詳細信息,，請參閱配置構(gòu)建變體,。

如果在檢查這些設(shè)置后，在 Android Studio 中構(gòu)建和運行項目時仍出現(xiàn)異常問題,，請考慮修改 Eclipse ADT 項目并重新開始導入過程,。

注： 將 Eclipse ADT 項目導入 Android Studio 將創(chuàng)建一個新的 Android Studio 項目，不會影響現(xiàn)有 Eclipse ADT 項目,。

后續(xù)步驟

根據(jù)您的項目和工作流程,，您可能想要閱讀更多有關(guān)使用版本控制、管理依賴關(guān)系,、簽署和打包應用或配置和更新 Android Studio 的信息,。

若要開始使用 Android Studio，請閱讀探索 Android Studio。

配置版本控制

Android Studio 支持多個版本控制系統(tǒng),，包括 Git、GitHub,、CVS,、Mercurial、Subversion 和 Google Cloud Source Repositories,。

在將您的應用導入 Android Studio 后,，使用 Android Studio VCS 菜單選項啟用對所需版本控制系統(tǒng)的 VCS 支持、創(chuàng)建存儲庫,、導入新文件至版本控制以及執(zhí)行其他版本控制操作：

1. 在 Android Studio VCS 菜單中點擊 Enable Version Control Integration,。
2. 從下拉菜單中選擇要與項目根目錄關(guān)聯(lián)的版本控制系統(tǒng)，然后點擊 OK,。 此時,，VCS 菜單將根據(jù)您選擇的系統(tǒng)顯示多個版本控制選項。

注： 您還可以使用 File > Settings > Version Control 菜單選項設(shè)置和修改版本控制設(shè)置,。

如需了解有關(guān)使用版本控制的詳細信息,，請參閱 IntelliJ 版本控制參考。

Android 支持存儲庫和 Google Play 服務存儲庫

雖然 Eclipse ADT 使用 Android 支持庫和 Google Play 服務庫,，但在導入過程中 Android Studio 會用 Android 支持存儲庫和 Google 存儲庫替換這些庫,，以便繼續(xù)使用兼容的功能并支持新的 Android 功能。Android Studio 使用已知的 Maven 坐標將這些依賴關(guān)系添加為 Maven 依賴關(guān)系,，因此不需要手動更新這些依賴關(guān)系,。

在 Eclipse 中，要使用支持庫,，您必須針對想要使用的每個支持庫在開發(fā)環(huán)境中修改項目的類路徑依賴關(guān)系,。在 Android Studio 中，無需將庫源代碼復制到您自己的項目中,，您只需聲明依賴關(guān)系,，即可自動下載庫并將其合并到您的項目中。 這包括在構(gòu)建時自動合并到資源,、清單條目,、ProGuard 排除規(guī)則和自定義 Lint 規(guī)則。 如需了解有關(guān)依賴關(guān)系的詳細信息,，請參閱配置構(gòu)建變體,。

應用簽署

如果您的應用在 Eclipse ADT 中使用調(diào)試證書，Android Studio 將繼續(xù)引用該證書,。 或者,，調(diào)試配置使用 Android Studio 生成的一個調(diào)試密鑰庫和一個默認密鑰，二者密碼均已知，調(diào)試密鑰庫位于 $HOME/.android/debug.keystore 中,。

當您從 Android Studio 運行或調(diào)試您的項目時,，調(diào)試構(gòu)建類型將自動使用此調(diào)試配置。在構(gòu)建用于發(fā)布的應用時,，Android Studio 會應用在 Eclipse ADT 中使用的發(fā)布證書,。 如果在導入過程中未找到發(fā)布證書，則將發(fā)布簽署配置添加到 build.gradle 文件,，或使用 Build > Generate Signed APK 菜單選項打開 Generate Signed APK Wizard,。如需了解簽署應用的詳細信息，請參閱簽署您的應用,。

調(diào)整 Android Studio 的最大堆內(nèi)存

默認情況下,，Android Studio 的最大堆內(nèi)存為 1280MB。 如果您要處理較大的項目,，或您的系統(tǒng)有大量 RAM 可用,，您可以通過在 Android Studio 的 VM 選項中增加最大堆內(nèi)存來提高性能。

如需了解有關(guān)配置 Android Studio 設(shè)置的詳細信息,，請參閱配置 Android Studio 和配置 Android Studio,。

軟件更新

Android Studio 與 Gradle 插件、構(gòu)建工具和 SDK 工具分開更新,。 您可以指定想要使用的 Android Studio 版本,。

默認情況下，在有新穩(wěn)定版本發(fā)布時 Android Studio 將自動更新,，但您可以選擇更頻繁地進行更新,，也可以接收預覽版或測試版。

如需了解有關(guān)更新 Android Studio 以及使用預覽版和測試版的詳細信息,，請參閱保持更新,。