eShop

ESHOP参考应用程序 - “ AdventureWorks”

使用.NET ASPIRE的基于服务的架构实现电子商务网站的参考.NET应用程序。

入门

此版本的ESHOP基于.NET 9。

以前的ESHOP版本：

• .NET 8

先决条件

• 克隆ESHOP存储库：https：//github.com/dotnet/eshop
• 安装和启动Docker桌面

带有视觉工作室的窗户

• 安装Visual Studio 2022版本17.10或更新。
  • 选择以下工作负载：
    • ASP.NET and web development工作负载。
    • .NET Aspire SDK组件中的Individual components 。
    • 可选： .NET Multi-platform App UI development用于运行客户端应用程序

或者

• 以Administrator运行的PowerShell＆Terminal运行以下命令，以自动使用所需的工具来构建和运行此应用程序。 （注意：需要重新启动并包含在下面的脚本中。）

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvside.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

或者

• 从开发主页转到Machine Configuration -> Clone repositories 。输入此存储库的URL。在确认屏幕中查找Configuration File Detected ，然后单击Run File 。

Mac，Linux和Windows没有Visual Studio

• 安装最新的.NET 9 SDK

或者

• 在以管理员为Administrator PowerShell和终端中运行以下命令，以使用所需的工具来自动配置环境，以构建和运行此应用程序。 （注意：运行下面的脚本后需要重新启动。）

安装Visual Studio代码和相关扩展名

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense  - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvscode.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

注意：这些命令可能需要sudo

• 可选：使用C＃开发套件安装Visual Studio代码
• 可选：安装.NET MAUI工作负载

注意：使用Apple Silicon（M系列处理器）在Mac上运行时，Rosetta 2用于GRPC-Tools。

运行解决方案

警告

请记住要确保码头工人开始

• （仅Windows）从Visual Studio运行应用程序：

• 在Visual Studio中打开eShop.Web.slnf文件
• 确保eShop.AppHost.csproj是您的启动项目
• 点击Ctrl-F5开始Aspire

• 或从您的终端运行应用程序：

dotnet run -- project src / eShop.AppHost / eShop.AppHost.csproj

然后在控制台输出中查找这样的行，以找到打开Aspire仪表板的URL：

Login to the dashboard at: http://localhost:19888/login ? t=uniquelogincodeforyou

您可能需要首先安装ASP.NET Core HTTPS开发证书，然后关闭所有浏览器选项卡。在https://aka.ms/aspnet/https-trust-dev-cert上了解更多信息

Azure打开AI

使用Azure OpenAi时，内部eshop.apphost/appsettings.json ，添加以下部分：

  "ConnectionStrings" : {
    "OpenAi" : " Endpoint=xxx;Key=xxx; "
  }

用自己的值替换值。然后，在eshop.apphost program.cs中，将此值设置为true

 bool useOpenAI = false ;

这是有关.NET ASPIRE OPENAI组件的其他指导。

使用Azure开发人员CLI

您可以使用Azure开发人员CLI使用只有几个命令在Azure上运行此项目。按照下一个说明：

• 将最新或更新安装到最新的Azure开发人员CLI（AZD）中。
• 登录azd （如果您以前没有这样做）到您的Azure帐户：

azd auth login

• 从回购的根部初始化azd 。

azd init

• 在初始化期间：

  • Use code in the current directory 。 AZD将自动检测.NET ASPIRE项目。
  • 确认.NET (Aspire)并继续。
  • 选择要暴露于Internet的服务（公开webapp足以测试样本）。
  • 通过为您的环境命名来最终确定初始化。

• 创建Azure资源并通过运行部署样本：

azd up

笔记：

• 该操作第一次为环境运行时需要几分钟。
• 在过程结束时， azd将显示WebApp的url 。按照该链接测试样品。
• 您可以在保存样本更改以重新部署并更新样本后运行azd up 。
• 向Azure-Dev回购报告任何问题。
• 常见问题解答和对AZD的故障排除。

贡献

有关贡献此回购的更多信息，请阅读贡献文档和行为准则。

示例数据

样品目录数据在目录中定义。这些产品名称，描述和品牌名称是虚构的，是使用GPT-35-Turbo生成的，并且使用DALL·E 3生成相应的产品图像。

azure上的eShop

对于该应用程序的版本，该应用程序配置为在Azure上部署，请在Azure Repo上查看ESHOP。