在 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 多平台项目能够更加灵活地处理跨平台代码和平台特定代码,从而实现真正的代码复用和平台无关性。