KMM项目集成MOKO Resources遇multiplatformResources未识别问题

算力阿峰

2026-6-20

解决KMP项目中multiplatformResources未识别的问题

问题根源

Unresolved reference: multiplatformResources错误本质是MOKO Resources的Gradle插件未被成功加载，导致Gradle无法识别这个扩展配置块，大概率是插件声明、仓库配置或版本兼容层面出了问题。

分步修复方案

1. 核对`libs.versions.toml`的插件配置

打开项目根目录的libs.versions.toml，确保MOKO插件的ID和版本声明完全正确：

[versions]
# 版本需与依赖的moko-resources保持一致（你用的是0.24.1）
mokoResources = "0.24.1"

[plugins]
mokoMultiplatformResources = { id = "dev.icerock.mobile.multiplatform-resources", version.ref = "mokoResources" }

2. 确保插件仓库配置完整

在settings.gradle.kts的pluginManagement块中，确认包含所有必要的仓库（部分版本的MOKO插件需要从Icerock私有仓库拉取）：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
        maven("https://maven.icerock.dev")
    }
}

3. 排查版本兼容性

MOKO Resources 0.24.1要求Kotlin版本≥1.8.20，检查你的libs.versions.toml中Kotlin版本是否达标：

[versions]
kotlin = "1.8.20" # 或更高兼容版本

4. 跳过别名直接应用插件（排查别名解析问题）

如果别名方式加载插件失败，可以尝试直接指定插件ID和版本，替换plugins块中的对应行：

plugins {
    alias(libs.plugins.kotlinMultiplatform)
    alias(libs.plugins.jetbrainsCompose)
    alias(libs.plugins.compose.compiler)
    // 替换别名方式为直接声明
    id("dev.icerock.mobile.multiplatform-resources") version "0.24.1"
}