Merge pull request #169 from KuzminVik/university_base_android

edit university basic android

Author: RezMike

university/1-android-basics/android-intro.md

@@ -17,12 +17,14 @@ sidebar_position: 0
     - `ContentProvider`
 - Верстка UI используя Compose
 - Библиотеки AndroidX и Jetpack от Google
-- Kotlin flows, `StateFlow`, `SharedFlow`
+- Kotlin flows, `StateFlow`, `SharedFlow`, Kotlin Coroutines
+- kotlinx.serialization
 - `ViewModel`
 - Жизненный цикл `Application`, `Activity`, `ViewModel`
 - Библиотека Android Navigation Component от Google
-- Библиотека Retrofit от Square
+- Библиотека Ktor Client
 - Библиотека Koin
+- База данных SQLDelight
 
 :::info
 Для тех кому всё перечисленное уже знакомо, использовано на практике и есть уверенное понимание о чем речь - можно пропустить ознакомление с теоретическим блоком и сразу перейти к [практической задаче](practice).

university/1-android-basics/app-logic.md

@@ -26,11 +26,12 @@ sidebar_position: 5
 - [StateFlow and SharedFlow](https://developer.android.com/kotlin/flow/stateflow-and-sharedflow)
 - [Android Basics Compose: 5. ViewModel and State in Compose](https://developer.android.com/codelabs/basic-android-kotlin-compose-viewmodel-and-state) - для закрепления связей жизненного цикла android компонентов и ViewModel, StateFlow. Не пропуская Conclusion и ссылки в нем
 
-## Retrofit
+## Network client
 
-Практически все приложения выполняют работу с сетью. Основной способ выполнения сетевых запросов в Android это библиотека [Retrofit](https://square.github.io/retrofit/).
+Практически все приложения выполняют работу с сетью. Классический способ выполнения сетевых запросов в Android это библиотека [Retrofit](https://square.github.io/retrofit/).
+Альтернативный современный клиент - [Ktor](https://ktor.io/docs/client-create-new-application.html)
 
-CodeLab [Get data from the internet](https://developer.android.com/codelabs/basic-android-kotlin-training-getting-data-internet) даст более детальное представление о библиотеке и как её использовать.
+CodeLab [Get data from the internet](https://developer.android.com/codelabs/basic-android-kotlin-training-getting-data-internet) даст более детальное представление о библиотеке Retrofit и как её использовать.
 
 ## Coroutines
 

university/1-android-basics/getting-started.md

@@ -4,21 +4,20 @@ sidebar_position: 1
 
 # Первые шаги
 
-## Build your first app
+## Your first Android app
 
-Первые шаги в разработке Android приложений рекомендуем начать с выполнения инструкций на [developer.android.com](https://developer.android.com) в блоке [Build your first app](https://developer.android.com/training/basics/firstapp).
+Первые шаги в разработке Android приложений рекомендуем начать с выполнения инструкций на [developer.android.com](https://developer.android.com) в блоке [Your first Android app](https://developer.android.com/courses/android-basics-compose/unit-1).
 
 Блок "Создание вашего первого приложения" научит:
 - Как развернуть среду разработки Android приложений `Android Studio`
 - Как создать простейший проект
 - Как собрать Android приложение и запустить на эмуляторе/устройстве
-- Как построить UI используя `ConstraintLayout`
-- Как использовать строки локализации из ресурсов
-- Как делать переходы между `Activity`
+- Как построить простой UI используя `Jetpack Compose`
+- Как менять цвет фона и отступы у UI элементов
 
 ## App fundamentals
 
-После первого созданного приложения (молодец!) нужно глубже погрузиться в теорию об устройстве Android приложений. В этом нам поможет все та же официальная документация [developer.android.com](https://developer.android.com) - идем читать [App fundamentals](https://developer.android.com/guide/components/fundamentals).
+После первого созданного приложения (молодец!) нужно глубже погрузиться в теорию об устройстве Android приложений. В этом нам поможет все та же официальная документация [developer.android.com](https://developer.android.com) - идем читать [App fundamentals](https://developer.android.com/guide/components/fundamentals?hl=ru).
 
 Документация расскажет:
 - Что является компонентами Android приложения
@@ -29,7 +28,10 @@ sidebar_position: 1
 - Чем полезен `ContentProvider`
 - Как запустить каждый из компонентов Android приложения
 - Для чего нужен `ContentResolver`
-- Состав и предназначение `AndroidManifest.xml` 
+- Состав и предназначение `AndroidManifest.xml`
+- О жизненном цикле компонентов
+- Как Android управляет процессами и потоками
+- О разрешениях (permissions) и безопасности приложения
 - Как управлять требованиями приложения к версии Android
 - Что такое ресурсы Android приложения
 

university/1-android-basics/gradle.md

@@ -45,4 +45,4 @@ sidebar_position: 3
 - Официальная документация Gradle - [docs.gradle.org](https://docs.gradle.org/current/userguide/userguide.html)
 - Текущие версии Gradle - [gradle.org](https://gradle.org/releases/)
 - Текущие версии Android Gradle Plugin - [developer.android.com](https://developer.android.com/reference/tools/gradle-api)
-- Официальная документация Android Gradle Plugin - [developer.android.com](https://developer.android.com/studio/build)
+- Официальная документация Android Gradle Plugin - [developer.android.com](https://developer.android.com/build)

university/1-android-basics/kotlin.md

@@ -6,7 +6,7 @@ sidebar_position: 2
 
 ## Examples
 
-Для знакомства с языком разработки Kotlin воспользуемся разделом [Examples](https://play.kotlinlang.org/byExample) на официальном сайте (группу Kotlin/JS смотреть не нужно).
+Для знакомства с языком разработки Kotlin воспользуемся разделом [kotlin-tour](https://kotlinlang.org/docs/kotlin-tour-welcome.html) на официальном сайте.
 Данный раздел показывает наглядно, на интерактивных примерах, весь синтаксис языка и наиболее популярные возможности стандартной библиотеки Kotlin.
 
 ## Koans
@@ -16,7 +16,7 @@ sidebar_position: 2
 
 ## Документация
 
-Официальная документация Kotlin расположена по адресу [kotlinlang.org/docs](https://kotlinlang.org/docs/). К ней стоит обращаться во всех случаях, когда что-то не понятно про язык разработки и его инструментарий.
+Официальная документация Kotlin расположена по адресу [kotlinlang.org/docs](https://kotlinlang.org/docs/home.html). К ней стоит обращаться во всех случаях, когда что-то не понятно про язык разработки и его инструментарий.
 
 Сразу знакомиться со всей документацией не стоит (все равно забудется без практики), но нужно прочитать несколько базовых разделов:
 - [Basic Syntax](https://kotlinlang.org/docs/basic-syntax.html)
@@ -29,5 +29,5 @@ sidebar_position: 2
 
 ## Вспомнить главное
 
-- Официальная документация Kotlin - [kotlinlang.org/docs](https://kotlinlang.org/docs)
+- Официальная документация Kotlin - [kotlinlang.org/docs](https://kotlinlang.org/docs/home.html)
 - Песочница для выполнения Kotlin кода - [play.kotlinlang.org](http://play.kotlinlang.org/)

university/1-android-basics/practice.md

@@ -25,50 +25,50 @@ sidebar_position: 6
 ## Технические требования
 
 1. Реализация на Kotlin
-1. Использовать XML Layouts для UI
+1. Использовать Jetpack Compose для UI
 1. Использовать Kotlin Gradle DSL
-1. Использовать Retrofit для работы с REST API
-1. Использовать RecyclerView для отображения списка
-1. Использовать ConstraintLayout для экрана детальной информации
-1. Использовать Android Navigation Component для переходов между экранами
-1. Использовать View Binding для связывания верстки с кодом
-1. Экраны делать с помощью Fragment (подход Single Activity)
+1. Использовать Ktor Client для работы с REST API
+1. Использовать LazyColumn для отображения списка
+1. Использовать Jetpack Navigation для переходов между экранами
 1. Использовать Coroutines для асинхронности и многопоточности
 1. Использовать [Kotlinx.Serialization](https://github.com/Kotlin/kotlinx.serialization) для парсинга json
 1. Использовать ViewModel для реализации логики экранов
-1. Использовать LiveData / StateFlow для обновления данных на UI
-1. Использовать Dagger Hilt для внедрения зависимостей
+1. Использовать StateFlow для обновления данных на UI
+1. Использовать Koin для внедрения зависимостей
 1. Сохранять токен авторизации в хранилище устройства - SharedPreferences
 1. Корректно обрабатывать ситуации "загрузка данных", "ошибка загрузки", "пустой список"
 1. Корректно обрабатывать смену конфигурации
 1. При перезапуске приложения авторизация должна сохраняться
 1. Использовать локализацию для всех строк, показываемых пользователю
 1. Использовать векторную графику везде, где это возможно
-1. Обеспечить поддержку Android API 21
+1. Обеспечить поддержку Android API 26
 
-## Классы Android-приложения
+## Файлы Android-приложения
 
 ```kotlin
 
     class MainActivity: AppCompatActivity {
         // TODO:
     }
 
-    class AuthFragment: Fragment {
+    @Composable
+    fun AuthScreen() {
         // TODO:
     }
 
-    class RepositoriesListFragment: Fragment {
+    @Composable
+    fun RepositoriesListScreen() {
        // TODO:
     }
 
-    class DetailInfoFragment: Fragment {
+    @Composable
+    fun DetailInfoScreen() {
        // TODO:
     }
 
    class AuthViewModel {
-      val token: MutableLiveData<String>
-      val state: LiveData<State>
+      val token: MutableStateFlow<String>
+      val state: StateFlow<State>
       val actions: Flow<Action>
 
       fun onSignButtonPressed() {
@@ -90,7 +90,7 @@ sidebar_position: 6
    }
 
    class RepositoryInfoViewModel {
-      val state: LiveData<State>
+      val state: StateFlow<State>
 
       sealed interface State {
          object Loading : State
@@ -113,7 +113,7 @@ sidebar_position: 6
    }
 
    class RepositoriesListViewModel {
-      val state: LiveData<State>
+      val state: StateFlow<State>
 
       sealed interface State {
          object Loading : State
@@ -158,9 +158,9 @@ sidebar_position: 6
    classDiagram
 
    class MainActivity:::android
-   class AuthFragment:::android
-   class RepositoriesListFragment:::android
-   class DetailInfoFragment:::android
+   fun AuthScreen:::android
+   fun RepositoriesListScreen:::android
+   fun DetailInfoScreen:::android
    
    class AuthViewModel:::android
    
@@ -171,13 +171,13 @@ sidebar_position: 6
    class AppRepository:::android
    class KeyValueStorage:::android
    
-   MainActivity --> AuthFragment
-   MainActivity --> RepositoriesListFragment
-   MainActivity --> DetailInfoFragment
+   MainActivity --> AuthScreen
+   MainActivity --> RepositoriesListScreen
+   MainActivity --> DetailInfoScreen
    
-   AuthFragment --> AuthViewModel
-   RepositoriesListFragment --> RepositoriesListViewModel
-   DetailInfoFragment --> RepositoryInfoViewModel
+   AuthScreen --> AuthViewModel
+   RepositoriesListScreen --> RepositoriesListViewModel
+   DetailInfoScreen --> RepositoryInfoViewModel
    
    RepositoryInfoViewModel --> AppRepository
    AuthViewModel --> AppRepository
@@ -192,5 +192,5 @@ sidebar_position: 6
 1. [GitHub Basic Authorization](https://docs.github.com/en/rest/overview/other-authentication-methods#basic-authentication)
 1. [GitHub user repositories](https://docs.github.com/en/rest/reference/repos#list-repositories-for-a-user)
 1. [Kotlinx.Serialization guide](https://github.com/Kotlin/kotlinx.serialization/blob/master/docs/basic-serialization.md#json-decoding)
-1. [Интеграция Kotlinx.Serialization и Retrofit](https://github.com/JakeWharton/retrofit2-kotlinx-serialization-converter)
+1. [Интеграция Kotlinx.Serialization и Ktor](https://ktor.io/docs/client-serialization.html)
 1. [Дизайн](https://www.figma.com/file/Mh3ga5XAzyJNCY87NBp01G)