eshop-mobile-client

eshop-mobile-client

基于.NET MAUI的跨平台移动电商应用示例

eshop-mobile-client是基于.NET MAUI开发的多平台电商应用示例,支持iOS、Android、macOS和Windows。该项目展示了产品目录管理、商品浏览、购物车操作和订单处理等核心功能。采用XAML、IoC容器、自定义控件等技术,呈现现代移动应用架构。开发者可选择连接实际微服务后端,深入体验完整的电商应用开发流程,是学习跨平台移动应用开发的理想参考。

.NET MAUI跨平台开发移动应用微服务eShopGithub开源项目

eshop-移动客户端

eShop示例应用程序已更新并移至https://github.com/dotnet/eShop。活跃开发将在那里继续。

eshop-移动客户端是一个参考.NET MAUI多平台客户端应用程序,其设想目的是为一家销售产品的虚构公司的移动员工提供服务。该应用程序允许您管理目录、查看产品以及管理购物篮和订单。

依赖项

虽然eshop-移动客户端移动应用依赖于eShopOnContainers仓库作为其后端,但默认情况下,它使用内部的MockServices实现所有功能。更多详情请参阅设置部分。

<img src="https://yellow-cdn.veclightyear.com/2b54e442/485f3bb0-8711-4f07-b462-275be4d8c0a3.png" alt="eShopOnContainers" Width="800" />

架构

应用程序架构包含两个部分:

  1. 一个适用于iOS、macOS、Android和Windows的.NET MAUI移动应用。
  2. 几个部署为Docker容器的.NET Web API微服务。

.NET MAUI应用

该项目涉及以下平台、框架和功能:

  • .NET MAUI
    • XAML
    • 行为
    • 绑定
    • 转换器
    • 中央样式
    • 动画
    • IoC
    • 消息中心
    • 自定义控件
    • xUnit测试
  • Azure移动服务
    • C#后端
    • WebAPI
    • Entity Framework
    • Identity Server 4

后端服务

所有与后端服务相关的代码和组件都在eShopOnContainers仓库中维护。

支持的平台

该应用针对四个平台:

  • iOS
  • Android
  • macOS(必须在Mac上构建和部署)
  • Windows(必须在Windows上构建和部署)

要求

  • Visual Studio 2022(2022或更高版本)以编译C#语言特性
    • 完全支持Visual Studio社区版!
  • Visual Studio的.NET MAUI插件(可通过Visual Studio安装程序获得)

设置

1. 确保已安装.NET MAUI平台

您可以按照安装.NET MAUI中提到的步骤进行操作。

2. 确保.NET MAUI已更新

Visual Studio会定期自动检查更新。您也可以使用更新Visual Studio选项手动检查更新。

3. 项目设置

恢复项目的NuGet包。

4. 确保已安装Android模拟器

您可以使用任何Android模拟器或设备。有关设置的详细信息,请参阅Android模拟器文档

注意:Android模拟器在虚拟机内或通过远程桌面或VNC无法正常运行,因为它依赖于虚拟化。

要在物理设备上部署和调试应用程序,请参阅在Android设备上调试文章。

5. 可选的iOS部署

要部署到iOS,您可以直接从Mac机器部署,或者可选择从Windows机器直接部署到设备,或通过将Windows机器与Mac配对

6. 使用实际微服务

默认情况下,eshop多平台客户端使用内部模拟服务,让用户探索应用程序中的不同功能集。

但如果您想使用真实服务测试应用程序,也可以这样做。

为此,您需要执行以下操作:

  1. eShopOnContainers仓库部署eShop应用程序的后端服务。您可以将应用程序部署到本地KubernetesAKS环境。

  2. 设置部分启用微服务端点。

<img src="https://yellow-cdn.veclightyear.com/2b54e442/4eff0a79-2078-42bf-9cf9-4522563f7d57.png" alt="启用微服务端点" Width="300" /> <img src="https://yellow-cdn.veclightyear.com/2b54e442/62c7dbc8-a616-4128-8b7a-e150d15fe6d1.png" alt="配置微服务端点" Width="300" />

身份URL:http://<您的IP或DNS名称>/identity 移动网关购物URL:http://<您的IP或DNS名称>/mobileshoppingapi

  1. 启用HTTP流量。

Android应用

您还需要在network_security_config.xml文件的<domain includeSubdomains="true"><您的IP或DNS名称></domain>部分中包含<您的IP或DNS名称>,以使用HTTP流量。

更多详情请参阅使用网络安全配置管理Android上的HTTP和明文流量

iOS应用

您需要确保您的info.plist文件包含以下配置。

<key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict>

更多详情请参阅退出ATS

**注意:**请注意,在生产环境中,您将使用HTTPS端点的服务。

7. 为Android设置Google地图

eShopOnContainers\Platforms\Android\AndroidManifest.xml中,您必须将com.google.android.geo.API_KEY的值替换为有效的Google地图API密钥。

<meta-data android:name="com.google.android.geo.API_KEY" android:value="您的密钥在这里" />

更多详情请参阅.NET MAUI地图 - 获取Google地图API密钥

截图

<img src="https://yellow-cdn.veclightyear.com/2b54e442/7c5e7875-7fb4-43db-a3c7-bb80072526d4.png" alt="登录" Width="210" /> <img src="https://yellow-cdn.veclightyear.com/2b54e442/ef575cbd-5fec-485a-b3d1-e09b750b593e.png" alt="登录" Width="210" /> <img src="https://yellow-cdn.veclightyear.com/2b54e442/e386f238-4489-4de8-978f-a17b27f02135.png" alt="目录" Width="210" /> <img src="https://yellow-cdn.veclightyear.com/2b54e442/c6a3737c-eca1-4249-aeb7-8333e3417d77.png" alt="个人资料" Width="210" /> <img src="https://yellow-cdn.veclightyear.com/2b54e442/90167f3e-4edb-4bdb-90f4-fbbad91a096e.png" alt="订单详情" Width="210" />

清理和重建

如果从仓库拉取更新时遇到构建问题,请尝试清理和重建解决方案。

故障排除

许可

本项目使用了一些需要注明出处的第三方资产:

版权和许可

  • 代码和文档版权2023 Microsoft Corp. 代码基于MIT许可发布。

编辑推荐精选

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
讯飞星火

讯飞星火

深度推理能力全新升级,全面对标OpenAI o1

科大讯飞的星火大模型,支持语言理解、知识问答和文本创作等多功能,适用于多种文件和业务场景,提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台,涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能,能为不同需求的用户提供便捷高效的帮助,助力用户轻松获取信息、解决问题,满足多样化使用场景。

热门AI开发模型训练AI工具讯飞星火大模型智能问答内容创作多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目,由多个知名机构联合参与。该项目提供了高效的 LLM(大语言模型)驱动的语音合成方案,支持语音克隆和语音创建功能,可通过命令行界面(CLI)和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数,生成高质量的语音。该项目适用于多种场景,如有声读物制作、智能语音助手开发等。

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
咔片PPT

咔片PPT

AI助力,做PPT更简单!

咔片是一款轻量化在线演示设计工具,借助 AI 技术,实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT,提供海量模板、智能美化、素材替换等功能,适用于销售、教师、学生等各类人群,能高效制作出高品质 PPT,满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文,一站式创作,让内容运营更高效

讯飞绘文,一个AI集成平台,支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容,加速品牌传播,提升内容营销效果。

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
材料星

材料星

专业的AI公文写作平台,公文写作神器

AI 材料星,专业的 AI 公文写作辅助平台,为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能,支持 30 + 文稿类型生成,助力快速完成领导讲话、工作总结、述职报告等材料,提升办公效率,是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK,助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK,它为开发者提供了与 OpenAI 模型交互的高效工具,支持工具调用、结果处理、追踪等功能,涵盖多种应用场景,如研究助手、财务研究等,能显著提升开发效率,让开发者更轻松地利用 OpenAI 的技术优势。

Hunyuan3D-2

Hunyuan3D-2

高分辨率纹理 3D 资产生成

Hunyuan3D-2 是腾讯开发的用于 3D 资产生成的强大工具,支持从文本描述、单张图片或多视角图片生成 3D 模型,具备快速形状生成能力,可生成带纹理的高质量 3D 模型,适用于多个领域,为 3D 创作提供了高效解决方案。

3FS

3FS

一个具备存储、管理和客户端操作等多种功能的分布式文件系统相关项目。

3FS 是一个功能强大的分布式文件系统项目,涵盖了存储引擎、元数据管理、客户端工具等多个模块。它支持多种文件操作,如创建文件和目录、设置布局等,同时具备高效的事件循环、节点选择和协程池管理等特性。适用于需要大规模数据存储和管理的场景,能够提高系统的性能和可靠性,是分布式存储领域的优质解决方案。

下拉加载更多