MacOS运行ns run、ns doctor android提示ANDROID_HOME环境变量未设置

步骤1：确认当前使用的shell #

执行命令：
echo $SHELL
如果输出是/bin/zsh，说明你使用的是MacOS Catalina及以上版本默认的zsh shell，修改.bash_profile不会生效，需要修改zsh对应的配置文件。

步骤2：写入正确的环境变量配置 #

如果是zsh shell：
执行以下命令：

cd ~
touch .zshrc
open -e .zshrc

在打开的文件中粘贴以下内容：

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/emulator

保存关闭文件后，执行source ~/.zshrc让配置立即生效。

如果确认使用的是bash shell，执行source ~/.bash_profile让之前写入的配置生效，也可以在~/.bashrc文件中添加source ~/.bash_profile，确保每次打开终端配置都会自动加载。

步骤3：验证ANDROID_HOME配置有效性 #

执行命令：
echo $ANDROID_HOME
输出应该为/Users/你的用户名/Library/Android/sdk
再执行ls $ANDROID_HOME，确认能正常列出platform-tools、build-tools等文件夹，没有目录不存在的报错。如果报错目录不存在，打开Android Studio，进入Settings -> Appearance & Behavior -> System Settings -> Android SDK，复制顶部显示的Android SDK Location路径，替换掉ANDROID_HOME后面的路径即可。

步骤4：验证SDK版本符合要求 #

执行sdkmanager --list，确认已安装版本≥28的Android SDK Platform，以及版本在23到30之间的Android SDK Build-Tools。如果缺少对应版本，可直接在Android Studio的SDK Manager界面勾选安装，也可以执行命令安装：
sdkmanager "platforms;android-30" "build-tools;30.0.3"

步骤5：验证环境配置 #

重启终端后执行ns doctor android，所有Android环境相关的报错都会消失。

额外版本兼容优化 #

你的项目中@nativescript/core和@nativescript/android版本和全局安装的nativescript 8.1.2版本不匹配，可在项目目录下执行以下命令升级，避免后续出现兼容问题：
npm install @nativescript/core@8.1.3 @nativescript/android@8.1.1

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