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

Корневой проект

Корневой проект представляет собой проект 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.8.0"
    // ..
}

kotlin {
    android()
    ios()
}

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

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.