Best Practices für Verknüpfungen

Beachten Sie beim Entwerfen und Erstellen von Verknüpfungen für Ihre App die folgenden Richtlinien:

Designrichtlinien befolgen

Damit die Verknüpfungen deiner App optisch mit den Tastenkombinationen für System-Apps übereinstimmen, folge den Designrichtlinien für das Symbol für App-Verknüpfungen.

Nur vier unterschiedliche Tastenkombinationen veröffentlichen

Die API unterstützt zwar eine Kombination von bis zu 15 statischen und dynamischen Tastenkombinationen für Ihre App, wir empfehlen jedoch, nur vier unterschiedliche Tastenkombinationen zu veröffentlichen, um ihre visuelle Darstellung im Launcher zu verbessern.

Tastenkombinationen werden nicht nur im Launcher angezeigt, sondern auch in der Integrationsbibliothek von Google-Verknüpfungen, um sie auf Google-Oberflächen wie Google Assistant anzeigen zu lassen. Diese Bibliothek unterstützt die Übertragung einer unbegrenzten Anzahl von dynamischen Tastenkombinationen. Wenn Sie diese Bibliothek verwenden, um eine große Anzahl von Tastenkombinationen zu übertragen, empfehlen wir, die rank der Tastenkombinationen festzulegen, die in unterstützten Launchern angezeigt werden müssen. Rufen Sie dazu die Methode setRank() auf.

Länge der Beschreibung für Kurzbefehle beschränken

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

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

Nutzungsverlauf für Kurzbefehle und Aktionen verwalten

Überlege dir bei jeder erstellten Verknüpfung, wie ein Nutzer dieselbe Aufgabe direkt in deiner App ausführen kann. Rufe in jeder dieser Situationen reportShortcutUsed() auf, damit der Launcher einen genauen Verlauf darüber hat, wie oft ein Nutzer die Aktionen ausführt, die deinen Verknüpfungen entsprechen.

Verknüpfungen nur aktualisieren, wenn ihre Bedeutung beibehalten wird

Wenn Sie dynamische und angepinnte Tastenkombinationen ändern, rufen Sie updateShortcuts() nur dann auf, wenn Sie die Informationen einer Verknüpfung ändern, deren Bedeutung erhalten bleibt. Andernfalls verwenden Sie je nach Art der neu erstellten Verknüpfung eine der folgenden Methoden:

Wenn Sie beispielsweise eine Verknüpfung für die Navigation zu einem Supermarkt erstellen, ist es angemessen, diese Verknüpfung zu aktualisieren, wenn sich der Name des Supermarkts ändert, sein Standort jedoch bleibt. Wenn der Nutzer jedoch bei einem anderen Supermarkt einzukaufen beginnt, ist es besser, eine neue Verknüpfung zu erstellen.

Dynamische Tastenkombinationen beim Starten Ihrer 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, bei jedem Start Ihrer App die Anzahl der von getDynamicShortcuts() zurückgegebenen Objekte zu prüfen und dynamische Verknüpfungen nach Bedarf noch einmal zu veröffentlichen, wie im Code-Snippet unter Sichern und Wiederherstellen gezeigt.