Compose Swift Bridge 项目中 iOS 构建依赖问题的分析与解决-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_07232/article/details/148706958

Compose Swift Bridge 项目中 iOS 构建依赖问题的分析与解决

compose-swift-bridge Automate the boilerplate of blending Compose UI and native UI on iOS 项目地址: https://gitcode.com/gh_mirrors/co/compose-swift-bridge

问题背景

在使用 Compose Swift Bridge 框架开发跨平台应用时，开发者可能会遇到一个特殊现象：当尝试构建 iOS 平台代码前，必须先完成 Android 平台的构建，否则 iOS 构建会失败并出现各种类未找到的错误。这种构建顺序依赖性会给开发流程带来不便，特别是对于专注于 iOS 开发的团队成员。

错误表现

当直接尝试构建 iOS 平台而不先构建 Android 时，系统会报告一系列编译错误，主要包括：

接口声明与实际实现不匹配的错误
各种工厂类和委托类的未解析引用
类型推断失败，要求显式指定类型参数
各种更新方法（如 updateMarkers、updateState 等）的未解析引用

这些错误表明代码生成或依赖解析过程出现了问题，导致必要的类和接口未能正确生成或导入。

根本原因分析

经过深入调查，发现这个问题与 Kotlin Symbol Processing (KSP) 的代码生成机制有关。在 Compose Swift Bridge 的工作流程中：

注解处理器需要在多个平台间共享生成的代码
默认配置下，某些代码生成任务可能没有正确设置跨平台依赖
特别是当使用 @ExpectSwiftView 注解时，相关的工厂类和接口需要在所有平台间保持同步

解决方案

要解决这个问题，关键在于正确配置 Gradle 构建脚本，确保代码生成任务能够跨平台工作。以下是推荐的配置方式：

plugins {
    alias(libs.plugins.skie)
    alias(libs.plugins.google.ksp)
}

kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation(libs.composeSwiftBridge)
        }
    }
}

dependencies {
    val composeSwiftBridgeKsp = libs.composeSwiftBridge.ksp
    "kspCommonMainMetadata"(composeSwiftBridgeKsp)
    "kspIosSimulatorArm64"(composeSwiftBridgeKsp)
    "kspIosArm64"(composeSwiftBridgeKsp)
    "kspIosX64"(composeSwiftBridgeKsp)
    "kspAndroid"(composeSwiftBridgeKsp)
    skieSubPlugin(libs.composeSwiftBridge.skie)
}

tasks.withType<com.google.devtools.ksp.gradle.KspTaskNative>().configureEach {
    options.add(SubpluginOption("apoption", "compose-swift-bridge.targetName=$target"))
}

// 支持在 commonCode 中生成 ksp 代码
tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile>().configureEach {
    if (name != "kspCommonMainKotlinMetadata") {
        dependsOn("kspCommonMainKotlinMetadata")
    }
}

kotlin.sourceSets.commonMain {
    kotlin.srcDir("build/generated/ksp/metadata/commonMain/kotlin")
}