Nativescript执行tns run android后模拟器不启动应用无连接怎么办

搁置1个月左右的项目出现该问题，核心诱因是环境版本自动更新导致的缓存失效、adb连接假死、配置偏移，按以下顺序排查修复即可：

1. 优先修复adb连接异常 #

• 终端执行adb devices校验模拟器连接状态，如果对应模拟器条目后显示offline/unauthorized，依次执行以下命令重启adb服务：

  adb kill-server
  adb start-server
  

• 打开模拟器的开发者选项页，确认「USB调试」「USB调试（安全设置）」「允许通过USB安装应用」三个开关为开启状态——安卓模拟器镜像更新后会自动重置开发者选项配置，哪怕之前开过也会被默认关闭。
• 打开Android Studio的AVD管理器，找到当前使用的模拟器进入编辑页，将启动选项从「Quick Boot（快速启动）」改为「Cold Boot（冷启动）」，保存后完全关闭模拟器再重新打开，快速启动的旧快照在环境更新后大概率出现adb连接假死，表现为能装应用但无法建立调试通道、拉不起应用。
• 执行tns run android前关闭所有会占用adb端口的程序：包括Android Studio的内置调试面板、第三方手机助手、其他跨端开发框架的CLI进程，端口被抢占时会出现CLI和模拟器通信中断的问题。

2. 全量清理缓存解决版本漂移问题 #

项目搁置期间本地NativeScript版本、安卓构建工具、SDK、项目依赖大概率有过自动更新，旧构建缓存和新版本不兼容是最高发的触发原因：

• 在项目根目录依次执行以下命令完成全量清理，不要跳步：

  # 终止所有运行中的NS相关进程
  tns device log stop
  # 清理NS项目构建缓存
  tns clean
  # 删除旧依赖和平台生成文件
  rm -rf node_modules platforms package-lock.json
  # 重新安装依赖
  npm install
  # 重新生成安卓平台工程文件
  tns platform add android
  

• 清理完成后先执行tns doctor android做环境校验，所有标红的报错全部按提示修复，尤其是提示缺少对应版本build-tools、platform SDK的问题，直接通过sdkmanager安装对应版本即可，不要用未正式发布的预览版SDK做开发。

3. 校验应用启动配置 #

如果以上两步操作后仍然存在安装完不启动的问题，检查启动入口配置：

• 打开路径app/App_Resources/Android/src/main/AndroidManifest.xml，确认作为启动页的Activity节点下的intent-filter包含以下两个配置项：

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

  部分NativeScript插件在版本更新后会篡改Manifest配置，替换或删除LAUNCHER分类，导致系统识别不到应用启动入口，表现为安装完成后桌面找不到图标、CLI无法自动拉起应用。
• 手动在模拟器桌面找到已安装的应用图标点击启动，如果手动启动直接闪退，执行adb logcat抓取崩溃日志，最常见的原因为搁置期间自动升级的插件版本和当前安卓平台版本不兼容，按日志提示降级冲突的插件版本即可。

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