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

Grundlagen von Android Studio

Hier sind einige der wichtigsten Unterschiede, die du kennen solltest, wenn du dich auf die Migration zu Android Studio vorbereitest.

Organisation von Projekten und Modulen

Android Studio basiert auf der IntelliJ IDEA-IDE. 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 debuggen.

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 geschrieben wurden, um die Erweiterbarkeit und Anpassung zu erleichtern.

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

  • Unterstützung für Binärbibliotheken (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 das automatische Zusammenführen in Ressourcen, Manifesteinträgen, Proguard-Ausschlussregeln, benutzerdefinierten Lint-Regeln usw. beim Erstellen.
  • Unterstützung für Build-Varianten, mit denen Sie verschiedene Versionen Ihrer App, z. B. eine kostenlose und eine Pro-Version, im selben Projekt erstellen können.
  • Einfache Konfiguration und Anpassung von Builds Sie können beispielsweise Versionsnamen und Versionscodes im Rahmen des Builds aus Git-Tags abrufen.
  • Gradle kann über die IDE, über die Befehlszeile und auf Servern für kontinuierliche Integration wie Jenkins verwendet werden, sodass immer derselbe Build überall verfügbar ist.

Weitere Informationen zum Verwenden und Konfigurieren von Gradle finden Sie 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 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 File > New > Import Project (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 importieren, das nicht zu Gradle gehört

Wenn das Gradle-Build-System in Ihrem IntelliJ-Projekt noch nicht verwendet wird, haben Sie zwei Möglichkeiten, Ihr 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 Ihr Anwendungsprojekt 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 Menü „Ansicht“ zu öffnen, und wählen Sie die Ansicht Projekt aus, um die Organisation Ihres neuen Android Studio-Projekts anzusehen und genauer kennenzulernen. Weitere Informationen zum Ändern von Ansichten und zur Strukturierung von Projekten in Android Studio finden Sie unter Projektdateien.
  6. Wechseln Sie zu dem Speicherort, den Sie für Ihr neues Projekt ausgewählt haben, und verschieben Sie den Code, die Einheitentests, die Instrumentierungstests und die Ressourcen aus den alten Projektverzeichnissen an die richtigen Speicherorte in Ihrer neuen Projektstruktur.
  7. Klicken Sie in Android Studio auf File > Project Structure (Datei > Projektstruktur), um das Dialogfeld Project Structure (Projektstruktur) zu öffnen. Prüfen Sie, ob 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 hinzu, von denen Ihr Projekt abhängig ist (als Gradle-Abhängigkeiten). Klicken Sie zum Hinzufügen einer neuen Abhängigkeit auf Hinzufügen , wählen Sie dann 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 die Erstellung Ihres Projekts zu testen und gegebenenfalls vorhandene Fehler zu beheben.

Durch Erstellen einer benutzerdefinierten Gradle-Build-Datei migrieren

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 die Projektdateien an einem separaten Speicherort, da der Inhalt Ihres Projekts durch den Migrationsprozess 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 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 und dependencyResolutionManagement verwendet werden:

    Cool

      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 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 Quellgruppen, um die Speicherorte bestimmter Dateitypen zu ermitteln. Wenn Ihr vorhandenes Projekt nicht den Standardeinstellungen entspricht, können Sie entweder 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 finden Sie unter Build konfigurieren.

  3. Identifizieren Sie als Nächstes, welches Bibliotheksprojekt 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 zum dependencies{}-Block einer Build-Datei hinzugefügt.

    Cool

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

    // AndroidX libraries
    implementation 'androidx.core:core-ktx:1.13.1'
    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.8.0'

    // 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.13.1")
    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.8.0")

    // 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 dann das Projekt in IntelliJ. Wechseln Sie zu Ihrem Projektverzeichnis und löschen Sie das Verzeichnis .idea sowie 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 durch Erstellen des Projekts zu testen und mögliche Fehler zu beheben.

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. Informationen zum Einstieg in Android Studio finden Sie unter Android Studio kennenlernen.

Versionsverwaltung konfigurieren

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

Wenn Ihre App bereits der Versionsverwaltung unterliegt, 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 entsprechende Versionsverwaltungssystem aus.

Wenn Ihre App nicht der Versionsverwaltung unterliegt, können Sie sie nach dem Importieren Ihrer App in Android Studio konfigurieren. Verwenden Sie die VCS-Menüoptionen in Android Studio, um die VCS-Unterstützung für das gewünschte Versionsverwaltungssystem zu aktivieren, ein Repository zu erstellen, die neuen Dateien in die Versionsverwaltung zu importieren und weitere 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 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 Versionsverwaltung auch über die Menüoption Datei > Einstellungen > Versionsverwaltung einrichten und ändern.

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

App-Signatur

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

Ebenso kann beim Importvorgang ein vorhandenes Freigabezertifikat erkannt werden. Wenn noch kein Release-Zertifikat definiert wurde, füge der Datei build.gradle oder build.gradle.kts die Konfiguration für die Release-Signatur hinzu oder öffne den Assistenten zum Generieren eines signierten APKs über die Menüoption Build > Signiertes APK generieren. Weitere Informationen zum Signieren deiner App findest du unter App signieren.

Maximale Heap-Größe von Android Studio anpassen

Die maximale Heap-Größe in Android Studio beträgt standardmäßig 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 getrennt 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, wenn eine neue stabile Version veröffentlicht wird. Sie können aber auch häufigere Updates durchführen und Vorschau- oder Betaversionen erhalten.

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