Skip to content

Most visited

Recently visited

navigation

Migrar a Android Studio

Project: /studio/_project.yaml Book: /studio/guide/_book.yaml Subcategory: guide

Para migrar tus proyectos a Android Studio es necesaria la adaptación a una estructura de proyecto, una funcionalidad IDE y un sistema de compilación nuevos. Si estás migrando un proyecto Android desde Eclipse, Android Studio proporciona una herramienta de importación para que traslades rápidamente tu código existente en proyectos de Android Studio y archivos de compilación basados en Gradle. Para obtener más información, consulta Migración desde Eclipse.

Si estás migrando desde IntelliJ y tu proyecto ya usa Gradle, simplemente puedes abrir tu proyecto existente desde Android Studio. Si estás usando IntelliJ, pero tu proyecto todavía no usa Gradle, deberás implementar algunas acciones manuales antes de poder importar tu proyecto a Android Studio. Para obtener más información, consulta Migración desde IntelliJ.

Conceptos básicos de Android Studio

A continuación, te indicamos algunas de las diferencias claves 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 Conoce Android Studio.

Android Studio no usa espacios de trabajo, por lo que cada proyecto se abre en una ventana de Android Studio diferente. Android Studio organiza el código en proyectos, que contienen todo lo que define tu app para Android, desde el código fuente de esta hasta las configuraciones de compilación y el código de prueba. 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 acerca de los proyectos y módulos de Android Studio, consulta Información general sobre 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 sintaxis Groovy para facilitar la extensibilidad y personalización.

Los proyectos basados en Gradle ofrecen funciones importantes para el desarrollo de Android, entre ellas:

Para obtener más información acerca del uso y de la configuración de Gradle, consulta Configurar tu compilación.

Dependencias

Las dependencias de bibliotecas en Android Studio usan declaraciones de dependencia de Gradle y dependencias Maven para bibliotecas locales de origen y binarias conocidas con coordenadas Maven. Para obtener más información, consulta Configurar variantes de compilación.

Código de prueba

Con el complemento de ADT para Eclipse, las pruebas de instrumentación se escriben en proyectos diferentes y se integran a través del elemento <instrumentation> en tu archivo de manifiesto. Android Studio proporciona un directorio androidTest/ en el conjunto principal de archivos de origen de tu proyecto, para que puedas agregar y mantener fácilmente tu código de prueba de instrumentación en la misma vista del proyecto. Android Studio también proporciona un directorio test/ en el conjunto principal de archivos de origen de tu proyecto para realizar pruebas de equipos virtuales Java (JVM) locales.

Migración desde Eclipse

Android Studio ofrece una herramienta de importación automatizada para los proyectos Android que fueron creados con Eclipse.

Requisitos previos para la migración

Antes de migrar tu app desde Eclipse a Android Studio, repasa los siguientes pasos para asegurarte de que tu proyecto esté listo para la conversión, y verifica que tienes la configuración de herramientas que necesitas en Android Studio.

En el complemento ADT de Eclipse:

En Android Studio:

Importar proyectos de Eclipse en Android Studio

Debes decidir cómo importarás tus proyectos de ADT para Eclipse según su estructura:

Importar como un proyecto:

  1. Inicia Android Studio y cierra los proyectos de Android Studio abiertos.
  2. En el menú de Android Studio, haz clic en File > New > Import Project.
    • Como opción, en la pantalla de bienvenida, haz clic en Import project (Eclipse ADT, Gradle, etc.).
  3. Selecciona la carpeta del proyecto de ADT para Eclipse del archivo AndroidManifest.xml y haz clic en Ok.

  4. Selecciona la carpeta de destino y haz clic en Next.

  5. Selecciona las opciones de importación y haz clic en Finish.
  6. El proceso de importación te indicará que migres las dependencias de bibliotecas y proyectos a Android Studio, y que agregues las declaraciones de las dependencias al archivo build.gradle. Consulta Crear una biblioteca de Android para obtener más información acerca de este proceso.

    El proceso de importación también reemplaza las bibliotecas de origen conocidas, las bibliotecas binarias y los archivos JAR que poseen coordenadas Maven conocidas con dependencias de Maven, de modo que ya no necesites mantener esas dependencias manualmente. Las opciones de importación también te permiten ingresar al directorio de tu área de trabajo y a los mapas de ruta de acceso reales para abordar las vías de acceso relativas, variables de vías de acceso y referencias a recursos vinculados no resueltas.

  7. Android Studio importa la app y muestra el resumen de importación del proyecto. Lee el resumen para obtener información detallada sobre la reestructuración del proyecto y el proceso de importación.

Después de importar el proyecto del complemento ADT para Eclipse a Android Studio, la carpeta de cada módulo de la app en Android Studio contendrá el conjunto completo de archivos de origen para ese módulo, incluidos los directorios src/main/ y src/androidTest/, los recursos, el archivo de compilación y el manifiesto de Android. Antes de comenzar a desarrollar la app, debes resolver los problemas que se muestran en el resumen de importación del proyecto para asegurarte de que el proceso de reestructuración e importación del proyecto se haya completado correctamente.

Importar como un módulo:

  1. Inicia Android Studio y abre el proyecto al que quieras agregar el módulo.
  2. En el menú de Android Studio, haz clic en File > New > Import Module.
  3. Selecciona la carpeta del proyecto de ADT para Eclipse con el archivo AndroidManifest.xml y haz clic en Ok.
  4. Si lo deseas, puedes modificar el nombre del módulo y luego hacer clic en Next.
  5. El proceso de importación te indicará que migres las dependencias de bibliotecas y proyectos a Android Studio, y que agregues las declaraciones de las dependencias al archivo build.gradle. Para obtener más información acerca de la migración de dependencias de bibliotecas y proyectos, consulta Crear una biblioteca de Android. El proceso de importación también reemplaza las bibliotecas de origen conocidas, las bibliotecas binarias y los archivos JAR que poseen coordenadas Maven conocidas con dependencias de Maven, de modo que ya no necesites mantener esas dependencias manualmente. Las opciones de importación también te permiten ingresar al directorio de tu área de trabajo y a los mapas de ruta de acceso reales para abordar las vías de acceso relativas, variables de vías de acceso y referencias a recursos vinculados no resueltas.
  6. Haz clic en Finish.

Validar proyectos importados

Después de completar el proceso de importación, usa las opciones de menú Build y Run de Android Studio para compilar tu proyecto y verificar el resultado. Si tu proyecto no se compila correctamente, comprueba los siguientes ajustes de configuración:

Si aún se presentan problemas inesperados al compilar y ejecutar tu proyecto en Android Studio después de haber comprobado estas configuraciones, considera modificar el proyecto de ADT para Eclipse y volver a iniciar el proceso de importación.

Nota: Al importar un proyecto de ADT para Eclipse a Android Studio, se crea un nuevo proyecto de Android Studio que no afecta el proyecto existente de ADT para Eclipse.

Migración desde IntelliJ

Si tu proyecto de IntelliJ usa el sistema de compilación de Gradle, puedes importar tu proyecto directamente en Android Studio. Si tu proyecto de IntelliJ usa Maven u otro sistema de compilación, antes de migrar a Android Studio debes configurarlo para que funcione con Gradle.

Importar un proyecto de IntelliJ basado en Gradle

Si ya estás usando 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.

Importar un proyecto de IntelliJ no basado en Gradle

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

Migrar mediante la creación de un nuevo proyecto vacío

Para migrar tu proyecto a Android Studio mediante la creación de un nuevo proyecto vacío y la copia de tus archivos de origen 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 donde debe crearse y luego haz clic en Next.
  3. Selecciona los formatos sobre los que se ejecutará tu app, y haz clic en Next.
  4. Haz clic en Add No Activity, y luego haz clic en Finish.
  5. En la ventana de herramientas Project, haz clic en la flecha para abrir la lista desplegable 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 cómo cambiar vistas y cómo Android Studio estructura los proyectos, consulta Project Files.
  6. Dirígete a la ubicación que seleccionaste para tu nuevo proyecto y mueve el código, las pruebas de unidad, 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 cuadro de diálogo Project Structure. Asegúrate de que el módulo de tu app esté seleccionado en el panel izquierdo.
  8. Haz las modificaciones necesarias para tu proyecto en la pestaña Properties (por ejemplo, modifica minSdkVersion o targetSdkVersion).
  9. Haz clic en Dependencies y agrega las bibliotecas de las que depende tu proyecto como dependencias de Gradle. Para agregar una nueva dependencia, haz clic en Add , selecciona el tipo de dependencia que quieres agregar y sigue las indicaciones.
  10. Haz clic en OK para guardar las modificaciones.
  11. Haz clic en Build > Make Project para comprobar la compilación de tu proyecto y resuelve cualquier error existente.

Migrar mediante la creación de un archivo de compilación de Gradle personalizado

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

  1. Antes de comenzar, asegúrate de crear una copia de seguridad de tus archivos de proyecto en una ubicación separada, ya que el proceso de migración modificará los contenidos de tu proyecto actual.
  2. A continuación, crea un archivo en tu directorio de proyecto denominado build.gradle. El archivo build.gradle incluirá toda la información requerida para que Gradle ejecute tu compilación.

    En 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.

    Debido a que tu proyecto de IntelliJ no usa la misma estructura, tu archivo build.gradle debe apuntar a los directorios de origen para la compilación en tus carpetas existentes (por ejemplo, res/ y src/) en lugar de apuntar a la nueva estructura de directorio predeterminada. El siguiente archivo build.gradle de ejemplo incluye la configuración básica para una compilación de Gradle, así como un bloque sourceSets{} dentro del bloque android{} para definir los directorios de origen correctos y trasladar las pruebas y los tipos de compilación para evitar conflictos de nombres. Copia el siguiente bloque de código en tu archivo build.gradle y haz los cambios necesarios para trabajar con tu configuración de proyecto existente. Por ejemplo, es posible que tengas que incluir dependencias adicionales, que uses una versión SDK de destino diferente, o que debas especificar diferentes ubicaciones para tus directorios de origen.
    // This buildscript{} block configures the code driving the build
    buildscript {
       /**
        * The nested repositories{} block declares that this build uses the
        * jcenter repository.
        */
        repositories {
            jcenter()
        }
    
       /**
        * This block declares a dependency on the 3.0.1 version
        * of the Gradle plugin for the buildscript.
        */
        dependencies {
            classpath 'com.android.tools.build:gradle:3.0.1'
        }
    }
    
    /**
     * This line applies the com.android.application plugin. Note that you should
     * only apply the com.android.application plugin. Applying the Java plugin as
     * well will result in a build error.
     */
    apply plugin: 'com.android.application'
    
    /**
     * This dependencies block includes any dependencies for the project itself. The
     * following line includes all the JAR files in the libs directory.
     */
    dependencies {
        compile fileTree(dir: 'libs', include: ['*.jar'])
        // Add other library dependencies here (see the next step)
    }
    
    /**
     * The android{} block configures all of the parameters for the Android build.
     * You must provide values for at least the build tools version and the
     * compilation target.
     */
    android {
        compileSdkVersion 26
        buildToolsVersion "26.0.2"
    
        /**
        * This nested sourceSets block points the source code directories to the
        * existing folders in the project, instead of using the default new
        * organization.
        */
        sourceSets {
            main {
                manifest.srcFile 'AndroidManifest.xml'
                java.srcDirs = ['src']
                resources.srcDirs = ['src']
                aidl.srcDirs = ['src']
                renderscript.srcDirs = ['src']
                res.srcDirs = ['res']
                assets.srcDirs = ['assets']
            }
    
            // Move the tests to tests/java, tests/res, etc...
            instrumentTest.setRoot('tests')
    
           /**
            * Move the build types to build-types/<type>
            * For instance, build-types/debug/java, build-types/debug/AndroidManifest.xml, ...
            * This moves them out of them default location under src/<type>/... which would
            * conflict with src/ being used by the main source set.
            * Adding new build types or product flavors should be accompanied
            * by a similar customization.
            */
            debug.setRoot('build-types/debug')
            release.setRoot('build-types/release')
         }
    }
    
    Para obtener más información sobre la configuración y la personalización de un archivo de compilación de Gradle, consulta Configurar tu compilación.
  3. A continuación, identifica los proyectos de biblioteca que estás usando. Con Gradle, ya no necesitas agregar estas bibliotecas como proyectos de código fuente, sino que puedes hacer referencia a ellas en el bloque dependencies{} de tu archivo de compilación. De esta manera, el sistema de compilación gestionará estas bibliotecas por ti; por ejemplo, descargará bibliotecas, fusionará recursos y fusionará entradas de manifiesto. El siguiente ejemplo agrega las declaraciones para los Servicios de Google Play y cierta cantidad de bibliotecas de soporte al bloque dependencies{} que se muestra en el archivo de compilación de ejemplo que se incluye más arriba.
    ...
    dependencies {
        compile fileTree(dir: 'libs', include: ['*.jar'])
    
        // Google Play Services
        compile 'com.google.android.gms:play-services:9.8.0'
    
        // Support Libraries
        compile 'com.android.support:appcompat-v7:27.0.0'
        compile 'com.android.support:cardview-v7:27.0.0'
        compile 'com.android.support:design:27.0.0'
        compile 'com.android.support:gridlayout-v7:27.0.0'
        compile 'com.android.support:leanback-v17:27.0.0'
        compile 'com.android.support:mediarouter-v7:27.0.0'
        compile 'com.android.support:palette-v7:27.0.0'
        compile 'com.android.support:recyclerview-v7:27.0.0'
        compile 'com.android.support:support-annotations:27.0.0'
        compile 'com.android.support:support-v13:27.0.0'
        compile 'com.android.support:support-v4:27.0.0'
    
        // Note: these libraries require the "Google Repository" and "Android Repository"
        //       to be installed via the SDK manager.
    }
    
    Para ayudar a determinar las declaraciones correctas para tus bibliotecas, Gradle, pleasepuede proporcionarte las declaraciones correctas basadas en Maven Central.
  4. Guarda tu archivo build.gradle y cierra el proyecto en IntelliJ. Dirígete a tu directorio de proyectos y quita el directorio .idea y cualquier archivo .iml dentro de tu proyecto.
  5. Abre Android Studio y haz clic en File > New > Import Project.
  6. Ubica tu directorio de proyectos, haz clic en el archivo build.gradle que creaste anteriormente para seleccionarlo y haz clic en OK para importar tu proyecto.
  7. Haz clic en Build > Make Project para comprobar tu archivo de compilación mediante la creación de tu proyecto y resuelve cualquier error que encuentres.

Siguientes pasos

Una vez que hayas migrado tu proyecto a Android Studio, consulta Compilación y ejecución de tu app para obtener más información sobre cómo compilar con Gradle y cómo ejecutar tu app en Android Studio.

Según tu proyecto y tu flujo de trabajo, es posible que quieras obtener más información sobre cómo usar el control de versiones, gestionar dependencias, firmar y empaquetar tu app, o configurar y actualizar Android Studio. Para comenzar a usar Android Studio, lee Conoce Android Studio.

Configurar el control de versión

Android Studio admite diferentes sistemas de control de versión, incluidos Git, GitHub, CVS, Mercurial, Subversion y Google Cloud Source Repositories.

Después de importar tu app a Android Studio, usa las opciones del menú del VCS de Android Studio a fin de habilitar la compatibilidad con VCS para el sistema de control de versión deseado, crea un repositorio, importa los nuevos archivos al control de versión y realiza 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ú desplegable y 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 los ajustes de control de versión.

Para obtener más información sobre cómo trabajar con el Control de versiones, consulta Referencia de control de versiones de IntelliJ.

Repositorio de compatibilidad de Android y repositorio de servicios de Google Play

Mientras el complemento ADT para Eclipse usa la biblioteca de compatibilidad de Android y la biblioteca de servicios de Google Play, Android Studio reemplaza estas bibliotecas durante el proceso de importación con el repositorio de compatibilidad de Android y el repositorio de Google para mantener una funcionalidad compatible y admitir nuevas funciones de Android. Android Studio agrega estas dependencias como dependencias Maven mediante el uso de coordenadas Maven conocidas, de modo que esas dependencias no requieran actualizaciones manuales.

En Eclipse, para poder usar una biblioteca de compatibilidad, debes modificar las dependencias de classpath de tu proyecto en tu entorno de desarrollo para cada biblioteca de compatibilidad que quieras usar. En Android Studio, ya no necesitas copiar orígenes de bibliotecas a tus proyectos, simplemente puedes declarar una dependencia. Con esto, la biblioteca se descargará automáticamente y se incorporará a tu proyecto. Esto incluye la incorporación automática de recursos, entradas del manifiesto, reglas de exclusión de ProGuard y reglas lint personalizadas al momento de la compilación. Para obtener más información acerca de las dependencias, consulta Configurar variantes de compilación.

Firma de apps

Si tu app usó un certificado de depuración en el complemento ADT para Eclipse, Android Studio continúa haciendo referencia a ese certificado. De lo contrario, la configuración de depuración usa el keystore 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.

Al compilar tu app para el lanzamiento, Android Studio aplica el certificado de lanzamiento usado en el complemento de ADT para Eclipse. Si no se localizó un certificado durante el proceso de importación, agrega la configuración de firma para el lanzamiento al archivo build.gradle o usa la opción del menú Build > Generate Signed APK para abrir el asistente de generación de APK firmado Generate Signed APK Wizard. Para obtener más información acerca de cómo firmar tu app, consulta Firma de tus aplicaciones.

Ajuste del 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 memoria RAM, puedes mejorar el rendimiento aumentando el tamaño máximo de montón en las opciones de VM para Android Studio.

Para obtener más información acerca de cómo configurar Android Studio, consulta Configurar Android Studio y Configuración de Android Studio.

Optimización de tu proyecto para Instant Run

Instant Run, presentado en Android Studio 2.0, es un comportamiento para los comandos Run y Debug que reduce significativamente el tiempo entre las actualizaciones de tu app. Aunque tu primera compilación puede tardar más tiempo en completarse, Instant Run envía actualizaciones subsiguientes a tu app sin compilar un nuevo APK, por lo que los cambios son visibles mucho más rápido. Puedes mejorar el proceso de compilación de Instant Run cambiando algunas configuraciones de Android Studio.

Para obtener más información sobre cómo configurar tu proyecto para mejorar el rendimiento de Instant Run, consulta Configurar y optimizar tu proyecto para Instant Run.

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 también recibir vistas previas o versiones beta.

Para obtener más información acerca de cómo actualizar Android Studio y cómo usar vistas previas y versiones beta, consulta Permanece actualizado.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)