plugins {
    id 'org.jetbrains.kotlin.jvm' version "1.8.0" apply false
    id 'org.jetbrains.kotlin.multiplatform' version '1.8.0' apply false
    id 'org.jetbrains.kotlin.plugin.serialization' version '1.8.0' apply false
    id 'com.google.devtools.ksp' version '1.8.21-1.0.11' apply false
}

plugins {
    id 'kotlinx-serialization'

    id 'com.google.devtools.ksp'
}

ksp.incremental=false

buildFeatures {
    viewBinding = true
}

implementation "com.github.catchpig.kmvvm:mvvm:last_version"
ksp "com.github.catchpig.kmvvm:compiler:last_version"

implementation "com.github.catchpig.kmvvm:download:last_version"

interface IGlobalConfig {
    /**
     * Высота строки заголовка
     * @return Int
     */
    @DimenRes
    fun getTitleHeight(): Int

    /**
     * Ресурсы кнопки возврата строки заголовка
     * @return Int
     */
    @DrawableRes
    fun getTitleBackIcon(): Int

    /**
     * Цвет фона строки заголовка
     * @return Int
     */
    @ColorRes
    fun getTitleBackground(): Int

    /**
     * Цвет текста строки заголовка
     * @return Int
     */
    @ColorRes
    fun getTitleTextColor(): Int

    /**
     * Стиль шрифта строки заголовка
     * @return Int
     */
    @TextStyle
    fun getTitleTextStyle(): Int

    /**
     * Требуется ли горизонтальная линия под строкой заголовка
     * @return Boolean
     */
    fun isShowTitleLine(): Boolean

    /**
     * Цвет горизонтальной линии под строкой заголовка
     * @return Int
     */
    @ColorRes
    fun getTitleLineColor(): Int

    /**
     * Цвет индикатора загрузки
     * @return Int
     */
    @ColorRes
    fun getLoadingColor(): Int

    /**
     * Цвет фона индикатора загрузки
     * @return Int
     */
    @ColorRes
    fun getLoadingBackground(): Int

    /**
     * ViewBinding для пустой страницы RecyclerView
     * @param parent ViewGroup
     * @return ViewBinding
     */
    fun getRecyclerEmptyBanding(parent: ViewGroup): ViewBinding

    /**
     * Отображение страницы при ошибке сетевого запроса
     * @param layoutInflater LayoutInflater
     * @param any Any BaseActivity или
``` Вот перевод текста на русский язык:

**BaseFragment**
    * @return ViewBinding
    */
    fun getFailedBinding(layoutInflater: LayoutInflater, any: Any): ViewBinding?

    /**
     * Страница ошибки, требующая повторной загрузки, идентификатор события клика
     * @return Int
     */
    @IdRes
    fun onFailedReloadClickId(): Int
    
    /**
     * Размер страницы при каждой загрузке
     * @return Int
     */
    fun getPageSize(): Int

    /**
     * Индекс начальной страницы (некоторые настройки бэкенда равны 0, некоторые — 1)
     */
    fun getStartPageIndex(): Int
}

+ Реализовать интерфейс **IGlobalConfig** (./annotation/src/main/java/com/catchpig/annotation/IGlobalConfig.kt) и добавить аннотацию **GlobalConfig** к классу реализации (./annotation/src/main/java/com/catchpig/annotation/GlobalConfig.kt).

> Пример использования:

```kotlin
@GlobalConfig
class MvvmGlobalConfig : IGlobalConfig {
    override fun getTitleHeight(): Int {
        return R.dimen.title_bar_height
    }

    override fun getTitleBackIcon(): Int {
        return R.drawable.back_black
    }

    override fun getTitleBackground(): Int {
        return R.color.colorPrimary
    }

    override fun getTitleTextColor(): Int {
        return R.color.white
    }

    override fun getTitleTextStyle(): Int {
      return TextStyle.BOLD
    }

    override fun isShowTitleLine(): Boolean {
        return true
    }

    override fun getTitleLineColor(): Int {
        return R.color.color_black
    }

    override fun getLoadingColor(): Int {
        return R.color.color_black
    }

    override fun getLoadingBackground(): Int {
        return R.color.white
    }

    override fun getRecyclerEmptyBanding(parent: ViewGroup): ViewBinding {
        return LayoutEmptyBinding.inflate(LayoutInflater.from(parent.context), parent, false)
    }
    
    override fun getFailedBinding(layoutInflater: LayoutInflater, any: Any): ViewBinding? {
        return when (any) {
            is BaseActivity<*> -> {
                LayoutActivityErrorBinding.inflate(layoutInflater)
            }
            is BaseFragment<*> -> {
                LayoutFragmentErrorBinding.inflate(layoutInflater)
            }
            else -> {
                null
            }
        }
    }

    override fun onFailedReloadClickId(): Int {
        return R.id.failed_reload
    }

    override fun getPageSize(): Int {
        return 16
    }

    override fun getStartPageIndex(): Int {
        return 1
    }
}

//Установка текста заголовка
@Title(R.string.child_title)
class ChildActivity : BaseVMActivity<ActivityChildBinding, ChildViewModel>() 

class ChildActivity : BaseVMActivity<ActivityChildBinding, ChildViewModel>() {
    @OnClickFirstDrawable(R.drawable.more)
    fun clickFirstDrawable(v: View) {
        updateTitle("Изменение заголовка")
    }
}

//Отказаться от аннотации
@StatusBar(hide = true)
class FullScreenActivity : BaseActivity<ActivityFullScreenBinding>()

@Title(R.string.child_title)
class ChildActivity : BaseVMActivity<ActivityChildBinding, ChildViewModel>() {
    @OnClickFirstDrawable(R.drawable.more)
    fun clickFirstDrawable(v: View) {
        SnackbarManager.show(bodyBinding.root, "Эффект нажатия на первую кнопку с изображением")
        updateTitle("nihao")
    }

    @OnClickFirstText(R.string.more)
    fun clickFirstText() {
        SnackbarManager.show(bodyBinding.root, "Эффект нажатия на первый текстовый элемент")
        updateTitle("12354")
    }

    @OnClickSecondDrawable(R.drawable.more)
    fun clickSecondDrawable(v: View) {
        SnackbarManager.show(bodyBinding.root, "Эффект нажатия на вторую кнопку с изображением")
        updateTitle("nihao")
    }

    @OnClickSecondText(R.string.more)
    fun clickSecondText() {
        SnackbarManager.show(bodyBinding.root, "Эффект нажатия на второй текстовый элемент")
        updateTitle("12354")
    }
}

@OnClickSecondDrawable(R.drawable.more)
fun clickSecondDrawable(v: View) {
    snackBar("Эффект нажатия на вторую кнопку с изображением")
}
``` **2.5 Страница с ошибкой загрузки**

* Сетевой запрос завершается неудачно — можно отобразить страницу ошибки, а также предоставить кнопку для повторной загрузки данных.

* В расширенной функции lifecycleLoadingView класса BaseView устанавливается значение showFailedView в true, если запрос данных завершился неудачно, то будет показана страница ошибки.

* Повторно вызвать сетевой запрос интерфейса можно в замыкании onFailedReload (см. файл BaseView.kt), чтобы повторно загрузить данные.

```kotlin
/**
 * Показывает страницу с ошибкой после неудачной загрузки, пользователь может нажать на кнопку обновления на этой странице, чтобы запросить данные снова.
 * @param autoFirstLoad Boolean указывает, следует ли автоматически загружать данные при первом обращении.
 * @param block [@kotlin.ExtensionFunctionType] Function1<View, Unit>
 */
fun onFailedReload(autoFirstLoad: Boolean = true, block: View.() -> Unit){
    .....
}

override fun initFlow() {
    onFailedReload {
        loadingViewError(bodyBinding.root)
    }
}

fun loadingViewError(v: View) {
    viewModel.loadingViewError().lifecycleLoadingView(this, showFailedView = true) {
        snackBar(this)
    }
}

snackbar.setOnClickListener {
    snackBar("Сообщение")
}

/**
 * Отображает страницу с ошибкой после неудачи при загрузке, пользователь может обновить страницу, нажав на соответствующую кнопку, чтобы повторить попытку загрузки данных.
 * @param autoFirstLoad Boolean определяет, должна ли загрузка происходить автоматически при первом обращении.
 * @param block [@kotlin.ExtensionFunctionType] Function1<View, Unit>
 */
fun onFailedReload(autoFirstLoad: Boolean = true, block: View.() -> Unit){
    .....
}

override fun initFlow() {
    onFailedReload {
        loadBanners()
    }
}

private fun loadBanners(){
    viewModel.queryBanners().lifecycleLoadingDialog(this, true) {
        val images = mutableListOf<String>()
        this.forEach {
            images.add(it.imagePath)
        }
        bodyBinding.banner.run {
            setImages(images)
            start()
        }
    }
}

class UserAdapter(iPageControl: IPageControl) :
    RecyclerAdapter<User, ItemUserBinding>(iPageControl) {

    override fun viewBinding(parent: ViewGroup): ItemUserBinding {
        return ItemUserBinding.inflate(LayoutInflater.from(parent.context), parent, false)
    }

    override fun bindViewHolder(holder: CommonViewHolder<ItemUserBinding>, m: User, position: Int) {
        holder.viewBanding {
            name.text = m.name
        }
    }
}

bodyBinding.refresh.run {
    setOnRefreshLoadMoreListener { nextPageIndex ->
        viewModel.queryArticles(nextPageIndex).lifecycleRefresh(this@ArticleFragment, this)
    }
}

bodyBinding.refresh.run {
    setOnRefreshLoadMoreListener { nextPageIndex ->
        viewModel.queryArticles(nextPageIndex).lifecycleRefresh(this@ArticleFragment, this)
    }
}
``` ### 7. Журналирование

+ Не нужно инициализировать в приложении, так как LogUtils уже инициализирован в KotlinMvvmInitializer (./mvvm/src/main/java/com/catchpig/mvvm/initializer/KotlinMvvmInitializer.kt).
+ Можно использовать LogUtils.getInstance().i, LogUtils.getInstance().d для печати журналов (не рекомендуется).
+ Также можно использовать методы расширения LogExt для печати журналов (рекомендуется).

### 8. Использование аннотаций (REMARD_ANNOTATION.md)

### 9. Менеджер загрузки файлов (REMARD_DOWNLOAD_MANAGER.md)

### 10. Библиотека утилит (utils/README.md)

**Обфускация**

```properties
-keep class com.catchpig.annotation.enums.**
-keep class com.google.android.material.snackbar.Snackbar {*;}
-keep @com.catchpig.annotation.ServiceApi class * {*;}
-keep public class **.databinding.*Binding {*;}
-keep class **.*_Compiler {*;}
# Сериализация обфускации
-if @kotlinx.serialization.Serializable class **
-keepclassmembers class <1> {
static <1>$Companion Companion;
}
# Сохраняем serializer() на сопутствующих объектах (как по умолчанию, так и с именем) сериализуемых классов.
-if @kotlinx.serialization.Serializable class ** {
static **$* *;
}
-keepclassmembers class <1>$<3> {
kotlinx.serialization.KSerializer serializer(...);
}
# Сохраняем INSTANCE.serializer() сериализуемых объектов.
-if @kotlinx.serialization.Serializable class ** {
public static ** INSTANCE;
}
-keepclassmembers class <1> {
public static <1> INSTANCE;
kotlinx.serialization.KSerializer serializer(...);
}
# @Serializable и @Polymorphic используются во время выполнения для полиморфной сериализации.
-keepattributes RuntimeVisibleAnnotations,AnnotationDefault