上次写了这篇《基于 Kotlin KMP 实现 HarmonyOS 与 Android 双平台 SDK 开发实践》，

但是当时有个遗憾， Kotlin KMP 项目除了 Android 平台，在IOS 和鸿蒙端两个端没法直接做断点调试。此前在另外两个端调试，一直是通过打印 log 来进行。但是要是遇到在主线程高频的操作，在其逻辑块中打印日志简直是酸爽。

后来找资料的过程中，同事了介绍了这个工具xcode-kotlin。借助于这个工具，Kotlin KMP 项目也可以实现在 IOS 端的 Kotlin 代码断点调试。

以下是详细操作过程。

安装插件

按照https://touchlab.co/xcode-kotlin-2-0 这里的教程来操作。

使用 brew 来进行安装，这一步完成的是xcode-kotlin CLI，即terminal 命令行工具的安装

brew install xcode-kotlin

如果之前安装过，也可以使用以下指令升级版本：

brew update && brew upgrade xcode-kotlin

第二步，安装 xcode-kotlin 插件：

xcode-kotlin install

这个工具的安装确实方便简单，两步搞定。接下来就是在具体的 kotlin KMP 跨端项目中使用了。

xcode-kotlin插件的使用

第一步

打开 Xcode。选择 Open Existing Project，定位到项目的 iosApp 目录，如图所示打开项目：

到这里正常情况下就能顺利打开项目。

例外情况

但是很不幸我遇到了意外，项目报错：Command PhaseScriptExecution failed with a nonzero exit code

错误信息如下：

   REPO_ROOT="$PODS_TARGET_SRCROOT"
        "$REPO_ROOT/../gradlew" -p "$REPO_ROOT" $KOTLIN_PROJECT_PATH:syncFramework           -Pkotlin.native.cocoapods.platform=$PLATFORM_NAME           -Pkotlin.native.cocoapods.archs="$ARCHS"           -Pkotlin.native.cocoapods.configuration="$CONFIGURATION"
The operation couldn’t be completed. Unable to locate a Java Runtime.

Please visit http://www.java.com for information on installing Java.

Command PhaseScriptExecution failed with a nonzero exit code

最终折腾一番发现是因为之前调试 Android 程序，将 Android studio 的 Java jdk 配置为了系统 Java 环境变量。和 Mac 机器上原有的系统目录/usr/bin/java下的 Java 产生了冲突。

暂时想到办法就是为了整个项目的统一，强制将 Android studio 内的 Java jdk 设置给了 xcode 环境。

找到项目的 Run script，加入如下两行环境变量配置：

export JAVA_HOME="/Users/xxxxxx/Applications/Android Studio.app/Contents/jbr/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"

第二步

在 iosApp 上右键，创建一个空Group，名字随意，这里叫 KotlinDebug

接着把这个目录拖拽到 顶部iosApp 这里释放。完成后如下图所示：

第三步

在 DebugKotlin 目录上右键，选择 Add Files

定位到项目的 shared 目录部分，最终选择 iosMain和 commMain将 kotlin 代码勾进来。

之后会弹框提示，点击 Finish

完成后如下图所示：

最后一步

定位到 kotlin 代码，设置断点后，直接 run 即可。

总结

• 这个插件的功能确实强大。之前在 ios 端无法做断点调试只能通过打印 log 来进行，非常局限。有了它的辅助项目调试能更加灵活、精准。
• 这里也要吐槽一下，还是学艺不精，操作过几次经常出问题导致断点无效。写文章的过程中就翻车了。开始创建的是文件目录，add files 的时候会自动拷贝一份kotlin 代码到新建的目录下，然后在 xcode 调试断点根本就打不到真正的 kotlin 文件上而是在副本文件上。后期改成创建 ”Group“做文件隐射，就解决掉了这个问题。

（欢迎大家关注我的同名微信公众号）