Ionic React项目Capacitor Splash Screen插件Android端不生效求助

• 确认插件安装与同步
  先确保已正确安装插件并同步到Android项目：

  npm install @capacitor/splash-screen
  npx cap sync android
  

• 检查启动屏资源是否存在
  Capacitor默认的splash资源需要放置在Android项目的android/app/src/main/res/drawable-xxxhdpi/（及其他dpi对应目录）下，文件名为splash.png。如果没有这些资源，可通过以下方式生成：

  1. 准备符合尺寸要求的启动屏图片（比如xxxhdpi对应1280x1920）
  2. 将图片复制到对应drawable目录，确保文件名与androidSplashResourceName配置的splash一致（不带后缀）
     或者使用Capacitor资源生成工具：npx cap assets generate（需提前在capacitor.config.ts中配置assets字段指定资源路径）

• 修正冲突配置项
  你的配置中layoutName: "launch_screen"和useDialog: true会覆盖默认的图片启动屏逻辑，建议删除这两个配置项，保留核心配置：

  plugins: {
    SplashScreen: {
      androidSplashResourceName: "splash",
      launchShowDuration: 3000,
      launchAutoHide: true,
      launchFadeOutDuration: 3000,
      androidScaleType: "CENTER_CROP",
      splashFullScreen: true,
      splashImmersive: true,
    },
  }
  

• 检查AndroidManifest.xml配置
  打开Android项目的android/app/src/main/AndroidManifest.xml，确保启动Activity的theme未被自定义修改导致覆盖启动屏：
  启动Activity的theme应保持Capacitor默认设置，比如：

  <activity
      android:name=".MainActivity"
      android:theme="@style/AppTheme.NoActionBar"
      ...>
  

• 清理缓存并重新构建
  在Android Studio中执行：

  1. Build > Clean Project
  2. Build > Rebuild Project
     清理旧缓存后重新编译，避免资源未更新的问题。

• 确认应用启动时未提前隐藏启动屏
  检查你的App.tsx或入口文件，确保没有在应用初始化阶段提前调用SplashScreen.hide()，否则会覆盖launchAutoHide的自动隐藏逻辑。如果需要手动控制，可在应用加载完成后调用：

  import { SplashScreen } from '@capacitor/splash-screen';
  import { useEffect } from 'react';
  
  function App() {
    useEffect(() => {
      const initApp = async () => {
        // 模拟应用加载完成
        await new Promise(resolve => setTimeout(resolve, 2000));
        await SplashScreen.hide();
      };
      initApp();
    }, []);
  
    // ... 其他组件代码
  }
  

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