Zu Android Studio migrieren

Die Migration Ihrer Projekte zu Android Studio erfordert eine Anpassung an eine neue Projektstruktur, ein neues Build-System und neue IDE-Funktionen.

Wenn Sie von IntelliJ migrieren und Ihr Projekt bereits Gradle verwendet, können Sie Ihr vorhandenes Projekt über Android Studio öffnen. Wenn Sie IntelliJ verwenden, aber Gradle für Ihr Projekt nicht bereits nutzt, müssen Sie Ihr Projekt manuell vorbereiten, bevor Sie es in Android Studio importieren können. Weitere Informationen finden Sie im Abschnitt Migration von IntelliJ.

Grundlagen von Android Studio

Hier sind einige der wichtigsten Unterschiede, die du bei der Vorbereitung auf die Migration zu Android Studio beachten solltest.

Projekt- und Modulorganisation

Android Studio basiert auf der IntelliJ IDEA IDE. Unter Android Studio kennenlernen können Sie sich mit den Grundlagen der IDE vertraut machen, z. B. Navigation, Codevervollständigung und Tastenkombinationen.

In Android Studio wird Code in Projekten organisiert, die alles enthalten, was Ihre Android-App definiert, vom App-Quellcode über Build-Konfigurationen bis hin zu Testcode. Projekte werden in separaten Android Studio-Fenstern geöffnet. Jedes Projekt enthält ein oder mehrere Module, mit denen Sie Ihr Projekt in separate Funktionseinheiten aufteilen können. Module lassen sich unabhängig voneinander erstellen, testen und debuggen.

Weitere Informationen zu Android Studio-Projekten und -Modulen findest du in der Projektübersicht.

Gradle-basiertes Build-System

Das Build-System von Android Studio basiert auf Gradle und verwendet Build-Konfigurationsdateien, die entweder in einem Groovy- oder Kotlin-Skript geschrieben wurden, um eine einfache Erweiterbarkeit und Anpassung zu vereinfachen.

Gradle-basierte Projekte bieten wichtige Funktionen für die Android-Entwicklung, darunter:

  • Unterstützung für binäre Bibliotheken (AAE) Sie müssen Bibliotheksquellen nicht mehr in Ihre eigenen Projekte kopieren, sondern können eine Abhängigkeit deklarieren. Die Bibliothek wird dann automatisch heruntergeladen und mit Ihrem Projekt zusammengeführt. Dazu gehört das automatische Zusammenführen von Ressourcen, Manifesteinträgen, Proguard-Ausschlussregeln, benutzerdefinierten Lint-Regeln usw. während der Build-Erstellung.
  • Unterstützung von Build-Varianten, sodass Sie verschiedene Versionen Ihrer App (z. B. eine kostenlose und eine Pro-Version) aus demselben Projekt erstellen können
  • Einfache Build-Konfiguration und -Anpassung. Sie können beispielsweise Versionsnamen und Versionscodes aus Git-Tags als Teil des Builds abrufen.
  • Gradle kann in der IDE, über die Befehlszeile und auf Continuous-Integration-Servern wie Jenkins verwendet werden. So ist immer und überall der gleiche Build verfügbar.

Weitere Informationen zum Verwenden und Konfigurieren von Gradle findest du unter Build konfigurieren.

Abhängigkeiten

Bibliotheksabhängigkeiten in Android Studio verwenden Gradle-Abhängigkeitsdeklarationen und Maven-Abhängigkeiten für bekannte lokale Quell- und Binärbibliotheken mit Maven-Koordinaten. Weitere Informationen finden Sie unter Abhängigkeiten deklarieren.

Von IntelliJ migrieren

Wenn Ihr IntelliJ-Projekt das Gradle-Build-System verwendet, können Sie Ihr Projekt direkt in Android Studio importieren. Wenn Ihr IntelliJ-Projekt Maven oder ein anderes Build-System verwendet, müssen Sie es so einrichten, dass es mit Gradle funktioniert, bevor Sie zu Android Studio migrieren können.

Gradle-basiertes IntelliJ-Projekt importieren

Wenn Sie Gradle bereits mit Ihrem IntelliJ-Projekt verwenden, öffnen Sie es in Android Studio. Gehen Sie dazu so vor:

  1. Klicken Sie auf File > New > Import Project.
  2. Wählen Sie Ihr IntelliJ-Projektverzeichnis aus und klicken Sie auf OK. Ihr Projekt wird in Android Studio geöffnet.

Nicht-Gradle-IntelliJ-Projekt importieren

Wenn Ihr IntelliJ-Projekt nicht bereits das Gradle-Build-System verwendet, haben Sie zwei Möglichkeiten, das Projekt in Android Studio zu importieren. Diese werden in den folgenden Abschnitten beschrieben:

Durch Erstellen eines neuen leeren Projekts migrieren

So migrieren Sie Ihr Projekt zu Android Studio, indem Sie ein neues leeres Projekt erstellen und Ihre Quelldateien in die neuen Verzeichnisse kopieren:

  1. Öffnen Sie Android Studio und klicken Sie auf File > New > New Project.
  2. Geben Sie einen Namen für das Anwendungsprojekt ein und legen Sie den Speicherort fest, an dem es erstellt werden soll. Klicken Sie dann auf Weiter.
  3. Wählen Sie die Formfaktoren aus, auf denen Ihre App ausgeführt werden soll, und klicken Sie auf Weiter.
  4. Klicken Sie auf Add No Activity (Keine Aktivität hinzufügen) und dann auf Finish (Fertigstellen).
  5. Klicken Sie im Toolfenster Projekt auf den Pfeil, um das Menü „Ansicht“ zu öffnen, und wählen Sie die Ansicht Projekt aus, um die Organisation Ihres neuen Android Studio-Projekts anzusehen und zu erkunden. Weitere Informationen zum Ändern von Ansichten und zum Strukturieren von Projekten in Android Studio findest du unter Projektdateien.
  6. Wechseln Sie zu dem Speicherort, den Sie für das neue Projekt ausgewählt haben, und verschieben Sie den Code, die Einheitentests, Instrumentierungstests und Ressourcen aus dem alten Projektverzeichnis an die richtigen Speicherorte in der neuen Projektstruktur.
  7. Klicken Sie in Android Studio auf File > Project Structure (Datei > Projektstruktur), um das Dialogfeld Project Structure (Projektstruktur) zu öffnen. Achten Sie darauf, dass im linken Bereich das Modul Ihrer App ausgewählt ist.
  8. Nehmen Sie auf dem Tab Eigenschaften alle erforderlichen Änderungen für Ihr Projekt vor, ändern Sie z. B. minSdk oder targetSdk.
  9. Klicken Sie auf Abhängigkeiten und fügen Sie alle Bibliotheken, von denen Ihr Projekt abhängt, als Gradle-Abhängigkeiten hinzu. Klicken Sie zum Hinzufügen einer neuen Abhängigkeit auf Hinzufügen , wählen Sie den Typ der Abhängigkeit aus, die Sie hinzufügen möchten, und folgen Sie den Aufforderungen.
  10. Klicken Sie auf OK, um die Änderungen zu speichern.
  11. Klicken Sie auf Erstellen > Projekt erstellen, um das Erstellen Ihres Projekts zu testen und gegebenenfalls ausstehende Fehler zu beheben.

Migrieren durch Erstellen einer benutzerdefinierten Gradle-Build-Datei

So migrieren Sie Ihr Projekt zu Android Studio, indem Sie eine neue Gradle-Build-Datei erstellen, die auf Ihre vorhandenen Quelldateien verweist:

  1. Sichern Sie zuerst Ihre Projektdateien an einem separaten Speicherort, da durch den Migrationsprozess der Inhalt Ihres Projekts geändert wird.
  2. Erstellen Sie in Ihrem Projektverzeichnis eine Datei namens build.gradle, wenn Sie Groovy verwenden, oder build.gradle.kts, wenn Sie ein Kotlin-Script verwenden. Diese Datei enthält alle Informationen, die Gradle für die Ausführung Ihres Builds benötigt.

    Standardmäßig erwartet Android Studio, dass Ihr Projekt wie in Abbildung 1 organisiert ist.

    Abbildung 1: Die Standard-Projektstruktur für ein Android-App-Modul.

    In settings.gradle (für Groovy) oder settings.gradle.kts (für Kotlin-Script) legen Sie die Repositories fest, die zum Suchen von Plug-ins und Abhängigkeiten in den Blöcken pluginManagement bzw. dependencyResolutionManagement verwendet werden:

    Groovig

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

    Warnung:Das JCenter-Repository ist seit dem 31. März 2021 schreibgeschützt. Weitere Informationen finden Sie unter Update zum JCenter-Dienst.

    Das Android-Gradle-Plug-in wendet einige standardmäßige Quellsätze auf das Projekt an. Diese Quellsätze definieren die Verzeichnisse, die zum Speichern verschiedener Typen von Quelldateien verwendet werden. Gradle verwendet diese Quellsätze, um die Speicherorte bestimmter Dateitypen zu ermitteln. Wenn Ihr vorhandenes Projekt nicht den Standardeinstellungen entspricht, können Sie entweder die Dateien an den gewünschten Speicherort verschieben oder die Standardquellsätze ändern, damit Gradle weiß, wo sie zu finden sind.

    Weitere Informationen zum Einrichten und Anpassen einer Gradle-Build-Datei findest du unter Build konfigurieren.

  3. Bestimmen Sie als Nächstes, welche Bibliotheksprojekte Sie verwenden.

    Mit Gradle müssen Sie diese Bibliotheken nicht mehr als Quellcodeprojekte hinzufügen. Sie können stattdessen im dependencies{}-Block Ihrer Build-Datei darauf verweisen. Das Build-System verarbeitet diese Bibliotheken dann für Sie. Dazu gehören das Herunterladen von Bibliotheken, das Zusammenführen von Ressourcen und das Zusammenführen von Manifesteinträgen. Im folgenden Beispiel werden die Deklarationsanweisungen für eine Reihe von AndroidX-Bibliotheken dem dependencies{}-Block einer Build-Datei hinzugefügt.

    Groovig

    ...
    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.
    }
    Wenn Sie Hilfe beim Bestimmen der richtigen Deklarationsanweisungen für Ihre Bibliotheken benötigen, suchen Sie im Google Maven-Repository oder in Maven Central.
  4. Speichern Sie die Datei build.gradle und schließen Sie das Projekt dann in IntelliJ. Gehen Sie zu Ihrem Projektverzeichnis und löschen Sie das Verzeichnis .idea und alle IML-Dateien in Ihrem Projekt.
  5. Starten Sie Android Studio und klicken Sie auf File > New > Import Project.
  6. Suchen Sie Ihr Projektverzeichnis, wählen Sie die von Ihnen erstellte Datei build.gradle oder build.gradle.kts aus und klicken Sie dann auf OK, um Ihr Projekt zu importieren.
  7. Klicken Sie auf Erstellen > Projekt erstellen, um Ihre Build-Datei zu testen, indem Sie Ihr Projekt erstellen, und beheben Sie alle gefundenen Fehler.

Nächste Schritte

Nachdem Sie Ihr Projekt zu Android Studio migriert haben, können Sie unter App erstellen und ausführen weitere Informationen zum Erstellen mit Gradle und zum Ausführen Ihrer App in Android Studio erhalten.

Je nach Projekt und Workflow möchten Sie vielleicht auch mehr über Versionsverwaltung, das Verwalten von Abhängigkeiten und das Konfigurieren von Android Studio erfahren. Informationen zur Verwendung von Android Studio finden Sie unter Android Studio kennenlernen.

Versionsverwaltung konfigurieren

Android Studio unterstützt eine Vielzahl von Versionsverwaltungssystemen, einschließlich Git, Mercial und Subversion. Andere Versionskontrollsysteme können mithilfe von Plug-ins hinzugefügt werden.

Wenn für Ihre App bereits Versionsverwaltung festgelegt ist, müssen Sie sie möglicherweise in Android Studio aktivieren. Klicken Sie im VCS-Menü auf Integration der Versionsverwaltung aktivieren und wählen Sie das passende Versionskontrollsystem aus.

Falls Ihre App nicht der Versionsverwaltung unterliegt, können Sie sie konfigurieren, nachdem Sie sie in Android Studio importiert haben. Verwenden Sie die Menüoptionen des VCS-Menüs in Android Studio, um die VCS-Unterstützung für das gewünschte Versionskontrollsystem zu aktivieren, ein Repository zu erstellen, die neuen Dateien in die Versionsverwaltung zu importieren und andere Vorgänge zur Versionsverwaltung auszuführen:

  1. Klicken Sie im VCS-Menü von Android Studio auf Integration der Versionsverwaltung aktivieren.
  2. Wählen Sie im Menü ein Versionsverwaltungssystem aus, das mit dem Projektstamm verknüpft werden soll, und klicken Sie dann auf OK. Das VCS-Menü enthält jetzt eine Reihe von Optionen zur Versionsverwaltung basierend auf dem ausgewählten System.

Hinweis:Sie können die Versionsverwaltung auch über die Menüoption Datei > Einstellungen > Versionsverwaltung einrichten und ändern.

Weitere Informationen zum Arbeiten mit der Versionsverwaltung finden Sie unter Referenz zur Versionsverwaltung von IntelliJ.

App-Signatur

Wenn zuvor ein Fehlerbehebungszertifikat verwendet wurde, wird es während des Importvorgangs möglicherweise erkannt. In diesem Fall verweist Android Studio weiterhin auf dieses Zertifikat. Andernfalls wird für die Fehlerbehebungskonfiguration der von Android Studio generierte Schlüsselspeicher zur Fehlerbehebung mit einem bekannten Passwort und einem Standardschlüssel mit einem bekannten Passwort in $HOME/.android/debug.keystore verwendet. Der Build-Typ für die Fehlerbehebung ist so eingestellt, dass diese Debug-Konfiguration automatisch verwendet wird, wenn Sie Ihr Projekt über Android Studio ausführen oder Fehler beheben.

Ebenso kann beim Import ein vorhandenes Freigabezertifikat erkannt werden. Wenn zuvor noch kein Release-Zertifikat definiert wurde, füge die Konfiguration für die Release-Signatur der Datei build.gradle oder build.gradle.kts hinzu oder verwende die Menüoption Build > Signiertes APK generieren, um den Assistenten zum Generieren eines signierten APKs zu öffnen. Weitere Informationen zum Signieren Ihrer App finden Sie unter App signieren.

Maximale Heap-Größe von Android Studio anpassen

Standardmäßig hat Android Studio eine maximale Heap-Größe von 1.280 MB. Wenn Sie an einem großen Projekt arbeiten oder Ihr System viel RAM hat, können Sie die Leistung verbessern, indem Sie die maximale Heap-Größe erhöhen.

Softwareupdates

Android Studio wird unabhängig vom Gradle-Plug-in, den Build-Tools und den SDK-Tools aktualisiert. Sie können angeben, welche Versionen Sie mit Android Studio verwenden möchten.

Standardmäßig stellt Android Studio automatische Updates bereit, sobald eine neue stabile Version veröffentlicht wird. Sie können jedoch auch häufiger Updates durchführen und Vorschau- oder Betaversionen erhalten.

Weitere Informationen zum Aktualisieren von Android Studio und zur Verwendung von Vor- und Betaversionen findest du unter Updates.