Bedingte Zustellung konfigurieren

Mit der bedingten Bereitstellung können Sie bestimmte Anforderungen an die Gerätekonfiguration festlegen, damit Funktionsmodule während der App-Installation automatisch heruntergeladen werden. Du kannst zum Beispiel ein Funktionsmodul konfigurieren, das Funktionen für Augmented Reality (AR) enthält, die bei der App-Installation nur auf Geräten verfügbar sind, die AR unterstützen.

Dieser Bereitstellungsmechanismus unterstützt derzeit die Steuerung des Downloads eines Moduls bei der App-Installation basierend auf den folgenden Gerätekonfigurationen:

Wenn ein Gerät nicht alle von dir angegebenen Anforderungen erfüllt, wird das Modul bei der Installation der App nicht heruntergeladen. Ihre App kann jedoch später mit dem Play Core SDK das Modul bei Bedarf herunterladen.

Bevor Sie beginnen, sollten Sie prüfen, ob Sie Android Studio 3.5 oder höher verwenden. In den folgenden Abschnitten wird beschrieben, wie Sie die Unterstützung für die bedingte Bereitstellung zu Ihren Funktionsmodulen hinzufügen.

Neues Modul mit Optionen für die bedingte Bereitstellung hinzufügen

Am einfachsten erstellen Sie ein neues Funktionsmodul mit bedingter Bereitstellung über den Assistenten Neues Modul:

  1. Wählen Sie in der Menüleiste Datei > Neu > Neues Modul aus, um das Dialogfeld Neues Modul zu öffnen.
  2. Wählen Sie im Dialogfeld „New Module“ (Neues Modul) die Option Dynamic Feature Module (Dynamisches Funktionsmodul) aus und klicken Sie auf Next (Weiter).
  3. Konfigurieren Sie Ihr Modul wie gewohnt und klicken Sie auf Weiter.
  4. Führen Sie im Abschnitt Module Download Options (Downloadoptionen für Module) folgende Schritte aus:

    1. Geben Sie den Modultitel mit bis zu 50 Zeichen an. Die Plattform verwendet diesen Titel, um das Modul für Nutzer zu identifizieren, z. B. wenn bestätigt werden soll, ob der Nutzer das Modul herunterladen möchte. Aus diesem Grund muss das Basismodul Ihrer App den Modultitel als String-Ressource enthalten, die Sie übersetzen können. Wenn Sie das Modul mit Android Studio erstellen, fügt die IDE die String-Ressource für Sie dem Basismodul hinzu und fügt den folgenden Eintrag in das Manifest des Funktionsmoduls ein:

      <dist:module
          ...
          dist:title="@string/feature_title">
      </dist:module>
      
    2. Wählen Sie im Drop-down-Menü unter Einbeziehung bei der Installation die Option Modul nur bei der App-Installation für Geräte mit bestimmten Funktionen einbeziehen aus. Dadurch wird ein Modul erstellt, das bei der App-Installation nur auf Geräten mit bestimmten Konfigurationen enthalten ist, die Sie angeben können, z. B. Gerätefunktionen oder Land. Android Studio fügt Folgendes in das Manifest des Moduls ein, um Ihre Auswahl widerzuspiegeln:

      <dist:module ... >
        <dist:delivery>
            <dist:install-time>
                <dist:conditions>
                    <!-- If you specify conditions, as described in the steps
                         below, the IDE includes them here. -->
                </dist:conditions>
            </dist:install-time>
        </dist:delivery>
      </dist:module>
      
    3. Wenn Sie den automatischen Download des Moduls auf bestimmte Länder oder ein bestimmtes Mindest-API-Level beschränken möchten, klicken Sie auf Fertigstellen, um die Erstellung des Moduls abzuschließen. Lesen Sie dann den Abschnitt zum Angeben von Bedingungen basierend auf dem Land oder dem Mindest-API-Level. Klicken Sie andernfalls auf + Gerätefunktion, um eine Funktion hinzuzufügen, die ein Gerät benötigt, um das Modul bei der Installation herunterzuladen.

    4. Wählen Sie neben device-feature eine der folgenden Optionen aus dem Drop-down-Menü aus und geben Sie den Wert an:

      • Name: Hier können Sie eine Hardware- oder Softwarefunktion angeben, die ein Gerät benötigt, um das Modul bei der Installation herunterzuladen. Die von der bedingten Bereitstellung unterstützten Funktionen sind dieselben, die von PackageManager als FEATURE_*-Konstanten aufgeführt werden. Wenn Sie diese Option auswählen, geben Sie einen beliebigen Teil des konstanten Werts des Features, z. B. „bluetooth“, in das Feld neben dem Drop-down-Menü ein und wählen Sie einen der angezeigten Vorschläge aus.
      • OpenGL ES-Version: Hier können Sie eine OpenGL ES-Version angeben, die ein Gerät benötigt, um das Modul bei der Installation herunterzuladen. Wenn Sie diese Option auswählen, geben Sie die Version, z. B. „0x00030001“, in das Feld neben dem Drop-down-Menü ein und wählen Sie einen der angezeigten Vorschläge aus.
    5. Wenn du mehrere Bedingungen basierend auf verfügbaren Gerätefunktionen hinzufügen möchtest, klicke für jede Bedingung, die du angeben möchtest, auf + Gerätefunktion.

    6. Setze ein Häkchen neben Zusammenführen, wenn dieses Modul für Geräte mit Android 4.4 (API-Level 20) und niedriger verfügbar sein und in Multi-APKs enthalten sein soll. Das bedeutet, dass du das On-Demand-Verhalten für dieses Modul aktivieren und die Zusammenführung deaktivieren kannst, um es auf Geräten, die das Herunterladen und Installieren von unterteilten APKs nicht unterstützen, wegzulassen. Android Studio fügt Folgendes in das Manifest des Moduls ein, um Ihre Auswahl widerzuspiegeln:

      <dist:module ...>
          <dist:fusing dist:include="true | false" />
      </dist:module>
      
  5. Wenn Sie die Downloadoptionen für das Modul konfiguriert haben, klicken Sie auf Fertig.

Beachten Sie, dass das Android-Gradle-Plug-in das Ausführen von lint aus Modulen für dynamische Funktionen nicht unterstützt. Wenn Sie Lint über das entsprechende Anwendungsmodul ausführen, wird Lint für die zugehörigen Module für dynamische Funktionen ausgeführt und alle Probleme werden in den Lint-Bericht der App aufgenommen.

Einem vorhandenen Funktionsmodul Optionen für die bedingte Bereitstellung hinzufügen

Sie können einem vorhandenen Funktionsmodul über das Manifest des Moduls Optionen für die bedingte Bereitstellung hinzufügen. Sie sollten sich jedoch zuerst über die Kompatibilität von Optionen für die bedingte Zustellung mit anderen Zustellungsoptionen informieren, die Sie möglicherweise bereits aktiviert haben.

Zuerst müssen Sie Ihr Manifest zum neuen <dist:delivery>-Element migrieren. Das folgende Code-Snippet zeigt ein Beispiel für die ältere Syntax:

<!-- This is the old syntax. -->
<dist:module
  dist:title="@string/feature_title" dist:onDemand="true">
  <dist:fusing dist:include="true"/>
</dist:module>

Die oben genannten Lieferoptionen werden jetzt so angegeben.

<dist:module
  dist:title="@string/feature_title">
  <dist:delivery>
      <dist:on-demand/>
  </dist:delivery>
  <dist:fusing dist:include="true"/>
</dist:module>

Anschließend kannst du Optionen für die bedingte Bereitstellung basierend auf Gerätefunktionen wie folgt einfügen.

<dist:module
    dist:title="@string/feature_title">
    <dist:delivery>
      <dist:on-demand/>
      <dist:install-time>
        <dist:conditions>
          <!-- Requires that the device support AR to download the module at
          app install-time.  -->
          <dist:device-feature dist:name="android.hardware.camera.ar"/>
        </dist:conditions>
      </dist:install-time>
    </dist:delivery>
    <dist:fusing dist:include="true"/>
</dist:module>

In den folgenden Abschnitten werden weitere Optionen für die bedingte Bereitstellung erläutert, z. B. nach Land oder Mindest-API-Level.

Kompatibilität mit anderen Modul-Downloadoptionen

Da Funktionsmodule mehrere Optionen zum Konfigurieren der Bereitstellung der einzelnen Funktionen auf dem Gerät eines Nutzers bieten, ist es wichtig zu verstehen, wie sich andere Einstellungen auf die Optionen für die bedingte Bereitstellung auswirken. In der folgenden Tabelle wird die Kompatibilität der bedingten Bereitstellung mit anderen Downloadoptionen für Module zusammengefasst.

Option zum Herunterladen von Modulen Kompatibilität mit der bedingten Bereitstellung
Zusammenführen (<dist:fusing dist:include="true"/>) Wenn ein Modul diese Option auf „true“ setzt, werden die von Ihnen angegebenen Optionen für die bedingte Bereitstellung von Google Play nicht berücksichtigt, wenn Sie Ihre App auf Geräten mit API-Level 19 oder niedriger bereitstellen. Das bedeutet, dass Funktionsmodule, die die Zusammenführung ermöglichen, bei der Installation auf Geräten mit API-Level 19 oder niedriger immer enthalten sind.
Instant-fähig (<dist:module dist:instant="true"/>) Optionen für die bedingte Bereitstellung werden für Instant-fähige Funktionsmodule nicht unterstützt.
On Demand (<dist:on-demand/>) Wenn Sie Optionen für die bedingte Bereitstellung angeben, ist das Modul standardmäßig auch on demand verfügbar.

Bedingungen nach Land angeben

Mit der bedingten Bereitstellung kannst du auch angeben, welche Länder du beim Herunterladen deines Moduls zum Zeitpunkt der App-Installation ausschließen (oder einschließen) möchtest. Die Angabe dieser Bedingung kann nützlich sein, wenn Ihr Modul beispielsweise eine Zahlungsmethode implementiert, die in bestimmten Regionen nicht verfügbar ist.

In diesem Kontext wird das Land des Geräts in der Regel durch die Rechnungsadresse des Nutzers bestimmt, die in seinem Google Play-Konto registriert ist.

Wenn du Länder für dein Modul angeben möchtest, füge Folgendes in das Manifest des Funktionsmoduls ein.

<dist:conditions>
   <!-- Set to "true" to specify countries to exclude from downloading
   this module at app install-time. By default, modules are available
   for download to all user countries. -->
  <dist:user-countries dist:exclude="true">
    <!-- Specifies the two-letter  CLDR country code for regions that should
    not download the module at app install-time. -->
    <dist:country dist:code="CN"/>
    <dist:country dist:code="HK"/>
  </dist:user-countries>
</dist:conditions>

Bedingungen für API-Level angeben

Die Angabe einer Bedingung basierend auf dem API-Level eines Geräts kann nützlich sein, wenn ein Funktionsmodul von APIs abhängt, die nur in bestimmten Versionen der Android-Plattform verfügbar sind.

Wenn Sie eine Bedingung auf Grundlage eines minimalen oder maximalen Geräte-API-Levels festlegen möchten, fügen Sie Folgendes in das Manifest Ihres Funktionsmoduls ein.

<dist:conditions>
    <!-- Specifies the minimum API level that the device must satisfy
         in order to download your module at app install-time. The API level you
         specify must be greater or equal to the module's own minSdkVersion. -->
   <dist:min-sdk dist:value="21"/>
    <!-- Specifies the maximum API level that the device cannot exceed
         in order to download your module at app install-time. The API level you
         specify must be less than or equal to the module's own maxSdkVersion. -->
   <dist:max-sdk dist:value="24"/>
</dist:conditions>

Bedingungen für andere Geräteeigenschaften angeben (Beta)

Wenn Sie Bedingungen für andere Geräteeigenschaften wie Modellname, RAM, Systemfunktionen und System-on-a-Chip angeben möchten, können Sie eine Konfigurationsdatei für das Geräte-Targeting verwenden.

Informationen zum Erstellen einer Konfigurationsdatei für das Geräte-Targeting finden Sie in der Dokumentation zum Geräte-Targeting.

Nachdem Sie die Konfigurationsdatei erstellt haben, können Sie Gerätegruppen für Ihr Modul angeben, indem Sie Folgendes in das Manifest des Funktionsmoduls einfügen.

<dist:conditions>
   <dist:device-groups>
      <dist:device-group dist:name="myCustomGroup1"/>
      <dist:device-group dist:name="myCustomGroup2"/>
   </dist:device-groups>
</dist:conditions>