已添加依赖但FlexboxLayout仍无法识别的Android开发问题

已导入FlexboxLayout相关依赖，但布局代码中的com.google.android.flexbox.FlexboxLayout仍无法被识别，报错找不到该依赖。相关配置如下：

布局代码 #

<!-- Tags -->
<com.google.android.flexbox.FlexboxLayout
    android:id="@+id/post_tags"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    android:layout_marginBottom="8dp"
    app:flexDirection="row"
    app:flexWrap="wrap"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintTop_toBottomOf="@+id/post_content"/>

app级build.gradle依赖配置 #

dependencies {
    implementation(libs.androidx.core.ktx)
    implementation(libs.androidx.lifecycle.runtime.ktx)
    implementation(libs.androidx.activity.compose)
    implementation(platform(libs.androidx.compose.bom))
    implementation(libs.androidx.ui)
    implementation(libs.androidx.ui.graphics)
    implementation(libs.androidx.ui.tooling.preview)
    implementation(libs.androidx.material3)
    implementation(libs.androidx.constraintlayout)
    implementation(libs.androidx.appcompat)
    implementation(libs.material)
    implementation(libs.androidx.activity)
    implementation(libs.firebase.firestore)
    implementation(libs.androidx.navigation.fragment.ktx)
    implementation(libs.androidx.navigation.ui.ktx)
    testImplementation(libs.junit)
    androidTestImplementation(libs.androidx.junit)
    androidTestImplementation(libs.androidx.espresso.core)
    androidTestImplementation(platform(libs.androidx.compose.bom))
    androidTestImplementation(libs.androidx.ui.test.junit4)
    debugImplementation(libs.androidx.ui.tooling)
    debugImplementation(libs.androidx.ui.test.manifest)

    // Add Flexbox dependency
    implementation(libs.flexbox)
}

libs.version.toml配置 #

[versions]
agp = "8.4.2"
flexbox = "com.google.android:flexbox:3.0.0"
kotlin = "1.9.0"
coreKtx = "1.13.1"
junit = "4.13.2"
junitVersion = "1.2.1"
espressoCore = "3.6.1"
lifecycleRuntimeKtx = "2.8.2"
activityCompose = "1.9.0"
composeBom = "2024.06.00"
constraintlayout = "2.1.4"
appcompat = "1.7.0"
material = "1.12.0"
activity = "1.9.0"
googleGmsGoogleServices = "4.4.2"
firebaseFirestore = "25.0.0"
navigationFragmentKtx = "2.6.0"
navigationUiKtx = "2.6.0"

问题原因 #

使用Version Catalog管理依赖时，仅在[versions]块声明版本号是不够的，还需要在[libraries]块中建立libs.flexbox到对应依赖的映射关系，当前配置缺少这一步，导致Gradle无法解析libs.flexbox。

解决方法 #

1. 补全libs.version.toml的libraries配置
   在libs.version.toml文件中添加[libraries]块，并配置flexbox的映射：

   [libraries]
   flexbox = { module = "com.google.android:flexbox", version.ref = "flexbox" }
   

   若文件中已有[libraries]块，直接在其中添加上述flexbox配置即可。

2. 同步并重建项目

   • 点击Android Studio右上角的Sync Project with Gradle Files按钮同步依赖
   • 执行Build > Clean Project清理缓存，再执行Build > Rebuild Project重新构建

3. 额外检查点

   • 确认Android Studio未开启Offline Mode（路径：File > Settings > Build, Execution, Deployment > Gradle，取消勾选Offline work）
   • 若仍有问题，可尝试将Flexbox版本降级到2.0.1，确认是否与当前AGP版本（8.4.2）存在兼容问题，修改后重新同步依赖

内容的提问来源于stack exchange，提问作者user26436559