如何在Android Studio或安卓移动设备上运行Ionic Capacitor应用？

问题1：执行ionic capacitor run android无设备可选、报TypeError: Cannot read property 'value' of undefined #

• 首先重启adb服务排除连接异常：

  adb kill-server
  adb start-server
  

• 执行adb devices确认设备状态为device，若显示unauthorized，需要在安卓设备弹窗中勾选「始终允许此计算机调试」后确认
• 升级Ionic CLI和Capacitor安卓依赖到最新版本，修复版本兼容问题：
  全局执行npm install -g @ionic/cli@latest，项目根目录执行npm install @capacitor/android@latest

问题2：ionic capacitor run android --open无法启动Android Studio #

需要手动配置CAPACITOR_ANDROID_STUDIO_PATH环境变量，按操作系统操作：

• Linux/macOS：
  编辑终端配置文件（bash用户编辑~/.bashrc，zsh用户编辑~/.zshrc），添加一行：

  export CAPACITOR_ANDROID_STUDIO_PATH="你的Android Studio实际安装路径"
  

  常见默认路径参考：
  • Linux：/home/用户名/android-studio/bin/studio.sh
  • macOS：/Applications/Android Studio.app/Contents/MacOS/studio
    保存后执行source ~/.bashrc（或对应配置文件）生效，执行echo $CAPACITOR_ANDROID_STUDIO_PATH验证配置是否正确
• Windows：
  打开系统环境变量设置，新建系统变量，变量名为CAPACITOR_ANDROID_STUDIO_PATH，变量值为Android Studio安装路径下的bin\studio64.exe，默认路径为C:\Program Files\Android\Android Studio\bin\studio64.exe
  配置完成后重启终端生效，执行echo %CAPACITOR_ANDROID_STUDIO_PATH%验证配置是否正确

问题3：adb可识别设备，但Capacitor无目标、指定target报错 #

• 首先确认项目已添加安卓平台，根目录执行npx cap add android（首次运行必须执行，若已添加可跳过）
• 检查安卓项目最低兼容版本：打开android/app/build.gradle，确认minSdkVersion数值低于等于当前设备的安卓系统版本，Capacitor 4+默认minSdkVersion为22（对应安卓5.1），设备版本过低会无法识别
• 若CLI识别始终异常，可直接通过Android Studio运行，稳定性更高：先执行npx cap sync android同步前端代码和插件到安卓项目，再打开Android Studio导入项目根目录下的android文件夹，直接在AS界面选择设备点击运行即可

正确运行通用步骤 #

• 提前开启安卓设备USB调试，连接电脑后授权调试请求，adb devices确认设备正常识别
• 项目根目录执行npm install安装所有依赖
• 首次运行执行npx cap add android添加安卓平台
• 每次修改前端代码后执行npx cap sync android同步资源到安卓项目
• 选择任意一种方式运行：
  • 命令行运行：环境变量配置完成后执行ionic capacitor run android，选择对应设备即可运行
  • Android Studio运行：执行npx cap open android启动AS，在AS顶部工具栏选择目标设备，点击运行按钮即可

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