环境搭建

大约 2 分钟

环境搭建

Kuikly是基于Kotlin MultiPlatform(KMP)实现的一套跨平台应用框架,因此开发环境与KMP要求的环境一致, 环境安装步骤如下:

  1. 下载并安装Android Studioopen in new window

  2. Android Studio中安装KotlinKotlin MultiPlatform插件,路径为Setting->Preferences->Plugins->Marketplace安装kotlin和kmp插件

  3. Android Studio中安装Kuikly插件

    安装步骤:

    1. Android Studio -> Setting->Preferences -> Plugins->Marketplace
    2. 在Marketplace页签,输入Kuikly回车搜索,点击Install,然后Restart IDE即可

    目前Kuikly Android Studio插件提供了以下功能

    1. 新建Kuikly业务工程: 一键生成Kuikly业务工程与 Android/iOS App 宿主工程,自动集成Kuikly依赖等
    2. 新建Kuikly的ComposeView类: 自动帮业务开发者生成组合组件的模板代码
    3. 新建Kuikly的Pager类: 自动帮业务开发者生成Pager的模板代码
  4. 下载jdk 17并配置环境变量

  5. 如需运行iOS, 还需要安装XCodeopen in new windowcocoapodsopen in new window

  6. 如需运行Ohos,还需要安装DevEcoopen in new window

忽略iOS编译打包

注意

这一步为本机不安装iOS运行环境时做的兼容处理,非必需执行。

若无需运行iOS,可进行如下配置忽略iOS编译打包,否则可能导致编译失败。

对于windows开发人员,系统不能运行iOS开发环境,也需要进行如下配置。

切换到Project视图,打开shared/build.gradle.kts,并注释iOS相关配置。

忽略iOS编译打包
忽略iOS编译打包

相关逻辑如下:

...

iosX64()
iosArm64()
iosSimulatorArm64()

cocoapods {
   summary = "Some description for the Shared Module"
   homepage = "Link to the Shared Module homepage"
   version = "1.0"
   ios.deploymentTarget = "14.1"
   podfile = project.file("../iosApp/Podfile")
   framework {
      baseName = "shared"
      isStatic = true
      license = "MIT"
   }
}

...

val iosX64Main by getting
val iosArm64Main by getting
val iosSimulatorArm64Main by getting
val iosMain by creating {
   dependsOn(commonMain)
   iosX64Main.dependsOn(this)
   iosArm64Main.dependsOn(this)
   iosSimulatorArm64Main.dependsOn(this)
}
val iosX64Test by getting
val iosArm64Test by getting
val iosSimulatorArm64Test by getting
val iosTest by creating {
   dependsOn(commonTest)
   iosX64Test.dependsOn(this)
   iosArm64Test.dependsOn(this)
   iosSimulatorArm64Test.dependsOn(this)
}

...

add("kspIosArm64", this)
add("kspIosX64", this)
add("kspIosSimulatorArm64", this)

使用KMP提供的KDoctor检查环境(仅限Mac用户)

注意

这一步为检查本地的环境是否满足KMP的环境要求,非必需执行。

  1. 安装kdoctor: brew install kdoctor
  2. 安装完毕后,命令行输入kdoctor, 检查环境是否准备好
kdoctor检查
kdoctor检查

更多

关于KMP环境搭建遇到的问题,可以到KMP官网open in new window 查看更详细的环境搭建教程

上次编辑于: