Zu Android Studio migrieren

Für die Migration Ihrer Projekte zu Android Studio müssen Sie sich an eine neue Projektstruktur, ein neues Build-System und eine neue IDE-Funktionalität anpassen.

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, 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. Weitere Informationen zu den IDE-Grundlagen wie Navigation, Codevervollständigung und Tastenkombinationen finden Sie unter Android Studio kennenlernen.

In Android Studio wird Code in Projekten organisiert, die alles enthalten, was Ihre Android-App definiert – vom Quellcode der App bis hin zu Build-Konfigurationen und 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 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. Die Bibliothek wird dann automatisch heruntergeladen und mit Ihrem Projekt zusammengeführt. 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 von Build-Varianten, mit denen Sie verschiedene Versionen Ihrer App, z. B. eine kostenlose und eine Pro-Version, im selben 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 werden soll, und klicken Sie auf Weiter.
  4. Klicken Sie auf Add No Activity und dann auf Finish.
  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 Anwendung im linken Bereich ausgewählt ist.
  8. Nehmen Sie alle erforderlichen Änderungen auf dem Tab Eigenschaften für Ihr Projekt vor, 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. 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 zuerst die Projektdateien an einem separaten Speicherort, da durch den Migrationsprozess der Inhalt Ihres Projekts an Ort und Stelle 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 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-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, 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 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.
}
    Wenn Sie Hilfe bei der Bestimmung der richtigen Deklarationsanweisungen für Ihre Bibliotheken benötigen, suchen Sie im Maven-Repository von Google 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 Ihr Projektverzeichnis, wählen Sie die von Ihnen erstellte Datei build.gradle oder build.gradle.kts aus und klicken Sie auf OK, um Ihr 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, finden Sie unter App erstellen und ausführen weitere Informationen zum Erstellen mit Gradle und zum Ausführen Ihrer App in Android Studio.

Je nach Projekt und Workflow können Sie auch mehr über die Versionsverwaltung, die Verwaltung von Abhängigkeiten und die Konfiguration von Android Studio erfahren. Android Studio kennenlernen

Versionskontrolle konfigurieren

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

Wenn Ihre App bereits Versionskontrollmechanismen verwendet, müssen Sie diese 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 Stammverzeichnis des Projekts verknüpft werden soll, und klicken Sie dann auf OK. Im VCS-Menü werden jetzt basierend auf dem ausgewählten System eine Reihe von Versionsverwaltungsoptionen angezeigt.

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

Weitere Informationen zur Versionsverwaltung finden Sie in der Referenz zur 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 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 deiner App findest du 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 zur Verwendung der Vorschau- und Betaversionen finden Sie unter Updates.