Android Kotlin项目引入FingerPaintView时Gradle同步报错原因排查

核心问题分析 #

你遇到的错误本质是两个问题：一是依赖坐标不完整，二是依赖声明的位置或Gradle配置不符合规则。

具体解决步骤 #

1. 修正依赖坐标
   你写的com.nex3zfingerpaintview是不完整的Maven坐标，正确的坐标应该是：

   implementation 'com.nex3z:finger-paint-view:1.2.0'
   

2. 确保依赖声明的位置正确
   只能在**app模块的build.gradle（不是项目根目录的build.gradle）**的dependencies代码块中添加该依赖，示例如下：

   plugins {
       id 'com.android.application'
       id 'org.jetbrains.kotlin.android'
   }
   
   android {
       // 你的Android配置（compileSdk、defaultConfig等）
   }
   
   dependencies {
       // 其他已有依赖
       implementation 'androidx.core:core-ktx:1.12.0'
       implementation 'androidx.appcompat:appcompat:1.6.1'
       // 添加FingerPaintView依赖
       implementation 'com.nex3z:finger-paint-view:1.2.0'
   }
   

   注意：项目根目录的build.gradle中的dependencies块是用于配置Gradle插件等项目级依赖的，不能在这里使用implementation。

3. 检查Android插件是否正确应用
   确认app级build.gradle顶部已经应用了Android和Kotlin插件，只有应用这些插件后，implementation方法才会被Gradle识别。如果是旧版Gradle写法，应该是：

   apply plugin: 'com.android.application'
   apply plugin: 'kotlin-android'
   

4. 同步并重建项目
   完成上述配置后，点击Android Studio右上角的"Sync Project with Gradle Files"按钮，同步完成后再执行Rebuild Project即可。

内容的提问来源于stack exchange，提问作者Omilana Halimat Olufolake Oluf