在 Kotlin 多平台编程中,expect
和 actual
关键字用于定义跨平台的抽象和具体实现。这种机制允许开发者声明一个平台无关的接口或函数签名(使用 expect
),然后在每个目标平台上提供具体的实现(使用 actual
)。
expect
关键字
expect
关键字用于声明一个抽象成员,它可以是类、接口、对象、函数、属性或类型别名。这些声明不包含具体的实现,而是作为跨平台代码中的占位符,表明在某个平台上将提供具体的实现。
示例:
kotlin复制代码
// 声明一个跨平台的期望函数 | |
expect fun platformSpecificFunction(): String |
actual
关键字
actual
关键字用于为目标平台提供 expect
声明的具体实现。每个目标平台(如 JVM、JS、Native 等)都可以有自己的 actual
实现。
示例:
kotlin复制代码
// 在 JVM 平台上的实际实现 | |
actual fun platformSpecificFunction(): String { | |
return "This is JVM implementation" | |
} | |
// 在 JS 平台上的实际实现 | |
// 这个文件通常位于另一个源代码集中,例如 `commonMain`, `jvmMain`, `jsMain` | |
actual fun platformSpecificFunction(): String { | |
return "This is JS implementation" | |
} |
使用场景
- 跨平台 API:当你需要定义一个跨平台的 API,但每个平台的具体实现不同时。
- 条件编译:虽然不完全等同于条件编译,但
expect
/actual
提供了一种在不同平台上提供不同实现的方法。 - 共享代码:在共享代码中声明
expect
成员,然后在每个平台的特定代码集中提供actual
实现,有助于减少重复代码。
注意事项
expect
声明必须在common
源集(或任何被标记为expect
的源集)中。actual
实现必须在对应平台的源集中,例如jvmMain
,jsMain
,nativeMain
等。- 一个
expect
声明可以有多个actual
实现,每个目标平台一个。
通过 expect
和 actual
,Kotlin 多平台项目能够更加灵活地处理跨平台代码和平台特定代码,从而实现真正的代码复用和平台无关性。