Обновление мультиплатформенных проектов с приложениями для Android для использования AGP 9

Создание и настройка модуля приложения Android

Чтобы создать модуль приложения Android (androidApp):

1. Создайте каталог androidApp в корне проекта.

2. В этом каталоге создайте пустой файл build.gradle.kts и каталог src.

3. Добавьте новый модуль в настройки проекта в файле settings.gradle.kts, добавив в конец файла эту строку:

   include(":androidApp")
   

4. В главном меню выберите Сборка | Синхронизировать проект с файлами Gradle или нажмите кнопку обновления Gradle в редакторе.

Настройка скрипта сборки приложения Android

Настройте скрипт сборки Gradle для нового модуля:

1. Добавьте плагин Kotlin Android Gradle в каталог версий в файле gradle/libs.versions.toml:

   [plugins]
   kotlinAndroid = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
   

2. Укажите плагины, необходимые для модуля приложения Android, в файле androidApp/build.gradle.kts:

   plugins {
      alias(libs.plugins.kotlinAndroid)
      alias(libs.plugins.androidApplication)
      alias(libs.plugins.composeMultiplatform)
      alias(libs.plugins.composeCompiler)
   }
   

3. Убедитесь, что все эти плагины указаны в файле build.gradle.kts в корневом каталоге:

   plugins {
       alias(libs.plugins.kotlinAndroid) apply false
       alias(libs.plugins.androidApplication) apply false
       alias(libs.plugins.composeMultiplatform) apply false
       alias(libs.plugins.composeCompiler) apply false
       // ...
   }
   

4. Чтобы добавить необходимые зависимости, скопируйте существующие зависимости из блока androidMain.dependencies {} скрипта сборки composeApp и добавьте зависимость от самого модуля composeApp. В этом примере результат должен выглядеть так:

   kotlin {
       dependencies { 
           implementation(projects.composeApp)
           implementation(libs.androidx.activity.compose)
           implementation(libs.compose.uiToolingPreview)
       }
   }
   

5. Скопируйте весь блок android {} с конфигурацией для Android из файла composeApp/build.gradle.kts в файл androidApp/build.gradle.kts.

6. Скопируйте параметры компилятора из блока androidTarget {} файла composeApp/build.gradle.kts в блок target {} файла androidApp/build.gradle.kts:

   kotlin {
       target {
           compilerOptions {
               jvmTarget.set(JvmTarget.JVM_11)
           }
       }
   }
   

7. Измените конфигурацию модуля composeApp: вместо приложения Android настройте библиотеку Android, поскольку фактически модуль становится библиотекой. В файле composeApp/build.gradle.kts:

   • Измените ссылку на плагин Gradle:

              alias(libs.plugins.androidApplication)
          

              alias(libs.plugins.androidLibrary)
          

   • Удалите строки со свойствами приложения из блока android.defaultConfig {}:

             defaultConfig {
                 applicationId = "com.jetbrains.demo"
                 minSdk = libs.versions.android.minSdk.get().toInt()
                 targetSdk = libs.versions.android.targetSdk.get().toInt()
                 versionCode = 1
                 versionName = "1.0"
             }
         

             defaultConfig {
                 minSdk = libs.versions.android.minSdk.get().toInt()
             }
         

8. В главном меню выберите Сборка | Синхронизировать проект с файлами Gradle или нажмите кнопку обновления Gradle в редакторе.

Перенос кода и запуск приложения Android

1. Переместите каталог composeApp/src/androidMain в каталог androidApp/src/, учитывая при этом код, который должен оставаться кроссплатформенным:

   • Код точки входа, например MainActivity.kt в нашем примере, должен находиться в модуле androidApp, чтобы сборка приложения Android выполнялась корректно.

   • Все объявления expect и actual должны оставаться в исходных наборах общего модуля (composeApp в нашем примере), чтобы быть доступными на всех платформах. После настройки зависимости androidApp от composeApp эти объявления также станут доступны в коде точки входа.

2. Переименуйте каталог androidApp/src/androidMain в main.

3. Если всё настроено правильно, импорты в файле androidApp/src/main/.../MainActivity.kt будут работать, а код скомпилируется.

4. В IntelliJ IDEA или Android Studio среда разработки распознаёт новый модуль и автоматически создаёт новую конфигурацию запуска androidApp. Если этого не произошло, вручную измените конфигурацию запуска Android composeApp:

   1. В раскрывающемся списке конфигураций запуска выберите Изменить конфигурации.

   2. Найдите конфигурацию composeApp в категории Android.

   3. В поле Общие | Модуль замените demo.composeApp на demo.androidApp.

5. Запустите новую конфигурацию, чтобы убедиться, что приложение работает как ожидалось.

6. Если всё работает правильно, удалите блок kotlin.sourceSets.androidMain.dependencies {} из файла composeApp/build.gradle.kts.

Вы выделили точку входа Android в отдельный модуль. Теперь обновите модуль с общим кодом, чтобы использовать новый плагин библиотеки Android-KMP.