Android Studio构建成功但Ionic/Capacitor/Vue3应用未在模拟器显示

问题背景 #

• 清理项目后构建基于Ionic、Capacitor、Vue3技术栈的移动应用，构建日志无错误输出，但应用未出现在安卓模拟器的应用列表中
• 现有AndroidManifest.xml配置如下，经检查基础配置无语法错误、入口配置正确：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="cash.dat.mobile">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">

        <activity
            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|smallestScreenSize|screenLayout|uiMode"
            android:name="cash.dat.mobile.MainActivity"
            android:label="@string/title_activity_main"
            android:theme="@style/AppTheme.NoActionBarLaunch"
            android:launchMode="singleTask"
            android:exported="true">

            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>

        </activity>

        <provider
            android:name="androidx.core.content.FileProvider"
            android:authorities="${applicationId}.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths"></meta-data>
        </provider>
    </application>

    <uses-permission android:name="android.permission.INTERNET" />
</manifest>

核心成因与对应解决方案 #

• 构建流程缺失同步、安装步骤（最高发）
  清理项目操作会清空web构建产物目录，直接执行安卓构建不会自动更新Capacitor依赖的web静态资源，也不会默认把构建好的apk推送到模拟器安装。按顺序执行以下命令修复：

  1. 重新构建Vue前端产物：npm run build
  2. 将web产物同步到安卓原生工程目录：npx cap sync android
  3. 打开安卓工程：npx cap open android，在Android Studio中选中已启动的模拟器点击运行按钮，或者直接在命令行执行debug包安装命令：cd android && ./gradlew installDebug

• 构建变体选择错误
  如果在Android Studio中将Build Variants切换为release版本，未配置签名规则的release包不会自动推送到模拟器安装。打开Android Studio左侧Build Variants面板，将app模块的Active Build Variant切换为debug后重新运行即可。

• ABI架构不匹配
  若创建的模拟器为x86/x86_64架构，但android/app/build.gradle中配置了ndk架构过滤，仅保留arm架构支持，构建出的安装包无法在x86架构模拟器上运行。检查对应配置，debug构建阶段加入x86架构支持：

  android {
      defaultConfig {
          ndk {
              abiFilters 'x86_64', 'x86', 'armeabi-v7a', 'arm64-v8a'
          }
      }
  }
  

• 同包名应用残留冲突
  之前安装过同包名的应用，卸载残留会导致新包安装失败但构建日志不抛出明显错误。先执行命令卸载残留应用再重新安装：adb uninstall cash.dat.mobile

排查技巧 #

排查前先执行adb devices确认模拟器已被电脑正常识别，再执行adb logcat | grep -i "package manager"查看安装阶段的隐式报错，90%以上无构建错误但应用不显示的问题，本质是安装流程未实际执行完成。

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