MAUI Blazor Hybrid怎么用 MAUI Blazor入门教程

MAUI Blazor Hybrid 是 .NET 中融合原生跨平台能力（MAUI）与 Web UI 开发体验（Blazor）的方案，支持用 C# 编写 Razor 组件并调用摄像头、蓝牙、NFC 等设备功能；需 Visual Studio 2025 v17.12+ 及对应工作负载，项目入口为 wwwroot/index.html，通过 MAUI Essentials 或平台服务注入实现原生能力调用，权限须在各平台配置文件中声明。

MAUI Blazor Hybrid 是 .NET 生态中把原生跨平台能力（MAUI）和 Web UI 开发体验（Blazor）结合起来的方案，适合想用 C# 写界面、又需要调用摄像头、蓝牙、NFC、本地数据库等设备功能的场景。它不是纯 Web 应用，也不是传统 MAUI XAML 应用，而是“Blazor 组件跑在 MAUI 容器里”，页面逻辑用 Razor + C#，底层由 MAUI 提供平台桥接。

环境准备和项目创建

必须安装 Visual Studio 2025 v17.12 或更高版本，并启用两个工作负载：

• .NET Multi-Platform App UI 开发
• ASP.NET 和 Web 开发

创建方式有两种：

• 在 Visual Studio 中：新建项目 → 筛选 “.NET MAUI Blazor Hybrid 应用” 模板 → 命名、选择框架（推荐 .NET 9 或 .NET 10）→ 创建
• 在 VS Code 中：安装 .NET MAUI 扩展 + .NET SDK + MAUI 工作负载 → 命令面板输入 “.NET: Create Project” → 选 “.NET MAUI Blazor Hybrid App”

项目生成后，结构类似普通 MAUI，但 wwwroot/index.html 是入口，Pages/ 下是 Razor 组件，Platforms/ 下可写平台专用代码。

运行和调试多平台目标

刚创建的项目默认支持 Windows、Android、iOS（需 Mac）、macOS。常用启动方式：

• Windows：工具栏选 “Windows Machine” → 自动拉起桌面窗口（需开启开发者模式）
• Android：选 “Android Emulator” → 首次会提示安装 Android SDK 和接受许可证
• iOS/macOS：需在 macOS 上用 VS for Mac 或 CLI 构建，Windows 上无法直接部署

注意：不同平台的权限（如相机、位置、蓝牙）需在对应 Platforms/xxx/Info.plist 或 AndroidManifest.xml 中声明，否则运行时会拒绝访问。

接入原生能力（比如摄像头、蓝牙）

MAUI Blazor Hybrid 的核心优势是能无缝调用原生 API。不是靠 JS 互操作硬桥接，而是通过 MAUI 的 Microsoft.Maui.Essentials 或平台服务注入：

• 摄像头：用 MediaPicker.CapturePhotoAsync() 直接拍照，返回 FileResult，再转成 base64 或保存到本地
• 蓝牙 BLE：引用 Plugin.BluetoothLE 或使用 MAUI Community Toolkit 的 BluetoothLE 封装，从 Blazor 页面通过 @inject 获取服务实例调用
• 本地设置：用 Preferences.Set("key", value) 存取轻量数据，比手写文件更安全可靠

如果官方组件不支持某功能（比如 NFC），可在 Platforms/Android/MainActivity.cs 中扩展 Java/Kotlin 代码，再通过 MAUI 的 DependencyService 或 MauiHandlers 暴露给 Blazor 层。

UI 库与样式定制

默认 UI 是基础 HTML + Bootstrap CSS。想提升体验，推荐集成 BootstrapBlazor：

• NuGet 引入：BootstrapBlazor 和 BootstrapBlazor.FontAwesome（v7.*）
• 在 wwwroot/index.html 的 中添加 CSS 引用：
• Razor 页面中直接使用组件，如 点我

自定义主题只需改 wwwroot/css/app.css，或引入 Tailwind、Bulma 等现代 CSS 框架，Blazor 组件自动响应。

基本上就这些。起步不复杂，但容易忽略权限配置和平台初始化细节。只要环境搭好、模板跑通、第一个摄像头按钮点出来，后续加数据库、蓝牙、NFC 就是按模块叠加的事。

# css  # java  # html  # android  # js  # bootstrap  # windows  # app  # 工具  # mac  # ai  # ios 

相关文章： 微网站制作教程,我微信里的网站怎么才能复制到浏览器里？  个人网站制作流程图片大全,个人网站如何注销？  国美网站制作流程,国美电器蒸汽鍋怎么用官方网站？  如何在阿里云香港服务器快速搭建网站？  网站设计制作企业有哪些,抖音官网主页怎么设置？  Python路径拼接规范_跨平台处理说明【指导】  杭州银行网站设计制作流程,杭州银行怎么开通认证方式？  Python文件管理规范_工程实践说明【指导】  c++23 std::expected怎么用 c++优雅处理函数错误返回【详解】  如何快速搭建FTP站点实现文件共享？  山东云建站价格为何差异显著？  如何通过wdcp面板快速创建网站？  合肥做个网站多少钱,合肥本地有没有比较靠谱的交友平台？  php能控制zigbee模块吗_php通过串口与cc2530 zigbee通信【介绍】  宝盒自助建站智能生成技巧：SEO优化与关键词设置指南  网站规划与制作是什么,电子商务网站系统规划的内容及步骤是什么？  如何用IIS7快速搭建并优化网站站点？  ppt制作免费网站有哪些,ppt模板免费下载网站？  如何通过WDCP绑定主域名及创建子域名站点？  制作网站建设的公司有哪些,网站建设比较好的公司都有哪些？  网站按钮制作软件,如何实现网页中按钮的自动点击？  红河网站制作公司,红河事业单位身份证如何上传？  武汉网站如何制作,黄黄高铁武穴北站途经哪些村庄？  php条件判断怎么写_ifelse和switchcase的使用区别【对比】  小捣蛋自助建站系统：数据分析与安全设置双核驱动网站优化  如何零基础开发自助建站系统？完整教程解析  如何用手机制作网站和网页,手机移动端的网站能制作成中英双语的吗？  建站之星多图banner生成与模板自定义指南  如何在西部数码注册域名并快速搭建网站？  网站制作公司排行榜,四大门户网站排名？  小建面朝正北，A点实际方位是否存在偏差？  无锡制作网站公司有哪些,无锡优八网络科技有限公司介绍？  Android使用GridView实现日历的简单功能  如何通过虚拟机搭建网站？详细步骤解析  公司网站设计制作厂家,怎么创建自己的一个网站？  平台云上自主建站：模板化设计与智能工具打造高效网站  制作网页的网站有哪些,电脑上怎么做网页？  宿州网站制作公司兴策,安徽省低保查询网站？  较简单的网站制作软件有哪些,手机版网页制作用什么软件？  内部网站制作流程,如何建立公司内部网站？  在线制作视频网站免费,都有哪些好的动漫网站？  活动邀请函制作网站有哪些,活动邀请函文案？  如何通过老薛主机一键快速建站？  长沙企业网站制作哪家好,长沙水业集团官方网站？  制作企业网站建设方案,怎样建设一个公司网站？  如何选购建站域名与空间？自助平台全解析  网站制作公司哪里好做,成都网站制作公司哪家做得比较好，更正规？  如何通过西部数码建站助手快速创建专业网站？  魔方云NAT建站如何实现端口转发？  如何在Golang中使用replace替换模块_指定本地或远程路径