Cómo migrar a Android Studio

Para migrar tus proyectos a Android Studio, debes adaptarte a una estructura de proyecto, una funcionalidad IDE y un sistema de compilación nuevos.

Si realizas la migración desde IntelliJ y tu proyecto ya usa Gradle, puedes abrir tu proyecto existente desde Android Studio. Si usas IntelliJ, pero tu proyecto todavía no usa Gradle, debes prepararlo manualmente antes de importarlo a Android Studio. Para obtener más información, consulta la sección Cómo migrar desde IntelliJ.

Conceptos básicos de Android Studio

A continuación, te indicamos algunas de las diferencias clave que debes conocer mientras te preparas para la migración a Android Studio.

Organización del proyecto y de los módulos

Android Studio se basa en el IDE de IntelliJ IDEA. Para familiarizarte con los conceptos básicos del IDE, como la navegación, la compleción de código y las combinaciones de teclas, consulta Introducción a Android Studio.

Android Studio organiza el código en proyectos, que contienen todo lo que define tu app para Android: desde el código fuente hasta las configuraciones de compilación y el código de prueba. Cada proyecto se abre en una ventana diferente del programa. Cada proyecto contiene uno o más módulos que te permiten dividirlo en unidades de funcionalidad discretas. Los módulos se pueden compilar, probar y depurar de forma independiente.

Para obtener más información sobre los proyectos y módulos de Android Studio, consulta Descripción general de proyectos.

Sistema de compilación basado en Gradle

El sistema de compilación de Android Studio se basa en Gradle y usa archivos de configuración de compilación escritos con secuencia de comandos Groovy o Kotlin para facilitar la extensibilidad y personalización.

Los proyectos basados en Gradle ofrecen funciones importantes para el desarrollo en Android. Se incluyen las siguientes:

  • Compatibilidad con bibliotecas binarias (AAR). Ya no necesitas copiar recursos de biblioteca a tus proyectos; puedes declarar una dependencia, y la biblioteca se descargará y combinará automáticamente en tu proyecto. Esta función incluye la fusión automática en recursos, entradas de manifiesto, reglas de exclusión de ProGuard y reglas de lint personalizadas, entre otros aspectos, durante el tiempo de compilación.
  • Compatibilidad con variantes de compilación, que te permiten compilar diferentes versiones de tu app (como una versión gratuita y otra profesional) a partir del mismo proyecto.
  • Fácil configuración de compilación y personalización. Por ejemplo, puedes obtener nombres y códigos de versión de las etiquetas Git como parte de la compilación.
  • Gradle se puede usar desde el IDE, desde la línea de comandos y desde servidores de integración continua como Jenkins, lo que proporciona la misma compilación en cualquier momento y lugar.

Para obtener más información sobre el uso y la configuración de Gradle, consulta Cómo configurar tu compilación.

Dependencias

Las dependencias de bibliotecas en Android Studio usan declaraciones de dependencia de Gradle y dependencias de Maven para bibliotecas fuente locales y binarias conocidas con coordenadas de Maven. Para obtener más información, consulta Cómo declarar dependencias.

Migración desde IntelliJ

Si tu proyecto de IntelliJ usa el sistema de compilación de Gradle, puedes importar tu proyecto directamente a Android Studio. Si tu proyecto de IntelliJ usa Maven o algún otro sistema de compilación, para poder realizar la migración a Android Studio, debes configurarlo de modo que funcione con Gradle.

Cómo importar un proyecto de IntelliJ basado en Gradle

Si ya usas Gradle con tu proyecto de IntelliJ, sigue estos pasos para abrirlo en Android Studio:

  1. Haz clic en File > New > Import Project.
  2. Selecciona tu directorio de proyectos de IntelliJ y haz clic en OK. Tu proyecto se abrirá en Android Studio.

Cómo importar un proyecto de IntelliJ no basado en Gradle

Si tu proyecto de IntelliJ todavía no usa el sistema de compilación de Gradle, tienes dos opciones para importar tu proyecto a Android Studio, que se describen en las siguientes secciones:

Cómo realizar la migración creando un nuevo proyecto vacío

Para migrar tu proyecto a Android Studio creando un nuevo proyecto vacío y copiando tus archivos fuente en nuevos directorios, sigue estos pasos:

  1. Abre Android Studio y haz clic en File > New > New Project.
  2. Escribe un nombre para tu proyecto de app, especifica la ubicación en la que debe crearse y, luego, haz clic en Next.
  3. Selecciona los factores de forma sobre los que se ejecuta tu app y, luego, haz clic en Next.
  4. Haz clic en Add No Activity y, luego, en Finish.
  5. En la ventana de herramientas Project, haz clic en la flecha para abrir el menú de vistas y selecciona la vista Project para ver y explorar la organización de tu nuevo proyecto de Android Studio. Para obtener más información sobre la forma en la que se cambian las vistas y cómo Android Studio estructura los proyectos, consulta Archivos de proyecto.
  6. Dirígete a la ubicación que seleccionaste para tu nuevo proyecto y mueve el código, las pruebas de unidades, las pruebas de instrumentación y los recursos de tus antiguos directorios de proyectos a las ubicaciones correspondientes en tu nueva estructura de proyecto.
  7. En Android Studio, haz clic en File > Project Structure para abrir el diálogo Project Structure. Asegúrate de que el módulo de tu app esté seleccionado en el panel izquierdo.
  8. Realiza las modificaciones necesarias a tu proyecto en la pestaña Properties (por ejemplo, modifica minSdk o targetSdk).
  9. Haz clic en Dependencies y agrega las bibliotecas de las que depende tu proyecto como dependencias de Gradle. Para agregar una dependencia nueva, haz clic en Add , selecciona el tipo de dependencia que desees agregar y sigue las indicaciones.
  10. Haz clic en OK para guardar las modificaciones.
  11. Haz clic en Build > Make Project para realizar pruebas de compilación de tu proyecto y, si es necesario, resolver cualquier error existente.

Cómo realizar la migración creando un archivo de compilación de Gradle personalizado

Para migrar tu proyecto a Android Studio creando un nuevo archivo de compilación de Gradle que apunte a tus archivos fuente existentes, sigue estos pasos:

  1. Antes de comenzar, crea una copia de seguridad de los archivos de tu proyecto en una ubicación separada, ya que el proceso de migración modifica los contenidos de tu proyecto actual.
  2. Crea un archivo en el directorio de tu proyecto llamado build.gradle si usas Groovy o build.gradle.kts si usas la secuencia de comandos de Kotlin. El archivo contiene toda la información requerida para que Gradle ejecute tu compilación.

    De forma predeterminada, Android Studio espera que tu proyecto se organice como se observa en la Figura 1.

    Figura 1: Estructura de proyecto predeterminada para un módulo de app de Android

    En settings.gradle para Groovy o settings.gradle.kts para la secuencia de comandos de Kotlin, debes configurar los repositorios que se usan para buscar complementos y dependencias en los bloques pluginManagement y dependencyResolutionManagement, respectivamente:

    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")
      

    Advertencia: El repositorio de JCenter se convirtió en solo lectura el 31 de marzo de 2021. Para obtener más información, consulta la Actualización del servicio de JCenter.

    El complemento de Android para Gradle aplica algunos conjuntos de orígenes predeterminados al proyecto. Estos conjuntos de orígenes definen los directorios que se usan para almacenar diversos tipos de archivos de origen. Gradle usa estos conjuntos de orígenes para determinar las ubicaciones de tipos de archivos específicos. Si tu proyecto existente no se ajusta a los valores predeterminados, puedes mover los archivos a donde deberían estar o cambiar los conjuntos de orígenes predeterminados para que Gradle sepa dónde encontrarlos.

    Para obtener más información sobre la configuración y la personalización de un archivo de compilación de Gradle, consulta Cómo configurar tu compilación.

  3. A continuación, identifica los proyectos de biblioteca que uses.

    Con Gradle, ya no necesitas agregar estas bibliotecas como proyectos de código fuente. En su lugar, puedes hacer referencia a ellas en el bloque dependencies{} de tu archivo de compilación De esta manera, el sistema de compilación se encargará de controlar esas bibliotecas (por ejemplo, las descargará y fusionará recursos y entradas de manifiesto). En el siguiente ejemplo, se agregan las sentencias de declaración para varias bibliotecas de AndroidX al bloque dependencies{} de un archivo de compilación.

    Groovy

    ...
    dependencies {
        implementation fileTree(dir: 'libs', include: ['*.jar'])
    
        // AndroidX libraries
        implementation 'androidx.core:core-ktx:1.12.0'
        implementation 'androidx.appcompat:appcompat:1.6.1'
        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.7.1'
    
        // 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.12.0")
        implementation("androidx.appcompat:appcompat:1.6.1")
        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.7.1")
    
        // Note: these libraries require that the Google repository has been declared
        // in the pluginManagement section of the top-level build.gradle.kts file.
    }
    Si deseas obtener orientación sobre cómo determinar las sentencias de declaración apropiadas para tus bibliotecas, busca el repositorio de Maven de Google o Maven Central.
  4. Guarda tu archivo build.gradle y cierra el proyecto en IntelliJ. Dirígete a tu directorio de proyectos y borra el directorio .idea y cualquier archivo IML en tu proyecto.
  5. Inicia Android Studio y haz clic en File > New > Import Project.
  6. Ubica tu directorio de proyectos, selecciona el archivo build.gradle o build.gradle.kts que creaste, y haz clic en OK para importar tu proyecto.
  7. Para comprobar tu archivo de compilación, haz clic en Build > Make Project, crea tu proyecto y resuelve cualquier error que encuentres.

Próximos pasos

Una vez que hayas migrado el proyecto a Android Studio, consulta Cómo compilar y ejecutar tu app para obtener más información sobre el modo en que se compila con Gradle y se ejecuta la app en Android Studio.

Según tu proyecto y flujo de trabajo, probablemente también desees obtener más información sobre el control de versión, la administración de dependencias y la configuración de Android Studio. Para comenzar a usar Android Studio, lee Introducción a Android Studio.

Cómo configurar el control de versión

Android Studio admite diferentes sistemas de control de versión, incluidos Git, Mercurial y Subversion. Se pueden agregar otros sistemas de control de versión mediante complementos.

Si tu app ya está bajo el control del código fuente, es posible que debas habilitarla en Android Studio. En el menú del VCS, haz clic en Enable Version Control Integration y selecciona el sistema de control de versión correcto.

Si tu app no está bajo el control del código fuente, puedes configurarla después de importarla a Android Studio. Usa las opciones del menú del VCS de Android Studio para habilitar la compatibilidad con VCS para el sistema de control de versión deseado, crear un repositorio, importar los archivos nuevos al control de versión y realizar otras operaciones de control de versión:

  1. En el menú del VCS de Android Studio, haz clic en Enable Version Control Integration.
  2. Selecciona un sistema de control de versión para asociarlo con la raíz del proyecto en el menú y, luego, haz clic en OK. En el menú del VCS se mostrarán diversas opciones de control de versión según el sistema que hayas seleccionado.

Nota: También puedes usar la opción del menú File > Settings > Version Control para configurar y modificar el control de versión.

Para obtener más información sobre cómo trabajar con el control de versión, consulta la referencia de control de versión de IntelliJ.

Firma de apps

Si se usó un certificado de depuración anteriormente, es posible que se detecte durante el proceso de importación. En ese caso, Android Studio continúa haciendo referencia a ese certificado. De lo contrario, la configuración de depuración usa el almacén de claves de depuración generado por Android Studio, con una contraseña conocida y una clave predeterminada con una contraseña conocida ubicada en $HOME/.android/debug.keystore. El tipo de compilación de depuración se configura automáticamente para usar esta configuración de depuración cuando ejecutas o depuras tu proyecto desde Android Studio.

Del mismo modo, el proceso de importación puede detectar un certificado de lanzamiento existente. Si no se definió un certificado de lanzamiento anteriormente, agrega la configuración de firma para el lanzamiento al archivo build.gradle o build.gradle.kts, o usa la opción del menú Build > Generate Signed APK para abrir el asistente de generación de APK firmado. Obtén más información sobre Cómo firmar tu app.

Cómo ajustar el tamaño máximo de montón de Android Studio

De forma predeterminada, Android Studio tiene un tamaño máximo de montón de 1280 MB. Si trabajas en un proyecto grande o tu sistema tiene mucha RAM, puedes mejorar el rendimiento aumentando el tamaño máximo de montón.

Actualizaciones de software

Android Studio se actualiza por separado del complemento Gradle, las herramientas de compilación y las herramientas del SDK. Puedes especificar las versiones que quieras usar con Android Studio.

De forma predeterminada, Android Studio proporciona actualizaciones automáticas cada vez que se lanza una nueva versión estable, pero puedes optar por actualizar con más frecuencia y recibir versiones preliminares o versiones Beta.

Para obtener más información acerca de cómo actualizar Android Studio y usar versiones preliminares y versiones beta, lee sobre las actualizaciones.