NetLift: Automatyczne narzędzie migracji .NET Framework

Przez ostatnie kilka lat prowadziłem kilkanaście migracji z .NET Framework do .NET 8+. Za każdym razem napotykałem ten sam problem: 60-80% pracy to mechaniczne, powtarzalne transformacje. Zmień using System.Web.Mvc na using Microsoft.AspNetCore.Mvc. Przekształć DbContext.Set<T>().Where() na async ToListAsync(). Zamień [ServiceContract] na gRPC service.

To żmudna praca, podatna na błędy. Więc zbudowałem narzędzie, które robi to za mnie - NetLift.

NetLift korzysta z Roslyn (kompilatora C#) do analizy drzew składniowych i przeprowadzania deterministycznych transformacji kodu. Nie ma tu AI, nie ma losowości. Tylko precyzyjna inżynieria kompilatorów i 1819 testów jednostkowych gwarantujących poprawność transformacji.

01Dlaczego zbudowałem to narzędzie

Kiedy migrujesz aplikację .NET Framework, masz świetne oficjalne narzędzie: .NET Upgrade Assistant. Robi fantastyczną robotę z plikami projektów - aktualizuje .csproj, dodaje pakiety NuGet, zmienia target framework. To rozwiązuje może 20% problemu.

Pozostałe 80%? To twój kod źródłowy. Tysiące linii kontrolerów MVC 5, które trzeba przekształcić do ASP.NET Core. Setki zapytań Entity Framework 6, które powinny być async w EF Core. Kontrakty WCF, które musisz zamienić na gRPC albo REST API. Wzorce CQRS z przestarzałymi interfejsami MediatR.

Większość czasu w projekcie migracyjnym to mechaniczna praca nad kodem. Upgrade Assistant rozwiązuje pliki projektów, ale kod źródłowy trzeba przepisywać ręcznie. Na dużej aplikacji to tygodnie pracy.

Chciałem narzędzie, które zrobi te transformacje za mnie. Roslyn daje dostęp do drzew składniowych - mogę analizować i przepisywać kod programatycznie, z gwarancją poprawności składniowej.

Dlatego powstał NetLift. W kontekście przewodnika migracji .NET, NetLift zajmuje się właśnie tą najbardziej czasochłonną fazą - automatyczną transformacją kodu.

02Jak działa NetLift

NetLift to nie gloryfikowany find-and-replace. Każda transformacja przechodzi przez Roslyn: parsing, analiza drzew składniowych, transformacja, przepisanie.

// Your code
public class ProductsController : Controller
{
    [HttpGet]
    public ActionResult Index() { }
}

// Roslyn Syntax Tree (simplified)
ClassDeclaration("ProductsController")
  ├─ BaseList: "Controller"
  └─ MethodDeclaration("Index")
      ├─ Attribute("[HttpGet]")
      └─ ReturnType("ActionResult")

SemanticModel.GetTypeInfo(node)
  → System.Web.Mvc.Controller

// NetLift decision:
// "This is MVC5 controller, needs AspNetCore migration"

public override SyntaxNode VisitClassDeclaration(
    ClassDeclarationSyntax node)
{
    if (InheritsFrom(node, "System.Web.Mvc.Controller"))
    {
        return node
            .ReplaceToken("Controller", "ControllerBase")
            .WithUsing("Microsoft.AspNetCore.Mvc");
    }
    return node;
}

// Transformed output
using Microsoft.AspNetCore.Mvc;

public class ProductsController : ControllerBase
{
    [HttpGet]
    public IActionResult Index() { }
}

03Co jest migrowane

NetLift pokrywa najczęstsze scenariusze migracji .NET Framework do .NET 8+. Skupiam się na aplikacjach biznesowych - tam gdzie migracja przynosi największy ROI.

using System.Web.Mvc;

public class ProductsController : Controller
{
    private readonly IProductService _service;

    public ProductsController(
        IProductService service)
    {
        _service = service;
    }

    [HttpGet]
    public ActionResult GetProduct(int id)
    {
        var product = _service.GetById(id);
        if (product == null)
            return HttpNotFound();

        return Json(product,
            JsonRequestBehavior.AllowGet);
    }

    [HttpPost]
    [ValidateAntiForgeryToken]
    public ActionResult Create(ProductDto dto)
    {
        if (!ModelState.IsValid)
            return View(dto);

        _service.Create(dto);
        return RedirectToAction("Index");
    }
}

using Microsoft.AspNetCore.Mvc;

public class ProductsController : ControllerBase
{
    private readonly IProductService _service;

    public ProductsController(
        IProductService service)
    {
        _service = service;
    }

    [HttpGet("{id}")]
    public async Task<IActionResult> GetProduct(
        int id)
    {
        var product = await _service
            .GetByIdAsync(id);
        if (product == null)
            return NotFound();

        return Ok(product);
    }

    [HttpPost]
    [ValidateAntiForgeryToken]
    public async Task<IActionResult> Create(
        ProductDto dto)
    {
        if (!ModelState.IsValid)
            return BadRequest(ModelState);

        await _service.CreateAsync(dto);
        return RedirectToAction("Index");
    }
}

04Prawdziwe migracje do przejrzenia

Przepuściłem NetLift przez trzy znane open-source aplikacje .NET. Poniżej linki do PR-ów - możesz przejrzeć co dokładnie zostało zmienione.

05Scoring pewności transformacji

Nie każda transformacja jest tak samo pewna. Prosty namespace update to jedno, złożona logika biznesowa to drugie. NetLift przypisuje każdej transformacji confidence score.

// TODO: NetLift - Manual migration required
// REASON: Custom HttpContext manipulation detected
// GUIDANCE: Replace Session with IDistributedCache or ISession
// BEFORE:
//   HttpContext.Session["UserId"] = userId;
// AFTER:
//   await HttpContext.Session.SetStringAsync("UserId", userId);
// REFERENCE: https://learn.microsoft.com/aspnet/core/fundamentals/app-state

public class UserController : ControllerBase
{
    public IActionResult Login(LoginDto dto)
    {
        // Your manual work here
    }
}

06Ograniczenia

NetLift nie jest uniwersalnym rozwiązaniem. Obsługuje migrację aplikacji ASP.NET MVC/Web API z Entity Framework. Inne technologie .NET Framework wymagają innego podejścia.

dotnet netlift analyze --project ./MyApp.csproj --report compatibility

# Output:
# ✓ ASP.NET MVC Controllers: 45 found, 42 compatible (93%)
# ✓ Entity Framework 6 DbContext: 8 found, 7 compatible (87%)
# ⚠ WCF Services: 12 found, 9 compatible (75%)
# ✗ WebForms Pages: 23 found, NOT SUPPORTED
#
# Overall Compatibility Score: 78% (GOOD)
# Estimated Manual Work: 15-25% of total migration

07Jak zacząć

NetLift jest narzędziem CLI. Instalujesz jako .NET global tool i uruchamiasz na swoim projekcie. Proces jest designed do być bezpieczny - najpierw dry run, potem transformacja, zawsze z backup.

dotnet tool install --global NetLift

netlift analyze --project ./YourApp.csproj --report compatibility

netlift migrate --project ./YourApp.csproj --dry-run --output ./preview

# Backup first!
git commit -am "Pre-migration snapshot"

# Run migration
netlift migrate --project ./YourApp.csproj --backup ./backup

# NetLift creates backup automatically, but git commit is safer

# Review all TODO comments
grep -r "TODO: NetLift" ./src

# Build and test
dotnet build
dotnet test

# Review confidence scores
netlift report --project ./YourApp.csproj --format html

08FAQ