Xamarin Forms项目拉取GitHub仓库后找不到Mono.Android引用无法构建调试
问题根因说明
出现Mono.Android引用无法解析、跨设备拉取仓库后项目文件不全的问题,核心由两点导致:
- 新安装VS2019的PC未部署完整的Xamarin Android开发配套组件,无法识别本地安装的Mono.Android程序集路径
- 原项目提交Git时,通过.gitignore过滤了本地生成的平台关联配置、编译缓存类文件,这类文件本身属于用户端本地生成内容,不会随仓库同步;即使手动从原PC拷贝文件,因为两台PC的SDK安装路径不一致,引用绑定关系也无法自动生效
项目状态参考截图:
个人PC正常的解决方案结构:
另一台PC拉取仓库后的解决方案结构:
个人PC正常的解决方案文件夹目录:
个人PC正常的项目特定配置文件夹:
另一台PC缺失文件的项目特定文件夹:
构建过程弹出的引用警告提示:
分步解决操作
1. 补全新PC的VS开发组件
- 启动Visual Studio Installer,找到已安装的Visual Studio 2019 Community版本,点击「修改」
- 切换到「工作负载」配置页,勾选使用.NET的移动开发选项,在右侧的安装详情面板中,确认以下子项全部勾选:
- Xamarin Android SDK
- Android SDK 安装程序
- 适用于Windows的Android SDK 设置
- Google Android Emulator
- 切换到「单个组件」配置页,找到和原开发PC版本一致的Xamarin.Android SDK版本勾选安装,避免跨版本兼容问题
- 等待组件安装完成后重启Visual Studio
2. 清理本地项目缓存配置
- 关闭所有打开的Visual Studio窗口,进入拉取完成的项目本地目录,删除以下文件/文件夹:
- 根目录下的隐藏
.vs配置文件夹 - Android平台项目目录下的
bin、obj编译缓存文件夹 - 跨平台共享代码项目目录下的
bin、obj编译缓存文件夹
- 根目录下的隐藏
3. 重新绑定Mono.Android程序集引用
- 重新通过Visual Studio打开解决方案,等待IDE自动完成SDK路径识别
- 在解决方案资源管理器中展开Android平台项目的「引用」节点,找到带黄色警告标记的
Mono.Android引用,右键选择「移除」 - 右键Android项目节点,依次选择「添加」→「程序集引用」,在系统已安装的框架列表中找到对应版本的
Mono.Android,勾选后确认添加 - 右键解决方案根节点,依次选择「清理解决方案」→「重新生成解决方案」
4. 验证部署调试能力
- 构建完成后,检查输出窗口的日志,确认不存在
Mono.Android绑定失败的警告 - 在顶部调试工具栏选择已连接的物理移动设备或配置完成的Android模拟器作为调试目标,执行部署、调试流程即可正常使用
内容的提问来源于stack exchange,提问作者Arturo Daza Bohorquez
相关产品推荐
相关产品推荐







