Понимание структуры проекта для мобильных платформ

Основной проект

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

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

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

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

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

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

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

Модуль общего кода

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

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

kotlin {
    android()
    ios()
}

plugins {
    id 'org.jetbrains.kotlin.multiplatform' version '1.7.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 проект получает последнюю версию фреймворка. Для этого используется фаза сборки Скрипт выполнения, которая выполняет задачу 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.