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 in Ihrem Projekt bereits Gradle verwendet wird, können Sie Ihr vorhandenes Projekt in Android Studio öffnen. Wenn Sie IntelliJ verwenden, Ihr Projekt aber noch nicht Gradle verwendet, müssen Sie es manuell vorbereiten, bevor Sie es in Android Studio importieren können. Weitere Informationen finden Sie im Abschnitt Von IntelliJ migrieren.

Grundlagen von Android Studio

Im Folgenden finden Sie einige der wichtigsten Unterschiede, die Sie bei der Vorbereitung auf die Migration zu Android Studio beachten sollten.

Projekt- und Modulorganisation

Android Studio basiert auf der IDE IntelliJ IDEA. Informationen zu den Grundlagen der IDE, z. B. Navigation, Codevervollständigung und Tastenkürzel, finden Sie unter Meet Android Studio.

In Android Studio wird Code in Projekten organisiert, die alles enthalten, was Ihre Android-App definiert, vom App-Quellcode bis hin zu Build-Konfigurationen und Testcode. Projekte werden in separaten Android Studio-Fenster geöffnet. Jedes Projekt enthält ein oder mehrere Module, mit denen Sie Ihr Projekt in einzelne 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 Übersicht über Projekte.

Gradle-basiertes Build-System

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

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, damit die Bibliothek automatisch heruntergeladen und in Ihr Projekt eingefügt wird. Dazu gehört auch das automatische Zusammenführen von Ressourcen, Manifesteinträgen, Proguard-Ausnahmeregeln, benutzerdefinierten Lint-Regeln usw. während des Build-Prozesses.
  • Unterstützung für Build-Varianten, mit denen Sie verschiedene Versionen Ihrer App (z. B. eine kostenlose und eine Pro-Version) aus demselben Projekt erstellen können.
  • Einfache Build-Konfiguration und -Anpassung. So können Sie beispielsweise Versionsnamen und Versionscodes aus Git-Tags im Rahmen des Builds abrufen.
  • Gradle kann über die IDE, über die Befehlszeile und über Continuous Integration-Server wie Jenkins verwendet werden, sodass überall und jederzeit derselbe Build zur Verfügung steht.

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 in Ihrem IntelliJ-Projekt das Gradle-Build-System verwendet wird, 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 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 mit den folgenden Schritten in Android Studio:

  1. Klicken Sie auf Datei > Neu > Projekt importieren.
  2. Wählen Sie das IntelliJ-Projektverzeichnis aus und klicken Sie auf OK. Ihr Projekt wird in Android Studio geöffnet.

Nicht-Gradle-IntelliJ-Projekt 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:

Migration durch Erstellen eines neuen leeren Projekts

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 (Datei > Neu > Neues Projekt).
  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 Fertigstellen.
  5. Klicken Sie im Toolfenster Projekt auf den Pfeil, um das Ansichtsmenü zu öffnen, und wählen Sie die Ansicht Projekt aus, um die Struktur Ihres neuen Android Studio-Projekts zu sehen und zu erkunden. 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 (Datei > Projektstruktur), um das Dialogfeld Project Structure (Projektstruktur) zu öffnen. Achten Sie darauf, dass das Modul Ihrer App im linken Bereich ausgewählt ist.
  8. Nehmen Sie auf dem Tab 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 die gewünschte Abhängigkeit 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 den Build Ihres Projekts zu testen und gegebenenfalls ausstehende Fehler zu beheben.

Migration durch Erstellen einer benutzerdefinierten Gradle-Builddatei

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 an einem separaten Speicherort, da der Inhalt Ihres Projekts während der Migration geändert wird.
  2. Erstellen Sie im Projektverzeichnis eine Datei mit dem Namen build.gradle, wenn Sie Groovy verwenden, oder build.gradle.kts, wenn Sie Kotlin-Script verwenden. Diese Datei enthält alle Informationen, die Gradle zum Ausführen des Builds benötigt.

    In Android Studio wird standardmäßig davon ausgegangen, dass Ihr Projekt wie in Abbildung 1 dargestellt 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-Scripts legen Sie die Repositories fest, die zum Finden 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-Dienstaktualisierung.

    Das Android Gradle-Plug-in wendet einige standardmäßige Quellsätze 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 die Dateien entweder an den richtigen Speicherort verschieben oder die Standard-Quellsätze ändern, damit Gradle weiß, wo sie zu finden sind.

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

  3. Als Nächstes müssen Sie die Bibliotheksprojekte ermitteln, die Sie verwenden.

    Mit Gradle müssen Sie diese Bibliotheken nicht mehr als Quellcodeprojekte hinzufügen. Sie können stattdessen im Block dependencies{} 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 dem dependencies{}-Block einer Build-Datei die Deklarationsanweisungen für eine Reihe von AndroidX-Bibliotheken hinzugefügt.

    Groovy

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

    // AndroidX libraries
    implementation 'androidx.core:core-ktx:1.15.0'
    implementation 'androidx.appcompat:appcompat:1.7.0'
    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.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.15.0")
    implementation("androidx.appcompat:appcompat:1.7.0")
    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.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.
}
    Informationen zu den richtigen Erklärungsaussagen für Ihre Bibliotheken finden Sie im Google Maven-Repository oder in Maven Central.
  4. Speichern Sie die Datei build.gradle und schließen Sie das Projekt in IntelliJ. Rufen Sie das Projektverzeichnis auf 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 (Datei > Neu > Projekt importieren).
  6. Suchen Sie das Projektverzeichnis, wählen Sie die von Ihnen erstellte Datei build.gradle oder build.gradle.kts aus und klicken Sie auf OK, um das Projekt zu importieren.
  7. Klicken Sie auf Build > Make Project (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 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 Versionskontrolle, Verwaltung von Abhängigkeiten und Konfiguration von Android Studio informieren. Android Studio kennenlernen

Versionskontrolle konfigurieren

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

Wenn Ihre App bereits versioniert ist, müssen Sie die Versionskontrolle möglicherweise in Android Studio aktivieren. Klicken Sie im VCS-Menü auf Versionskontroll-Integration aktivieren und wählen Sie das entsprechende Versionskontrollsystem aus.

Wenn Ihre App nicht versioniert ist, können Sie die Versionskontrolle nach dem Importieren der App in Android Studio konfigurieren. Mit den VCS-Menüoptionen in Android Studio können Sie die VCS-Unterstützung für das gewünschte Versionskontrollsystem aktivieren, ein Repository erstellen, die neuen Dateien in die Versionskontrolle importieren und andere Versionskontrollvorgänge ausführen:

  1. Klicken Sie im VCS-Menü von Android Studio auf 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. Das Menü „Versionskontrollsystem“ enthält jetzt eine Reihe von Optionen für die Versionskontrolle, die vom ausgewählten System abhängen.

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

Weitere Informationen zur Arbeit mit der Versionskontrolle finden Sie in der Referenz zur Versionskontrolle in 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 verwendet die Debug-Konfiguration den von Android Studio generierten Debug-Keystore mit einem bekannten Passwort und einem Standardschlüssel mit einem bekannten Passwort in $HOME/.android/debug.keystore. Der Debug-Buildtyp ist so festgelegt, dass diese Debug-Konfiguration automatisch verwendet wird, wenn Sie Ihr Projekt in Android Studio ausführen oder beheben.

Ebenso kann der Importvorgang ein vorhandenes Release-Zertifikat erkennen. Wenn noch kein Release-Zertifikat definiert wurde, fügen Sie der Datei build.gradle oder build.gradle.kts die Konfiguration für die Release-Signatur hinzu oder verwenden Sie die Menüoption Build > Generate Signed APK (Erstellen > Signiertes APK generieren), um den Assistenten zum Generieren eines signierten APK zu öffnen. Weitere Informationen zum Signieren Ihrer App finden Sie unter App signieren.

Maximale Heap-Größe in 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 werden in Android Studio automatische Updates bereitgestellt, sobald eine neue stabile Version veröffentlicht wird. Sie können aber auch häufiger aktualisieren und Vorab- oder Betaversionen erhalten.

Weitere Informationen zum Aktualisieren von Android Studio und zum Verwenden von Vorab- und Betaversionen finden Sie unter Updates.