Tách solution nhiều project

Ở khoá WinForms, DbProductStore phải chép nguyên từ API sang app kho. Sửa một bên mà quên bên kia là hai app lệch nhau. Bài này đưa Core và Infrastructure thành project riêng, rồi cho cả ShopApi lẫn ShopDesk tham chiếu tới, để code chung chỉ có một bản.

Khái niệm

📁 Solution: file .sln (từ .NET 10 là .slnx) gom nhiều project lại để mở và build cùng lúc.

📗 Class library: project không chạy được một mình, chỉ chứa class để project khác tham chiếu, tạo bằng dotnet new classlib.

Như bài Viết test cho API, dotnet add A reference B cho project A dùng class public của project B. Chiều tham chiếu chính là chiều phụ thuộc của bài Clean Architecture.

Ví dụ

Trong thư mục chứa ShopApi và ShopDesk:

dotnet new sln -n Shop
dotnet new classlib -f net9.0 -o Shop.Core
dotnet new classlib -f net9.0 -o Shop.Infrastructure
dotnet sln add Shop.Core Shop.Infrastructure
dotnet sln add ShopApi ShopDesk ShopApi.Tests
dotnet add Shop.Infrastructure reference Shop.Core
dotnet add ShopApi reference Shop.Core Shop.Infrastructure
dotnet add ShopDesk reference Shop.Core Shop.Infrastructure
dotnet build

-f net9.0 cho class library cùng framework với ShopApi. Thiếu nó, SDK .NET 10 tạo project net10.0, và project net9.0 không tham chiếu được.

Sau đó chuyển code:

Migration giờ nằm cùng ShopDbContext ở Infrastructure, nên lệnh dotnet ef ghi rõ project chứa migration và project khởi động:

dotnet ef migrations add Ten --project Shop.Infrastructure --startup-project ShopApi

// Shop.Core/Product.cs
namespace Shop.Core;

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public decimal Price { get; set; }
    public int Stock { get; set; }
}

• namespace Shop.Core; như bài Ứng dụng WinForms đầu tiên. File nào trong ShopApi, ShopDesk dùng Product thì thêm using Shop.Core; ở đầu.
• ShopApi là net9.0, ShopDesk là net9.0-windows, cùng tham chiếu một Shop.Core net9.0 được.
• Sửa Product một lần, dotnet build là cả API lẫn app kho cùng nhận.

Thử ngay

Thử phá quy tắc của bài trước: thêm file này vào Shop.Core rồi chạy dotnet build Shop.Core.

// Shop.Core/Bad.cs
using Microsoft.EntityFrameworkCore;

namespace Shop.Core;

public class Bad
{
}

Đoán trước khi chạy: build qua hay lỗi?

error CS0234: The type or namespace name 'EntityFrameworkCore'
does not exist in the namespace 'Microsoft' (are you missing
an assembly reference?)

Lỗi hay gặp

Quên public. Class không ghi gì mặc định là internal, chỉ dùng được trong chính project đó.

// SAI — ShopApi báo CS0122: Product is inaccessible
namespace Shop.Core;

class Product
{
    public int Id { get; set; }
}

// ĐÚNG — public để project khác dùng được
namespace Shop.Core;

public class Product
{
    public int Id { get; set; }
}

Tham chiếu vòng cũng bị chặn: Shop.Core tham chiếu ngược lại Shop.Infrastructure thì build báo MSB4006: There is a circular dependency.

Tóm tắt

• Solution gom nhiều project. Class library chứa code dùng chung.
• dotnet add A reference B cho A dùng class public của B.
• Core và Infrastructure thành project riêng, API và WinForms cùng tham chiếu.
• Lõi không có package database, nên compiler chặn luôn việc dùng nhầm.