Verknüpfungen erstellen

Beachten Sie beim Entwerfen und Erstellen der App-Verknüpfungen die folgenden Richtlinien:

Designrichtlinien berücksichtigen

Damit die Verknüpfungen Ihrer App optisch mit den Verknüpfungen von System-Apps übereinstimmen, folgen Sie den Designrichtlinien für App-Verknüpfungssymbole.

Nur vier verschiedene Tastenkombinationen veröffentlichen

Die API unterstützt zwar eine Kombination aus bis zu 15 statischen und dynamischen Verknüpfungen für Ihre App, wir empfehlen jedoch, nur vier verschiedene Verknüpfungen zu veröffentlichen, um die Darstellung im Launcher zu verbessern.

Verwende zusätzlich zur Anzeige von Verknüpfungen im Launcher die Google Shortcuts Integration Library, um Verknüpfungen auf Google-Oberflächen wie Google Assistant anzuzeigen. Diese Bibliothek unterstützt das Pushen einer unbegrenzten Anzahl dynamischer Verknüpfungen. Wenn Sie diese Bibliothek verwenden, um eine große Anzahl von Verknüpfungen zu übertragen, empfehlen wir, die rank der Verknüpfungen festzulegen, die in unterstützten Launchern angezeigt werden müssen. Rufen Sie dazu die Methode setRank() auf.

Länge der Beschreibung der Verknüpfung begrenzen

Der Platz im Menü, in dem die Verknüpfungen Ihrer App im Launcher angezeigt werden, ist begrenzt. Beschränken Sie die Länge der „Kurzbeschreibung“ einer Verknüpfung nach Möglichkeit auf 10 Zeichen und die Länge der „Langbeschreibung“ auf 25 Zeichen.

Weitere Informationen zu Labels für statische Verknüpfungen finden Sie unter Attributwerte anpassen. Weitere Informationen zu dynamischen und angepinnten Verknüpfungen finden Sie in der Referenzdokumentation zu setLongLabel() und setShortLabel().

Verlauf der Nutzung von Verknüpfungen und Aktionen beibehalten

Überlegen Sie sich für jede Verknüpfung, die Sie erstellen, wie ein Nutzer dieselbe Aufgabe direkt in Ihrer App ausführen kann. Rufen Sie reportShortcutUsed() in jeder dieser Situationen auf, damit der Launcher einen genauen Verlauf der Häufigkeit führt, mit der ein Nutzer die Aktionen ausführt, die Ihre Verknüpfungen darstellen.

Tastenkombinationen nur aktualisieren, wenn ihre Bedeutung erhalten bleibt

Rufen Sie beim Ändern dynamischer und angepinnter Verknüpfungen updateShortcuts() nur auf, wenn sich die Informationen einer Verknüpfung ändern, die ihre Bedeutung beibehält. Verwenden Sie andernfalls eine der folgenden Methoden, je nachdem, welche Art von Shortcut Sie neu erstellen:

• Dynamische Verknüpfungen: pushDynamicShortcut().

• Angepinnte Verknüpfungen: requestPinShortcut().

  Wenn Sie beispielsweise eine Verknüpfung zum Navigieren zu einem Supermarkt erstellen, ist es angemessen, die Verknüpfung zu aktualisieren, wenn sich der Name des Supermarkts ändert, die Adresse jedoch gleich bleibt. Wenn der Nutzer jedoch in einem anderen Supermarkt einkauft, ist es besser, eine neue Verknüpfung zu erstellen.

Dynamische Verknüpfungen bei jedem Start der App prüfen

Dynamische Verknüpfungen werden nicht beibehalten, wenn der Nutzer seine Daten auf einem neuen Gerät wiederherstellt. Aus diesem Grund empfehlen wir, die Anzahl der von getDynamicShortcuts() zurückgegebenen Objekte bei jedem Start Ihrer App zu prüfen und dynamische Verknüpfungen nach Bedarf neu zu veröffentlichen, wie im Code-Snippet unter Sichern und Wiederherstellen gezeigt.