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 插件版本是根本解法——始终以官方兼容矩阵为准，避免盲目升级单一方。
