Zu Android Studio migrieren

Wenn Sie Ihre Projekte zu Android Studio migrieren, müssen Sie sich an eine neue Projektstruktur, ein neues Build-System und neue IDE-Funktionen anpassen.

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

Android Studio-Grundlagen

Im Folgenden sind einige der wichtigsten Unterschiede aufgeführt, die Sie bei der Vorbereitung auf die Migration zu Android Studio beachten sollten.

Projekt- und Modulorganisation

Android Studio basiert auf der IDE IntelliJ IDEA. Hier finden Sie eine Einführung in Android Studio. Dort werden die Grundlagen der IDE wie Navigation, Codevervollständigung und Tastenkombinationen beschrieben.

In Android Studio wird Code in Projekten organisiert, die alles enthalten, was Ihre Android-App ausmacht, 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 unterteilen können. Module können unabhängig voneinander erstellt, getestet und debuggt werden.

Weitere Informationen zu Android Studio-Projekten und -Modulen finden Sie in der Projektübersicht.

Gradle-basiertes Build-System

Das Build-System von Android Studio basiert auf Gradle und verwendet Build-Konfigurationsdateien, die zur einfachen Erweiterung und Anpassung in Groovy- oder Kotlin-Script geschrieben sind.

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

  • Unterstützung für binäre Bibliotheken (AARs). Sie müssen Bibliotheksquellen nicht mehr in Ihre eigenen Projekte kopieren. Sie können eine Abhängigkeit deklarieren. Die Bibliothek wird dann automatisch heruntergeladen und in Ihr Projekt eingefügt. Dazu gehört das automatische Zusammenführen von Ressourcen, Manifesteinträgen, ProGuard-Ausschlussregeln und benutzerdefinierten Lint-Regeln zur Build-Zeit.
  • Unterstützung für Build-Varianten, mit denen Sie verschiedene Versionen Ihrer App (z. B. eine kostenlose Version 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 über die IDE, über die Befehlszeile und über Continuous Integration-Server wie Jenkins verwendet werden. So wird überall und jederzeit derselbe Build erstellt.

Weitere Informationen zur Verwendung und Konfiguration von Gradle finden Sie unter Build konfigurieren.

Abhängigkeiten

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

Von IntelliJ migrieren

Wenn Ihr IntelliJ-Projekt das Gradle-Build-System verwendet, können Sie es direkt in Android Studio importieren. Wenn in Ihrem IntelliJ-Projekt Maven oder ein anderes Build-System verwendet wird, müssen Sie es für die Verwendung mit Gradle einrichten, 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 Datei > Neu > Projekt importieren.
  2. Wählen Sie Ihr IntelliJ-Projektverzeichnis aus und klicken Sie auf OK. Ihr Projekt wird in Android Studio geöffnet.

IntelliJ-Projekt ohne Gradle importieren

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

Migrieren, indem Sie ein neues leeres Projekt erstellen

So migrieren Sie Ihr Projekt in 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 Ihr App-Projekt ein und geben Sie den Speicherort an, an dem es erstellt werden soll. Klicken Sie dann auf Weiter.
  3. Wählen Sie die Formfaktoren aus, auf denen Ihre App ausgeführt wird, und klicken Sie auf Weiter.
  4. Klicken Sie auf Keine Aktivität hinzufügen und dann auf Fertig.
  5. Klicken Sie im Toolfenster Project (Projekt) auf den Pfeil, um das Ansichtsmenü zu öffnen, und wählen Sie die Ansicht Project (Projekt) aus, um die Organisation Ihres neuen Android Studio-Projekts zu sehen und zu untersuchen. Weitere Informationen zum Ändern von Ansichten und zur Strukturierung von Projekten in Android Studio finden Sie unter Projektdateien.
  6. Rufen Sie den Speicherort auf, den Sie für Ihr neues Projekt ausgewählt haben, und verschieben Sie den Code, die Unit-Tests, die Instrumentierungstests und die Ressourcen aus den Verzeichnissen Ihres alten Projekts an die richtigen Stellen in der neuen Projektstruktur.
  7. Klicken Sie in Android Studio auf File > Project Structure, um das Dialogfeld Project Structure zu öffnen. Achten Sie darauf, dass das Modul Ihrer App im linken Bereich ausgewählt ist.
  8. Nehmen Sie auf dem Tab Properties (Eigenschaften) alle erforderlichen Änderungen an Ihrem Projekt vor, z. B. an 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. Wenn Sie eine neue Abhängigkeit hinzufügen möchten, klicken Sie auf Hinzufügen , wählen Sie den gewünschten Abhängigkeitstyp aus und folgen Sie der Anleitung.
  10. Klicken Sie auf OK, um die Änderungen zu speichern.
  11. Klicken Sie auf Build > Make Project (Erstellen > Projekt erstellen), um das Erstellen Ihres Projekts zu testen und ggf. ausstehende Fehler zu beheben.

Durch Erstellen einer benutzerdefinierten Gradle-Build-Datei migrieren

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

  1. Sichern Sie Ihre Projektdateien vor Beginn an einem separaten Speicherort, da der Migrationsprozess den Inhalt Ihres Projekts ändert.
  2. Erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen build.gradle, wenn Sie Groovy verwenden, oder build.gradle.kts, wenn Sie ein Kotlin-Skript verwenden. Diese Datei enthält alle Informationen, die Gradle zum Ausführen des Builds benötigt.

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

    Abbildung 1. Die Standardprojektstruktur für ein Android-App-Modul.

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

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

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

    Das Android Gradle-Plug-in wendet einige Standard-Quellsets auf das Projekt an. Diese Quellsätze definieren die Verzeichnisse, in denen verschiedene Arten von Quelldateien gespeichert 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 Dateien an den richtigen Ort verschieben oder die Standardquellsets ändern, damit Gradle weiß, wo sie sich befinden.

    Weitere Informationen zum Einrichten und Anpassen einer Gradle-Build-Datei finden Sie unter Build konfigurieren.

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

    Mit Gradle müssen Sie diese Bibliotheken nicht mehr als Quellcode-Projekte hinzufügen. Stattdessen können Sie im dependencies{}-Block Ihrer Build-Datei darauf verweisen. Das Build-System kümmert sich dann um diese Bibliotheken, einschließlich des Herunterladens von Bibliotheken, des Zusammenführens von Ressourcen und des Zusammenführens von Manifesteinträgen. Im folgenden Beispiel werden die Deklarationsanweisungen für eine Reihe von AndroidX-Bibliotheken dem dependencies{}-Block einer Build-Datei hinzugefügt.

    Groovy

    ...
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])

    // AndroidX libraries
    implementation 'androidx.core:core-ktx:1.16.0'
    implementation 'androidx.appcompat:appcompat:1.7.1'
    implementation 'androidx.cardview:cardview:1.0.0'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.gridlayout:gridlayout:1.1.0'
    implementation 'androidx.leanback:leanback:'
    implementation 'androidx.mediarouter:mediarouter:1.8.1'
    implementation 'androidx.palette:palette-ktx:1.0.0'
    implementation 'androidx.recyclerview:recyclerview:1.4.0'
    implementation 'androidx.annotation:annotation:1.9.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.16.0")
    implementation("androidx.appcompat:appcompat:1.7.1")
    implementation("androidx.cardview:cardview:1.0.0")
    implementation("com.google.android.material:material:1.7.0")
    implementation("androidx.gridlayout:gridlayout:1.1.0")
    implementation("androidx.leanback:leanback:")
    implementation("androidx.mediarouter:mediarouter:1.8.1")
    implementation("androidx.palette:palette-ktx:1.0.0")
    implementation("androidx.recyclerview:recyclerview:1.4.0")
    implementation("androidx.annotation:annotation:1.9.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 bei der Bestimmung der richtigen Deklarationsanweisungen für Ihre Bibliotheken benötigen, suchen Sie im Google Maven-Repository oder bei Maven Central.
  4. Speichern Sie die Datei build.gradle und schließen Sie das Projekt dann in IntelliJ. Rufen Sie das Projektverzeichnis auf und löschen Sie das Verzeichnis .idea und alle IML-Dateien im Projekt.
  5. Starten Sie Android Studio und klicken Sie auf File > New > Import Project.
  6. Suchen Sie das Projektverzeichnis, wählen Sie die Datei build.gradle oder build.gradle.kts aus, die Sie erstellt haben, und klicken Sie dann auf OK, um das Projekt zu importieren.
  7. Klicken Sie auf Build > Make Project (Erstellen > Projekt erstellen), um Ihre Build-Datei zu testen, und beheben Sie alle Fehler, die Sie finden.

Nächste Schritte

Nachdem Sie Ihr Projekt zu Android Studio migriert haben, können Sie unter App erstellen und ausführen mehr über das Erstellen mit Gradle und das Ausführen Ihrer App in Android Studio erfahren.

Je nach Projekt und Workflow sollten Sie sich auch über die Versionsverwaltung, die Verwaltung von Abhängigkeiten und die Konfiguration von Android Studio informieren. Weitere Informationen zu Android Studio

Versionsverwaltung konfigurieren

Android Studio unterstützt eine Vielzahl von Versionsverwaltungssystemen, darunter Git, Mercurial und Subversion. Andere Versionskontrollsysteme können über Plug-ins hinzugefügt werden.

Wenn Ihre App bereits der Quellcodeverwaltung unterliegt, müssen Sie sie möglicherweise in Android Studio aktivieren. Klicken Sie im VCS-Menü auf Enable Version Control Integration (Versionskontrollintegration aktivieren) und wählen Sie das entsprechende Versionskontrollsystem aus.

Wenn Ihre App nicht unter Quellcodeverwaltung steht, können Sie sie nach dem Importieren in Android Studio konfigurieren. Mit den VCS-Menüoptionen in Android Studio können Sie die VCS-Unterstützung für das gewünschte Versionsverwaltungssystem aktivieren, ein Repository erstellen, die neuen Dateien in die Versionsverwaltung importieren und andere Versionsverwaltungsvorgänge ausführen:

  1. Klicken Sie im VCS-Menü von Android Studio auf Enable Version Control Integration (Versionskontrollintegration aktivieren).
  2. Wählen Sie im Menü ein Versionskontrollsystem aus, das mit dem Projektstamm verknüpft werden soll, und klicken Sie dann auf OK. Im VCS-Menü werden nun je nach ausgewähltem System verschiedene Optionen für die Versionsverwaltung angezeigt.

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

Weitere Informationen zur Versionsverwaltung finden Sie in der Versionsverwaltung von IntelliJ.

App-Signatur

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

Ebenso kann beim Importvorgang ein vorhandenes Release-Zertifikat erkannt werden. Wenn zuvor kein Release-Zertifikat definiert wurde, fügen Sie die Konfiguration für die Release-Signierung der Datei build.gradle oder build.gradle.kts hinzu oder verwenden Sie die Menüoption Build > Generate Signed APK (Build > Signiertes APK generieren), um den Assistenten zum Generieren signierter 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 1280 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 bietet Android Studio automatische Updates an, sobald eine neue stabile Version veröffentlicht wird. Sie können aber auch häufiger aktualisieren und Vorab- oder Betas erhalten.

Weitere Informationen zum Aktualisieren von Android Studio und zur Verwendung von Vorschau- und Betaversionen finden Sie unter Updates.