Android Studio集成VerticalCalendar库遇问题，其他库也报错

1. 先搞定仓库与依赖同步 #

• 检查项目根目录的build.gradle.kts，必须配置MavenCentral仓库（多数第三方库都托管于此）：

  repositories {
      google()
      mavenCentral()
      // 若使用JitPack托管的库，需额外添加maven("https://jitpack.io")
  }
  

• 执行File → Sync Project with Gradle Files，同步完成后去External Libraries目录确认VerticalCalendar包已成功下载。

2. 核对XML组件的全类名 #

• XML中使用组件必须写对完整类路径，VerticalCalendar的正确写法为：

  <com.emcthye.verticalcalendar.VerticalCalendarView
      android:id="@+id/verticalCalendar"
      android:layout_width="match_parent"
      android:layout_height="match_parent"/>
  

• 包名或类名拼写错误是最常见的报错原因，务必仔细核对。

3. 版本兼容性要匹配 #

• 查看库的官方文档，确认项目的compileSdk、targetSdk版本符合库的要求。例如库要求compileSdk 33以上，而项目用30就会触发兼容性报错。
• 检查gradle.properties中的kotlin_version，必须与库依赖的Kotlin版本一致，版本不兼容会引发大量异常：

  kotlin.code.style=official
  kotlin_version=1.9.0 # 需与库的Kotlin版本对齐
  

4. 清缓存重建项目 #

• 执行Build → Clean Project，再执行Build → Rebuild Project，清除旧编译缓存（缓存异常常导致依赖加载失败）。
• 若仍未解决，手动删除项目根目录的.gradle、build文件夹，以及app模块下的build文件夹，再重新同步Gradle。

5. 通用问题排查（换库也报错的情况） #

如果更换其他第三方库仍出现类似问题，说明项目基础配置存在问题：

• 若开启了R8/ProGuard混淆，需为第三方库添加混淆规则，避免类被混淆导致找不到：

  -keep class com.emcthye.verticalcalendar.** { *; }
  

• 确认项目的minSdkVersion满足库的要求，例如库要求minSdk 21，而项目设为19会直接报错。

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