Отдельные и не отдельные приложения Wear OS

Рекомендуем создавать приложения для Wear OS, которые могут работать независимо от телефона, чтобы пользователи могли выполнять задачи на часах без доступа к телефону Android или iOS. Если для работы приложения для часов требуется взаимодействие с телефоном, вы должны пометить приложение для Wear OS как неавтономное и предпринять шаги, чтобы убедиться, что у пользователя есть доступ к приложению "Телефон".

Планирование приложения

Вы можете использовать набор Android App Bundle, чтобы автоматически создавать оптимизированные APK-файлы для каждой конфигурации устройства пользователя в рамках одной страницы приложения. Это позволяет пользователям скачивать только тот код и ресурсы, которые необходимы для запуска приложения.

Информацию о том, как подготовить приложение к распространению через Google Play, вы найдете в статьях Упаковка и распространение приложений для Wear OS и Начало работы с наборами Android App Bundle.

Для новых приложений целевой уровень API должен быть не ниже 34. Подробнее о том, как обеспечить соответствие требованиям Google Play к целевому уровню API… Если вы выберете последний доступный уровень API, то ваше приложение будет хорошо работать на текущих версиях платформы.

Дополнительную информацию о сетевых запросах и доступе к сети с высокой пропускной способностью можно найти в статье Доступ к сети и синхронизация в Wear OS.

Как определить приложение как приложение для Wear OS

В файле манифеста Android вашего приложения необходимо определить тег <uses-feature>. Чтобы указать, что это приложение для часов, добавьте запись, подобную следующей:

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

Как определить, является ли приложение отдельным

Приложения для часов делятся на два типа:

  • Автономное. Полностью независимое приложение, для работы основных функций которого не требуется приложение на телефоне. Подсказки "Открыть на телефоне" допустимы, но в приложении должны быть предусмотрены альтернативные способы выполнения действий, например короткая ссылка или QR-код, не требующие подключения к телефону.
  • Зависимое приложение. Для работы основных функций требуется приложение на телефоне или другом устройстве. Этот вариант лучше всего подходит для приложений, в которых нельзя легко реализовать альтернативный способ выполнения основной функции, например аутентификации, с помощью QR-кода или короткой ссылки.

Примечание. Даже если приложение неавтономное, пользователь может установить его на устройство Wear OS раньше, чем на мобильное устройство. Если приложение для Wear OS обнаружит, что на находящемся поблизости мобильном устройстве нет сопутствующего приложения, оно должно предложить пользователю установить его.

Google проверяет точность статуса автономного приложения во время его показа. Это значение влияет на видимость приложений в Google Play на автономных устройствах, например устройствах Wear OS, которые не подключены к мобильным устройствам. Приложения, которые не являются автономными, а также приложения, которые разработчики ошибочно пометили как автономные, недоступны пользователям на таких устройствах.

В файле манифеста Android приложения для Wear OS задайте значение элемента meta-data com.google.android.wearable.standalone, чтобы указать, является ли приложение автономным.

Если приложение для часов полностью независимо, укажите это в Google Play, задав для com.google.android.wearable.standalone значение true:

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

Если приложение для часов не является самостоятельным и его основные функции зависят от другого приложения, задайте для атрибута com.google.android.wearable.standalone значение false. Это означает, что для работы приложения для часов требуется другое устройство, но не влияет на рекламу приложения в Google Play.

Примечание. Даже если для com.google.android.wearable.standalone задано значение false, приложение для часов можно установить до установки приложения "Телефон". Поэтому, если приложение для часов обнаружит, что на сопутствующем телефоне нет необходимого приложения "Телефон", как описано на этой странице, предложите пользователю установить его.

Общий код и хранилище данных

Код может быть общим для приложения для Wear OS и приложения "Телефон". Например, общий код для работы с сетью может находиться в общей библиотеке.

При необходимости код, предназначенный для определенного типа устройства, можно поместить в отдельный модуль.

Для локального хранения данных можно использовать стандартные API хранилища Android, как на телефоне. Для хранения пар "ключ-значение" и типизированных объектов можно использовать DataStore или библиотеку персистентности Room.

Обнаружение приложения на другом устройстве

Приложение для часов и соответствующее приложение "Телефон" могут определять, доступно ли другое приложение.

Приложения на телефоне и часах могут использовать CapabilityClient, чтобы сообщать о своем присутствии подключенному устройству. Это можно сделать статически или динамически.

Если приложение находится на узле в сети Wear OS пользователя, например на телефоне, подключенных часах или в облаке, CapabilityClient позволяет другим приложениям обнаружить его. Подробнее о том, как находить устройства с помощью CapabilityClient…

Если одно из ваших приложений не может обнаружить другое, вы можете предложить пользователю открыть страницу в Google Play на затронутом устройстве. Это решение для приложений, которые не могут работать без сопутствующего приложения на телефоне.

Необходимо проверить, доступен ли Google Play на устройстве, поскольку не все телефоны, например iPhone, поддерживают Google Play.

Ниже приведены рекомендации для двух сценариев:

  • Для работы автономного приложения на часах требуется приложение на телефоне.
  • Приложению на телефоне требуется автономное приложение на часах.

Вы также можете ознакомиться с примером использования помощников уровня данных, в котором показано, как работать с библиотеками помощников уровня данных, входящими в состав Horologist. Эти помощники позволяют отслеживать подключение между мобильным устройством и устройством Wear OS. Дополнительную информацию о классах, описанных в следующем разделе, можно найти в документации по Wear OS API. В этом справочнике также есть информация о классе PhoneTypeHelper, который содержит метод getPhoneDeviceType(), позволяющий приложению Wear OS проверять, является ли сопутствующий телефон устройством Android или iOS.

Укажите названия возможностей для обнаружения приложений

Для приложения, соответствующего каждому типу устройства (часы или телефон), укажите уникальную строку для названия возможности в файле res/values/wear.xml.

Например, в мобильном модуле файл wear.xml может содержать следующее:

<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>

В модуле Wear OS файл wear.xml содержит другое значение для названия функции, например:

<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>

Подробнее о том, как находить устройства с помощью клиента возможностей…

Обнаружение приложения и открытие URL на часах

Приложение для часов может определить, установлено ли на телефоне пользователя сопутствующее приложение. Для этого выполните следующие действия:

  1. Используйте CapabilityClient, чтобы проверить, установлено ли приложение "Телефон" на подключенном телефоне. Дополнительную информацию можно найти в примере помощников уровня данных на сайте GitHub.
  2. Если приложение "Телефон" не установлено на телефоне, используйте метод PhoneDeviceType.getPhoneDeviceType(), чтобы проверить тип телефона. Подробная информация приведена в следующем разделе.
  3. Если возвращается PhoneDeviceType.DEVICE_TYPE_ANDROID, то это телефон Android. Вызовите RemoteActivityHelper.startRemoteActivity() на устройстве Wear OS, чтобы открыть Google Play на телефоне. Используйте URI для приложения на телефоне, который может отличаться от URI приложения для Wear OS. Например, используйте URI Google Play: market://details?id=com.example.android.wearable.wear.finddevices.
  4. Если возвращается значение PhoneDeviceType.DEVICE_TYPE_IOS, то это телефон iOS, на котором нет Google Play. Откройте магазин приложений на iPhone, вызвав RemoteActivityHelper.startRemoteActivity() на устройстве Wear OS. Вы можете указать URL приложения в iTunes, например https://itunes.apple.com/us/app/yourappname.

    В Wear OS нельзя программно определить, установлено ли приложение для телефона на устройстве iOS. Рекомендуем предоставить пользователю возможность вручную открывать магазин приложений.

Примечание. Используйте API RemoteActivityHelper, как описано в предыдущем разделе, чтобы указать, что любой URL-адрес должен открываться на телефоне с часов и что приложение "Телефон" не требуется.

Сведения об определении типа подключенного телефона

Ниже приведен фрагмент кода, в котором метод getPhoneDeviceType() используется для проверки типа телефона, подключенного к часам.

var phoneDeviceType: Int = PhoneTypeHelper.getPhoneDeviceType(this)

Метод getPhoneDeviceType() возвращает одно из следующих значений:

Возвращаемое значение Описание
DEVICE_TYPE_ANDROID Телефон-компаньон работает на базе Android.
DEVICE_TYPE_IOS Сопутствующий телефон — это iOS-устройство.
DEVICE_TYPE_UNKNOWN Телефон-компаньон – неизвестное устройство.
DEVICE_TYPE_ERROR При определении типа подключенного телефона произошла ошибка. Повторите попытку позже.

Обнаружение приложений, начиная с телефона Android

Телефон Android может определить, установлено ли на устройствах Wear OS пользователя ваше приложение для часов. Для этого выполните следующие действия:

  1. С помощью NodeClient найдите все часы, подключенные к телефону пользователя. Дополнительную информацию можно найти в примере помощников уровня данных на сайте GitHub.
  2. С помощью CapabilityClient проверьте, на каких часах пользователя установлено ваше приложение.
  3. Если приложение установлено не на всех часах пользователя, дайте ему возможность открыть Google Play на остальных устройствах Wear OS с телефона, используя метод RemoteActivityHelper.startRemoteActivity(). Используйте URI для приложения Wear OS, который может отличаться от URI приложения для телефона. Например, используйте URI магазина, такой как market://details?id=com.example.android.wearable.wear.finddevices.

Данные о местоположении для часов, подключенных к iPhone

Если часы подключены к iPhone, используйте поставщик геоданных из нескольких источников (FLP), чтобы получать данные о местоположении на часах. Подробнее о том, как определять местоположение в Wear OS…

Если телефон доступен, FLP использует его для получения данных о местоположении.

Получайте только необходимые данные

Как правило, при получении данных из интернета следует запрашивать только необходимые данные. В противном случае могут возникнуть задержки, а также увеличиться расход памяти и заряда батареи.

Когда часы подключены через Bluetooth LE, у приложения может быть доступ к пропускной способности всего 4 КБ/с в зависимости от часов. Рекомендуется выполнить следующие действия:

  • Проверьте сетевые запросы и ответы на наличие дополнительных данных, которые нужны только для приложения на телефоне.
  • Уменьшайте большие изображения перед отправкой по сети на часы.

Если вам нужна сеть с высокой пропускной способностью, ознакомьтесь с разделом Доступ к сети с высокой пропускной способностью.

Дополнительные примеры кода

Примеры использования API, описанных на этой странице, можно найти в примере вспомогательных функций уровня данных.