Mit Google Play Instant können Nutzer mit Ihrer App interagieren, ohne APKs auf ihrem Gerät installieren zu müssen. Stattdessen können sie Ihre App über die Schaltfläche „Jetzt ausprobieren“ im Google Play Store oder über eine von Ihnen erstellte URL ausprobieren. Diese Form der Bereitstellung von Inhalten erleichtert es Ihnen, die Interaktion mit Ihrer App zu steigern.
Sie können eine Funktion nur dann Instant-fähig machen, wenn Sie auch das Basismodul Ihrer App Instant-fähig machen. Wenn ein Nutzer ein Instant-fähiges Funktionsmodul Ihrer App verwenden möchte, muss sein Gerät auch das Basismodul Ihrer App für gemeinsamen Code und gemeinsame Ressourcen herunterladen. Damit Google Play Instant unterstützt wird, muss der Download für Ihr Basismodul und Ihre Funktion mehrere Kriterien erfüllen:
- Maximale Größe: Die Gesamtgröße des Instant-fähigen Basismoduls und des Instant-fähigen Funktionsmoduls darf maximal 10 MB betragen. Weitere Informationen finden Sie unter Instant-Apps durch Reduzieren der App- oder Spielgröße aktivieren.
- Hintergrundaktivität: Ein Instant-fähiges Modul kann keine Hintergrunddienste verwenden. Außerdem kann ein solches Modul keine Benachrichtigungen senden, wenn es im Hintergrund ausgeführt wird.
Wenn Sie ein Instant-fähiges Funktionsmodul mit Android Studio 3.5 oder höher erstellen, wie in diesem Abschnitt beschrieben, aktiviert die IDE automatisch sowohl das Basis- als auch das Funktionsmodul für Sie, indem sie Folgendes in das Manifest jedes Moduls einfügt:
<manifest xmlns:dist="http://schemas.android.com/apk/distribution"
... >
<dist:module dist:instant="true" />
...
Wenn deine App heruntergeladen und installiert wird, werden außerdem Instant-fähige Funktionsmodule automatisch mit dem Basis-APK deiner App heruntergeladen und installiert. Daher fügt die IDE dem Instant-fähigen Funktionsmodul auch Folgendes hinzu:
<dist:module ...>
<dist:delivery>
<dist:install-time />
</dist:delivery>
</dist:module>
Dieses Verhalten bedeutet, dass Sie beim Festlegen von dist:instant="true" nicht auch <dist:on-demand /> angeben können. Sie können jedoch innerhalb Ihrer Instant-Version mithilfe der Play Feature Delivery-Bibliothek bei Bedarf Instant-fähige Module anfordern.
Neues Modul für die sofortige Bereitstellung konfigurieren
So fügen Sie Ihrem App-Projekt mit Android Studio ein Instant-fähiges Funktionsmodul hinzu:
- Öffnen Sie Ihr App-Projekt in der IDE, falls noch nicht geschehen.
- Wählen Sie in der Menüleiste Datei > Neu > Neues Modul aus.
- Wählen Sie im Dialogfeld Create New Module (Neues Modul erstellen) die Option Instant Dynamic Feature Module (Dynamisches Instant-Funktionsmodul) aus und klicken Sie auf Next (Weiter).
Führen Sie im Bereich Neues Modul konfigurieren die folgenden Schritte aus:
- Wählen Sie im Drop-down-Menü das Basisanwendungsmodul für Ihr App-Projekt aus.
- Geben Sie einen Modulnamen an. Die IDE verwendet diesen Namen, um das Modul in der Gradle-Einstellungsdatei als Gradle-Unterprojekt zu identifizieren. Wenn Sie Ihr App-Bundle erstellen, verwendet Gradle das letzte Element des Unterprojektnamens, um das Attribut
<manifest split>in das Manifest des Funktionsmoduls einzufügen. - Geben Sie den Paketnamen des Moduls an. Standardmäßig schlägt Android Studio einen Paketnamen vor, der den Namen des Stammverzeichnispakets des Basismoduls und den im vorherigen Schritt angegebenen Modulnamen kombiniert.
- Wählen Sie das Mindest-API-Level aus, das das Modul unterstützen soll. Dieser Wert sollte mit dem des Basismoduls übereinstimmen.
Geben Sie den Modultitel mit bis zu 50 Zeichen an. Die Plattform verwendet diesen Titel, um das Modul für Nutzer zu identifizieren. 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>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. Android Studio fügt Folgendes in das Manifest des Moduls ein, um Ihre Auswahl widerzuspiegeln.
<dist:module> <dist:fusing dist:include="true" /> </dist:module>
Klicken Sie auf Fertig.
Nachdem Android Studio das Modul erstellt hat, können Sie sich den Inhalt im Bereich Project ansehen. Wählen Sie dazu in der Menüleiste View > Toolfenster > Project aus. Der Standardcode, die Ressourcen und die Organisation sollten denen des Standard-App-Moduls ähneln.
Nachdem du eine Funktion implementiert hast, die du on demand herunterladen möchtest, kannst du sie mithilfe der Play Feature Delivery-Bibliothek anfordern.
Anwendung bereitstellen
Wenn Sie Ihre App mit Unterstützung für Funktionsmodule entwickeln, können Sie sie wie gewohnt auf einem verbundenen Gerät bereitstellen. Wählen Sie dazu in der Menüleiste Ausführen > Ausführen aus oder klicken Sie in der Symbolleiste auf Ausführen
.
Wenn Ihr App-Projekt ein oder mehrere Funktionsmodule enthält, können Sie auswählen, welche Funktionen bei der Bereitstellung Ihrer App enthalten sein sollen. Ändern Sie dazu Ihre vorhandene Konfiguration ausführen/debuggen so:
- Wählen Sie in der Menüleiste Ausführen > Konfigurationen bearbeiten aus.
- Wählen Sie im linken Bereich des Dialogfelds Konfigurationen ausführen/debuggen die gewünschte Android-App-Konfiguration aus.
- Setze unter Bereitzustellende dynamische Funktionen auf dem Tab Allgemein ein Häkchen neben jedem Funktionsmodul, das du bei der Bereitstellung deiner App einbeziehen möchtest.
- Klicken Sie auf OK.
Standardmäßig stellt Android Studio Ihre Instant-fähigen Module nicht als Instant-Version bereit und verwendet auch keine App-Bundles, um Ihre App bereitzustellen. Stattdessen erstellt und installiert die IDE APKs auf Ihrem Gerät, die für die Bereitstellungsgeschwindigkeit und nicht für die APK-Größe optimiert sind. Wenn Sie Android Studio so konfigurieren möchten, dass APKs und Instant-Versionen stattdessen aus einem App-Bundle erstellt und bereitgestellt werden, ändern Sie die Konfiguration zum Ausführen/Debuggen.