Liquid-Application-Framework

Liquid Application Framework 项目介绍

项目概述

Liquid Application Framework 是一个专为促进云原生微服务开发而设计的多云框架。它帮助开发人员在编写应用程序时不再需要关注具体的云服务提供商技术，而是专注于业务逻辑。Liquid 通过抽象大部分繁琐的准备工作，让开发者专注于开发出色且有效的领域代码。

重大版本更新

在2021年4月，Liquid Application Framework 推出了新的重大版本。这个版本经过了全面的重构和重要的兼容性破坏性更改，与旧版本不兼容，并且无法轻松转换。因此，旧版本已被废弃，不再接收任何更新甚至是错误修复。不过，为满足历史需求和让依赖旧版的开发者能够维护自己的版本，旧版代码库依然公开。

项目特色

多云兼容性：Liquid 可以抽象来自 Azure、AWS 和 Google Cloud 等云服务提供商的多种服务，使代码能够在任何平台上运行。
指导式的编程模型：框架提供了一个指导式编程模型，帮助开发者节省思考如何构建应用程序的时间，从而更专注于业务代码的编写。

涉及的二进制文件

Liquid Application Framework 提供了一些关键的库模块，以支持不同的开发需求：

Liquid.Core：必要模块。
Liquid.Domain：推荐模块。
Liquid.Repository、Liquid.Cache、Liquid.Messaging 和 Liquid.WebApi.Http：可选模块，用于扩展功能。

开始使用

Liquid 提供了一系列模板，便于开发者快速启动自己的微服务项目。通过运行以下命令安装这些模板：

dotnet new install Liquid.Templates

之后，可以通过命令行使用不同的模板来创建适合自己项目需求的解决方案，例如 CRUD 操作的 WebAPI 解决方案或数据处理的 WorkerService 项目。

示例

假如你想创建一个拥有 CRUD（增删改查）处理程序的 WebAPI 解决方案，只需执行以下命令：

dotnet new liquidcrudsolution --projectName "你的根命名空间" --entityName "你的实体名" --entityIdType "唯一ID的类型"

然后在 IDE 中打开生成的项目，按照代码中的 TODO 指引进行操作即可开始项目开发。

贡献方式

Liquid 鼓励开发者通过试用、提交问题和创建 pull requests 来对项目进行贡献。可以在 GitHub 上提交反馈或在 Discussions 标签页开展讨论。项目对新人友好，特别标记为 ready 的问题即是适合初学者参与解决的问题。此外，Avanade 要求所有的提交都需符合开发者证书的规定。

在贡献之前，请先查看项目的贡献指南以及安全披露政策。