Thử Nghiệm Với .Net - 04.Tạo dự án và xây dựng cấu trúc thư mục backend với .Net 8 bằng .NET CLI.

Posted on:21 tháng 11, 2024 at 13:02

Table of contents

Open Table of contents

Mở đầu

Bài trước chúng ta đã dùng Visual Studio để tạo các project và cấu trúc thư mục của dự án, bài này chúng ta dùng .NET CLI để tạo các project và cấu trúc thư mục của dự án.

.NET CLI là công cụ dòng lệnh mạnh mẽ của Microsoft, giúp bạn dễ dàng phát triển và quản lý ứng dụng .NET.

Mở Command Prompt trên window hoăc Terminal trên Mac/Linux gõ lệnh sau để kiểm tra .NET version.

Terminal window
1
dotnet --version

Output

1
8.0.300

Kiểm tra các command của dotnet

Terminal window
1
dotnet --help

Output

1
Usage: dotnet [runtime-options] [path-to-application] [arguments]
2


3
Execute a .NET application.
4


5
runtime-options:
6
  --additionalprobingpath <path>   Path containing probing policy and assemblies to probe for.
7
  --additional-deps <path>         Path to additional deps.json file.
8
  --depsfile                       Path to <application>.deps.json file.
9
  --fx-version <version>           Version of the installed Shared Framework to use to run the application.
10
  --roll-forward <setting>         Roll forward to framework version  (LatestPatch, Minor, LatestMinor, Major, LatestMajor, Disable).
11
  --runtimeconfig                  Path to <application>.runtimeconfig.json file.
12


13
path-to-application:
14
  The path to an application .dll file to execute.
15


16
Usage: dotnet [sdk-options] [command] [command-options] [arguments]
17


18
Execute a .NET SDK command.
19


20
sdk-options:
21
  -d|--diagnostics  Enable diagnostic output.
22
  -h|--help         Show command line help.
23
  --info            Display .NET information.
24
  --list-runtimes   Display the installed runtimes.
25
  --list-sdks       Display the installed SDKs.
26
  --version         Display .NET SDK version in use.
27


28
SDK commands:
29
  add               Add a package or reference to a .NET project.
30
  build             Build a .NET project.
31
  build-server      Interact with servers started by a build.
32
  clean             Clean build outputs of a .NET project.
33
  format            Apply style preferences to a project or solution.
34
  help              Show command line help.
35
  list              List project references of a .NET project.
36
  msbuild           Run Microsoft Build Engine (MSBuild) commands.
37
  new               Create a new .NET project or file.
38
  nuget             Provides additional NuGet commands.
39
  pack              Create a NuGet package.
40
  publish           Publish a .NET project for deployment.
41
  remove            Remove a package or reference from a .NET project.
42
  restore           Restore dependencies specified in a .NET project.
43
  run               Build and run a .NET project output.
44
  sdk               Manage .NET SDK installation.
45
  sln               Modify Visual Studio solution files.
46
  store             Store the specified assemblies in the runtime package store.
47
  test              Run unit tests using the test runner specified in a .NET project.
48
  tool              Install or manage tools that extend the .NET experience.
49
  vstest            Run Microsoft Test Engine (VSTest) commands.
50
  workload          Manage optional workloads.
51


52
Additional commands from bundled tools:
53
  dev-certs         Create and manage development certificates.
54
  fsi               Start F# Interactive / execute F# scripts.
55
  user-jwts         Manage JSON Web Tokens in development.
56
  user-secrets      Manage development user secrets.
57
  watch             Start a file watcher that runs a command when files change.
58


59
Run 'dotnet [command] --help' for more information on a command.

Có rất nhiều command trong .NET CLI, chúng ta sẽ sử dụng command dotnet new để khởi tạo project.

1
new               Create a new .NET project or file.

Kiểm tra các templates của command dotnet new

Terminal window
1
dotnet new list

Output

1
These templates matched your input:
2


3
Template Name           Short Name                  Language    Tags
4
----------------------  --------------------------  ----------  -------------------------------------------------------
5
.NET Aspire App Host    aspire-apphost              [C#]        Common/.NET Aspire/Cloud
6
.NET Aspire Applica...  aspire                      [C#]        Common/.NET Aspire/Cloud/Web/Web API/API/Service
7
.NET Aspire Service...  aspire-servicedefaults      [C#]        Common/.NET Aspire/Cloud/Web/Web API/API/Service
8
.NET Aspire Starter...  aspire-starter              [C#]        Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
9
.NET Aspire Test Pr...  aspire-xunit                [C#]        Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
10
API Controller          apicontroller               [C#]        Web/ASP.NET
11
ASP.NET Core Empty      web                         [C#],F#     Web/Empty
12
ASP.NET Core gRPC S...  grpc                        [C#]        Web/gRPC/API/Service
13
ASP.NET Core Web API    webapi                      [C#],F#     Web/Web API/API/Service
14
ASP.NET Core Web AP...  webapiaot                   [C#]        Web/Web API/API/Service
15
ASP.NET Core Web Ap...  mvc                         [C#],F#     Web/MVC
16
ASP.NET Core Web Ap...  webapp,razor                [C#]        Web/MVC/Razor Pages
17
Blazor Web App          blazor                      [C#]        Web/Blazor/WebAssembly
18
Blazor WebAssembly ...  blazorwasm                  [C#]        Web/Blazor/WebAssembly/PWA
19
Class Library           classlib                    [C#],F#,VB  Common/Library
20
Console App             console                     [C#],F#,VB  Common/Console
21
dotnet gitignore file   gitignore,.gitignore                    Config
22
Dotnet local tool m...  tool-manifest                           Config
23
Duende BFF Host usi...  bff-remoteapi               [C#]        Web/IdentityServer
24
Duende BFF using a ...  bff-localapi                [C#]        Web/IdentityServer
25
Duende IdentityServ...  isempty                     [C#]        Web/IdentityServer
26
Duende IdentityServ...  isui                        [C#]        Web/IdentityServer
27
Duende IdentityServ...  isaspid                     [C#]        Web/IdentityServer
28
Duende IdentityServ...  isef                        [C#]        Web/IdentityServer
29
Duende IdentityServ...  isinmem                     [C#]        Web/IdentityServer
30
EditorConfig file       editorconfig,.editorconfig              Config
31
global.json file        globaljson,global.json                  Config
32
MSBuild Directory.B...  buildprops                              MSBuild/props
33
MSBuild Directory.B...  buildtargets                            MSBuild/props
34
MSTest Playwright T...  mstest-playwright           [C#]        Test/MSTest/Playwright
35
MSTest Test Project     mstest                      [C#],F#,VB  Test/MSTest
36
MVC Controller          mvccontroller               [C#]        Web/ASP.NET
37
MVC ViewImports         viewimports                 [C#]        Web/ASP.NET
38
MVC ViewStart           viewstart                   [C#]        Web/ASP.NET
39
NuGet Config            nugetconfig,nuget.config                Config
40
NUnit 3 Test Item       nunit-test                  [C#],F#,VB  Test/NUnit
41
NUnit 3 Test Project    nunit                       [C#],F#,VB  Test/NUnit
42
NUnit Playwright Te...  nunit-playwright            [C#]        Test/NUnit/Playwright
43
Protocol Buffer File    proto                                   Web/gRPC
44
Razor Class Library     razorclasslib               [C#]        Web/Razor/Library
45
Razor Component         razorcomponent              [C#]        Web/ASP.NET
46
Razor Page              page                        [C#]        Web/ASP.NET
47
Razor View              view                        [C#]        Web/ASP.NET
48
Solution File           sln,solution                            Solution
49
Web Config              webconfig                               Config
50
Windows Forms App       winforms                    [C#],VB     Common/WinForms
51
Windows Forms Class...  winformslib                 [C#],VB     Common/WinForms
52
Windows Forms Contr...  winformscontrollib          [C#],VB     Common/WinForms
53
Worker Service          worker                      [C#],F#     Common/Worker/Web
54
WPF Application         wpf                         [C#],VB     Common/WPF
55
WPF Class Library       wpflib                      [C#],VB     Common/WPF
56
WPF Custom Control ...  wpfcustomcontrollib         [C#],VB     Common/WPF
57
WPF User Control Li...  wpfusercontrollib           [C#],VB     Common/WPF
58
xUnit Test Project      xunit                       [C#],F#,VB  Test/xUnit

Chúng ta sẽ dùng các command sau để tạo project và cấu trúc thư mục của dự án

1
Template Name           Short Name                  Language    Tags
2
----------------------  --------------------------  ----------  -------------------------------------------------------
3
Solution File           sln,solution                            Solution
4
ASP.NET Core Web API    webapi                      [C#],F#     Web/Web API/API/Service"
5
Class Library           classlib                    [C#],F#,VB  Common/Library

Tao folder chứa thư mục dự án, đứng ở nơi và bạn muốn đặt source code, tạo một foler chứa dự án bằng lệnh sau

Terminal window
1
mkdir Ziply

Chuyển đến thư mục vừa tạo và bắt đầu tạo solution

Terminal window
1
cd Ziply
2
dotnet new sln -n Ziply

Output

1
The template "Solution File" was created successfully.

Tạo các project trong solution

Terminal window
1
`
2
dotnet new webapi -o src\app\Ziply.API
3
dotnet new classlib -o src\app\Ziply.Domain
4
dotnet new classlib -o src\app\Ziply.Application
5
dotnet new classlib -o src\app\Ziply.Infrastructure
6


7
dotnet new classlib -o src\services\Ziply.AuthService
8
dotnet new classlib -o src\services\Ziply.CacheService
9
dotnet new classlib -o src\services\Ziply.EmailService
10
dotnet new classlib -o src\services\Ziply.LoggerService
11


12
dotnet new classlib -o src\shared\Ziply.Shared

Gõ tree để kiểm tra xem cấu trúc thư mục

Terminal window
1
tree

Output

1
Folder PATH listing
2
Volume serial number is 3EC0-5B6F
3
C:.
4
└───src
5
    ├───app
6
    │   ├───Ziply.API
7
    │   │   ├───obj
8
    │   │   └───Properties
9
    │   ├───Ziply.Application
10
    │   │   └───obj
11
    │   ├───Ziply.Domain
12
    │   │   └───obj
13
    │   └───Ziply.Infrastructure
14
    │       └───obj
15
    ├───services
16
    │   ├───Ziply.AuthService
17
    │   │   └───obj
18
    │   ├───Ziply.CacheService
19
    │   │   └───obj
20
    │   ├───Ziply.EmailService
21
    │   │   └───obj
22
    │   └───Ziply.LoggerService
23
    │       └───obj
24
    └───shared
25
        └───Ziply.Shared
26
            └───obj

Cuối cùng chúng ta thêm các project này vào solution

Terminal window
1
dotnet sln add src\app\Ziply.API\Ziply.API.csproj
2


3
dotnet sln add src\app\Ziply.Domain\Ziply.Domain.csproj
4


5
dotnet sln add src\app\Ziply.Application\Ziply.Application.csproj
6


7
dotnet sln add src\app\Ziply.Infrastructure\Ziply.Infrastructure.csproj
8


9
dotnet sln add src\services\Ziply.AuthService\Ziply.AuthService.csproj
10


11
dotnet sln add src\services\Ziply.CacheService\Ziply.CacheService.csproj
12


13
dotnet sln add src\services\Ziply.EmailService\Ziply.EmailService.csproj
14


15
dotnet sln add src\services\Ziply.LoggerService\Ziply.LoggerService.csproj
16


17
dotnet sln add src\shared\Ziply.Shared\Ziply.Shared.csproj

Mở file Solution bằng Visual Studio và kiểm tra thành quả

Tạo một Blank Solution

Chúc các ban thành công.

Source Code

Source code của bài này

Bài viết trong series

Bài 1 - Implement hệ thống rút gọn link giống tiny url, bitly

Bài 2 - Setup môi trường, cài các công cụ và extension cần thiết để tiến hành xây dựng ứng dụng rút gọn link

Bài 3 - Tạo dự án và xây dựng cấu trúc thư mục backend với .Net 8 bằng Visual Studio.

Bài 4 - Tạo dự án và xây dựng cấu trúc thư mục backend với .Net 8 bằng .NetCLI

Bài 5 -Xây dựng Domain project với Domain Driven Design