当前位置:

首页 > 编程开发 > c#如何使用MAUI开发移动应用_c#MAUI开发移动应用最全用法总结

c#如何使用MAUI开发移动应用_c#MAUI开发移动应用最全用法总结

MAUI并非Xamarin.Forms升级版,而是全新架构。开发需遵循其规则:入口逻辑统一在MauiProgram.cs中,导航使用Shell与路由注册,原生API调用需补全平台权限声明,自定义控件通过Handler替代渲染器且注册严格。

本文目录

    先澄清一个基础认知:MAUI 不是 Xamarin.Forms 的升级版,而是从头设计的全新架构。拿它做移动应用开发,技术路线上完全可行,但前提是必须接受它自己的那一套规则——生命周期怎么跑、依赖注入怎么挂、平台专属逻辑往哪放,这些都得按 MAUI 的方式组织。否则,iOS 启动白屏、Android 资源找不到、热重载看似成功界面却纹丝不动,这些坑几乎一个都躲不掉。

    说到这,有个关键点必须先讲清楚:MAUI 的入口逻辑已经彻底变了。过去 Xamarin.Forms 时代,大家习惯在 App.xaml.cs 的构造函数里写服务注册、初始化数据库这些操作,但 MAUI 已经明确废弃了这种模式。所有服务注册、配置加载、字体和图标注入,必须统一收口到 MauiProgram.CreateMauiApp() 方法里。举个例子,MauiAppBuilder.Services.AddSingleton() 才是注册单例的正确位置,而不是在 App.xaml.cs 里搞。另外,平台专属的初始化逻辑,比如 Android 的 Microsoft.Maui.Essentials.Platform.Init(),框架已经自动调用了,你再手动写一遍只会触发重复初始化异常。如果需要在启动时读取 appsettings.json 这类配置文件,也得用 builder.Configuration.AddJsonFile("appsettings.json"),并且文件的 Build Action 必须设为 MauiAsset——这个细节很容易被忽略,但一旦漏掉,运行时就找不到配置文件。

    导航机制:Shell 才是正道,PushAsync 别乱用

    页面导航这块,MAUI 默认模板启用的是 Shell,所有页面跳转都应该通过路由注册再加上 Shell.Current.GoToAsync("//pagekey") 来实现。如果你还沿用 Xamarin.Forms 的习惯,直接 new 一个页面然后调用 Na vigation.PushAsync(new Page()),在 Shell 模式下这个操作会静默失败,iOS 上甚至可能直接卡死。路由注册必须在 MauiProgram.cs 中完成,写法是 Routing.RegisterRoute("detail", typeof(DetailPage)),而不是去改什么 Handler 配置。当然,如果你确实不想用 Shell,也可以走纯 Na vigationPage 路线,但需要在 App.xaml.cs 里明确设置 MainPage = new Na vigationPage(new HomePage()),并且后续所有跳转都必须基于这个根 Na vigationPage 实例。另外,GoToAsync 的 URI 支持 //(绝对路径)、/(相对路径)和 ..(返回上层),但它不支持查询参数的自动绑定,你要么手动解析 Shell.Current.State.Location.QueryString,要么自己封装一个参数传递机制。

    原生 API 调用:权限声明是硬门槛,缺一个都不行

    用 Microsoft.Maui.Essentials 访问原生 API 看起来很简单,比如 Permissions.RequestAsync(),但实际跑起来,如果平台配置文件里缺少对应的权限声明,Android 上会直接抛 Ja va.Lang.SecurityException,iOS 上则是静默拒绝——而且错误信息里根本不会提示你缺了哪项配置。所以,动手之前必须先补全平台配置:iOS 要在 Platforms/iOS/Info.plist 里加键值对,比如定位就要加 NSLocationWhenInUseUsageDescription需要访问位置以显示附近门店;Android 则要在 Platforms/Android/AndroidManifest.xml 的 标签外添加权限声明,像 这种。另外,存敏感数据时别用 Preferences.Set("token", value),它在模拟器上可能没问题,但真机因为沙盒路径变化有时会写入失败,建议改用 SecureStorage.SetAsync("token", value)。

    自定义控件:Handler 替代了渲染器,注册方式极其严格

    你要是想改 Android 上 Button 的圆角,或者 iOS 上 Entry 的边框颜色,千万别再去找 ExportRenderer 了——MAUI 已经用 IViewHandler 和平台专属的 Handler 类替代了旧的自定义渲染器。但它的注册方式和类型匹配要求非常严格。举个例子,你需要继承 ButtonHandler(不是 ViewHandler),然后重写 ConnectHandler 或 DisconnectHandler。注册时写成 handlers.AddHandler(),泛型参数和类型必须完全匹配,否则运行时会静默回退到默认样式,连个警告都没有。更麻烦的是,iOS 的 UIButton 和 Android 的 MaterialButton 属性名差异很大,比如设置圆角:iOS 要用 Control.Layer.CornerRadius,而 Android 得改 Control.Background 的 ShapeAppearanceModel。这个细节往往需要查平台文档才能确认。

    说白了,MAUI 的“一次编写、多端运行”确实能实现,但前提是你得接受它的约束:Shell 导航模型、平台配置的硬性要求、Handler 注册机制——这些都不是可以绕过去的“建议”,而是必须遵守的规则。如果还套用 Xamarin.Forms 的经验去写,问题会变得更加隐蔽。比如热重载明明成功了,界面却纹丝不动,很多时候不是代码逻辑写错了,而是 Handler 没在 MauiProgram.cs 里正确注册。我甚至建议把“接受框架约束”当作 MAUI 开发的第一原则。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 C#
    相关文章 更多
    winforms教程自学入门与基础开发步骤详解
    winforms教程自学入门与基础开发步骤详解

    本教程详细讲解如何使用Visual Studio创建WinForms项目,通过添加按钮和标签控件并编写点击事件代码,实现一个基础的计数器功能,适合C#初学者快速上手Windows窗体应用开发。

    谈编程与编程语言
    谈编程与编程语言

    编程的本质是创造性的严谨翻译,通过for、if和函数调用实现重复计算任务。语言发展让集成度提高,门槛降低但竞争加剧。程序员需培养整体架构能力,抓住思想精髓而非追逐新技术,方能长远发展。

    什么是面向接口编程、面向过程编程、面向对象编程?
    什么是面向接口编程、面向过程编程、面向对象编程?

    面向接口编程通过接口解耦,降低耦合度并提升可扩展性和维护性,是面向对象思想的精髓。面向过程编程将问题拆解为步骤,用函数依次执行。面向对象编程将事物抽象为对象,封装属性和方法,通过对象协作解决问题。

    我对编程的一些感悟
    我对编程的一些感悟

    编程这件事,说到底是门手艺活,但又不全是手艺。把代码写出来容易,把代码写好、写出境界,那就得看功夫了。今天聊几个核心判断,算是多年敲键盘的一点沉淀。 一、语言是功夫,思路是内功 编程语言五花八门,就像武林高手会的功夫一样,但想成为顶尖高手,内功必须深厚。内功到了,学新功夫就是分分钟的事。看过《倚天屠

    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程
    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程

    abstract类不能被直接实例化,子类必须用override实现其所有抽象方法。抽象类可实现接口,并以抽象方法转发接口成员。抽象类不能与sealed共用,其抽象方法默认隐式virtual且无方法体。可包含字段、属性等非抽象成员。

    c#如何删除文件_c#删除文件的正确用法与注意事项
    c#如何删除文件_c#删除文件的正确用法与注意事项

    C#删除文件前应先判断存在性以防异常,注意权限不足和文件被占用。File.Delete与FileInfo.Delete功能相同,后者适合多次操作。无异步删除方法,推荐后台执行或限流以避免阻塞。

    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点
    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点

    在EmguCV中,进行Bitmap转Image时,需先转为24位无Alpha格式,以避免颜色错乱问题;Image转Bitmap时,建议使用Mat或ImageBox控件,以有效减少内存拷贝;跨线程处理时,应使用Mat.Clone()进行深拷贝,以确保数据安全;DLL加载失败时,需设置x64平台目标,并确保native库在输出目录中。

    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】
    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】

    C#图表生成中,LiveCharts需用ChartValues数据集合,并在更新后触发重绘;OxyPlot饼图需启用交互与标签;包引用务必注意版本适配;导出图片需在布局完成后操作,并校正DPI缩放以确保清晰度。

    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】
    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】

    ASP.NETCore过滤器需关注执行顺序、作用域与DI生命周期。接口实现需手动注册,特性继承更常用但需满足构造函数要求。全局注册时注意scoped服务注入问题,Order值须显式设置以控制同类型过滤器执行顺序。异常过滤器仅捕获操作方法内异常,模型绑定与授权失败须分别处理。

    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例
    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例

    实现全局鼠标钩子需使用SetWindowsHookEx配合WH_MOUSE_LL,窗体级事件仅捕获本进程消息。回调函数必须为静态且标记特定签名,禁止阻塞操作。通过Marshal.PtrToStructure解析lParam获取坐标与按键状态。钩子生命周期绑定线程,需注意注册线程持续运行并双重卸载,避免句柄泄漏。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。