Deeplinks zu App-Inhalten erstellen

Wenn ein angeklickter Link oder eine programmatische Anfrage einen Web-URI-Intent aufruft, versucht das Android-System in sequenzieller Reihenfolge, die folgenden Aktionen auszuführen, bis die Anfrage erfolgreich ist:

  1. Öffnen Sie die bevorzugte App des Nutzers, die den URI verarbeiten kann, sofern eine solche App angegeben ist.
  2. Öffnen Sie die einzige verfügbare App, die den URI verarbeiten kann.
  3. Ermöglichen Sie es Nutzern, in einem Dialogfeld eine App auszuwählen.

Führe die folgenden Schritte aus, um Links zu deinen Inhalten zu erstellen und zu testen. Sie können auch den App-Link-Assistenten in Android Studio verwenden, um Android-App-Links hinzuzufügen.

Hinweis : Ab Android 12 (API-Level 31) wird eine allgemeine Web Intent wird nur dann in eine Aktivität in Ihrer App aufgelöst, wenn Ihre App für die in diesem Web Intent enthaltene Domain. Wenn Ihre App für Domain ist, wird der Web-Intent in die Standardbrowseranwendung des Nutzers aufgelöst .

Intent-Filter für eingehende Links hinzufügen

Füge einen Intent-Filter hinzu, um einen Link zu deinen App-Inhalten zu erstellen, folgende Elemente und Attributwerte in Ihrem Manifest enthält:

<action>
Geben Sie die Intent-Aktion ACTION_VIEW so an, dass der Intent-Filter über die Google Suche erreicht werden kann.
<data>
Fügen Sie ein oder mehrere <data>-Tags hinzu, die jeweils ein URI-Format darstellen, das auf die Aktivität verweist. Das <data>-Tag muss mindestens das android:scheme-Attribut enthalten.

Sie können weitere Attribute hinzufügen, um den URI-Typ weiter einzugrenzen, der für die Aktivität zulässig ist. Beispiel: Sie haben möglicherweise mehrere Aktivitäten, die ähnliche URIs akzeptieren, sich aber nur durch den Pfadnamen unterscheiden. Verwenden Sie in diesem Fall das Attribut android:path oder die Varianten pathPattern oder pathPrefix, um zu unterscheiden, welche Aktivität das System für verschiedene URI-Pfade öffnen soll.

<category>
BROWSABLE einschließen Kategorie. Er ist erforderlich, damit der Intent-Filter über einen Webbrowser zugänglich ist. Andernfalls kann das Klicken auf einen Link in einem Browser nicht zur App weitergeleitet werden.

Geben Sie auch die Kategorie DEFAULT an. So kann Ihre App auf implizite Intents reagieren. Andernfalls kann die Aktivität gestartet werden, wenn der Intent den Namen Ihrer App-Komponente angibt.

Das folgende XML-Snippet zeigt, wie Sie in Ihrem Manifest einen Intent-Filter für Deeplinks angeben können. Die URIs “example://gizmos” und “http://www.example.com/gizmos” wurden beide in diese Aktivität aufgelöst.

<activity
    android:name="com.example.android.GizmosActivity"
    android:label="@string/title_gizmos" >
    <intent-filter android:label="@string/filter_view_http_gizmos">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- Accepts URIs that begin with "http://www.example.com/gizmos” -->
        <data android:scheme="http"
              android:host="www.example.com"
              android:pathPrefix="/gizmos" />
        <!-- note that the leading "/" is required for pathPrefix-->
    </intent-filter>
    <intent-filter android:label="@string/filter_view_example_gizmos">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- Accepts URIs that begin with "example://gizmos” -->
        <data android:scheme="example"
              android:host="gizmos" />
    </intent-filter>
</activity>

Beachten Sie, dass sich die beiden Intent-Filter nur durch das Element <data> unterscheiden. Es ist zwar möglich, mehrere <data>-Elemente in denselben Filter aufzunehmen, ist es wichtig, separate Filter zu erstellen, wenn Sie eindeutige (z. B. eine bestimmte Kombination aus scheme und host), Mehrere <data>-Elemente im selben Intent-Filter werden tatsächlich zusammengeführt um alle Variationen ihrer kombinierten Attribute zu berücksichtigen. Betrachten Sie beispielsweise Folgendes: 

<intent-filter>
  ...
  <data android:scheme="https" android:host="www.example.com" />
  <data android:scheme="app" android:host="open.my.app" />
</intent-filter>

Es sieht so aus, als würden nur https://www.example.com und app://open.my.app unterstützt. Tatsächlich werden aber diese beiden Zeichen sowie app://www.example.com und https://open.my.app unterstützt.

Achtung:Wenn mehrere Aktivitäten Intent-Filter enthalten, die zum selben Zeitpunkt Android-App-Links bestätigt haben, gibt es keine Garantie, den Link verarbeitet.

Nachdem Sie Ihrer App Intent-Filter mit URIs für Aktivitätsinhalte hinzugefügt haben kann Android alle Intent weiterleiten, der Ihrer App zur Laufzeit übereinstimmende URIs entspricht.

Weitere Informationen zum Definieren von Intent-Filtern finden Sie unter Zulassen, dass andere Apps Aktivitäten starten

Daten aus eingehenden Intents lesen

Sobald das System deine Aktivität über einen Intent-Filter startet, kannst du Bestimmen Sie anhand der von Intent bereitgestellten Daten, was gerendert werden muss. Anruf getData() und getAction()-Methoden zum Abrufen der Daten und Aktion, die mit der eingehenden Intent verknüpft ist. Sie können diese Methoden jederzeit während des Lebenszyklus der Aktivität aufrufen. Sie sollten dies jedoch in der Regel bei frühen Rückrufen wie onCreate() oder onStart() tun.

Im folgenden Snippet wird gezeigt, wie Daten aus einem Intent abgerufen werden:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)

    val action: String? = intent?.action
    val data: Uri? = intent?.data
}

Java

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

    Intent intent = getIntent();
    String action = intent.getAction();
    Uri data = intent.getData();
}

Befolgen Sie diese Best Practices, um die User Experience zu verbessern:

  • Über einen Deeplink sollten Nutzer direkt zum Inhalt gelangen, ohne Aufforderungen, Interstitial-Seiten oder Log-ins. Sorgen Sie dafür, dass Nutzende App-Inhalte auch dann sehen, wenn der Nutzer die App zuvor noch nie geöffnet hat. Es ist in Ordnung, Nutzer bei nachfolgenden Interaktionen oder beim Öffnen der App über den Launcher um Eingaben zu bitten.
  • Befolgen Sie die Designleitfäden, Mit der Zurück-Taste und der Nach-oben-Taste navigieren damit Ihre App den Anforderungen der Nutzer die Rückwärtsnavigation nach gelangen sie über einen Deeplink zu Ihrer App.

Deeplinks testen

Sie können die Android Debug Bridge mit dem Activity Manager-Tool (am) verwenden, um zu testen, ob die Intent-Filter-URIs, die Sie für Deeplinks angegeben haben, auf die richtige App-Aktivität verweisen. Ich den Befehl „adb“ für ein Gerät oder einen Emulator ausführen.

Die allgemeine Syntax zum Testen eines Intent-Filter-URI mit ADB lautet:

$ adb shell am start
        -W -a android.intent.action.VIEW
        -d <URI> <PACKAGE>

Mit dem folgenden Befehl wird beispielsweise versucht, eine Ziel-App-Aktivität aufzurufen, die mit dem angegebenen URI verknüpft ist.

$ adb shell am start
        -W -a android.intent.action.VIEW
        -d "example://gizmos" com.example.android

Die Manifestdeklaration und der Intent-Handler, die Sie oben festgelegt haben, definieren die Verbindung zwischen Ihrer App und einer Website und was mit eingehenden Links geschehen soll. Damit das System Ihre App jedoch als Standard-Handler für eine Reihe von URIs behandelt, müssen Sie auch beantragen, dass das System diese Verbindung überprüft. In der nächsten Lektion erfahren Sie, wie Sie diese Bestätigung implementieren.

Weitere Informationen zu Intents und App-Links finden Sie in den folgenden Ressourcen: