Что такое greylisted API?

Что такое Greylisted API?

Greylisted API (или "серый список API") — это термин, специфичный для экосистемы Android, который обозначает API-интерфейсы, доступные для использования в приложениях, но имеющие ограничения на их прямое обращение через Java/Kotlin-код в новых версиях Android. Вместо этого разработчикам рекомендуется использовать альтернативные, более современные и безопасные методы, предоставляемые платформой.

Контекст появления greylisted API

Эти API появились как часть стратегии Google по ужесточению политик совместимости (Compatibility) и безопасности. Начиная с Android 9 (API 28) и особенно в Android 10 (API 29), Google ввел разделение API на несколько категорий:

1. Public API (публичные) — стабильные, поддерживаемые, рекомендованные к использованию.
2. Unlisted API (скрытые) — внутренние API платформы, недоступные для общего использования.
3. Greylisted API (серый список) — занимают промежуточное положение.

Ключевые характеристики greylisted API

• Доступны через reflection или JNI, но их прямое использование в коде может вызывать предупреждения или ошибки при таргетинге на новые версии Android.
• Не являются частью публичного контракта SDK, то есть Google может изменить или удалить их в будущих версиях без предупреждения.
• Часто представляют собой устаревшие (deprecated) методы или низкоуровневые системные функции, которые заменяются более безопасными альтернативами.
• Их использование может привести к проблемам с безопасностью, стабильностью или совместимостью на различных устройствах и версиях ОС.

Пример greylisted API

Яркий пример — методы для работы с MAC-адресом устройства. В Android 10 доступ к постоянному MAC-адресу через WifiInfo.getMacAddress() был ограничен. Этот метод попал в greylist, и для получения адреса требовались дополнительные разрешения или использование альтернативных подходов.

// ПРЯМОЕ ИСПОЛЬЗОВАНИЕ GREYLISTED API (НЕ РЕКОМЕНДУЕТСЯ)
// На новых Android может не работать или требовать особых условий
val wifiManager = getSystemService(Context.WIFI_SERVICE) as WifiManager
val info: WifiInfo = wifiManager.connectionInfo
val macAddress: String? = info.macAddress // Greylisted на Android 10+

// АЛЬТЕРНАТИВНЫЙ ПОДХОД (использование публичного API)
// Например, получение IP-адреса или использование идентификаторов, рекомендованных Google
val network = wifiManager.currentNetwork
val linkProperties = connectivityManager.getLinkProperties(network)
val ipAddress = linkProperties?.linkAddresses?.firstOrNull()?.address

Почему Google вводит greylist?

1. Безопасность: Ограничение доступа к чувствительным данным (идентификаторы устройства, информация о сети) и системным функциям.
2. Конфиденциальность пользователей: Соответствие современным стандартам, таким как GDPR.
3. Стабильность экосистемы: Предотвращение зависимости приложений от внутренних, нестабильных компонентов системы, которые могут меняться.
4. Поощрение лучших практик: Стимулирование разработчиков к переходу на современные, безопасные и кросс-версионные API (например, использование Settings.Panel для настроек Wi-Fi вместо прямого управления).

Что делать разработчику?

• Избегать прямого использования greylisted API через Java/Kotlin-вызовы.
• Искать альтернативы в официальной документации Android. Часто Google предоставляет замену в виде новых классов или методов в Jetpack библиотеках (AndroidX).
• Если альтернативы нет, а функционал критичен — использовать осторожно, с учетом рисков:

    *   Проверять версию Android (`Build.VERSION.SDK_INT`).
    *   Обрабатывать исключения (`SecurityException`, `NoSuchMethodError`).
    *   Помнить, что приложение может вести себя по-разному на различных устройствах.

• Тестировать на широком спектре устройств и версий ОС.
• Мониторить обновления целевой версии Android (targetSdkVersion), так как с её повышением ранее работавшие greylisted API могут перейти в разряд запрещенных (blacklisted), что приведет к падению приложения.

Связь с политиками Google Play

С 2019 года Google Play требует, чтобы новые приложения и обновления целевали относительно свежие версии Android (targetSdkVersion). Это напрямую связано с greylist: при повышении targetSdkVersion использование многих greylisted API становится явно ограниченным, что вынуждает разработчиков переписывать соответствующие части кода.

Вывод

Greylisted API — это важный механизм контроля со стороны Google, который направлен на улучшение безопасности, конфиденциальности и стабильности платформы Android. Для разработчика работа с ними требует внимательности: необходимо постоянно следить за обновлениями документации, использовать рекомендованные альтернативы и тщательно тестировать приложение, чтобы избежать проблем на устройствах пользователей. Игнорирование этих ограничений может привести к непредсказуемому поведению приложения и его отказу в публикации на Google Play.