Что такое developer.android.com и как за 2–3 шага найти нужную документацию
Коротко: developer.android.com — официальный ресурс Google для Android‑разработчиков: API reference, гайды, примеры (Samples), codelabs и релиз‑ноты. Чтобы быстро найти нужную страницу, используйте поиск на сайте или Google с уточняющими словами, фильтруйте по API level и открывайте соответствующий Sample.
Что находится на сайте и зачем это нужно
- Документация API (Reference): подробные описания классов, методов и требований по API level.
- Guides & Training: концепты (lifecycle, permissions, background work), практические руководства и codelabs.
- Samples: готовые проекты на GitHub/встраиваемые примеры кода для быстрого старта.
- Design: Material Design гайдлайны, адаптивность и доступность.
- Distribute & Play: требования к публикации, монетизация и подготовка релизов.
- Release notes / Migration: изменения в платформах, deprecated‑альтернативы и инструкции по миграции.
Если нужно одно действие — найдите «API reference» + название класса/функции и проверьте метку API level слева от описания.
Как быстро и точно найти нужную документацию (практическая инструкция)
- Сформулируйте цель, не ключевые слова: вместо «camera» ищите «CameraX capture image sample» или «CameraX lifecycle integration».
- Используйте встроенный поиск на сайте или в Google: запрос «site:developer.android.com CameraX capture» даст релевантные страницы.
- Откройте Reference для целевого класса (например, CameraX -> CameraSelector) и прочтите пометки API level и Deprecated.
- Зайдите в раздел Samples рядом с Reference — скопируйте/запустите проект, чтобы сразу увидеть рабочий пример.
- Проверьте Release notes/Behavior changes и Migration guide, если используете новую версию SDK.
Не полагайтесь только на старые примеры: многие samples долго не обновляются. Сравнивайте дату и пометки Deprecated.
Практические примеры поисковых запросов
- Нужен жизненный цикл Activity и примеры: "Activity lifecycle guide site:developer.android.com"
- Ищете RecyclerView API: "RecyclerView adapter site:developer.android.com RecyclerView.Adapter"
- Хочется CameraX codelab: "CameraX codelab developer.android.com" или "CameraX sample site:developer.android.com"
Частые ошибки
- Ищут по общим словам (camera, view) — результат слишком широкий. Формулируйте задачу конкретнее.
- Применяют методы без проверки API level — приложение ломается на старых устройствах.
- Используют устаревшие samples без замены Deprecated API.
FAQ
- Как понять, какой API level нужен? — В Reference рядом с классом указан минимальный API level; ориентируйтесь на minSdkVersion вашего приложения.
- Где найти рабочий пример? — Откройте секцию Samples на странице API или ищите соответствующий codelab.
- Что делать, если документ устарел? — Ищите Migration guide, Release notes или альтернативные реализации в разделе Guides.
Если хотите, составлю пошаговый план поиска и подборку конкретных страниц для вашего кейса (например, CameraX, Navigation или WorkManager).