Как Google учит работать с Android API на живых примерах

13 мар 2026
1,760
549
99
3 недели

Build

Представьте ситуацию: вам нужно быстро разобраться, как в современном Android работать с камерой или запрашивать разрешения на доступ к геолокации. Вы открываете официальную документацию, читаете длинные тексты про жизненный цикл и обратную совместимость, но в голове всё равно не складывается общая картинка. Знакомо? Обычно в такие моменты хочется просто открыть Android Studio, запустить готовый код и посмотреть, как он ведет себя на реальном устройстве.

Именно для таких случаев команда Google поддерживает репозиторий android/platform-samples. Это не огромный проект с запутанной архитектурой вроде Now In Android, а набор изолированных примеров, каждый из которых бьет точно в цель.

Что внутри этого склада

Проект представляет собой коллекцию небольших модулей. Каждый из них посвящен конкретной технологии или API операционной системы. Здесь нет попыток построить «идеальное приложение» с Clean Architecture и десятком слоев абстракции. Наоборот, авторы намеренно упростили код, чтобы вы могли сфокусироваться на работе конкретного API.

На текущий момент в репозитории собраны примеры по следующим направлениям:

Реклама
  • Accessibility. Как сделать приложение удобным для людей с ограниченными возможностями.
  • Camera. Работа с фото и видео без боли.
  • Connectivity. Управление сетевыми подключениями.
  • Graphics. Нюансы отрисовки и работы с графическим подсистемами.
  • Location и Privacy. Правильный запрос координат и защита данных пользователя.
  • Storage. Как сохранять файлы так, чтобы система не ругалась на права доступа.
  • User-interface. Свежие фишки системного интерфейса.

Чем это полезно на практике

Главная ценность репозитория в том, что это «песочница». Если вы сомневаетесь, как поведет себя ActivityResultLauncher при запросе разрешений в специфических условиях, вам не нужно внедрять его в свой рабочий проект и тратить время на пересборку.

Изолированность функций

Каждый пример живет в своей папке. Если вам нужен код для работы с хранилищем (Storage), вы идете в соответствующую директорию и видите там только то, что относится к делу. Это экономит кучу времени, которое обычно уходит на вычленение нужной логики из больших open-source проектов.

Актуальность от первоисточника

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

Готовый полигон для тестов

В репозитории есть общий модуль app. Он собирает все примеры в один список. Вы клонируете проект, запускаете его и получаете на телефоне меню со всеми доступными демками. Это удобно, когда нужно показать коллегам или дизайнеру, как работает та или иная системная функция «в натуре».

Технические нюансы

Проект написан на Kotlin и использует Gradle. Архитектура здесь максимально прозрачная. Интересно, что разработчики добавили скрипт spotless для проверки стиля кода. Если решите отправить свой Pull Request, не забудьте прогнать команду:

./gradlew --init-script gradle/spotless-init.gradle.kts spotlessApply

Это гарантирует, что ваш код будет соответствовать стандартам Google.

Стоит учитывать один момент: авторы прямо говорят, что этот код не предназначен для копипаста в продакшн «как есть». В примерах могут отсутствовать сложные обработки ошибок или специфические оптимизации, которые важны для высоконагруженных приложений. Это именно учебное пособие, а не библиотека готовых решений.

Кому стоит заглянуть в репозиторий

В первую очередь проект пригодится тем, кто переходит на новые версии Android SDK и хочет быстро прощупать изменения. Также это отличная база для обучения новичков: вместо того чтобы объяснять теорию на пальцах, можно дать ссылку на конкретный пример из platform-samples.

Если вы часто сталкиваетесь с задачами по интеграции системных функций (камера, биометрия, файлы), добавьте этот репозиторий в закладки. Он избавляет от необходимости изобретать велосипед и показывает, как сами создатели Android рекомендуют использовать их API.

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

🍪 Мы используем файлы cookie и сервис аналитики Яндекс.Метрика, чтобы сайт работал лучше. Продолжая пользоваться devtrends.ru, вы соглашаетесь с обработкой данных согласно Политике конфиденциальности.