Ionic Cordova iOS平台SplashScreen插件缺失导致闪屏无法隐藏问题

我之前也碰到过版本跨级升级后插件“失踪”的情况，结合你已经尝试过的操作，给你补充几个更深入的排查和修复方向：

1. 彻底校验插件安装与配置 #

首先要确保原生插件和对应的包装器都正确安装，并且配置没有遗漏：

• 执行完整的卸载+重装命令，避免残留旧版本依赖：

  npm uninstall @ionic-native/splash-screen cordova-plugin-splashscreen
  npm install @awesome-cordova-plugins/splash-screen@latest cordova-plugin-splashscreen@latest
  

• 在app.module.ts中确认插件已导入并添加到依赖注入列表：

  import { SplashScreen } from '@awesome-cordova-plugins/splash-screen/ngx';
  
  @NgModule({
    ...
    providers: [
      ...
      SplashScreen
    ]
  })
  export class AppModule { }
  

2. 检查config.xml的闪屏核心配置 #

升级过程中config.xml的配置可能被覆盖，务必确认以下关键项存在：

<!-- 启用闪屏插件 -->
<preference name="SplashScreen" value="screen" />
<!-- 开启自动隐藏 -->
<preference name="AutoHideSplashScreen" value="true" />
<!-- 可选：自定义闪屏显示时长（毫秒） -->
<preference name="SplashScreenDelay" value="3000" />

3. 彻底清理缓存并重建项目 #

升级后的缓存是插件注入失败的重灾区，按顺序执行以下操作：

• 清理Ionic/Cordova缓存和Node依赖：

  ionic cordova clean ios
  rm -rf node_modules package-lock.json
  npm install
  

• 完全移除iOS平台并重新添加（确保删除残留文件）：

  ionic cordova platform rm ios
  rm -rf platforms/ plugins/
  ionic cordova platform add ios@latest
  

4. 修复Xcode的CocoaPods依赖冲突 #

Cordova插件依赖CocoaPods管理，升级后可能出现缓存冲突：

• 进入iOS项目目录（platforms/ios/），删除Pods/文件夹和Podfile.lock文件
• 重新执行Pod安装：

  cd platforms/ios
  pod install
  

• 注意：后续必须用Xcode打开.xcworkspace文件（而非.xcodeproj）

5. 手动验证Xcode中的插件加载状态 #

如果以上步骤都无效，直接检查Xcode项目细节：

• 打开Xcode项目，进入Build Phases -> Link Binary With Libraries，查看是否存在libSplashScreen.a
• 如果缺失，手动添加插件文件：右键点击项目 -> Add Files to "你的项目名"，找到plugins/cordova-plugin-splashscreen/src/ios/下的CDVSplashScreen.m和CDVSplashScreen.h

6. 确认代码中手动触发闪屏隐藏 #

即使开启了AutoHideSplashScreen，升级后有时仍需要手动触发隐藏逻辑：
在app.component.ts的初始化方法中添加：

import { SplashScreen } from '@awesome-cordova-plugins/splash-screen/ngx';
import { Platform } from '@ionic/angular';

constructor(private platform: Platform, private splashScreen: SplashScreen) {}

initializeApp() {
  this.platform.ready().then(() => {
    // 确保平台就绪后强制隐藏闪屏
    this.splashScreen.hide();
  });
}

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