Eigenständige und nicht eigenständige Wear OS-Apps im Vergleich

Wir empfehlen, dass Wear OS-Apps unabhängig von einem Smartphone funktionieren, damit Nutzer Aufgaben auf einer Smartwatch ausführen können, ohne Zugriff auf ein Android- oder iOS-Smartphone zu haben. Wenn für deine Smartwatch-App eine Interaktion über ein Smartphone erforderlich ist, musst du deine Wear OS-App als nicht eigenständig kennzeichnen und dafür sorgen, dass die Smartphone-App für den Nutzer verfügbar ist.

App planen

Mit dem Android App Bundle können Sie automatisch optimierte Android Package Kits (APKs) für die Gerätekonfiguration jedes Nutzers unter demselben App-Eintrag generieren. So können Nutzer nur den Code und die Ressourcen herunterladen, die sie zum Ausführen der App benötigen.

Informationen zum Einrichten deiner App für den Vertrieb über den Google Play Store findest du unter Wear OS-Apps im Paket anbieten und vertreiben und im Leitfaden zu Android App Bundles.

Bei neuen Apps muss das Ziel-API-Level 34 oder höher sein. Weitere Informationen finden Sie unter Anforderungen an das Ziel-API-Level von Google Play erfüllen. Wenn du das neueste verfügbare API-Level verwendest, funktioniert deine App auf aktuellen Plattformversionen besser.

Informationen zu Netzwerkanfragen und Netzwerkzugriff mit hoher Bandbreite findest du unter Netzwerkzugriff und Synchronisierung unter Wear OS.

App als Wear OS-App definieren

Sie müssen das <uses-feature>-Tag in der Android-Manifestdatei Ihrer App definieren. Füge einen Eintrag wie den folgenden hinzu, um anzugeben, dass es sich um eine Smartwatch-App handelt:

<uses-feature android:name="android.hardware.type.watch" />

App als eigenständig oder nicht eigenständig kennzeichnen

Eine Smartwatch-App gilt entweder als eigenständig oder als nicht eigenständig:

  • Eigenständig: Eine vollständig unabhängige App, die für die Hauptfunktionen keine Smartphone-App benötigt. Aufforderungen wie „Auf dem Smartphone öffnen“ sind zwar zulässig, die App muss jedoch alternative Möglichkeiten bieten, mit denen Nutzer eine App-Funktion ausführen können, z. B. einen Kurzlink oder einen QR-Code, ohne dass ein verbundenes Smartphone erforderlich ist.
  • Nicht eigenständig: Eine abhängige App, die für die Hauptfunktionen eine App auf einem Smartphone oder einem anderen Gerät benötigt. Diese Option eignet sich am besten für Apps, die keine einfache Alternative wie einen QR-Code oder einen Kurzlink für die Ausführung einer Hauptfunktion der App wie die Authentifizierung bieten können.

Hinweis: Auch bei nicht eigenständigen Apps können Nutzer die Wear OS-App vor der mobilen App installieren. Wenn Ihre Wear OS-App also erkennt, dass auf einem Mobilgerät in der Nähe die erforderliche Companion-App fehlt, fordern Sie den Nutzer auf, die Companion-App zu installieren.

Google prüft die Richtigkeit des Status einer eigenständigen App während der Bereitstellung der App. Dieser Wert wirkt sich auf die Sichtbarkeit von Apps im Google Play Store auf Geräten ohne Tethering aus, z. B. Wear OS-Geräte, die nicht mit Mobilgeräten gekoppelt sind. Nicht eigenständige Apps sowie Apps, die von Entwicklern fälschlicherweise als „eigenständig“ gekennzeichnet wurden, sind für Nutzer auf diesen Geräten ohne Smartphone-Verbindung nicht verfügbar.

Lege in deiner Wear OS-App den Wert des meta-data-Elements com.google.android.wearable.standalone in der Android-Manifestdatei fest, um anzugeben, ob deine App eigenständig oder nicht eigenständig ist.

Wenn deine Smartwatch-App eine vollständig unabhängige, eigenständige App ist, teile dies dem Google Play Store mit, indem du den Wert von com.google.android.wearable.standalone auf true setzt:

<meta-data
    android:name="com.google.android.wearable.standalone"
    android:value="true" />

Wenn deine Smartwatch-App nicht eigenständig ist und für Hauptfunktionen von einer anderen App abhängt, setze den Wert von com.google.android.wearable.standalone auf false. Dies bedeutet, dass für die Smartwatch-App ein anderes Gerät erforderlich ist, hat aber keine Auswirkungen auf die App-Werbung im Google Play Store.

Hinweis: Auch wenn com.google.android.wearable.standalone den Wert false hat, kann die Smartwatch-App vor der Installation der Telefon App installiert werden. Wenn deine Smartwatch-App also erkennt, dass auf einem gekoppelten Smartphone die erforderliche Telefon App fehlt, wie auf dieser Seite beschrieben, fordere den Nutzer auf, die Telefon App zu installieren.

Gemeinsamer Code- und Datenspeicher

Code kann zwischen einer Wear OS-App und einer Smartphone-App geteilt werden. Beispielsweise kann gemeinsamer Code für die Netzwerkkommunikation in einer gemeinsam genutzten Bibliothek enthalten sein.

Optional kann Code, der für einen Formfaktor spezifisch ist, in einem separaten Modul enthalten sein.

Du kannst die Standard-Android-Storage-APIs verwenden, um Daten lokal zu speichern, so wie du es auf einem Smartphone tun würdest. Sie können DataStore verwenden, um Schlüssel/Wert-Paare und typisierte Objekte zu speichern, oder die Persistenzbibliothek Room.

App auf einem anderen Gerät erkennen

Sowohl die Smartwatch-App als auch die entsprechende Smartphone-App können erkennen, ob die jeweils andere App verfügbar ist.

Deine Smartphone- und Smartwatch-Apps können die CapabilityClient verwenden, um ihre Anwesenheit auf einem gekoppelten Gerät zu signalisieren. Das kann statisch oder dynamisch erfolgen.

Wenn sich eine App auf einem Knoten im Wear OS-Netzwerk eines Nutzers befindet, z. B. auf einem Smartphone, einer gekoppelten Smartwatch oder in der Cloud, kann sie von anderen Apps über die CapabilityClient erkannt werden. Weitere Informationen findest du unter Bestimmte Geräte mit einem CapabilityClient finden.

Wenn eine deiner Apps die andere nicht erkennen kann, kannst du den Nutzer auffordern, den Google Play Store-Eintrag auf dem betroffenen Gerät zu öffnen. Dies ist eine Lösung für Smartwatch-Apps, die die zugehörige Smartphone-App benötigen, um richtig zu funktionieren.

Du musst prüfen, ob der Play Store auf dem Gerät verfügbar ist, da nicht alle Smartphones, z. B. iPhones, den Play Store unterstützen.

In den folgenden Abschnitten werden Best Practices für zwei Szenarien beschrieben:

  • Ihre eigenständige Smartwatch-App benötigt Ihre Smartphone-App.
  • Die Smartphone-App benötigt die eigenständige Smartwatch-App.

Du kannst dir auch das Beispiel für Datenschicht-Hilfsprogramme ansehen, das zeigt, wie die Bibliotheken für Datenschicht-Hilfsprogramme verwendet werden, die Teil von Horologist sind. Mit diesen Hilfsprogrammen kannst du die Verbindung zwischen einem Mobilgerät und einem Wear OS-Gerät überwachen. Weitere Informationen zu den im folgenden Abschnitt beschriebenen Klassen findest du in der Wear OS API-Referenz. Diese Referenz enthält auch Informationen zur Klasse PhoneTypeHelper, die eine Methode getPhoneDeviceType() enthält, mit der deine Wear OS-App prüfen kann, ob ein Companion-Smartphone ein Android- oder iOS-Gerät ist.

Funktionsnamen für die Erkennung Ihrer Apps angeben

Gib für die App, die dem jeweiligen Gerätetyp (Smartwatch oder Smartphone) entspricht, in der Datei res/values/wear.xml einen eindeutigen String für den Namen der Funktion an.

In Ihrem mobilen Modul könnte die Datei wear.xml beispielsweise Folgendes enthalten:

<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@array/android_wear_capabilities">
    <string-array name="android_wear_capabilities">
        <item>verify_remote_example_phone_app</item>
    </string-array>
</resources>

In Ihrem Wear OS-Modul enthält die Datei wear.xml einen anderen Wert für den Namen der Funktion, z. B.:

<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@array/android_wear_capabilities">
    <string-array name="android_wear_capabilities">
        <item>verify_remote_example_wear_app</item>
    </string-array>
</resources>

Weitere Informationen findest du unter Bestimmte Geräte mit einem CapabilityClient finden.

App-Erkennung und Öffnen einer URL über eine Smartwatch

Deine Smartwatch-App kann erkennen, ob auf dem Smartphone des Nutzers deine Smartphone-App installiert ist. Gehe dazu so vor:

  1. Prüfe mit der CapabilityClient, ob die Smartphone-App auf dem gekoppelten Smartphone installiert ist. Weitere Informationen finden Sie im Beispiel für Datenschicht-Hilfsprogramme auf GitHub.
  2. Wenn die Telefon App nicht auf dem Smartphone installiert ist, verwende die Methode PhoneDeviceType.getPhoneDeviceType(), um den Typ des Smartphones zu prüfen. Weitere Informationen finden Sie im folgenden Abschnitt.
  3. Wenn PhoneDeviceType.DEVICE_TYPE_ANDROID zurückgegeben wird, ist das Smartphone ein Android-Smartphone. Rufe RemoteActivityHelper.startRemoteActivity() auf dem Wear OS-Gerät auf, um den Google Play Store auf dem Smartphone zu öffnen. Verwende den Markt-URI für deine Smartphone-App, der sich vom URI deiner Wear-App unterscheiden kann. Verwende beispielsweise einen Markt-URI wie market://details?id=com.example.android.wearable.wear.finddevices.
  4. Wenn PhoneDeviceType.DEVICE_TYPE_IOS zurückgegeben wird, ist das Smartphone ein iOS-Smartphone, auf dem der Play Store nicht verfügbar ist. Öffne den App Store auf dem iPhone, indem du RemoteActivityHelper.startRemoteActivity() auf dem Wear OS-Gerät aufrufst. Sie können die iTunes-URL Ihrer App angeben, z. B. https://itunes.apple.com/us/app/yourappname.

    In Wear OS kannst du nicht programmatisch ermitteln, ob deine Smartphone-App auf einem iOS-Gerät installiert ist. Als Best Practice empfiehlt es sich, dem Nutzer eine Möglichkeit zu bieten, das Öffnen des App-Shops manuell auszulösen.

Hinweis: Verwende die RemoteActivityHelper API wie im vorherigen Abschnitt beschrieben, um anzugeben, dass jede URL von der Smartwatch auf dem Telefon geöffnet werden kann und dass keine Telefon App erforderlich ist.

Details zur Erkennung des Typs des gekoppelten Smartphones

Hier ist ein Snippet, in dem die Methode getPhoneDeviceType() verwendet wird, um den Typ des Smartphones zu prüfen, mit dem die Smartwatch gekoppelt ist:

var phoneDeviceType: Int = PhoneTypeHelper.getPhoneDeviceType(this)

Der von der Methode getPhoneDeviceType() zurückgegebene Wert ist einer der folgenden:

Rückgabewert Beschreibung
DEVICE_TYPE_ANDROID Das gekoppelte Smartphone ist ein Android-Gerät.
DEVICE_TYPE_IOS Das gekoppelte Smartphone ist ein iOS-Gerät.
DEVICE_TYPE_UNKNOWN Das Companion-Smartphone ist ein unbekanntes Gerät.
DEVICE_TYPE_ERROR Beim Bestimmen des Typs des gekoppelten Smartphones ist ein Fehler aufgetreten. Es sollte später eine weitere Prüfung durchgeführt werden.

App-Erkennung auf einem Android-Smartphone

Dein Android-Smartphone kann erkennen, ob auf den Wear OS-Geräten eines Nutzers deine Smartwatch-App installiert ist. Gehe dazu so vor:

  1. Suche mit dem NodeClient alle Smartwatches, die mit dem Smartphone des Nutzers verbunden sind. Weitere Informationen finden Sie im Beispiel für Datenschicht-Hilfsprogramme auf GitHub.
  2. Prüfe mit der CapabilityClient, auf welchen Smartwatches des Nutzers deine App installiert ist.
  3. Wenn deine App nicht auf allen Smartwatches des Nutzers installiert ist, kannst du den Nutzer den Play Store auf den verbleibenden Wear OS-Geräten über das Smartphone mit der Methode RemoteActivityHelper.startRemoteActivity() öffnen lassen. Verwende den Market-URI für die Wear OS-App. Dieser kann sich vom URI deiner Smartphone-App unterscheiden. Verwende beispielsweise einen Market-URI wie market://details?id=com.example.android.wearable.wear.finddevices.

Standortdaten für Smartwatches, die mit iPhones gekoppelt sind

Verwende bei Smartwatches, die mit iPhones gekoppelt sind, den Fused Location Provider (FLP), um Standortdaten auf der Smartwatch abzurufen. Weitere Informationen findest du unter Standort auf Wear OS ermitteln.

Wenn das Smartphone verfügbar ist, verwendet der FLP das Smartphone für Standortdaten.

Nur erforderliche Daten abrufen

Wenn du Daten aus dem Internet abrufst, solltest du im Allgemeinen nur die erforderlichen Daten abrufen. Andernfalls kann es zu unnötiger Latenz, Speichernutzung und Akkunutzung kommen.

Wenn eine Smartwatch über eine Bluetooth LE-Verbindung verbunden ist, hat deine App je nach Smartwatch möglicherweise nur Zugriff auf eine Bandbreite von 4 Kilobyte pro Sekunde. Wir empfehlen daher folgende Schritte:

  • Prüfen Sie Ihre Netzwerkanfragen und -antworten auf zusätzliche Daten, die nur für eine Smartphone-App erforderlich sind.
  • Verkleinere große Bilder, bevor du sie über ein Netzwerk an eine Smartwatch sendest.

Informationen zu Fällen, in denen ein Netzwerk mit hoher Bandbreite erforderlich ist, finden Sie unter Netzwerkzugriff mit hoher Bandbreite.

Zusätzliche Codebeispiele

Das Beispiel für Datalayer-Hilfsprogramme veranschaulicht die Verwendung der auf dieser Seite beschriebenen APIs.