CakeBuilder .NET (jak to działa dla programistów)

Dlaczego warto używać CakeBuild w programowaniu w języku C#?

1. Znajomość języka C#: Ponieważ skrypty Cake są napisane w języku C#, programiści mogą wykorzystać swoją dotychczasową wiedzę i umiejętności, co pozwala na płynną integrację automatyzacji kompilacji z projektami C#.
2. Obsługa wielu platform: CakeBuild został zaprojektowany jako narzędzie wieloplatformowe, obsługujące systemy Windows, Linux i macOS. Pozwala to na spójne procesy kompilacji w różnych systemach operacyjnych.
3. Rozszerzalność: Cake obsługuje dodatki, czyli pakiety rozszerzające jego funkcjonalność. Ta rozszerzalność pozwala programistom na integrację Cake z różnymi narzędziami i zarządzanie złożonymi scenariuszami kompilacji.
4. Elastyczność: Dzięki Cake masz precyzyjną kontrolę nad procesem kompilacji. Niezależnie od tego, czy chodzi o kompilację kodu, uruchamianie testów czy pakowanie aplikacji, możesz dostosować skrypt kompilacji do konkretnych potrzeb swojego projektu.

Instalacja

Aby rozpocząć pracę z CakeBuild, należy zainstalować globalny manifest narzędzi Cake. Otwórz terminal lub wiersz poleceń i uruchom następujące polecenie narzędzia .NET:

dotnet tool install -g Cake.Tool

Korzystanie z programu Visual Studio

Aby zainstalować CakeBuild, można użyć rozszerzenia Cake dla Visual Studio. Oto kroki, które należy wykonać, aby zainstalować CakeBuild w Visual Studio:

1. Otwórz Visual Studio: Uruchom Visual Studio na swoim komputerze. Upewnij się, że masz zainstalowaną wersję Visual Studio obsługującą rozszerzenia. Pobierz najnowszą wersję 2022 z witryny Microsoft Visual Studio Downloads. Utwórz nową aplikację konsolową.

   

2. Otwórz okno dialogowe Rozszerzenia i aktualizacje:

   • W programie Visual Studio przejdź do menu "Rozszerzenia".
   • Wybierz "Zarządzaj rozszerzeniami" z menu rozwijanego. Spowoduje to otwarcie okna dialogowego Rozszerzenia i aktualizacje.

   

3. Wyszukaj rozszerzenie Cake:

   • W oknie dialogowym Rozszerzenia i aktualizacje kliknij kartę "Online" po lewej stronie.
   • Użyj pola wyszukiwania w prawym górnym rogu i wpisz "Cake", aby znaleźć rozszerzenie Cake.

   

4. Zainstaluj rozszerzenie Cake:
   • W wynikach wyszukiwania poszukaj rozszerzenia "Cake for Visual Studio 2022".
   • Kliknij przycisk "Pobierz", aby pobrać i zainstalować rozszerzenie.
5. Uruchom ponownie program Visual Studio:
   • Po instalacji pojawi się monit o ponowne uruchomienie programu Visual Studio.
   • Zamknij i ponownie uruchom Visual Studio, aby zastosować zmiany.

6. Sprawdź instalację:

   Po ponownym uruchomieniu programu Visual Studio można sprawdzić, czy rozszerzenie Cake zostało zainstalowane.

   

   W pasku menu Build powinna pojawić się nowa opcja "Build CakeBuild", wskazująca, że rozszerzenie Cake zostało pomyślnie dodane.

Tworzenie prostego skryptu Cake

Po zainstalowaniu Cake'a możesz tworzyć proste skrypty Cake'a w zależności od swoich ustawień. Utwórz plik o nazwie build.cake o następującej treści:

var target = Argument("target", "Default");

Task("Default")
    .Does(() =>
{
    Information("Hello, Cake!");
});

RunTarget(target);

var target = Argument("target", "Default");

Task("Default")
    .Does(() =>
{
    Information("Hello, Cake!");
});

RunTarget(target);

Dim target = Argument("target", "Default")

Task("Default").Does(Sub()
	Information("Hello, Cake!")
End Sub)

RunTarget(target)

Ten prosty przykładowy skrypt definiuje domyślny cel, który po uruchomieniu wyświetla komunikat "Hello, Cake!".

Uruchamianie skryptu Cake

Aby uruchomić skrypt, przejdź do katalogu zawierającego plik build.cake i wykonaj następujące polecenie:

dotnet cake

Spowoduje to wykonanie domyślnego celu w skrypcie i wyświetlenie komunikatu "Hello, Cake!" w konsoli.

Kompilacja i testowanie

Task("Compile")
    .Does(() =>
{
    // Compile C# code
    MSBuild("./src/MyProject.sln");
});

Task("RunTests")
    .IsDependentOn("Compile")
    .Does(() =>
{
    // Run tests
    DotNetTest("./src/MyProject.Tests");
});

Task("Build")
    .IsDependentOn("RunTests");

Task("Compile")
    .Does(() =>
{
    // Compile C# code
    MSBuild("./src/MyProject.sln");
});

Task("RunTests")
    .IsDependentOn("Compile")
    .Does(() =>
{
    // Run tests
    DotNetTest("./src/MyProject.Tests");
});

Task("Build")
    .IsDependentOn("RunTests");

Task("Compile").Does(Sub()
	' Compile C# code
	MSBuild("./src/MyProject.sln")
End Sub)

Task("RunTests").IsDependentOn("Compile").Does(Sub()
	' Run tests
	DotNetTest("./src/MyProject.Tests")
End Sub)

Task("Build").IsDependentOn("RunTests")

Ten przykład przedstawia skrypt kompilacji, który kompiluje kod C# i uruchamia testy jednostkowe przy użyciu MSBuild oraz .NET Test SDK.

Pakowanie i wdrażanie

Task("Package")
    .IsDependentOn("Build")
    .Does(() =>
{
    // Package application
    NuGetPack("./src/MyProject.csproj");
});

Task("Deploy")
    .IsDependentOn("Package")
    .Does(() =>
{
    // Deploy application
    // Add deployment steps here
});

Task("Release")
    .IsDependentOn("Deploy");

Task("Package")
    .IsDependentOn("Build")
    .Does(() =>
{
    // Package application
    NuGetPack("./src/MyProject.csproj");
});

Task("Deploy")
    .IsDependentOn("Package")
    .Does(() =>
{
    // Deploy application
    // Add deployment steps here
});

Task("Release")
    .IsDependentOn("Deploy");

Task("Package").IsDependentOn("Build").Does(Sub()
	' Package application
	NuGetPack("./src/MyProject.csproj")
End Sub)

Task("Deploy").IsDependentOn("Package").Does(Sub()
	' Deploy application
	' Add deployment steps here
End Sub)

Task("Release").IsDependentOn("Deploy")

Ten skrypt przedstawia zadania związane z pakowaniem i wdrażaniem aplikacji C# przy użyciu NuGet.

IronPDF: biblioteka do generowania plików PDF

Automatyzacja zadań IronPDF za pomocą CakeBuild

Rozważmy scenariusz, w którym chcesz zintegrować IronPDF z procesem kompilacji w celu zautomatyzowania generowania dokumentów PDF. Oto, jak możesz ulepszyć swój skrypt Cake:

// Install IronPdf as a Cake Addin
#addin nuget:?package=IronPdf&version=2023.12.6

Task("GeneratePDF")
    .Does(() =>
{
    // Your HTML content to convert to PDF
    var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

    // Convert HTML to PDF using IronPDF
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);

    // Save the generated PDF
    pdf.SaveAs("GeneratedDocument.pdf");
});

Task("Build")
    .IsDependentOn("GeneratePDF");

// Install IronPdf as a Cake Addin
#addin nuget:?package=IronPdf&version=2023.12.6

Task("GeneratePDF")
    .Does(() =>
{
    // Your HTML content to convert to PDF
    var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

    // Convert HTML to PDF using IronPDF
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);

    // Save the generated PDF
    pdf.SaveAs("GeneratedDocument.pdf");
});

Task("Build")
    .IsDependentOn("GeneratePDF");

' Install IronPdf as a Cake Addin
#addin nuget:?package=IronPdf And version=2023.12.6

Task("GeneratePDF").Does(Sub()
	' Your HTML content to convert to PDF
	Dim htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>"

	' Convert HTML to PDF using IronPDF
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)

	' Save the generated PDF
	pdf.SaveAs("GeneratedDocument.pdf")
End Sub)

Task("Build").IsDependentOn("GeneratePDF")

W tym przykładzie skrypt Cake zawiera bibliotekę IronPDF jako dodatek (#addin "nuget:?package=IronPDF") i definiuje zadanie o nazwie "GeneratePDF". Zadanie to wykorzystuje funkcję ChromePdfRenderer biblioteki IronPDF do konwersji treści HTML na dokument PDF.

Możesz również dodać IronPDF jako manifest narzędzi do CakeBuild:

// Install IronPdf as a Cake Tool
#tool nuget:?package=IronPdf&version=2023.12.6

Włączając IronPDF do skryptu CakeBuild, możesz zautomatyzować generowanie plików PDF w ramach procesu kompilacji. Może to być szczególnie przydatne przy tworzeniu dokumentacji, raportów lub innych treści w formacie PDF potrzebnych w Twojej aplikacji. Więcej informacji na temat pracy z plikami PDF można znaleźć w dokumentacji IronPDF.