安装与配置 #
系统要求 #
Windows 开发环境 #
text
┌─────────────────────────────────────────────────────────────┐
│ Windows 系统要求 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 操作系统： │
│ - Windows 10 版本 2004+ (推荐) │
│ - Windows 11 │
│ │
│ 硬件要求： │
│ - CPU: 1.8 GHz 或更快的双核处理器 │
│ - 内存: 8 GB RAM (推荐 16 GB) │
│ - 硬盘: 20 GB 可用空间 (SSD 推荐) │
│ - 显卡: 支持 DirectX 11 │
│ │
│ 开发目标： │
│ ✅ Android 应用 │
│ ✅ iOS 应用 (需要 Mac 进行编译) │
│ ✅ Windows 应用 (UWP) │
│ │
└─────────────────────────────────────────────────────────────┘
macOS 开发环境 #
text
┌─────────────────────────────────────────────────────────────┐
│ macOS 系统要求 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 操作系统： │
│ - macOS 10.15 (Catalina) 或更高版本 │
│ - macOS 12 (Monterey) 推荐 │
│ │
│ 硬件要求： │
│ - CPU: Intel Core i5 或 Apple Silicon (M1/M2) │
│ - 内存: 8 GB RAM (推荐 16 GB) │
│ - 硬盘: 20 GB 可用空间 (SSD 推荐) │
│ │
│ 开发目标： │
│ ✅ iOS 应用 │
│ ✅ Android 应用 │
│ ✅ macOS 应用 │
│ │
└─────────────────────────────────────────────────────────────┘
安装 Visual Studio #
Windows 版本安装 #
步骤 1：下载 Visual Studio #
text
┌─────────────────────────────────────────────────────────────┐
│ 下载 Visual Studio │
├─────────────────────────────────────────────────────────────┤
│ │
│ 访问官网： │
│ https://visualstudio.microsoft.com/downloads/ │
│ │
│ 版本选择： │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Visual Studio Community - 免费，适合个人学习 │ │
│ │ Visual Studio Professional - 付费，适合专业开发 │ │
│ │ Visual Studio Enterprise - 付费，适合企业团队 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ 推荐下载：Visual Studio Community (免费) │
│ │
└─────────────────────────────────────────────────────────────┘
步骤 2：选择工作负载 #
text
┌─────────────────────────────────────────────────────────────┐
│ 工作负载选择 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 必选工作负载： │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ☑ 使用 .NET 的移动开发 │ │
│ │ - Xamarin 开发工具 │ │
│ │ - Android SDK │ │
│ │ - Android 模拟器 │ │
│ │ - .NET Core SDK │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ 可选工作负载： │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ☐ ASP.NET 和 Web 开发 │ │
│ │ ☐ Azure 开发 │ │
│ │ ☐ .NET 桌面开发 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
步骤 3：安装过程 #
text
┌─────────────────────────────────────────────────────────────┐
│ 安装进度 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 安装组件： │
│ ├── Visual Studio 核心编辑器 │
│ ├── Xamarin 工具 │
│ ├── Android SDK │
│ ├── Android 模拟器 │
│ ├── .NET Framework │
│ └── Java JDK │
│ │
│ 预计时间：20-40 分钟 (取决于网速) │
│ │
│ 磁盘空间：约 15-20 GB │
│ │
└─────────────────────────────────────────────────────────────┘
macOS 版本安装 #
步骤 1：安装 Xcode #
text
┌─────────────────────────────────────────────────────────────┐
│ 安装 Xcode │
├─────────────────────────────────────────────────────────────┤
│ │
│ 方式一：App Store │
│ 1. 打开 App Store │
│ 2. 搜索 "Xcode" │
│ 3. 点击 "获取" 安装 │
│ │
│ 方式二：Apple Developer 网站 │
│ https://developer.apple.com/download/ │
│ │
│ 首次运行： │
│ 安装完成后，打开 Xcode 接受许可协议 │
│ │
│ 大小：约 10-15 GB │
│ │
└─────────────────────────────────────────────────────────────┘
步骤 2：安装 Visual Studio for Mac #
text
┌─────────────────────────────────────────────────────────────┐
│ Visual Studio for Mac │
├─────────────────────────────────────────────────────────────┤
│ │
│ 下载地址： │
│ https://visualstudio.microsoft.com/vs/mac/ │
│ │
│ 安装步骤： │
│ 1. 下载 .dmg 文件 │
│ 2. 双击打开，拖动到应用程序文件夹 │
│ 3. 首次启动时选择工作负载 │
│ │
│ 工作负载： │
│ ☑ .NET 移动开发 │
│ ☑ Android │
│ ☑ iOS │
│ │
└─────────────────────────────────────────────────────────────┘
配置 Android 开发环境 #
Android SDK 配置 #
text
┌─────────────────────────────────────────────────────────────┐
│ Android SDK 配置 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 打开：Tools → Android → Android SDK Manager │
│ │
│ 推荐安装的 SDK 平台： │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ SDK Platform │ API Level │ 用途 │ │
│ ├──────────────────────┼───────────┼─────────────────┤ │
│ │ Android 13 │ 33 │ 最新稳定版 │ │
│ │ Android 12L │ 32 │ 平板优化版 │ │
│ │ Android 12 │ 31 │ 主流版本 │ │
│ │ Android 11 │ 30 │ 广泛使用 │ │
│ └──────────────────────┴───────────┴─────────────────┘ │
│ │
│ SDK Tools： │
│ ☑ Android SDK Build-Tools │
│ ☑ Android Emulator │
│ ☑ Android SDK Platform-Tools │
│ ☑ Intel x86 Emulator Accelerator (HAXM) │
│ │
└─────────────────────────────────────────────────────────────┘
创建 Android 模拟器 #
text
┌─────────────────────────────────────────────────────────────┐
│ Android 模拟器配置 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 打开：Tools → Android → Android Device Manager │
│ │
│ 推荐设备配置： │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 设备名称：Pixel 5 │ │
│ │ 分辨率：1080 x 2340 │ │
│ │ API 级别：33 (Android 13) │ │
│ │ CPU/ABI：x86_64 │ │
│ │ 内存：2048 MB │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ 性能优化： │
│ - 启用硬件加速 (HAXM/Hyper-V) │
│ - 使用 x86/x86_64 镜像 │
│ - 分配足够的 RAM │
│ │
└─────────────────────────────────────────────────────────────┘
配置环境变量 #
bash
# Windows 环境变量
ANDROID_SDK_ROOT=C:\Program Files (x86)\Android\android-sdk
JAVA_HOME=C:\Program Files\Microsoft\jdk-11.0.12
# macOS/Linux 环境变量 (添加到 ~/.bash_profile 或 ~/.zshrc)
export ANDROID_SDK_ROOT=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_SDK_ROOT/emulator
export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools
配置 iOS 开发环境 #
Xcode 配置 #
text
┌─────────────────────────────────────────────────────────────┐
│ Xcode 配置 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. 接受许可协议 │
│ sudo xcodebuild -license accept │
│ │
│ 2. 安装命令行工具 │
│ xcode-select --install │
│ │
│ 3. 配置开发者账户 │
│ Xcode → Preferences → Accounts │
│ 添加 Apple ID │
│ │
│ 4. 下载模拟器 │
│ Xcode → Preferences → Components │
│ 下载需要的 iOS 模拟器 │
│ │
└─────────────────────────────────────────────────────────────┘
配置 Apple 开发者账户 #
text
┌─────────────────────────────────────────────────────────────┐
│ Apple 开发者账户 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 账户类型： │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 免费账户 (个人 Apple ID) │ │
│ │ - 可在模拟器测试 │ │
│ │ - 可在真机测试 (7 天有效期) │ │
│ │ - 无法发布到 App Store │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 付费账户 ($99/年) │ │
│ │ - 可在真机测试 │ │
│ │ - 可发布到 App Store │ │
│ │ - 完整的开发者功能 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
配置 Mac 与 Windows 连接 #
text
┌─────────────────────────────────────────────────────────────┐
│ Mac 连接配置 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 场景：Windows 开发，Mac 编译 iOS 应用 │
│ │
│ 步骤： │
│ 1. Mac 上启用远程登录 │
│ 系统偏好设置 → 共享 → 远程登录 │
│ │
│ 2. Windows Visual Studio 连接 Mac │
│ 工具 → 选项 → Xamarin → iOS 设置 │
│ 点击 "检查连接" │
│ │
│ 3. 输入 Mac 的 SSH 凭据 │
│ - Mac IP 地址或主机名 │
│ - 用户名和密码 │
│ │
│ 4. 等待连接完成 │
│ 首次连接需要几分钟配置 │
│ │
└─────────────────────────────────────────────────────────────┘
创建第一个项目 #
使用 Visual Studio 创建项目 #
text
┌─────────────────────────────────────────────────────────────┐
│ 创建 Xamarin.Forms 项目 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 步骤： │
│ 1. 文件 → 新建 → 项目 │
│ 2. 搜索 "Xamarin.Forms" │
│ 3. 选择 "移动应用 (Xamarin.Forms)" │
│ 4. 配置项目： │
│ - 项目名称：MyFirstApp │
│ - 位置：选择保存路径 │
│ - 解决方案名称：MyFirstApp │
│ │
│ 5. 选择模板： │
│ ☑ 空白应用 │
│ ☑ 使用 .NET Standard 共享代码 │
│ │
│ 6. 选择平台： │
│ ☑ Android │
│ ☑ iOS │
│ ☐ UWP (可选) │
│ │
└─────────────────────────────────────────────────────────────┘
项目结构 #
text
MyFirstApp/
├── MyFirstApp/ # 共享代码项目
│ ├── App.xaml # 应用程序定义
│ ├── App.xaml.cs # 应用程序逻辑
│ ├── MainPage.xaml # 主页面 XAML
│ ├── MainPage.xaml.cs # 主页面代码
│ └── AssemblyInfo.cs # 程序集信息
│
├── MyFirstApp.Android/ # Android 平台项目
│ ├── MainActivity.cs # Android 入口
│ ├── AndroidManifest.xml # Android 清单
│ └── Resources/ # Android 资源
│ ├── layout/
│ ├── values/
│ └── drawable/
│
├── MyFirstApp.iOS/ # iOS 平台项目
│ ├── AppDelegate.cs # iOS 入口
│ ├── Info.plist # iOS 配置
│ └── Resources/ # iOS 资源
│
└── MyFirstApp.UWP/ # UWP 平台项目 (可选)
├── MainPage.xaml
└── Package.appxmanifest
运行项目 #
text
┌─────────────────────────────────────────────────────────────┐
│ 运行项目 │
├─────────────────────────────────────────────────────────────┤
│ │
│ Android 运行： │
│ 1. 选择 MyFirstApp.Android 作为启动项目 │
│ 2. 选择目标设备 (模拟器或真机) │
│ 3. 按 F5 或点击 "启动调试" │
│ │
│ iOS 运行： │
│ 1. 选择 MyFirstApp.iOS 作为启动项目 │
│ 2. 选择目标设备 (模拟器或真机) │
│ 3. 按 F5 或点击 "启动调试" │
│ │
│ 首次运行： │
│ - 需要下载依赖包 │
│ - 需要配置模拟器 │
│ - 可能需要几分钟 │
│ │
└─────────────────────────────────────────────────────────────┘
开发工具推荐 #
Visual Studio 扩展 #
text
┌─────────────────────────────────────────────────────────────┐
│ 推荐扩展 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 必装扩展： │
│ ├── Xamarin.Forms Previewer - XAML 预览 │
│ ├── XAML Styler - XAML 格式化 │
│ ├── ReSharper - 代码分析 (付费) │
│ └── NuGet Package Manager - 包管理 │
│ │
│ 推荐扩展： │
│ ├── Productivity Power Tools - 效率工具 │
│ ├── CodeMaid - 代码清理 │
│ ├── OzCode - 调试增强 (付费) │
│ └── VSColorOutput - 输出着色 │
│ │
└─────────────────────────────────────────────────────────────┘
第三方工具 #
text
┌─────────────────────────────────────────────────────────────┐
│ 第三方工具 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 设计工具： │
│ ├── Figma - UI 设计 │
│ ├── Sketch - UI 设计 (macOS) │
│ └── Adobe XD - UI 设计 │
│ │
│ 测试工具： │
│ ├── App Center - 自动化测试和分发 │
│ ├── Xamarin.UITest - UI 自动化测试 │
│ └── TestCloud - 云端测试 │
│ │
│ 调试工具： │
│ ├── Charles Proxy - 网络抓包 │
│ ├── Android Device Monitor - Android 调试 │
│ └── Xcode Instruments - iOS 性能分析 │
│ │
└─────────────────────────────────────────────────────────────┘
常见问题解决 #
Android 模拟器问题 #
text
┌─────────────────────────────────────────────────────────────┐
│ 常见问题 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 问题：模拟器启动失败 │
│ 解决： │
│ 1. 确保启用 Hyper-V (Windows) 或 HAXM (macOS) │
│ 2. 检查 BIOS 中虚拟化是否开启 │
│ 3. 使用 x86_64 镜像而非 ARM │
│ │
│ 问题：模拟器运行缓慢 │
│ 解决： │
│ 1. 增加模拟器内存 │
│ 2. 启用硬件加速 │
│ 3. 使用较新的 API 级别 │
│ │
│ 问题：无法连接 ADB │
│ 解决： │
│ 1. 重启 ADB 服务：adb kill-server && adb start-server │
│ 2. 检查 ANDROID_SDK_ROOT 环境变量 │
│ 3. 重启 Visual Studio │
│ │
└─────────────────────────────────────────────────────────────┘
iOS 连接问题 #
text
┌─────────────────────────────────────────────────────────────┐
│ Mac 连接问题 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 问题：无法连接 Mac │
│ 解决： │
│ 1. 确认 Mac 已启用远程登录 │
│ 2. 检查防火墙设置 │
│ 3. 确认 SSH 端口 (22) 未被阻止 │
│ 4. 尝试手动 SSH 连接测试 │
│ │
│ 问题：Xcode 许可问题 │
│ 解决： │
│ sudo xcodebuild -license accept │
│ │
│ 问题：证书配置问题 │
│ 解决： │
│ 1. 在 Xcode 中登录开发者账户 │
│ 2. 自动签名配置 │
│ 3. 检查证书有效期 │
│ │
└─────────────────────────────────────────────────────────────┘
构建错误 #
text
┌─────────────────────────────────────────────────────────────┐
│ 构建错误 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 问题：NuGet 包还原失败 │
│ 解决： │
│ 1. 清理解决方案：Build → Clean Solution │
│ 2. 删除 bin 和 obj 文件夹 │
│ 3. 删除 .vs 文件夹 │
│ 4. 重新还原 NuGet 包 │
│ │
│ 问题：Android 资源错误 │
│ 解决： │
│ 1. 检查资源文件名 (只能用小写字母和下划线) │
│ 2. 清理并重新构建 │
│ 3. 检查 AndroidManifest.xml │
│ │
│ 问题：iOS 签名错误 │
│ 解决： │
│ 1. 检查 Provisioning Profile │
│ 2. 更新开发者证书 │
│ 3. 使用自动签名 │
│ │
└─────────────────────────────────────────────────────────────┘
下一步 #
现在你已经搭建好了 Xamarin 开发环境，接下来学习 基础概念，开始了解 Xamarin.Forms 的核心概念！
最后更新：2026-03-29