Merge pull request #170 from KuzminVik/knowledge_android

Knowledge android

Author: RezMike

learning/android/layout.md

@@ -1,10 +1,29 @@
 # Верстка
 
-## Android View
+## Jetpack Compose
 
-Для верстки Android приложения в наших проектах мы используем стандартный Android View с версткой из
-xml, поэтому для наших проектов полностью
-актуальна [документация android developer](https://developer.android.com/guide/topics/ui).
+Для верстки Android приложений мы используем [Jetpack Compose](https://developer.android.com/compose) — декларативный UI toolkit от Google. Compose позволяет описывать UI на Kotlin без XML.
 
-Для привязки данных к view мы
-используем [ViewBinding](https://developer.android.com/topic/libraries/view-binding).
+### Layouts
+
+- [Компоненты Material 3](https://developer.android.com/develop/ui/compose/components) — готовые компоненты (Buttons, Cards, Dialogs, etc.)
+- [Основы layout'ов](https://developer.android.com/develop/ui/compose/layouts/basics) — `Column`, `Row`, `Box`
+- [Модификаторы](https://developer.android.com/develop/ui/compose/modifiers) — порядок модификаторов имеет значение
+- [Scaffold](https://developer.android.com/develop/ui/compose/layouts/material/scaffold) — базовый каркас экрана с top bar, bottom bar, FAB, snackbar
+- [ConstraintLayout](https://developer.android.com/develop/ui/compose/layouts/constraintlayout) — для сложных layout'ов с зависимостями между элементами
+- [Custom layouts](https://developer.android.com/develop/ui/compose/layouts/custom) — создание собственных layout'ов через `Layout` composable
+
+### Списки и ленивая загрузка
+
+- [Lazy lists](https://developer.android.com/develop/ui/compose/lists) — `LazyColumn`, `LazyRow`, `LazyVerticalGrid` с эффективной прокруткой и переиспользованием элементов
+- Ключи для элементов: всегда указывайте `key { }` для стабильной идентификации элементов списка
+
+### Предпросмотр
+
+- [`@Preview`](https://developer.android.com/develop/ui/compose/previews) — предпросмотр composables прямо в Android Studio без запуска приложения
+- [Preview parameters](https://developer.android.com/develop/ui/compose/previews/preview-parameters) — передача тестовых данных в превью через `PreviewParameterProvider`
+
+### Взаимодействие с View
+
+- [Interop: Compose в View](https://developer.android.com/develop/ui/compose/migrate/interoperability-views/compose-in-views) — `ComposeView` для встраивания Compose в существующий View-based экран
+- [Interop: View в Compose](https://developer.android.com/develop/ui/compose/migrate/interoperability-views/views-in-compose) — `AndroidView` для встраивания View-компонентов в Compose

learning/android/media/split_mode.png

@@ -1,49 +1,221 @@
 # Сервисы
 
-## Android Service Component (in progress)
+## Android Service Component
+[Services overview](https://developer.android.com/guide/components/services)
 
-[Services overview](https://developer.android.com/guide/components/services).
+### Что такое Service
+Сервис — один из компонентов Android для выполнения длительных операций без UI.
 
-### Виды сервисов
+❗ Важно:
+- Сервис **не создаёт отдельный поток**
+- Все lifecycle-методы вызываются на **main thread**
+- Долгую работу нужно выполнять в отдельном потоке (Coroutine, Executor и т.д.)
 
-Сервисы - один из компонентов андроида. Все сервисы деляться на два вида: [Foreground](https://developer.android.com/guide/components/foreground-services) и Background.
+Сервис является точкой входа в приложение.
 
-Foreground - сервис выполняет функционал заметный для пользователя, и может продолжать работу даже если пользователь свернул приложение. Например проигрывать музыку, или отображать плавающее окошко с видео. Сервис обязан показать плашку уведомления о том, что он работает, это уведомление нельзя убрать пока сервис запущен.
-Для использования Foreground сервиса требуется специальный пермишен
+При нехватке памяти система в первую очередь избавляется от процессов с более низким приоритетом. Подробнее про приоритеты процессов:  
+[Who lives and who dies — process priorities on Android](https://medium.com/androiddevelopers/who-lives-and-who-dies-process-priorities-on-android-cb151f39044f)
+
+## Виды сервисов
+
+Сервисы делятся на два основных типа:
+
+### Foreground Service
+[Foreground services](https://developer.android.com/guide/components/foreground-services)
+
+Foreground — сервис выполняет функционал, заметный пользователю, и может продолжать работу, даже если приложение свернуто.
+
+Примеры:
+- проигрывание музыки
+- навигация
+- трекинг геолокации
+- VoIP-звонки
+- запись аудио/видео
+- плавающее окно с видео
+
+Обязательные требования:
+
+- Сервис обязан показать уведомление
+- Уведомление нельзя убрать, пока сервис работает
+- Необходимо разрешение:
 
 ```xml
 <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
 ```
 
-И foreground и Background сервисы запускаются на main потоке
+Начиная с Android 10+ необходимо указывать тип сервиса:
+
+```xml
+<service
+    android:name=".LocationService"
+    android:foregroundServiceType="location"
+    android:exported="false" />
+```
+
+В Android 14+ для некоторых типов требуется отдельное разрешение, например:
+
+```xml
+<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION"/>
+```
+
+Примеры типов:
+- location
+- mediaPlayback
+- camera
+- microphone
+- dataSync
+- connectedDevice
+- phoneCall
+
+Начиная с Android 12 действуют ограничения на запуск Foreground Service из background — система может запретить запуск.
+
+### Background Service
+
+Background — сервис выполняет функционал, скрытый от пользователя.
+
+⚠ Начиная с API 26 (Android 8.0) действуют ограничения:
+- Приложение не может свободно запускать background service, если находится в background
+- Возможен `IllegalStateException`
+
+В большинстве случаев вместо background service рекомендуется использовать:
+- ✅ [WorkManager](https://developer.android.com/topic/libraries/architecture/workmanager)
+- ✅ JobScheduler
+- ✅ AlarmManager (ограниченно)
+
+Background Service в современных приложениях используется редко.
+
+## Потоки
+
+И Foreground, и Background сервисы запускаются на main потоке.
+
+❗ Если выполнять долгую операцию внутри `onStartCommand()`, можно получить ANR.
+
+Правильный подход:
+- Coroutine + Dispatchers.IO
+- Thread / Executor
+- WorkManager
+
+## IntentService и JobIntentService
+
+[IntentService](https://developer.android.com/reference/android/app/IntentService.html) — **deprecated**  
+[JobIntentService](https://developer.android.com/reference/androidx/core/app/JobIntentService.html) — **deprecated**
+
+Ранее они автоматически выполняли работу в отдельном потоке.  
+Сейчас рекомендуется использовать:
+- WorkManager
+- Foreground Service + coroutine
+
+## Объявление в манифесте
+
+Независимо от типа сервис должен быть объявлен в манифесте:
+
+```xml
+<service
+    android:name=".MyService"
+    android:exported="false"/>
+```
+
+Начиная с Android 12 (targetSdk 31+) необходимо явно указывать `android:exported`, если есть `intent-filter`.
+
+- exported="true" — сервис доступен другим приложениям
+- exported="false" — только внутри приложения
+
+## Запуск сервиса
+
+Сервис можно запустить двумя способами:
+
+### startService()
+
+```kotlin
+startService(intent)
+```
+
+Если приложение в background (API 26+), необходимо использовать:
+
+```kotlin
+ContextCompat.startForegroundService(...)
+```
+
+После этого нужно вызвать `startForeground()` в течение ~5 секунд.
+
+Жизненный цикл started service:
+
+- onCreate()
+- onStartCommand()
+- onDestroy()
+
+Возвращаемое значение `onStartCommand()` влияет на перезапуск сервиса:
+- START_NOT_STICKY
+- START_STICKY
+- START_REDELIVER_INTENT
+
+Сервис будет жить, пока не вызван:
+- stopSelf()
+- stopService()
+
+### bindService()
+
+```kotlin
+bindService(...)
+```
+
+При запуске через bindService() сервис будет жить, пока у него есть хотя бы один клиент.  
+Когда все клиенты отпишутся — сервис будет уничтожен.
+
+Жизненный цикл у bound service:
+
+- onCreate()
+- onBind()
+- onUnbind()
+- onRebind()
+- onDestroy()
+
+Если сервис был запущен через startService(), на него всё равно можно подписаться:  
+[Bound services](https://developer.android.com/guide/components/bound-services)
+
+Сервис может быть одновременно started и bound.  
+Он уничтожится, только когда:
+- вызван stopSelf()
+- и нет активных bind-подключений
 
-Background - сервис выполняет функционал скрытый от пользователя. Начиная с API-26 фоновые сервисы имеют некоторые ограничения при свернутом приложении, например они не могут получить геолокацию
+Жизненный цикл сервиса не зависит от жизненного цикла компонента, который его запустил.
 
-Хотя [IntentService](https://developer.android.com/reference/android/app/IntentService.html) и запускается на главном потоке, но для обработки onHandleIntent он запускает отдельный поток. Аналогично [JobIntentService](https://developer.android.com/reference/androidx/core/app/JobIntentService.html) обрабатывает enqueueWork на отдельном потоке
+## Обращение к сервису из другого процесса
 
-Не зависимо от вида сервиса он должен быть объявлен в манифесте приложения
+Для взаимодействия с сервисом из другого процесса используется:
+- [AIDL](https://developer.android.com/guide/components/aidl)
+- Messenger
+- Binder
 
-Как и любой андроид компонент сервис является точкой входа в приложение, помимо этого при нехватке памяти в первую очередь система избавится от приложений [не имеющих сервисы](https://medium.com/androiddevelopers/who-lives-and-who-dies-process-priorities-on-android-cb151f39044f)
+## Когда стоит использовать Service
 
-### Запуск сервиса
+✅ Foreground Service — если:
+- работа длительная
+- пользователь понимает, что она выполняется
+- требуется повышенный приоритет процесса
 
-Сервис можно запустить двумя способами: через startService() или через bindService()
+✅ WorkManager — если:
+- задача должна гарантированно выполниться
+- задача может быть отложенной
+- нужна работа после перезапуска устройства
 
-Разница состоит в том, что при запуске через bindService() сервис будет жить до тех пор пока у него есть хотя бы один подписчик, после того как от сервиса отпишутся все подписчики он будет уничтожен. При запуске через startService() сервис будет жить не зависимо от количества подписчиков, пока не будет вызвана команда для его остановки.
-Жизненный цикл сервиса не зависит от жизненного цикла компонента который его запустил.
-Если сервис был запущен через startService(), на него все равно можно [подписаться](https://developer.android.com/guide/components/bound-services)
+В большинстве фоновых задач предпочтительнее WorkManager.
 
-### Обращение к сервису из другого процесса
+## Главное помнить
 
-Обращение к сервису из другого процесса возможно, для этого следует использовать [Android Interface Definition Language ](https://developer.android.com/guide/components/aidl)
+- Service не создаёт поток
+- IntentService устарел
+- Background Service сильно ограничены с Android 8+
+- Foreground Service строго регулируется на Android 12+
+- В большинстве случаев для фоновой работы лучше использовать WorkManager
 
 ### Примеры использования сервисов
 
 [Сервис для скачивания файлов](https://gitlab.icerockdev.com/marmalato/marmalato-android/-/blob/develop/app/src/main/java/com/icerockdev/marmalato/feature/loader/LoaderService.kt)
 Сервис в своем потоке скачивает файлы, может сообщать процент скачивания для отображения прогресса в активити
 
 [Стартовый сервис helga](https://gitlab.icerockdev.com/helga/helga-client/-/blob/dev/client-service/src/main/java/com/icerockdev/helga/client/service/HelgaService.kt)
-Сервис проверяет авторизацию пользователя, запускает остальные сервисы приложения(ожидание звонков, сервис для нотификаций календаря и др.)
+Сервис проверяет авторизацию пользователя, запускает остальные сервисы приложения (ожидание звонков, сервис для нотификаций календаря и др.)
 
 [Сервис для приема входящих звонков](https://gitlab.icerockdev.com/helga/helga-client/-/blob/dev/client-contacts/src/main/java/com/icerockdev/helga/client/contacts/feature/invitation/CallInvitationService.kt)
 При входящем звонке показывает плавающее окно-уведомление

learning/android/sdk-migrations.md

@@ -4,6 +4,6 @@ sidebar_position: 1
 
 # Материалы для обучения
 
-- [Android Basics in Kotlin](https://developer.android.com/courses/android-basics-kotlin/course) - база разработки под Android на Kotlin
-- [Developing Android Apps with Kotlin](https://www.udacity.com/course/developing-android-apps-with-kotlin--ud9012) - разработка приложения под Android на Kotlin, средний уровень
-- [Advanced Android with Kotlin](https://www.udacity.com/course/advanced-android-with-kotlin--ud940) - продвинутая разработка под Android на Kotlin
+- [Android Basics with Compose](https://developer.android.com/courses/android-basics-compose/course) - база разработки под Android на Compose
+- [Jetpack Compose for Android Developers](https://developer.android.com/courses/jetpack-compose/course) - разработка приложения под Android на Compose, средний уровень
+- [Advanced Android with Kotlin](https://www.udacity.com/course/advanced-android-with-kotlin--ud940) - передовые методы и рекомендуемая архитектура для создания Android приложений

learning/android/service.md

@@ -2,6 +2,7 @@
 
 ## Режим редактора по умолчанию
 
-[Source](https://twitter.com/theapache64/status/1463880529594314758?s=12)
+Если вас раздражает стандартный режим редактирования "Split" для Compose c Preview, вы можете изменить его поведение.
+Перейдите Settings → Editor → UI Tools и снимите галочку в пункте "Show split mode if file contains preview annotation"
 
-![image](https://pbs.twimg.com/media/FFC-iqZUcA8hgn-?format=jpg)
+![image](media/split_mode.png)

learning/android/study-materials.md

@@ -0,0 +1,4 @@
+{
+  "label": "Legacy IceRock",
+  "position": 25
+}