
android studio 升级后因 gradle 插件版本不匹配导致 onesignal 插件初始化失败,需同步升级 android gradle plugin(agp)与 onesignal gradle 插件至兼容版本。
android studio 升级后因 gradle 插件版本不匹配导致 onesignal 插件初始化失败,需同步升级 android gradle plugin(agp)与 onesignal gradle 插件至兼容版本。
在 Android 项目中集成 OneSignal 推送服务时,若升级 Android Studio(如升级至 Giraffe 版本)或更新构建工具,常会遇到如下构建错误:
A problem occurred evaluating project ':app'. > Failed to apply plugin 'com.onesignal.androidsdk.onesignal-gradle-plugin'. Could not create plugin of type 'GradleProjectPlugin'. > Could not initialize class com.onesignal.androidsdk.GradleProjectPlugin
该错误本质是 OneSignal Gradle 插件与当前 Android Gradle Plugin(AGP)版本不兼容 所致。旧版插件(如 0.12.6)仅支持 AGP 3.x~4.x,而新版 Android Studio(Giraffe 及以上)默认推荐或强制使用 AGP 7.0+,导致类加载失败(Could not initialize class)。
✅ 正确解决方式是同步升级两个依赖项:
在项目根目录的 build.gradle(或 build.gradle.kts)中,将旧配置:
// ❌ 过时配置(AGP 3.6.2 + OneSignal 0.12.6) classpath 'com.android.tools.build:gradle:3.6.2' classpath "gradle.plugin.com.onesignal:onesignal-gradle-plugin:0.12.6"
替换为兼容的最新稳定组合(以 AGP 7.0+ 为例):
// ✅ 推荐配置(AGP 7.0.0 + OneSignal 0.13.4) classpath 'com.android.tools.build:gradle:7.0.0' classpath "gradle.plugin.com.onesignal:onesignal-gradle-plugin:0.13.4"
⚠️ 注意事项:
- OneSignal 官方已明确:
0.13.4是首个正式支持 AGP 7.0+ 的插件版本(见 GitHub Issue #1399); - 若使用更高版本 AGP(如 8.0+),请查阅 OneSignal 官方 Gradle 插件文档 获取对应兼容版本(例如
0.14.3支持 AGP 8.1+); - 升级后务必执行 File → Sync Project with Gradle Files,避免仅清理缓存(
Invalidate Caches and Restart)而未更新依赖声明; -
onesignal-gradle-plugin仅需在项目级build.gradle中声明,切勿在模块级app/build.gradle中重复添加apply plugin(新版插件已自动处理)。
? 总结:OneSignal 构建失败多源于“版本错配”,而非环境或缓存问题。精准匹配 AGP 与 OneSignal 插件版本是根本解法——始终以官方兼容矩阵为准,避免盲目升级单一方。

















