Developer Tooling | The .NET Blog

azd + GitHub Copilot: Yapay Zeka Destekli Proje Kurulumu ve Akıllı Hata Çözümü

Emiliano Montesdeoca — Tue, 21 Apr 2026 00:00:00 +0000

Bu makale otomatik olarak çevrilmiştir. Orijinal İngilizce sürüm için buraya tıklayın.

Mevcut bir uygulamayı Azure’a dağıtmak isteyip boş bir azure.yaml dosyasına bakarak Express API’nizin Container Apps mı yoksa App Service mi kullanması gerektiğini hatırlamaya çalıştığınız o anı biliyor musunuz? O an artık çok daha kısa.

Azure Developer CLI (azd) artık GitHub Copilot ile iki somut şekilde entegre: azd init sırasında AI destekli proje iskele kurma ve dağıtımlar başarısız olduğunda akıllı hata giderme. Her iki özellik de tamamen terminalde kalıyor.

azd init Sırasında Copilot ile Kurulum

azd init çalıştırıldığında artık “Set up with GitHub Copilot (Preview)” seçeneği görünüyor. Seçin ve Copilot, gerçek kodunuzu temel alarak azure.yaml, altyapı şablonları ve Bicep modülleri oluşturmak için kod tabanınızı analiz eder.

azd init
# Seçin: "Set up with GitHub Copilot (Preview)"

Gereksinimler:

azd 1.23.11 veya üzeri — azd version ile kontrol edin veya azd update ile güncelleyin
Aktif GitHub Copilot aboneliği (Bireysel, İş veya Kurumsal)
GitHub CLI (gh) — gerekirse azd oturum açmanızı isteyecek

Gerçekten faydalı bulduğum şey: her iki yönde de çalışıyor. Sıfırdan mı inşa ediyorsunuz? Copilot doğru Azure hizmetlerini başından itibaren yapılandırmanıza yardımcı olur. Dağıtmak istediğiniz mevcut bir uygulamanız mı var? Copilot’u ona yöneltin — kodu yeniden yapılandırmadan konfigürasyon oluşturulur.

Gerçekte Ne Yapar

PostgreSQL bağımlılığına sahip bir Node.js Express API’niz olduğunu varsayalım. Container Apps ile App Service arasında manuel seçim yapmak ve ardından sıfırdan Bicep yazmak yerine, Copilot yığınınızı algılar ve şunları oluşturur:

Doğru language, host ve build ayarlarına sahip azure.yaml
Azure Container Apps için Bicep modülü
Azure Database for PostgreSQL için Bicep modülü

Ve herhangi bir şeyi değiştirmeden önce ön kontroller yapar — git çalışma dizininin temiz olduğunu doğrular, MCP sunucu araç iznini önceden sorar. Her şey bilginiz dahilinde gerçekleşir.

Copilot ile Hata Giderme

Dağıtım hataları kaçınılmazdır. Eksik parametreler, izin sorunları, SKU kullanılabilirlik sorunları — ve hata mesajı nadiren gerçekten bilmeniz gereken tek şeyi söyler: nasıl düzeltilir.

Copilot olmadan döngü şöyle görünür: hatayı kopyala → belgelerden ara → ilgisiz üç Stack Overflow cevabı oku → birkaç az CLI komutu çalıştır → tekrar dene ve umut et. azd‘de Copilot ile bu döngü çöküyor. Herhangi bir azd komutu başarısız olduğunda anında dört seçenek sunuluyor:

Explain — ne yanlış gittiğinin anlaşılır dilde açıklaması
Guidance — sorunu gidermek için adım adım talimatlar
Diagnose and Guide — tam analiz + Copilot düzeltmeyi uygular (onayınızla) + isteğe bağlı yeniden deneme
Skip — kendiniz halledin

Kritik nokta: Copilot’un projeniz, başarısız olan komut ve hata detayları hakkında zaten bağlamı var. Önerileri sizin durumunuza özeldir.

Varsayılan Davranışı Ayarlama

Her zaman aynı seçeneği seçiyorsanız etkileşimli istemi atlayın:

azd config set copilot.errorHandling.category troubleshoot

Değerler: explain, guidance, troubleshoot, fix, skip. Otomatik düzeltme ve yeniden denemeyi de etkinleştirebilirsiniz:

azd config set copilot.errorHandling.fix allow

İstediğiniz zaman etkileşimli moda geri dönün:

azd config unset copilot.errorHandling.category

Sonuç

En son sürümü edinmek için azd update çalıştırın ve bir sonraki projenizde azd init deneyin.

Orijinal duyuruyu buradan okuyun.

Node.js için C# ile .NET Native AOT Kullanarak Yerel Eklenti Yazma

Emiliano Montesdeoca — Tue, 21 Apr 2026 00:00:00 +0000

Bu makale otomatik olarak çevrilmiştir. Orijinal İngilizce sürüm için buraya tıklayın.

İşte sevdiğim bir senaryo: .NET araçları üzerinde çalışan bir ekibin node-gyp ile derlenen C++ ile yazılmış yerel Node.js eklentileri vardı. Çalışıyordu. Ama her geliştiricinin makinesinde Python’un yüklü olmasını gerektiriyordu — Python’un eski bir sürümü, dahası — sadece ekipten kimsenin hiç doğrudan dokunmayacağı bir paketi derlemek için.

Bunun üzerine çok makul bir soru sordular: zaten .NET SDK yüklüyken neden C++ yazıyoruz ki?

Cevap Native AOT oldu ve sonuç gerçekten zarif. C# Dev Kit ekibinden Drew Noakes bunu nasıl yaptıklarını anlattı.

Temel fikir

Node.js yerel eklentisi, Node.js’nin çalışma zamanında yükleyebildiği bir paylaşılan kütüphanedir (Windows’ta .dll, Linux’ta .so, macOS’ta .dylib). Arayüze N-API denir — kararlı, ABI uyumlu bir C API’si. N-API’nin kütüphaneyi hangi dilin ürettiğini umursamaz, sadece doğru sembolleri dışa aktarmasını önemser.

.NET Native AOT tam olarak bunu yapabilir. C# kodunuzu önceden isteğe bağlı giriş noktalarıyla yerel paylaşılan kütüphaneye derler.

Proje kurulumu

Proje dosyası minimumdur:

<Project Sdk="Microsoft.NET.Sdk">
 <PropertyGroup>
 <TargetFramework>net10.0</TargetFramework>
 <PublishAot>true</PublishAot>
 <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
 </PropertyGroup>
</Project>

PublishAot, SDK’ya dotnet publish‘te paylaşılan kütüphane üretmesini söyler.

Giriş noktasını dışa aktarma

Node.js, kütüphanenizin napi_register_module_v1‘i dışa aktarmasını bekler. C#’ta [UnmanagedCallersOnly] tam olarak bunu yapar:

[UnmanagedCallersOnly(
 EntryPoint = "napi_register_module_v1",
 CallConvs = [typeof(CallConvCdecl)])]
public static nint Init(nint env, nint exports)
{
 Initialize();
 RegisterFunction(env, exports, "readStringValue"u8, &ReadStringValue);
 return exports;
}

u8 soneki, herhangi bir encoding tahsisi olmadan doğrudan N-API’ye geçirilen UTF-8 string literaliyle bir ReadOnlySpan<byte> üretir.

TypeScript’ten çağırma

dotnet publish, platforma özgü yerel kütüphanenizi üretir. Onu .node olarak yeniden adlandırın ve standart require() ile kullanın:

const registry = require('./native/win32-x64/RegistryAddon.node') as RegistryAddon;
const sdkPath = registry.readStringValue(
 'SOFTWARE\\dotnet\\Setup\\InstalledVersions\\x64\\sdk',
 'InstallLocation'
);

İşte bu kadar. TypeScript’ten C#‘a, Python yok, C++ yok.

Sonuç

C# Dev Kit ekibi Python/C++ yükünü, ekipteki herkesin zaten nasıl yazılacağını ve hata ayıklayacağını bildiği temiz C# koduyla değiştirdi. Bu desen göründükten sonra karmaşık değil ve Native AOT’nun yeterince konuşulmayan gerçek bir sorunu çözdüğünün harika bir örneği.

.NET blogundaki orijinal yazıyı okuyun.