执行npx cap run android时遇ERR_SDK_NOT_FOUND错误求助（Ubuntu）

• 验证ANDROID_SDK_ROOT的有效性

  1. 在终端执行 echo $ANDROID_SDK_ROOT，确认输出路径是否为Android SDK实际安装目录（通常为/home/[你的用户名]/Android/Sdk）。
  2. 检查该路径下是否存在platforms、build-tools、emulator等核心目录，若缺少则说明Android Studio未完整安装SDK组件。
  3. 执行 ls -ld $ANDROID_SDK_ROOT 确认当前用户拥有该目录的读写权限，若权限不足，运行 sudo chown -R $USER:$USER $ANDROID_SDK_ROOT 修改权限。

• 确保环境变量持久化配置
  临时配置的环境变量会在终端重启后失效，需写入配置文件：

  1. 打开~/.bashrc（Bash终端）或~/.zshrc（Zsh终端），添加以下内容：

     export ANDROID_SDK_ROOT="/home/[你的用户名]/Android/Sdk"
     export PATH="$ANDROID_SDK_ROOT/tools:$ANDROID_SDK_ROOT/platform-tools:$PATH"
     

  2. 执行 source ~/.bashrc 或 source ~/.zshrc 使配置生效，重启终端后重新尝试命令。

• 在Capacitor配置中明确指定SDK路径
  编辑项目根目录下的capacitor.config.ts，手动添加SDK路径配置：

  import { CapacitorConfig } from '@capacitor/cli';
  
  const config: CapacitorConfig = {
    appId: 'com.your.app',
    appName: 'your-app-name',
    webDir: 'dist',
    android: {
      sdkPath: '/home/[你的用户名]/Android/Sdk',
      androidStudioPath: '/usr/local/android-studio' // 你的Android Studio安装路径
    }
  };
  
  export default config;
  

  保存后执行 npx cap sync android，再重新运行 npx cap run android。

• 检查Android Studio SDK组件完整性

  1. 打开Android Studio，进入Tools > SDK Manager。
  2. 确认已安装项目targetSdkVersion对应的Android SDK Platform、最新版Android SDK Build-Tools以及Android SDK Command-line Tools。
  3. 安装缺失组件后，回到终端重试命令。

• 验证SDK工具可用性

  1. 执行 adb version，若能显示版本信息则说明platform-tools配置正常。
  2. 执行 sdkmanager --list，若能列出SDK组件则说明command-line tools配置正常。
  3. 若命令找不到，回到环境变量配置步骤检查PATH是否包含SDK工具目录。

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