迁移到 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. 点击 File > New > Import Project（文件 > 新建 > 导入项目）。
2. 选择您的 IntelliJ 项目目录并点击 OK。您的项目将在 Android Studio 中打开。

导入非 Gradle 的 IntelliJ 项目

如果您的 IntelliJ 项目尚未使用 Gradle 构建系统，您有两种将项目导入 Android Studio 的选项，以下各节将对此进行说明：

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

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

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

1. 打开 Android Studio 并点击 File > New > New Project（文件 > 新建 > 新建项目）。
2. 输入应用项目的名称并指定创建位置，然后点击 Next（下一步）。
3. 选择您的应用所运行的设备类型（外形规格），然后点击 Next。
4. 点击 Add No Activity（不添加 Activity），然后点击 Finish（完成）。
5. 在 Project 工具窗口中，点击箭头打开视图菜单，选择 Project 视图，以查看和探索您的新 Android Studio 项目结构。要详细了解如何更改视图以及 Android Studio 如何组织项目，请参阅项目文件。
6. 导航到您为新项目选择的位置，并将代码、单元测试、插桩测试和资源从旧项目目录移动到新项目结构的正确位置。
7. 在 Android Studio 中，点击 File > Project Structure（文件 > 项目结构）以打开项目结构对话框。确保在左侧面板中选中了您的应用模块。
8. 在项目的 Properties 选项卡中进行任何必要的修改（例如修改 minSdk 或 targetSdk）。
9. 点击 Dependencies（依赖项），并将项目依赖的任何库添加为 Gradle 依赖项。要添加新依赖项，请点击 Add ，选择要添加的依赖项类型，然后按提示操作。
10. 点击 OK 以保存您的修改。
11. 点击 Build > Make Project（构建 > 编译项目）以测试构建项目，并在必要时解决任何遗留错误。

通过创建自定义 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 插件会对项目应用一些默认的源集 (source sets)。这些源集定义了用于存储各类源文件的目录。Gradle 使用这些源集来确定特定文件类型的位置。如果您的现有项目不符合默认设置，您可以移动文件，也可以更改默认源集，以便 Gradle 知道在哪里查找它们。

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

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

   使用 Gradle，您无需再将这些库添加为源代码项目。相反，您可以在构建文件的 dependencies{} 代码块中引用它们。构建系统会为您处理这些库，包括下载、合并资源以及合并清单条目。

   以下示例将 Jetpack Compose 和核心 AndroidX 库的声明语句添加到构建文件的 dependencies{} 代码块中。

   Groovy

   ...
   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   
       // Define the Compose Bill of Materials (BOM)
       def composeBom = platform("androidx.compose:compose-bom:2026.05.00")
       implementation composeBom
       androidTestImplementation composeBom
   
       // Jetpack Compose foundational libraries
       implementation 'androidx.compose.ui:ui'
       implementation 'androidx.compose.material3:material3'
       implementation 'androidx.compose.ui:ui-tooling-preview'
   
       // Activity integration
       implementation 'androidx.activity:activity-compose:1.13.0'
       implementation 'androidx.activity:activity-ktx:1.13.0'
   }

   Kotlin

   ...
   dependencies {
       implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))
   
       // Define the Compose Bill of Materials (BOM)
       val composeBom = platform("androidx.compose:compose-bom:2026.05.00")
       implementation(composeBom)
       androidTestImplementation(composeBom)
   
       // Jetpack Compose foundational libraries
       implementation("androidx.compose.ui:ui")
       implementation("androidx.compose.material3:material3")
       implementation("androidx.compose.ui:ui-tooling-preview")
   
       // Activity integration
       implementation("androidx.activity:activity-compose:1.13.0")
       implementation("androidx.activity:activity-ktx:1.13.0")
   }

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

后续步骤

将项目迁移到 Android Studio 后，请阅读构建并运行您的应用，进一步了解如何使用 Gradle 构建项目以及如何在 Android Studio 中运行应用。

根据您的项目和工作流程，您可能还需要进一步了解版本控制、依赖项管理和 Android Studio 配置。要开始使用 Android Studio，请阅读认识 Android Studio。

配置版本控制

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

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

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

1. 在 Android Studio 的 VCS 菜单中，点击 Enable Version Control Integration。
2. 从菜单中选择要与项目根目录关联的版本控制系统，然后点击 OK。VCS 菜单现在会根据您选择的系统显示多个版本控制选项。

注意：您也可以使用 File > Settings > Version Control（文件 > 设置 > 版本控制）菜单选项来设置和修改版本控制。

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

应用签名

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

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

调整 Android Studio 的最大堆大小

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

软件更新

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

默认情况下，每当发布新的稳定版本时，Android Studio 都会提供自动更新，但您可以选择更频繁地更新，以接收 Canary 或 RC（候选发布）版本。

有关更新 Android Studio 以及使用 Canary 和 RC 版本的更多信息，请阅读关于更新的内容。