Windows-appsample-customers-orders-database 项目教程

1. 项目介绍

Windows-appsample-customers-orders-database 是一个由微软开源的 Windows 应用示例项目，旨在展示如何在 Windows 平台上构建一个客户订单数据库应用。该项目使用 C# 和 XAML 实现，并托管在 Azure 上。它不仅展示了如何使用 WinUI 3 构建现代化的 UI，还涵盖了企业级应用中常见的功能，如 Azure Active Directory (AAD) 认证、SQLite 和 SQL Azure 数据库集成、Entity Framework 以及云 API 服务。

该项目的主要目标是帮助开发者快速上手 Windows 应用开发，并提供一个可扩展的基础，以便开发者在此基础上构建自己的企业级应用。

2. 项目快速启动

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Windows 11 Insider Preview (Build 22000) 或 Windows 10 (最低版本 2004, Build 19041)
• .NET SDK: .NET 6.0 SDK
• 开发工具: Visual Studio 2022 版本 17.1 或更高版本（推荐使用免费的 Visual Studio Community Edition）
• Windows App SDK: 版本 1.0

克隆项目

首先，克隆项目到本地：

git clone https://github.com/microsoft/Windows-appsample-customers-orders-database.git

配置项目

1. 打开解决方案: 在 Visual Studio 中打开 Contoso.sln 解决方案文件。
2. 设置启动项目: 右键点击 Contoso.App 项目，选择“设为启动项目”。
3. 配置数据库连接: 打开 Constants.cs 文件，配置数据库连接字符串。

public const string SqlAzureConnectionString = "Data Source=(LocalDB)\\ContosoDb;Initial Catalog=CONTOSODB;Integrated Security=True";

4. 配置 Azure AD: 在 Constants.cs 文件中，配置 Azure Active Directory 的客户端 ID。

public const string AccountClientId = "你的 Azure AD 客户端 ID";

运行项目

1. 选择架构: 在 Visual Studio 中，选择 x86 或 x64 架构。
2. 启动调试: 按 F5 启动调试，应用将会运行并连接到配置的数据库。

3. 应用案例和最佳实践

应用案例

Windows-appsample-customers-orders-database 项目适用于以下应用场景：

• 企业级应用开发: 适用于需要管理客户订单和产品信息的企业级应用。
• 数据库集成: 展示了如何将本地 SQLite 数据库与云端 SQL Azure 数据库集成。
• 身份验证: 展示了如何使用 Azure Active Directory 进行用户身份验证。

最佳实践

• 模块化设计: 项目采用模块化设计，便于扩展和维护。
• 代码质量: 项目代码经过优化，遵循最佳实践，适合作为学习参考。
• 安全性: 项目展示了如何使用 Azure AD 进行安全认证，确保数据安全。

4. 典型生态项目

VanArsdel Inventory 示例

VanArsdel Inventory 是另一个由微软提供的复杂企业级应用示例，涵盖了更多高级功能和更复杂的架构设计。它与 Windows-appsample-customers-orders-database 类似，但提供了更全面的解决方案。

Windows App SDK

Windows App SDK 是微软提供的用于构建现代化 Windows 应用的工具包，支持 WinUI 3 和其他现代化 UI 技术。该项目依赖于 Windows App SDK，展示了如何使用这些工具构建高效的应用。

Azure Active Directory

Azure Active Directory 是微软提供的云端身份管理服务，支持多种认证和授权方案。该项目展示了如何集成 Azure AD 进行用户认证，确保应用的安全性。

通过这些生态项目，开发者可以进一步扩展和优化自己的应用，构建更加强大和安全的企业级解决方案。