Modul für neues Gerät hinzufügen

Module bieten einen Container für den Quellcode, die Ressourcendateien und die Einstellungen der App, z. B. die Build-Datei auf Modulebene und die Android-Manifestdatei. Jedes Modul kann unabhängig voneinander erstellt, getestet und debuggen werden.

In Android Studio werden Module verwendet, um das Hinzufügen neuer Geräte zu Ihrem Projekt zu erleichtern. Mit ein paar einfachen Schritten in Android Studio können Sie ein Modul erstellen, das Code enthält, der für einen bestimmten Gerätetyp wie Wear OS oder Android TV spezifisch ist. Android Studio erstellt automatisch Modulverzeichnisse, z. B. Quell- und Ressourcenverzeichnisse, sowie eine build.gradle-Standarddatei, die zum Gerätetyp passt. Außerdem erstellt Android Studio Gerätemodule mit empfohlenen Build-Konfigurationen, z. B. die Verwendung der Leanback-Bibliothek für Android TV-Module.

Auf dieser Seite wird beschrieben, wie du ein neues Modul für ein bestimmtes Gerät hinzufügst.

Mit Android Studio können Sie Ihrem Projekt auch ganz einfach eine Bibliothek oder ein Google Cloud-Modul hinzufügen. Weitere Informationen zum Erstellen eines Bibliotheksmoduls findest du unter Bibliotheksmodul erstellen.

Neues Modul erstellen

So fügen Sie Ihrem Projekt ein neues Modul für ein neues Gerät hinzu:

  1. Klicken Sie auf File > New > New Module.
  2. Das Fenster Neues Modul erstellen wird eingeblendet. Android Studio bietet die folgenden Gerätemodule:
    • Telefon- und Tabletmodul
    • Wear OS-Modul
    • Android TV-Modul
    • Glass-Modul
    Wählen Sie das Modul für das gewünschte Gerät aus und klicken Sie auf Weiter.
  3. Geben Sie im Formular Neues Modul konfigurieren die folgenden Informationen ein:
    • Anwendungsname: Dieser Name wird als Titel des App Launcher-Symbols für das neue Modul verwendet.
    • Module Name (Modulname): Dieser Text wird als Name des Ordners verwendet, in dem Ihr Quellcode und Ihre Ressourcendateien sichtbar sind.
    • Paketname: Dies ist der Java-Namespace für den Code in Ihrem Modul. Es wird als Attribut package in der Android-Manifestdatei des Moduls hinzugefügt.
    • Minimum SDK (Mindestens erforderliche SDK-Version): Diese Einstellung gibt die niedrigste Version der Android-Plattform an, die vom App-Modul unterstützt wird. Mit diesem Wert wird das Attribut minSdkVersion in der Datei build.gradle festgelegt, die Sie später bearbeiten können.

    Klicken Sie dann auf Weiter.

  4. Je nachdem, welches Gerätemodul Sie ausgewählt haben, wird auf der folgenden Seite eine Auswahl geeigneter Codevorlagen angezeigt, die Sie als Hauptaktivität verwenden können. Klicken Sie auf eine Aktivitätsvorlage, mit der Sie beginnen möchten, und klicken Sie dann auf Weiter. Wenn Sie keine Aktivität benötigen, klicken Sie auf Add No Activity (Keine Aktivität hinzufügen) und dann auf Finish (Fertigstellen).
  5. Wenn Sie eine Aktivitätsvorlage ausgewählt haben, geben Sie auf der Seite Aktivität anpassen die Einstellungen für Ihre Aktivität ein. Die meisten Vorlagen erfordern einen Aktivitätsnamen, einen Layoutnamen, einen Titel und eine Quellsprache, aber jede Vorlage verfügt über aktivitätsspezifische Einstellungen. Klicken Sie auf Fertigstellen. Wenn Sie ein App-Modul mit einer Aktivitätsvorlage erstellen, können Sie das Modul sofort auf Ihrem Gerät ausführen und testen.

Android Studio erstellt alle erforderlichen Dateien für das neue Modul und synchronisiert das Projekt mit den neuen Gradle-Dateien des Moduls. Wenn Sie ein Modul für ein neues Gerät hinzufügen, werden der Build-Datei des Moduls auch alle erforderlichen Abhängigkeiten für das Zielgerät hinzugefügt.

Sobald die Synchronisierung des Gradle-Projekts abgeschlossen ist, wird das neue Modul links im Fenster Project (Projekt) angezeigt. Wenn der neue Modulordner nicht angezeigt wird, prüfen Sie, ob im Fenster die Android-Ansicht angezeigt wird.

Modul importieren

So importieren Sie ein vorhandenes Modul in Ihr Projekt:

  1. Klicken Sie auf File > New > Import Module.
  2. Geben Sie im Feld Quellverzeichnis das Verzeichnis der Module ein, die Sie importieren möchten, oder wählen Sie es aus:
    • Wenn Sie ein Modul importieren, geben Sie das Stammverzeichnis an.
    • Wenn Sie mehrere Module aus einem Projekt importieren, geben Sie den Projektordner an. Für jedes Modul im Ordner wird ein Feld mit dem Quellort und dem Modulnamen angezeigt. Achten Sie darauf, dass das Kästchen Importieren für alle Module angeklickt ist, die Sie importieren möchten.
    Falls Ihre Module weitere Abhängigkeiten haben, werden diese unter Zusätzliche erforderliche Module für den Import aufgeführt.
  3. Geben Sie die gewünschten Modulnamen in die Felder Modulname ein.
  4. Klicken Sie auf Fertigstellen.

Nachdem das Modul importiert wurde, wird es links im Fenster Projekt angezeigt.

Nächste Schritte

Nachdem Sie ein neues Modul hinzugefügt haben, können Sie den Modulcode und die Ressourcen ändern, die Modul-Build-Einstellungen konfigurieren und das Modul erstellen. Sie können das Modul auch wie jede andere App ausführen und debuggen.

Außerdem sollten Sie Code und Ressourcen hinzufügen, damit das neue Gerät ordnungsgemäß unterstützt wird. Weitere Informationen zum Entwickeln von App-Modulen für verschiedene Gerätetypen finden Sie in der entsprechenden Dokumentation:

Bei der Entwicklung Ihres neuen Moduls können Sie geräteunabhängigen Code erstellen, der bereits in einem anderen App-Modul dupliziert ist. Anstatt doppelten Code zu verwenden, können Sie den freigegebenen Code in ein Bibliotheksmodul verschieben und die Bibliothek als Abhängigkeit zu Ihren App-Modulen hinzufügen. Weitere Informationen zum Erstellen eines Bibliotheksmoduls und zum Hinzufügen als Abhängigkeit finden Sie unter Android-Bibliothek erstellen.