Android-App-Links hinzufügen

Android-App-Links sind HTTP-URLs, über die Nutzer direkt zu bestimmten in Ihrer Android-App. Mit Android-App-Links können Sie mehr Zugriffe können Sie leichter erkennen, welche App-Inhalte am häufigsten verwendet werden, und Nutzern um Inhalte in einer installierten App zu finden und zu teilen.

Der App-Link-Assistent in Android Studio vereinfacht diesen Vorgang mit einer Schritt-für-Schritt-Anleitung wie unten beschrieben.

Weitere Informationen zur Funktionsweise von App-Links und ihren Vorteilen findest du hier: Umgang mit Android-App-Links

Intent-Filter hinzufügen

Mit dem App-Link-Assistenten in Android Studio Intent-Filter in Ihrem Manifest und ordnen Sie vorhandene URLs auf Ihrer Website den Aktivitäten in Ihrer App zu. App-Links Assistant fügt außerdem in jeder entsprechenden Aktivität Vorlagencode hinzu, um die die Nutzerabsicht verstehen.

So fügen Sie Intent-Filter und URL-Verarbeitung hinzu:

1. Wählen Sie Tools > Assistant für App-Links.
2. Klicken Sie auf URL-Zuordnungs-Editor öffnen und dann auf Hinzufügen. am am Ende der Liste URL-Zuordnung, um eine neue URL-Zuordnung hinzuzufügen.

3. Fügen Sie Details für die neue URL-Zuordnung hinzu:

   

   Abbildung 1: Grundlegende Details zum Link Ihrer Website hinzufügen um URLs Aktivitäten in Ihrer App zuzuordnen.

   1. Geben Sie die URL Ihrer Website in das Feld Host ein.

   2. Fügen Sie ein path, pathPrefix oder pathPattern für die URLs, die Sie zuordnen möchten.

      Wenn Sie z. B. eine App zum Teilen von Rezepten haben, die alle Rezepte im selben Ordner enthält, Aktivität und die Rezepte der entsprechenden Website befinden sich alle im selben /recipe. Verwenden Sie pathPrefix und geben Sie /recipe ein. Auf diese Weise wird die URL Unter http://www.recipe-app.com/recipe/grilled-potato-salad wird die Aktivität angezeigt, die Sie in folgenden Schritt ausführen.

   3. Wählen Sie die Aktivität aus, zu der Nutzer über die URLs weitergeleitet werden sollen.
   4. Klicken Sie auf OK.

   Das Fenster des URL-Zuordnungs-Editors wird angezeigt. Der App-Link-Assistent fügt Intent-Filter auf Grundlage Ihrer URL-Zuordnung zum AndroidManifest.xml-Datei und hebt die Änderungen in der Preview (Vorschau). Wenn Sie Änderungen vornehmen möchten, klicken Sie auf Öffnen AndroidManifest.xml, um den Intent-Filter zu bearbeiten. Weitere Informationen finden Sie unter Intent Filter für eingehende Links.

   Im Hauptfenster des App-Link-Assistenten werden auch alle vorhandenen Deeplinks im AndroidManifest.xml-Datei und Sie können Fehlkonfigurationen durch Klick auf Behebe alle Manifestprobleme.

   

   Hinweis:Wenn Sie zukünftige Links unterstützen möchten, ohne Ihre App zu aktualisieren, müssen Sie Definieren Sie eine URL-Zuordnung, die URLs unterstützt, die Sie hinzufügen möchten. Fügen Sie außerdem eine URL für den Startbildschirm Ihrer App, damit sie in den Suchergebnissen enthalten ist.

4. Um zu überprüfen, ob Ihre URL-Zuordnung ordnungsgemäß funktioniert, geben Sie eine URL in das Feld URL-Zuordnung prüfen ein. ein.

   Wenn es richtig funktioniert, zeigt an, dass die von Ihnen eingegebene URL der von Ihnen ausgewählten Aktivität zugeordnet ist.

Eingehende Links verarbeiten

Nachdem Sie sich vergewissert haben, dass die URL-Zuordnung korrekt funktioniert, fügen Sie eine Logik für die Verarbeitung des Intents hinzu. von Ihnen erstellt:

1. Klicken Sie im Assistenten für App-Links auf Aktivitäten auswählen.
2. Wählen Sie eine Aktivität aus der Liste aus und klicken Sie auf Code einfügen.

Der App-Link-Assistent fügt Ihrer Aktivität Code hinzu, der dem folgenden ähnelt:

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    // ATTENTION: This was auto-generated to handle app links.
    val appLinkIntent: Intent = intent
    val appLinkAction: String? = appLinkIntent.action
    val appLinkData: Uri? = appLinkIntent.data
    ...
}

@Override
void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // ATTENTION: This was auto-generated to handle app links.
    Intent appLinkIntent = getIntent();
    String appLinkAction = appLinkIntent.getAction();
    Uri appLinkData = appLinkIntent.getData();
    ...
}

Dieser Code ist von allein nicht vollständig. Sie müssen nun eine Aktion basierend auf dem URI in appLinkData, z. B. die Anzeige des entsprechenden Inhalts. Für das Feld App zum Teilen von Rezepten könnte Ihr Code wie im folgenden Beispiel aussehen:

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    handleIntent(intent)
}

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    handleIntent(intent)
}

private fun handleIntent(intent: Intent) {
    val appLinkAction = intent.action
    val appLinkData: Uri? = intent.data
    if (Intent.ACTION_VIEW == appLinkAction) {
        appLinkData?.lastPathSegment?.also { recipeId ->
            Uri.parse("content://com.recipe_app/recipe/")
                    .buildUpon()
                    .appendPath(recipeId)
                    .build().also { appData ->
                        showRecipe(appData)
                    }
        }
    }
}

protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  ...
  handleIntent(getIntent());
}

protected void onNewIntent(Intent intent) {
  super.onNewIntent(intent);
  handleIntent(intent);
}

private void handleIntent(Intent intent) {
    String appLinkAction = intent.getAction();
    Uri appLinkData = intent.getData();
    if (Intent.ACTION_VIEW.equals(appLinkAction) && appLinkData != null){
        String recipeId = appLinkData.getLastPathSegment();
        Uri appData = Uri.parse("content://com.recipe_app/recipe/").buildUpon()
            .appendPath(recipeId).build();
        showRecipe(appData);
    }
}

App mit Ihrer Website verknüpfen

Nachdem Sie die URL-Unterstützung für Ihre App eingerichtet haben, erstellt der App-Link-Assistent digitale Assets. Linkdatei, mit der Sie verknüpfen Sie Ihre Website Ihrer App.

Als Alternative zur Verwendung der Digital Asset Links-Datei kannst du verknüpfen Sie Ihre Website Search Console.

Wenn Sie Google Play-App Signieren für Ihre App, dann der Zertifikat-Fingerabdruck der App-Links Assistant stimmt normalerweise nicht mit der Adresse auf dem Nutzer-Konto überein Geräte. In diesem Fall finden Sie das richtige Digital Asset Links-JSON-Snippet für Ihre App in Ihrem Play Console-Entwicklerkonto unter Release > Setup > App signing

Um Ihre App und Ihre Website mithilfe des App-Links-Assistenten zu verknüpfen, klicken Sie auf Öffnen Digital Asset Links-Dateigenerator aus und folgen Sie diesen Schritte:

Abbildung 2: Geben Sie Details zu Ihrer Website und App ein, um um eine Digital Asset Links-Datei zu erstellen.

1. Geben Sie Ihre Websitedomain und Ihre Bewerbung ID

2. So fügen Sie in Ihre Digital Asset Links-Datei Support für <ph type="x-smartling-placeholder"></ph> Anmeldung mit One Tap und wählen Sie Unterstützung für die gemeinsame Nutzung von Anmeldedaten zwischen der App und der Website und geben Sie die Anmelde-URL Ihrer Website ein.Dadurch wird der Digital Asset Links-Datei, in der deklariert wird, dass für Ihre App und Ihre Website Anmeldedaten verwendet werden: delegate_permission/common.get_login_creds

3. Geben Sie die Signaturkonfiguration an oder Wählen Sie eine Schlüsselspeicherdatei aus.

   Achten Sie darauf, dass Sie die richtige Releasekonfigurations- oder Schlüsselspeicherdatei für den Release-Build oder den Debug-Konfigurations- oder Schlüsselspeicherdatei für die Debuggen Sie den Build Ihrer App. Wenn Sie Ihren Produktions-Build einrichten möchten, verwenden Sie die Methode Releasekonfiguration. Verwenden Sie die Debug-Konfiguration, wenn Sie Ihren Build testen möchten.

4. Klicke auf Digital Asset Links-Datei generieren.
5. Sobald die Datei in Android Studio erstellt wurde, klicken Sie auf Datei speichern, um sie herunterzuladen.
6. Laden Sie die Datei assetlinks.json mit Lesezugriff für alle auf Ihre Website hoch: https://yoursite/.well-known/assetlinks.json.

   Wichtig:Das System überprüft die Digital Asset Links-Datei über das verschlüsseltes HTTPS-Protokoll. Stellen Sie sicher, dass auf die assetlinks.json-Datei über HTTPS-Verbindung unabhängig davon, ob der Intent-Filter Ihrer App https.

7. Klicke auf Verknüpfen und bestätigen, um zu bestätigen, dass du das richtige digitale Asset hochgeladen hast. Verlinkt die Datei mit dem richtigen Speicherort.

Der App-Link-Assistent kann die Digital Assets Links-Datei validieren, die auf Ihrer Website. Assistant parst die Datei für jede Domain, die in der Manifestdatei deklariert ist. auf Ihrer Website überprüfen, Validierungen durchführen und eine detaillierte Erklärung zur Behebung Fehler.

Weitere Informationen zum Verknüpfen Ihrer Website mit Ihrer App über die Digital Asset Links-Datei in Website deklarieren Verknüpfungen.

Android-App-Links testen

So überprüfen Sie, ob Ihre Links die richtige Aktivität öffnen:

1. Klicken Sie im Assistenten für App-Links auf App-Links testen.
2. Geben Sie in das Feld URL die URL ein, die Sie testen möchten. zum Beispiel http://recipe-app.com/recipe/grilled-potato-salad


Abbildung 3: Dialogfeld App-Links testen mit einer URL, die getestet wird, und einer Erfolgsmeldung.

3. Klicken Sie auf Run Test (Test ausführen).

Wenn die URL-Zuordnung nicht richtig eingerichtet ist oder nicht vorhanden ist, wird eine Fehlermeldung unter dem URL im Dialogfeld App-Links testen ein. Andernfalls wird Android Studio Ihre App bei der angegebenen Aktivität auf dem Gerät oder im Emulator startet, ohne das (App-Auswahl) und zeigt eine Erfolgsmeldung in der Dialogfeld App Link Testing (App-Linktest), wie in Abbildung 3 dargestellt.

Wenn Android Studio nicht gestartet werden kann App installiert haben, wird im Fenster Ausführen von Android Studio eine Fehlermeldung angezeigt.

Um Android-App-Links über den App-Links-Assistenten zu testen, muss ein Gerät verbunden oder ein virtuelles Gerät mit Android 6.0 (API-Level 23) oder höher verfügbar. Weitere Informationen Informationen zum Verbinden eines Geräts oder erstellen Sie ein AVD.