迁移到 Android Studio

将您的项目迁移到 Android Studio 需要适应新的项目结构、构建系统和 IDE 功能。

如果您是从 IntelliJ 迁移而来，并且您的项目已使用 Gradle，则可以从 Android Studio 中打开您的现有项目。如果您正在使用 IntelliJ，但您的项目尚未使用 Gradle，则需要在将其导入 Android Studio 之前手动准备您的项目。有关更多信息，请参阅从 IntelliJ 迁移部分。

Android Studio 基础知识

在准备迁移到 Android Studio 时，以下是一些需要注意的关键区别。

项目和模块组织

Android Studio 基于 IntelliJ IDEA IDE。要熟悉 IDE 基础知识，例如导航、代码补全和键盘快捷键，请参阅了解 Android Studio。

Android Studio 将代码组织到项目中，项目包含定义 Android 应用的所有内容，从应用源代码到构建配置和测试代码。项目在单独的 Android Studio 窗口中打开。每个项目包含一个或多个模块，这些模块允许您将项目划分为独立的功能单元。模块可以独立构建、测试和调试。

有关 Android Studio 项目和模块的更多信息，请参阅项目概述。

基于 Gradle 的构建系统

Android Studio 的构建系统基于 Gradle，并使用用 Groovy 或 Kotlin 脚本编写的构建配置文件，以便于扩展和自定义。

基于 Gradle 的项目为 Android 开发提供了重要的功能，包括以下功能

• 支持二进制库 (AAR)。您不再需要将库源代码复制到自己的项目中；您可以声明依赖项，库将自动下载并合并到您的项目中。这包括在构建时自动合并资源、清单条目、Proguard 排除规则、自定义 lint 规则等。
• 支持构建变体，这使您可以从同一个项目构建应用的不同版本（例如免费版和专业版）。
• 轻松构建配置和自定义。例如，您可以将版本名称和版本代码作为构建的一部分从 Git 标签中提取。
• Gradle 可以从 IDE、从命令行以及从 Jenkins 等持续集成服务器使用，从而在任何地方、任何时间提供相同的构建。

有关使用和配置 Gradle 的更多信息，请参阅配置您的构建。

依赖项

Android Studio 中的库依赖项使用 Gradle 依赖项声明和 Maven 依赖项，用于具有 Maven 坐标的知名本地源代码和二进制库。有关更多信息，请参阅声明依赖项。

从 IntelliJ 迁移

如果您的 IntelliJ 项目使用 Gradle 构建系统，则可以直接将您的项目导入 Android Studio。如果您的 IntelliJ 项目使用 Maven 或其他构建系统，则需要将其设置为与 Gradle 一起使用，然后才能迁移到 Android Studio。

导入基于 Gradle 的 IntelliJ 项目

如果您已在 IntelliJ 项目中使用 Gradle，请使用以下步骤在 Android Studio 中打开它

1. 点击文件 > 新建 > 导入项目。
2. 选择您的 IntelliJ 项目目录，然后点击确定。您的项目将在 Android Studio 中打开。

导入非 Gradle IntelliJ 项目

如果您的 IntelliJ 项目尚未使用 Gradle 构建系统，则有两种选项可以将您的项目导入 Android Studio，如下面的部分所述

• 创建一个新的空 Android Studio 项目，并将您现有的源代码复制到与新项目关联的目录中。有关更多信息，请参阅有关通过创建新的空项目进行迁移的部分。
• 为您的项目创建一个新的 Gradle 构建文件，然后将项目和新的构建文件导入 Android Studio。有关更多信息，请参阅有关通过创建自定义 Gradle 构建文件进行迁移的部分。

通过创建新的空项目进行迁移

要通过创建新的空项目并将您的源文件复制到新目录中来将项目迁移到 Android Studio，请按如下步骤操作

1. 打开 Android Studio 并点击文件 > 新建 > 新建项目。
2. 输入应用项目的名称并指定其创建位置，然后点击下一步。
3. 选择您的应用运行的表单因子，然后点击下一步。
4. 点击不添加 Activity，然后点击完成。
5. 在项目工具窗口中，点击箭头以打开视图菜单，并选择项目视图以查看和浏览新 Android Studio 项目的组织结构。要详细了解更改视图以及 Android Studio 如何构建项目，请参阅项目文件。
6. 导航到您为新项目选择的位置，并将代码、单元测试、仪器测试和资源从旧项目目录移动到新项目结构中的正确位置。
7. 在 Android Studio 中，点击文件 > 项目结构以打开项目结构对话框。确保在左侧窗格中选择了您的应用的模块。
8. 在属性选项卡中对您的项目进行任何必要的修改（例如，修改minSdk或targetSdk）。
9. 点击依赖项，并将项目依赖的任何库添加为 Gradle 依赖项。要添加新的依赖项，请点击添加，然后选择要添加的依赖项类型，并按照提示操作。
10. 点击确定保存您的修改。
11. 点击构建 > 构建项目以测试构建项目，并在必要时解决任何未解决的错误。

通过创建自定义 Gradle 构建文件进行迁移

要通过创建新的 Gradle 构建文件以指向您的现有源文件来将项目迁移到 Android Studio，请按如下步骤操作

1. 在开始之前，请将您的项目文件备份到其他位置，因为迁移过程会修改项目内容。
2. 在您的项目目录中创建一个名为build.gradle的文件（如果您使用 Groovy），或build.gradle.kts的文件（如果您使用 Kotlin 脚本）。此文件包含 Gradle 运行构建所需的所有信息。

   默认情况下，Android Studio 预期您的项目组织结构如图形 1 所示。

   

   在settings.gradle（对于 Groovy）或settings.gradle.kts（对于 Kotlin 脚本）中，分别在pluginManagement和dependencyResolutionManagement块中设置用于查找插件和依赖项的存储库

   Groovy

     pluginManagement {
         repositories {
             google()
             mavenCentral()
             gradlePluginPortal()
         }
     }
     dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
             google()
             mavenCentral()
         }
     }
     rootProject.name = "Test App"
     include ':app'
     

   Kotlin

     pluginManagement {
         repositories {
             google()
             mavenCentral()
             gradlePluginPortal()
         }
     }
     dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
             google()
             mavenCentral()
         }
     }
     rootProject.name = "Test App"
     include(":app")
     

   警告：JCenter 存储库于 2021 年 3 月 31 日变为只读。有关更多信息，请参阅JCenter 服务更新。

   Android Gradle 插件会对项目应用一些默认的源集。这些源集定义用于存储各种类型源文件的目录。Gradle 使用这些源集来确定特定文件类型的存储位置。如果您的现有项目不符合默认设置，则可以将文件移动到它们应该所在的位置，或者更改默认源集，以便 Gradle 知道在哪里可以找到它们。

   有关设置和自定义 Gradle 构建文件的更多信息，请阅读配置您的构建。

3. 接下来，确定您正在使用哪些库项目。

   使用 Gradle，您不再需要将这些库添加为源代码项目。相反，您可以在构建文件的dependencies{}块中引用它们。然后，构建系统将为您处理这些库，包括下载库、合并资源和合并清单条目。以下示例将一些 AndroidX 库的声明语句添加到构建文件的dependencies{}块中。

   Groovy

   ...
   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   
       // AndroidX libraries
       implementation 'androidx.core:core-ktx:1.13.1'
       implementation 'androidx.appcompat:appcompat:1.7.0'
       implementation 'androidx.cardview:cardview:1.0.0'
       implementation 'com.google.android.material:material:1.7.0'
       implementation 'androidx.gridlayout:gridlayout:1.0.0'
       implementation 'androidx.leanback:leanback:1.1.0-rc02'
       implementation 'androidx.mediarouter:mediarouter:1.7.0'
       implementation 'androidx.palette:palette-ktx:1.0.0'
       implementation 'androidx.recyclerview:recyclerview:1.3.2'
       implementation 'androidx.annotation:annotation:1.8.2'
   
       // Note: these libraries require that the Google repository has been declared
       // in the pluginManagement section of the top-level build.gradle file.
   }

   Kotlin

   ...
   dependencies {
       implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))
   
       // AndroidX libraries
       implementation("androidx.core:core-ktx:1.13.1")
       implementation("androidx.appcompat:appcompat:1.7.0")
       implementation("androidx.cardview:cardview:1.0.0")
       implementation("com.google.android.material:material:1.7.0")
       implementation("androidx.gridlayout:gridlayout:1.0.0")
       implementation("androidx.leanback:leanback:1.1.0-rc02")
       implementation("androidx.mediarouter:mediarouter:1.7.0")
       implementation("androidx.palette:palette-ktx:1.0.0")
       implementation("androidx.recyclerview:recyclerview:1.3.2")
       implementation("androidx.annotation:annotation:1.8.2")
   
       // Note: these libraries require that the Google repository has been declared
       // in the pluginManagement section of the top-level build.gradle.kts file.
   }

   要获取库的正确声明语句，请搜索Google Maven 存储库或Maven Central。
4. 保存您的build.gradle文件，然后在 IntelliJ 中关闭项目。导航到您的项目目录，然后删除.idea目录和项目中的任何 IML 文件。
5. 启动 Android Studio 并点击文件 > 新建 > 导入项目。
6. 找到您的项目目录，选择您创建的build.gradle或build.gradle.kts文件，然后点击确定以导入您的项目。
7. 点击构建 > 构建项目以通过构建项目来测试您的构建文件，并解决您发现的任何错误。

后续步骤

将项目迁移到 Android Studio 后，请阅读构建和运行您的应用，了解有关使用 Gradle 构建和在 Android Studio 中运行应用的更多信息。

根据您的项目和工作流程，您可能还想了解有关版本控制、依赖项管理和配置 Android Studio 的更多信息。要开始使用 Android Studio，请阅读了解 Android Studio。

配置版本控制

Android Studio 支持各种版本控制系统，包括 Git、Mercurial 和 Subversion。其他版本控制系统可以通过插件添加。

如果您的应用已在源代码控制下，您可能需要在 Android Studio 中启用它。从 VCS 菜单中，点击启用版本控制集成并选择相应的版本控制系统。

如果您的应用不在源代码控制下，您可以在将应用导入 Android Studio 后配置它。使用 Android Studio VCS 菜单选项为所需的版本控制系统启用 VCS 支持，创建存储库，将新文件导入版本控制，并执行其他版本控制操作

1. 从 Android Studio VCS 菜单中，点击启用版本控制集成。
2. 从菜单中选择一个与项目根目录关联的版本控制系统，然后点击确定。VCS 菜单现在将根据您选择的系统显示许多版本控制选项。

注意：您还可以使用文件 > 设置 > 版本控制菜单选项来设置和修改版本控制。

有关使用版本控制的更多信息，请参阅IntelliJ 的版本控制参考。

应用签名

如果以前使用过调试证书，则可能会在导入过程中检测到它。在这种情况下，Android Studio 将继续引用该证书。否则，调试配置将使用 Android Studio 生成的调试密钥库，使用已知的密码和位于$HOME/.android/debug.keystore中的具有已知密码的默认密钥。当您从 Android Studio 运行或调试项目时，调试构建类型将自动设置为使用此调试配置。

同样，导入过程可能会检测到现有的发布证书。如果以前未定义发布证书，请将发布签名配置添加到build.gradle或build.gradle.kts文件中，或者使用构建 > 生成签名 APK菜单选项打开生成签名 APK 向导。有关签名应用的更多信息，请参阅签名您的应用。

调整 Android Studio 的最大堆大小

默认情况下，Android Studio 的最大堆大小为 1280MB。如果您正在处理大型项目，或者您的系统拥有大量 RAM，则可以通过增加最大堆大小来提高性能。

软件更新

Android Studio 的更新与 Gradle 插件、构建工具和 SDK 工具是分开的。您可以指定希望在 Android Studio 中使用的版本。

默认情况下，Android Studio 会在发布新稳定版本时自动更新，但您也可以选择更频繁地更新并接收预览版或测试版。

有关更新 Android Studio 以及使用预览版和测试版的更多信息，请阅读有关更新的信息。