Merge pull request #160 from maiow/docusaurus

Update onboarding, university

Author: ExNDY

learning/android/media/screens_structure.png

@@ -20,10 +20,6 @@ sidebar_position: 2
 4.  Разница extensions - [раз](../kotlin-native/swift-extensions), [два](https://medium.com/mobile-app-development-publication/kotlin-vs-swift-the-extension-5462b531260b);
 5.  [Абстрактные классы](https://medium.com/mobile-app-development-publication/kotlin-vs-swift-the-abstract-class-f8817e5e54f).
 
-## Kotlin + Swift IDE
-
-AppCode позволяет разрабатывать и Kotlin и Swift код одновременно. [Видео с демонстрацией](https://www.youtube.com/watch?v=ELfcPdWP_CY)
-
 ## Конфликты имен на iOS
 
 - В iOS у всех объектов есть поле `description` (работает также как Kotlin `toString`) и поэтому при использовании в Kotlin свойств с таким названием будет появляться в iOS дополнительное поле `_description` - которое и будет свойством от Kotlin

learning/android/navigation.md

@@ -361,4 +361,85 @@ _actions.trySend(State.Empty)
 - `trySend` же возвращает `Boolean`: `true` - если добавить новое значение удалось, `false` - если не удается добавить из-за превышения объема буфера значений. Это значит что если в очереди уже есть какие-то события, которые не успел получить UI, то новое просто будет утерено. Поэтому всегда следует использовать `send`.
 
 ## Дополнительно
-Для работы с событиями и состояниями у нас в компании используются возможности библиотеки [moko-mvvm](https://github.com/icerockdev/moko-mvvm). С ее помощью происходят привязки, как односторонняя, так и двусторонняя. Событиями занимается класс EventsDispatcher.
+Для работы с событиями и состояниями у нас в компании используются возможности библиотеки [moko-mvvm](https://github.com/icerockdev/moko-mvvm). С ее помощью происходят привязки, как односторонняя, так и двусторонняя.
+
+Ранее событиями занимался класс EventsDispatcher. Подход с использованием EventsDispatcher считается устаревшим и в новых проектах мы его не используем. Ниже справочная информация на случай, если встретитесь с ним.
+
+`EventDispatcher` - это класс с одной единственной задачей - гарантировать доставку события и вызов его обработчика на UI, после сигнала от `ViewModel`.
+
+Во `ViewModel` объявляется интерфейс с методами, реализация которых ей нужна на платформе, например, метод для перехода на какой-нибудь экран:
+
+```kotlin 
+interface EventsListener {
+    fun routeToMainPage()
+}
+```
+
+Далее, все что остается сделать, чтобы вызвать событие на `UI` - это получить во `ViewModel` объект `eventsDispatcher` и, когда пора переходить на главный экран, послать платформе это событие простым вызовом метода:
+```kotlin
+class EventsViewModel(
+    val eventsDispatcher: EventsDispatcher<EventsListener>
+) : ViewModel() {
+
+    fun onButtonPressed() {
+        eventsDispatcher.dispatchEvent { routeToMainPage() }
+    }
+
+    interface EventsListener {
+        fun routeToMainPage()
+    }
+}
+```
+
+На платформах `Fragment` и `UIViewController` реализуют этот интерфейс.
+Пример реализации на Android:
+
+```kotlin
+class EventsFragment: Fragment(R.layout.fragment_simple), EventsViewModel.EventsListener {
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        super.onViewCreated(view, savedInstanceState)
+
+        val viewModel: EventsViewModel = getViewModel { 
+            EventsViewModel(eventsDispatcherOnMain()) 
+        }
+
+        viewModel.eventsDispatcher.bind(lifecycleOwner = this, listener = this)
+    }
+
+    override fun routeToMainPage() {
+        TODO("some routing")
+    }
+}
+```
+
+Пример на iOS:
+
+```swift
+class EventsViewController: UIViewController {
+    private var viewModel: EventsViewModel!
+    
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        
+        viewModel = EventsViewModel(
+            eventsDispatcher: EventsDispatcher(listener: self)
+        )
+    }
+}
+
+extension EventsViewController: EventsViewModelEventsListener {
+    func routeToMainPage() {
+        fatalError("some routing")
+    }
+}
+```
+
+За счет интерфейса обе платформы знают, какой набор действий должны поддерживать.  
+Если во `ViewModel` нужно будет добавить еще одно событие, и мы забудем реализовать его на какой-нибудь из платформ, компилятор выделит, что отсутствует реализация метода интерфейса.
+
+:::warning
+
+В `dispatchEvent` нельзя передавать лямбду из общего кода, например, для установки действия по кнопке в [AlertDialog](https://developer.android.com/reference/android/app/AlertDialog). Нельзя этого делать потому, что на Android мы не сможем ее никуда сохранить, поэтому при пересоздании экрана она пропадет.  
+Если вам нужно установить чему-либо на платформе действие - делайте соответствующий метод во `ViewModel`.
+
+:::

learning/kotlin-multiplatform/mobile-highlights.md

@@ -4,10 +4,19 @@ sidebar_position: 5
 
 # MOKO библиотеки
 
+MOKO - это разработанные в компании мультиплатформенные open-source библиотеки, которые позволяют нам решать типовые задачи проще и быстрее.
 Все наши проекты строятся с использованием библиотек MOKO, поэтому нужно поближе познакомиться с MOKO библиотеками.
 
-- Материалы [о MOKO в целом](../learning/libraries/moko)
-- Материалы [о MOKO resources](../learning/libraries/moko/moko-resources)
-- Материалы [о MOKO MVVM](../learning/libraries/moko/moko-mvvm)
-- Материалы [о MOKO units](../learning/libraries/moko/moko-units)
-- Материалы [о MOKO paging](../learning/libraries/moko/moko-paging)
+В каждом репозитории MOKO-библиотеки находятся:
+- `README` с инструкцией по подключению и описанием использования библиотеки
+- `sample-проект` с практическим применением библиотеки. Вы можете склонировать себе репозиторий библиотеки и запустить `sample-app`
+- `Issues` - список обнаруженных ошибок в работе библиотеки, а также предложения по обновлению библиотеки. Если вы заметите ошибку в работе какой-либо MOKO-библиотеки или у вас есть предложение по изменению существующей - зафиксируйте свои мысли в `issue`
+
+Посмотрите обзорную презентацию из материалов [о MOKO в целом](../learning/libraries/moko).
+Изучите библиотеку [MOKO resources](https://kmm.icerock.dev/university/icerock-basics/resources-in-common#библиотека-moko-resources), [дополнение](../learning/libraries/moko/moko-resources).
+
+Также ознакомьтесь с:
+- использованием классов-оберток [CFlow и CStateFlow](https://kmm.icerock.dev/university/icerock-basics/mvvm#flow-c-moko-kswift) из [MOKO MVVM](../learning/libraries/moko/moko-mvvm)
+- использованием [mvvm-state](https://kmm.icerock.dev/university/lists/moko-paging#moko-mvvm-state) из MOKO MVVM
+- зачем нужна библиотека [МОКО Network](https://kmm.icerock.dev/learning/libraries/moko/moko-network)
+- видео [о MOKO paging](https://kmm.icerock.dev/learning/libraries/moko/moko-paging), конкретные примеры текущего применения стоит смотреть в текущих проектах.

learning/state.md

@@ -571,7 +571,7 @@ mokoNetwork {
 
 ![mpp-library-](project-inside/project-inside-mpp-lib-src.png)
 
- - `androidMain` - директория, содержащая файл `AndroidManifest.xml`, в котором объявляется идентификатор (уникальный!) для модуля `mpp-library` для Android-приложения;
+ - `androidMain` - директория, содержащая платформенный di модуль. Ранее в проектах здесь находился файл `AndroidManifest.xml`, в котором объявлялся уникальный идентификатор для модуля `mpp-library` для Android-приложения. В новых проектах этого файла нет, т.к. id сейчас прописывается в рамках build.gradle.kts модуля;
  - `api` - директория, содержащая файл для генерации методов взаимодействия с API;
  - директория `commonMain` содержит директорию `kotlin`, в которой как раз и пишется вся бизнес-логика приложения; в директории `resources` находятся ресурсы, попавшие в проект через [moko-resources](https://github.com/icerockdev/moko-resources);
  - `commonTest` - директория, в которой находится исходный код тестов для общей библиотеки;

onboarding/moko.md

@@ -44,4 +44,4 @@ CodeLab [Get data from the internet](https://developer.android.com/codelabs/basi
 
 Разные классы приложения должны между собой связываться. Чтобы связанность классов не стала слишком жесткой, что усложнит поддержку кода, используют паттерн Dependency Injection.
 
-Подробнее позволит разобраться статья [Dependency Injection](https://developer.android.com/training/dependency-injection) и CodeLab [Using Hilt in your Android app](https://developer.android.com/codelabs/android-hilt).
+Подробнее позволит разобраться статья [Dependency Injection](https://developer.android.com/training/dependency-injection) и [Koin in Android app tutorial](https://insert-koin.io/docs/quickstart/android/).

onboarding/project-inside.md

@@ -110,6 +110,10 @@ sidebar_position: 4
 
 А также многое про удобство можно прочитать на сайте [material.io](https://material.io/design) - разделы Interaction и Communication очень детально и наглядно объясняют как можно создавать комфортное использование приложения. Многие принципы применимы не только на android, но и на любой системе с UI.
 
+## Изменения конфигурации
+
+Некоторые конфигурации мобильных устройств могут измениться во время работы приложения. Это могут быть, например, ориентация экрана при повороте устройства пользователем, увеличение пользователем размера шрифта, смена локализации, смена темного режима на светлый и наоборот. В процессе создания приложения нужно помнить о необходимости обработки изменений конфигурации. Прочитайте [документацию Google](https://developer.android.com/guide/topics/resources/runtime-changes) про обработку смены конфигурации.
+
 ## Practice time
 
 Сделать приложение по [дизайну](https://www.figma.com/file/07E2agIcfVsAZBMoq91ccL/android-ui-education).
@@ -123,3 +127,4 @@ sidebar_position: 4
 1. На фрагменте `ContactsFragment` расположить `RecyclerView` отрисовывающий множество элементов - разные контакты
 1. На фрагменте `ContactFragment` с помощью `ConstraintLayout` сверстать UI экрана просмотра контакта
 1. С помощью Android Navigation Component сделать переходы между списком и просмотром контакта
+1. Удостовериться в том, что приложение корректно обрабатывает смену конфигурации: локализации, темы, ориентации экрана, увеличение шрифта

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

@@ -2,20 +2,21 @@
 sidebar_position: 0
 ---
 
-# Введение в KMM
+# Введение в KMP
 
-Kotlin Multiplatform Mobile - это технология, позволяющая использовать единую базу кода для бизнес-логики приложений. Для каждой платформы код нужно писать только там, где это необходимо, например, для реализации пользовательского интерфейса или при работе с API конкретной платформы.
+Kotlin Multiplatform - это технология, позволяющая использовать единую базу кода для бизнес-логики приложений. Для каждой платформы код нужно писать только там, где это необходимо, например, для реализации пользовательского интерфейса или при работе с API конкретной платформы.
 
 После прохождения этого раздела вы узнаете следующее
-- Для чего нужен Kotlin Multiplatform Mobile
+- Для чего нужен Kotlin Multiplatform
 - Что такое `expect/actual`
 - Работа с сетью используя Ktor
 - Сериализация данных при помощи Kotlin Serialization
-- Как настроить gradle для работы с KMM
+- Как настроить gradle для работы с KMP
 - Что такое multiplatform-settings и как их использовать
+- Как использовать библиотеку Koin для внедрения зависимостей в KMP
 - Что такое multiplatform библиотеки и их отличия от других библиотек
-- Где искать и как выбирать kmm библиотеки
+- Где искать и как выбирать KMP библиотеки
 
 :::info
 Если вы уже знакомы со всем этим, можете переходить к [практическому заданию](practice)
-:::
+:::

university/1-android-basics/user-interface.md

@@ -0,0 +1,18 @@
+---
+sidebar_position: 6
+---
+
+# Koin
+
+[Koin](https://github.com/InsertKoinIO/koin)  - это мультиплатформенная библиотека для внедрения зависимостей.<br/>Ранее в разделе Основы разработки Android приложений в Логике приложений/Dependency Injection вы уже проходили тьюториал по подключению Koin в Android.
+
+[Официальная документация Koin](https://insert-koin.io), к ней следует обращаться за поиском информации по конкретному вопросу.
+
+Рекомендуем ознакомиться со следующими разделами:
+1. Раздел Setup
+1. Раздел Core&Tests
+1. Раздел Android
+1. [Раздел Dependency Injection in Ktor](https://insert-koin.io/docs/reference/koin-ktor/ktor)
+
+## Практическое задание
+Выполните действия по тьюториалу [Koin для KMP Dependency Injection](https://insert-koin.io/docs/reference/koin-mp/kmp).