Kotlin Multiplatform--01:项目结构基础

Kotlin Multiplatform--01:项目结构基础

引言

以下为使用 Android Studio 创建的默认 Kotlin Multiplatform 的项目结构,本章将对项目结构进行简单介绍,让读者对 Kotlin Multiplatform 项目能够有一个大概的认识。


Common Code

Common Code 是指与平台无关的代码,比如业务逻辑等。在项目结构中对应 commonMain 文件夹。需要注意的是,Common Code 不能使用任何与平台相关的 API ,比如 java.io.File 等,也不能添加任何与平台相关的依赖库。但可以使用专门为 Kotlin Multiplatform 设计的 Kotlin 库,比如 kotlinx.coroutines 等。

Targets

Target 指需要将项目编译到哪个平台上,比如 JVM, JS, Android, iOS, or Linux 等。需要注意:平台相关的代码可以调用 Common Code,但 Common Code 中不能调用平台相关的代码。在 build.gradle.kts 文件中配置,如下所示:

kotlin 复制代码
kotlin {
	androidTarget() // Declares a target that corresponds to Android phones
    iosArm64() // Declares a target that corresponds to 64-bit iPhones
    macosArm64() // Declares a target that corresponds to Modern Apple Silicon-based Macs
}

声明编译目标后,还需要在项目中新建相应的文件夹和文件,命名规则为xxxMain,还需要在里面新建名为 kotlin 的子文件夹,放该平台相关的源代码。因为我在默认项目结构上额外声明了 macosArm64 的目标,所以需要新建一个 macosMain 文件夹,如下所示:

最后在 build.gradle.kts 中的 sourceSets 中可以配置不同目标的依赖库文件,如下所示:

kotlin 复制代码
    sourceSets {
        androidMain {
            //put your multiplatform dependencies here
            implementation("xxx")
        }
        commonMain.dependencies {
            //put your multiplatform dependencies here
            implementation("xxx")
        }
        iosMain.dependencies {
            //put your multiplatform dependencies here
            implementation("xxx")
        }
        macosMain.dependencies { 
            //put your multiplatform dependencies here
            implementation("xxx")
        }
    }

Expected 和 actual

有时候我们确实需要在 Common Code 中调用平台相关的代码,并在不同的平台下有不同的表现该如何处理呢?

1.使用函数

在 CommonMain 中声明一个 except 函数,供其他 Common Code 使用:

kotlin 复制代码
package identity

class Identity(val userName: String, val processID: Long)

expect fun buildIdentity(): Identity

在不同平台中使用 actual 进行不同的实现,比如在 jvm 中进行以下实现:

kotlin 复制代码
package identity

import java.lang.System
import java.lang.ProcessHandle

actual fun buildIdentity() = Identity(
    System.getProperty("user.name") ?: "None",
    ProcessHandle.current().pid()
)

在 POSIX 系统中进行以下实现:

kotlin 复制代码
package identity

import kotlinx.cinterop.toKString
import platform.posix.getlogin
import platform.posix.getpid

actual fun buildIdentity() = Identity(
    getlogin()?.toKString() ?: "None",
    getpid().toLong()
)
2.使用接口

在 CommonMain 中声明一个 Identity 接口和 buildIdentity 函数,供其他 Common Code 使用:

kotlin 复制代码
// In the commonMain source set:
expect fun buildIdentity(): Identity

interface Identity {
    val userName: String
    val processID: Long
}

在不同平台中使用 actual 进行不同的实现,比如在 jvm 中进行以下实现:

kotlin 复制代码
// In the jvmMain source set:
actual fun buildIdentity(): Identity = JVMIdentity()

class JVMIdentity(
    override val userName: String = System.getProperty("user.name") ?: "none",
    override val processID: Long = ProcessHandle.current().pid()
) : Identity

在 POSIX 系统中进行以下实现:

kotlin 复制代码
// In the nativeMain source set:
actual fun buildIdentity(): Identity = NativeIdentity()

class NativeIdentity(
    override val userName: String = getlogin()?.toKString() ?: "None",
    override val processID: Long = getpid().toLong()
) : Identity
相关推荐
爱吃KFC的大肥羊1 分钟前
C++三大特性之“继承”
开发语言·c++
毕设源码-李学长8 分钟前
计算机毕业设计java高校多媒体教室管理系统高校多媒体教室综合管理系统高校智能多媒体教室管理平台
java·开发语言·课程设计
先知后行。16 分钟前
线程的创建.销毁
开发语言·c++·算法
鱼嘻21 分钟前
西嘎嘎学习 - C++ 继承 - Day 10
开发语言·c++·学习·算法
Digitally24 分钟前
如何将视频从安卓手机传输到电脑?
android·智能手机·电脑
孤廖27 分钟前
从 “模板” 到 “场景”,用 C++ 磨透拓扑排序的实战逻辑
开发语言·c++·程序人生·算法·贪心算法·动态规划·学习方法
CV资深专家27 分钟前
Android 相机框架的跨进程通信架构
android
我有火的意志36 分钟前
Liunx执行source /etc/profile 报错, -bash: HISTTIMEFORMAT: readonly variable
开发语言·bash·histtimeformat·readonly
前行的小黑炭1 小时前
Android :如何提升代码的扩展性,方便复制到其他项目不会粘合太多逻辑,增强你的实战经验。
android·java·kotlin
2501_915921431 小时前
前端开发工具有哪些?常用前端开发工具、前端调试工具、前端构建工具与效率提升工具对比与最佳实践
android·前端·ios·小程序·uni-app·iphone·webview