Android Studio中OneSignal Gradle插件初始化异常求助

可行的排查与解决步骤 #

• 校验插件与Gradle版本兼容性
  OneSignal插件对Gradle和Android Gradle Plugin（AGP）版本有明确适配要求，查看项目根目录build.gradle里的AGP版本，以及app模块build.gradle中的OneSignal插件版本，确保二者匹配。比如AGP 7.0+版本需搭配4.0.0及以上的OneSignal插件。
• 清理缓存并重启同步
  点击Android Studio菜单栏File → Invalidate Caches...，勾选Invalidate and Restart，重启后重新同步项目。
• 检查OneSignal配置完整性
  确认除了AP ID，AndroidManifest.xml已添加必要权限和元数据，示例如下：

  <meta-data android:name="com.onesignal.NotificationOpened.DEFAULT" android:value="DISABLE" />
  

  同时确保build.gradle中插件应用顺序正确，需在com.android.application插件之后：

  apply plugin: 'com.android.application'
  apply plugin: 'com.onesignal.androidsdk.onesignal-gradle-plugin'
  

• 获取详细错误日志定位根源
  在Terminal执行命令（Windows系统用gradlew.bat build --info）：

  ./gradlew build --info
  

  从日志里找到ExceptionInInitializerError的完整栈信息，该错误通常由依赖冲突或缺失必要依赖导致，比如OneSignal依赖的Google Play Services版本是否与项目其他依赖兼容。
• 更新OneSignal插件至稳定版
  在项目根目录build.gradle中更新插件classpath到最新稳定版：

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
    dependencies {
      classpath 'com.onesignal:onesignal-gradle-plugin:[最新稳定版本号]'
    }
  }
  

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