无法将Android Beacon Library添加至Android Studio项目求助

常见排查步骤 #

• 同步+清理重建项目
  先点Android Studio顶部工具栏的File > Sync Project with Gradle Files，同步完成后依次执行Build > Clean Project和Build > Rebuild Project。很多时候依赖只是在列表里显示，实际没同步到本地，重建能解决缓存不一致的问题。

• 确认依赖添加位置正确
  必须在模块级的build.gradle（一般是app/build.gradle）里添加依赖，别写到项目根目录的build.gradle里。正确的依赖写法示例：

  dependencies {
      implementation 'org.altbeacon:android-beacon-library:2.21.5' // 替换为官方最新版本号
  }
  

  注意别写错groupId、artifactId和版本号，版本号可以直接用官方当前最新的。

• 检查import语句是否正确
  在MainActivity里访问库内类前，必须先导入对应包。比如要使用BeaconManager，得在代码顶部加：

  import org.altbeacon.beacon.BeaconManager;
  

  要是记不清包名，直接写类名（比如BeaconManager），然后按Alt + Enter（Windows/Linux）或Option + Enter（Mac），让Android Studio自动帮你导入。

• 清除Android Studio缓存
  前面步骤都没用的话，试试清除缓存：点File > Invalidate Caches...，选择Invalidate and Restart。重启后重新同步项目，很多奇怪的依赖问题都能这么解决。

• 确认compileSdkVersion达标
  Android-Beacon-Library对compileSdkVersion有最低要求，比如最新版本可能需要33及以上。检查模块级build.gradle里的配置：

  android {
      compileSdk 34 // 版本至少要满足库的要求
      // ...其他配置
  }
  

额外提示 #

如果还是有问题，打开File > Project Structure > Modules > app > Dependencies，看看依赖列表里的Android-Beacon-Library是不是implementation类型，有没有红色警告。有警告的话，点依赖项旁的刷新按钮，或者删掉重新添加。

内容的提问来源于stack exchange，提问作者Kadir Sağlam