Понимание структуры мобильного проекта

Проект корневой директории

Проект корневой директории – это Gradle-проект, содержащий модуль shared и приложение Android в качестве своих подпроектов. Они связаны через механизм многопроектных сборок Gradle.

// settings.gradle.kts
include(":shared")
include(":androidApp")

// settings.gradle
include ':shared'
include ':androidApp'

Приложение iOS создается из проекта Xcode. Оно хранится в отдельной директории в корневом проекте. Xcode использует свою собственную систему сборки, поэтому проект приложения iOS не связан с другими частями проекта Multiplatform Mobile через Gradle. Вместо этого он использует модуль shared как внешний артефакт – фреймворк. Подробности об интеграции между модулем shared и приложением iOS см. в разделе Приложение iOS.

Вот базовая структура кроссплатформенного мобильного проекта:

Корневой проект не содержит исходного кода. Вы можете использовать его для хранения глобальной конфигурации в своих build.gradle(.kts) или gradle.properties, например, добавления репозиториев или определения глобальных конфигурационных переменных.

Для более сложных проектов вы можете добавить больше модулей в корневой проект, создав их в IDE и связав через include объявления в настройках Gradle.

Модуль общего использования

Модуль общего использования содержит основной логику приложения, используемую на обеих целевых платформах: классы, функции и так далее. Это модуль Kotlin Multiplatform, который компилируется в библиотеку Android и фреймворк iOS. Он использует Gradle с применённой плагином Kotlin Multiplatform и имеет целевые платформы Android и iOS.

plugins {
    kotlin("multiplatform") version "1.6.20"
    // ..
}

kotlin {
    android()
    ios()
}

plugins {
    id 'org.jetbrains.kotlin.multiplatform' version '1.6.20'
    //..
}

kotlin {
    android()
    ios()
}

kotlin {
    sourceSets {
        val commonMain by getting
        val androidMain by getting {
            dependencies {
                implementation("androidx.core:core-ktx:1.2.0")
            }
        }
        val iosMain by getting 
        // ...
    }
}

kotlin {
    sourceSets {
        commonMain {
        }
        androidMain {
            dependencies {
                implementation 'androidx.core:core-ktx:1.2.0'
            }
        }
        iosMain {
        }

        // ...
    }
}

kotlin {
    sourceSets {
        // ...
        val commonTest by getting {
            dependencies {
                implementation(kotlin("test"))
            }
        }
        val androidTest by getting
        val iosTest by getting
    }

}

kotlin {
    sourceSets {
        //...

        commonTest {
            dependencies {
                implementation kotlin('test')
            }
        }
        androidTest {

        }
        iosTest {

        }
    }
}

plugins {
    // ...
    id("com.android.library")
}

plugins {
    // ...
    id 'com.android.library'
}

android {
    compileSdk = 29
    sourceSets["main"].manifest.srcFile("src/androidMain/AndroidManifest.xml")
    defaultConfig {
        minSdk = 24
        targetSdk = 29
    }
}

android {
    compileSdk 29
    sourceSets.main.manifest.srcFile 'src/androidMain/AndroidManifest.xml'
    defaultConfig {
        minSdk 24
        targetSdk 29
    }
}

kotlin {
    // ...
    ios {
        binaries {
            framework {
                baseName = "shared"
            }
        }
    }
}

kotlin {
    // ...
    ios {
        binaries {
            framework {
                baseName = 'shared'
            }
        }
    }
}

Приложение Android

Часть приложения Android проекта Multiplatform Mobile – это типичное приложение Android, написанное на Kotlin. В базовом кроссплатформенном мобильном проекте оно использует два плагина Gradle:

• Kotlin Android

• Приложение Android

plugins {
    id("com.android.application")
    kotlin("android")
} 

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
}

Для доступа к коду модуля общего использования приложение Android использует его как проектную зависимость.

dependencies {
    implementation(project(":shared"))
    //..
} 

dependencies {
    implementation project(':shared')
    //..
}

Помимо этой зависимости, приложение Android использует стандартную библиотеку Kotlin (которая добавляется автоматически) и некоторые общие зависимости Android:

dependencies {
    //..
    implementation("androidx.core:core-ktx:1.2.0")
    implementation("androidx.appcompat:appcompat:1.1.0")
    implementation("androidx.constraintlayout:constraintlayout:1.1.3")
} 

dependencies {
    //..
    implementation 'androidx.core:core-ktx:1.2.0'
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
}

Добавьте специфичные для вашего проекта зависимости Android в этот блок. Конфигурация сборки приложения Android находится в блоке android {} верхнего уровня скрипта сборки:

android {
    compileSdk = 29
    defaultConfig {
        applicationId = "org.example.androidApp"
        minSdk = 24
        targetSdk = 29
        versionCode = 1
        versionName = "1.0"
    }
    buildTypes {
        getByName("release") {
            isMinifyEnabled = false
        }
    }
}

android {
    compileSdk 29
    defaultConfig {
        applicationId 'org.example.androidApp'
        minSdk 24
        targetSdk 29
        versionCode 1
        versionName '1.0'
    }
    buildTypes {
        'release' {
            minifyEnabled false
        }
    }
}

Это типично для любого проекта Android. Вы можете изменить его в соответствии с вашими потребностями. Дополнительную информацию см. в документации разработчика Android.

Приложение iOS

Приложение iOS создается из проекта Xcode, сгенерированного автоматически мастером создания новых проектов. Оно располагается в отдельной директории корневого проекта.

Для каждой сборки приложения iOS проект получает последнюю версию фреймворка. Для этого используется этап сборки Run Script, который выполняет задачу embedAndSignAppleFrameworkForXcode Gradle из модуля общего использования. Эта задача генерирует .framework с необходимой конфигурацией, в зависимости от настроек среды Xcode, и помещает артефакт в директорию DerivedData Xcode.

• Если у вас есть пользовательское имя для Apple фреймворка, используйте embedAndSign<Custom-name>AppleFrameworkForXcode в качестве имени для этой задачи Gradle.

• Если у вас есть пользовательская конфигурация сборки, отличная от стандартной Debug или Release, на вкладке Настройки сборки добавьте настройку KOTLIN_FRAMEWORK_BUILD_TYPE в разделе Определяемые пользователем и установите значение Debug или Release.

Чтобы встроить фреймворк в приложение и сделать объявления из общего модуля доступными в исходном коде приложения iOS, необходимо правильно настроить следующие настройки сборки:

1. Другие флаги компоновщика в разделе Компоновка:

   $(inherited) -framework shared
   

   

2. Пути поиска фреймворков в разделе Пути поиска:

   $(SRCROOT)/../shared/build/xcode-frameworks/$(CONFIGURATION)/$(SDK_NAME)
   

   

В остальных аспектах, часть Xcode в кроссплатформенном мобильном проекте — это типичный проект приложения iOS. Чтобы узнать больше о создании приложений iOS, см. документацию Xcode.