Android Studio无法显示Nearby API方法描述的问题求助

问题概况 #

使用play-services-nearby:19.1.0时遇到以下异常：

• 方法描述在Android Studio中无法正常显示，但手动打开localhost链接可查看完整文档
• IDE窗口底部的文档超链接点击无响应
• 尝试下载源码时报错：无法找到com.google.android.gms:play-services-nearby:19.1.0@aar

解决方案 #

1. 升级依赖版本 #

19.1.0属于较旧版本，谷歌可能未发布配套的源码包或文档映射资源。建议升级至稳定新版本（如20.0.0及以上）：
修改libs.versions.toml：

playServicesNearby = "20.0.0"
play-services-nearby = { group = "com.google.android.gms", name = "play-services-nearby", version.ref = "playServicesNearby" }

同步Gradle后重新尝试下载源码。

2. 重建IDE索引 #

执行File → Invalidate Caches...，勾选Invalidate and Restart，重启Android Studio。此操作会强制IDE重新构建文档与源码索引，可解决链接无响应、文档不显示的问题。

3. 检查仓库配置完整性 #

确保module级别的build.gradle中包含google()仓库（play-services系列依赖仅在谷歌仓库发布）：

repositories {
    google()
    mavenCentral()
}

同时关闭Gradle离线模式：进入Settings → Build, Execution, Deployment → Gradle，取消勾选Offline work，保证IDE能在线拉取文档资源。

4. 手动关联文档（可选） #

若升级版本后仍无法自动加载文档，可手动配置：

1. 打开File → Project Structure
2. 在Dependencies标签找到play-services-nearby
3. 右侧填写对应版本的官方文档URL，点击Apply后同步项目

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