CakeBuilder .NET (Geliştiriciler İçin Nasıl Çalışır)

C# Gelişiminde Neden CakeBuild Kullanmalı?

1. C# Aşinalığı: Cake betikleri C# ile yazıldığından, geliştiriciler mevcut bilgi ve becerilerinden yararlanarak, yapı otomasyonunu C# projelerine entegre etmeyi dikişsiz hale getirebilirler.
2. Çapraz Platform Desteği: CakeBuild, Windows, Linux ve macOS'u destekleyen platformlar arası olacak şekilde tasarlanmıştır. Bu, farklı işletim sistemleri arasında tutarlı bir yapı süreci sağlar.
3. Genişletilebilirlik: Cake, işlevselliğini genişleten paketler olan eklentilerin kullanımını destekler. Bu genişletilebilirlik, geliştiricilerin Cake'i çeşitli araçlarla entegre etmelerini ve karmaşık yapı senaryolarını yönetmelerini sağlar.
4. Esneklik: Cake ile yapı süreciniz üzerinde ince ayar yapma olanağı sağlarsınız. Kodu derleme, testleri çalıştırma ya da uygulamaları paketleme olsun, yapı betiğinizi projenizin belirgin ihtiyaçlarına göre özelleştirebilirsiniz.

Kurulum

CakeBuild ile başlamak için Cake global araç manifestini yüklemeniz gerekmektedir. Bir terminal veya komut istemcisini açın ve aşağıdaki .NET araç komutunu çalıştırın:

dotnet tool install -g Cake.Tool

Visual Studio Kullanımı

CakeBuild'ı yüklemek için Visual Studio için Cake uzantısını kullanabilirsiniz. Visual Studio'da CakeBuild'ı nasıl yükleyeceğiniz aşağıda sıralanmıştır:

1. Visual Studio'yu Açın: Makinenizde Visual Studio'yu başlatın. Uzantıları destekleyen bir Visual Studio sürümünün yüklü olduğundan emin olun. Microsoft Visual Studio İndirmeler sürümünün en son 2022 versiyonunu indirin. Yeni bir Konsol Uygulaması oluşturun.

2. Uzantılar ve Güncellemeler Diyalog Kutusunu Açın:
   • Visual Studio'da, "Uzantılar" menüsüne gidin.
   • Açılır menüden "Uzantıları Yönet" seçeneğini seçin. Bu, Uzantılar ve Güncellemeler diyalog kutusunu açacaktır.

3. Cake Uzantısını Arayın:
   • Uzantılar ve Güncellemeler diyalog kutusunda, sol taraftaki "Çevrimiçi" sekmesine tıklayın.
   • Üst sağ köşedeki arama kutusunu kullanarak "Cake" girin ve Cake uzantısını arayın.

4. Cake Uzantısını Yükleyin:
   • Arama sonuçlarında "Cake for Visual Studio 2022" uzantısını bulun.
   • Uzantıyı indirmek ve yüklemek için "İndir" butonuna tıklayın.
5. Visual Studio'yu Yeniden Başlatın:
   • Kurulumdan sonra, Visual Studio'yu yeniden başlatmanız istenecektir.
   • Değişiklikleri uygulamak için Visual Studio'yu kapatın ve yeniden açın.

6. Kurulumu Doğrulayın:

   Visual Studio yeniden başladığında, Cake uzantısının yüklü olduğunu doğrulayabilirsiniz.

Cake uzantısının başarıyla eklendiğini göstermek için Yapı menü çubuğunda yeni bir "Build CakeBuild" seçeneği görmelisiniz.

Basit Bir Cake Betiği Oluşturma

Cake yüklendikten sonra, ayarlarınıza bağlı olarak basit Cake betikleri oluşturabilirsiniz. build.cake adında bir dosya oluşturun ve içine aşağıdaki içeriği koyun:

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)

Bu basit örnek betik, çalıştırıldığında "Hello, Cake!" yazdıran bir varsayılan hedef tanımlar.

Bir Cake Betiği Çalıştırma

Betiği çağıştırmak için build.cake dosyasını içeren klasöre gidin ve aşağıdaki komutu uygulayın:

dotnet cake

Bu, betikteki varsayılan hedefi çalıştıracak ve "Hello, Cake!" mesajını konsola gösterecektir.

Derleme ve Test Etme

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")

Bu örnek, C# kodunu derleyen ve MSBuild ve .NET Test SDK'sını kullanarak birim testlerini çalıştıran bir yapı betiği gösterir.

Paketleme ve Dağıtım

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")

Bu betik, NuGet kullanarak bir C# uygulamasını paketleme ve dağıtım görevlerini sergiler.

IronPDF: Bir PDF Oluşturma Kütüphanesi

CakeBuild ile IronPDF Görevlerini Otomatikleştirme

PDF belgeleri oluşturma sürecini otomatikleştirmek için IronPDF'i yapı sürecinize entegre etmek istediğiniz bir senaryoyu düşünelim. İşte Cake betiğinizi nasıl geliştirebileceğiniz:

// 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");

Bu örnekte, Cake betiği IronPDF kütüphanesini bir ek (#addin "nuget:?package=IronPDF") olarak içerir ve 'GeneratePDF' adında bir görev tanımlar. Bu görev, HTML içeriğini bir PDF dokümanına çevirmek için IronPDF'nin ChromePdfRenderer kullanır.

IronPDF'i CakeBuild'a bir araç manifesti olarak da ekleyebilirsiniz:

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

IronPDF'i CakeBuild betiğinize dahil ederek, PDF oluşturmayı yapı sürecinizin bir parçası olarak otomatikleştirebilirsiniz. Bu, belgeler, raporlar veya uygulamanızda ihtiyaç duyulan herhangi bir PDF içeriği oluşturmak için özellikle yararlı olabilir. PDF'lerle daha fazla çalışma için IronPDF belgelere başvurun.