.NET Derleyici Platformu SDK'sı

Derleyiciler, bu kodun söz dizimini ve semantiğini doğrulayan ayrıntılı bir uygulama kodu modeli oluşturur. Kaynak koddan yürütülebilir çıktı oluşturmak için bu modeli kullanır. .NET Derleyici Platformu SDK'sı bu modele erişim sağlar. Üretkenliğimizi artırmak için IntelliSense, yeniden düzenleme, akıllı yeniden adlandırma, "Tüm başvuruları bul" ve "Tanıma git" gibi tümleşik geliştirme ortamı (IDE) özelliklerine giderek daha fazla güveniyoruz. Kod kalitemizi geliştirmek için kod analizi araçlarına ve uygulama yapımına yardımcı olmak için kod oluşturuculara güveniyoruz. Bu araçlar daha akıllı hale gelince, uygulama kodunu işlerken yalnızca derleyicilerin oluşturduğu modelin daha fazlasına erişmeleri gerekir. Bu, Roslyn API'lerinin temel misyonudur: opak kutuları açmak ve araçların ve son kullanıcıların kodumuz hakkında derleyicilerin sahip olduğu zengin bilgileri paylaşmasına izin vermek. Roslyn aracılığıyla opak kaynak kodu ve nesne kod dışarı çeviricileri olmak yerine, derleyiciler platformlar haline gelir: Araçlarınızda ve uygulamalarınızda kodla ilgili görevler için kullanabileceğiniz API'ler.

.NET Derleyici Platformu SDK'sı kavramları

.NET Derleyici Platformu SDK'sı, kod odaklı araçlar ve uygulamalar oluşturma engelini önemli ölçüde düşürür. Meta programlama, kod oluşturma ve dönüştürme, C# ve Visual Basic dillerinin etkileşimli kullanımı ve C# ile Visual Basic'in etki alanına özgü dillere eklenmesi gibi alanlarda yenilikler için birçok fırsat oluşturur.

.NET Derleyici Platformu SDK'sı, kodlama hatalarını bulup düzelten çözümleyiciler ve kod düzeltmeleri oluşturmanıza olanak tanır. Çözümleyiciler , düzeltilmesi gereken uygulamaları algılamak için söz dizimini (kodun yapısı) ve semantiği anlar. Kod düzeltmeleri çözümleyiciler veya derleyici tanılamaları tarafından bulunan kodlama hatalarını gidermek için bir veya daha fazla önerilen düzeltme sağlar. Genellikle çözümleyici ve ilişkili kod düzeltmeleri tek bir projede birlikte paketlenir.

Çözümleyiciler ve kod düzeltmeleri, kodu anlamak için statik analiz kullanır. Kodu çalıştırmaz veya başka test avantajları sağlamaz. Ancak, genellikle hatalara, istenmeyen kodlara veya standart kılavuz ihlaline yol açan uygulamalara işaret edebilir.

Çözümleyicilere ve kod düzeltmelerine ek olarak, .NET Derleyici Platformu SDK'sı kod yeniden düzenlemeleri oluşturmanıza da olanak tanır. Ayrıca bir C# veya Visual Basic kod tabanını incelemenize ve anlamanıza olanak tanıyan tek bir API kümesi sağlar. Bu tek kod tabanını kullanabileceğiniz için, .NET Derleyici Platformu SDK'sı tarafından sağlanan sentaktik ve semantik analiz API'lerini kullanarak analiz araçlarını ve kod düzeltmelerini daha kolay yazabilirsiniz. Derleyici tarafından yapılan çözümlemeyi çoğaltmanın büyük görevinden kurtularak, projeniz veya kitaplığınız için yaygın kodlama hatalarını bulma ve düzeltme konusunda daha odaklanmış bir göreve odaklanabilirsiniz.

Daha küçük bir avantaj, çözümleyicilerinizin ve kod düzeltmelerinizin daha küçük olması ve Visual Studio'ya yüklendiğinde projedeki kodu anlamak için kendi kod tabanınızı yazmanızdan çok daha az bellek kullanmasıdır. Derleyici ve Visual Studio tarafından kullanılan sınıfları kullanarak kendi statik çözümleme araçlarınızı oluşturabilirsiniz. Bu, ekibinizin IDE'nin performansı üzerinde belirgin bir etki yaratmadan çözümleyicileri ve kod düzeltmelerini kullanabileceği anlamına gelir.

Çözümleyiciler ve kod düzeltmeleri yazmak için üç ana senaryo vardır:

1. Takım kodlama standartlarını zorunlu kılma
2. Kitaplık paketleriyle ilgili rehberlik sağlama
3. Genel rehberlik sağlama

Takım kodlama standartlarını zorunlu kılma

Birçok ekip, diğer ekip üyeleriyle birlikte kod incelemeleri aracılığıyla uygulanan kodlama standartlarına sahiptir. Çözümleyiciler ve kod düzeltmeleri bu işlemi çok daha verimli hale getirir. Kod incelemeleri, bir geliştirici çalışmalarını ekipte bulunan diğer kişilerle paylaştığında gerçekleşir. Geliştirici, yorum almadan önce yeni bir özelliği tamamlamak için gerekli tüm zamanı harcamış olacak. Geliştirici, ekibin uygulamalarıyla eşleşmeyen alışkanlıkları pekiştirirken haftalar geçebilir.

Çözümleyiciler, geliştirici kod yazarken çalışır. Geliştirici, yönergeleri hemen takip etmeyi teşvik eden anında geri bildirim alır. Geliştirici, prototip oluşturmaya başlar başlamaz uyumlu kod yazmak için alışkanlıklar oluşturur. Özellik, insanların gözden geçirmesi için hazır olduğunda, tüm standart yönergeler zorunlu kılınmıştır.

Teams, ekip kodlama uygulamalarını ihlal eden en yaygın uygulamaları arayabilecek çözümleyiciler ve kod düzeltmeleri oluşturabilir. Bunlar, standartları uygulamak için her geliştiricinin makinesine yüklenebilir.

Tavsiye

Kendi çözümleyicinizi oluşturmadan önce yerleşik çözümleyicilere göz atın. Daha fazla bilgi için bkz. Kod stili kurallar.

Kitaplık paketleriyle ilgili rehberlik sağlama

NuGet'te .NET geliştiricilerinin kullanabileceği çok sayıda kitaplık vardır. Bunlardan bazıları Microsoft'tan, bazıları üçüncü taraf şirketlerden, bazıları ise topluluk üyelerinden ve gönüllülerden gelir. Bu kitaplıklar, geliştiriciler bu kitaplıklarla başarılı olduğunda daha fazla benimseme ve daha yüksek incelemeler alır.

Belge sağlamanın yanı sıra, kitaplığınızın yaygın yanlış kullanımlarını bulup düzelten çözümleyiciler ve kod düzeltmeleri de sağlayabilirsiniz. Bu anında düzeltmeler, geliştiricilerin daha hızlı başarılı hale gelmelerine yardımcı olur.

NuGet'te kitaplığınızla çözümleyicileri ve kod düzeltmelerini paketleyebilirsiniz. Bu senaryoda, NuGet paketinizi yükleyen her geliştirici çözümleyici paketini de yükler. Kitaplığınızı kullanan tüm geliştiriciler, hatalar ve önerilen düzeltmeler hakkında anında geri bildirim biçiminde ekibinizden hemen rehberlik alır.

Genel rehberlik sağlama

.NET geliştirici topluluğu deneyim sayesinde iyi çalışan desenler ve en iyi kaçınılan desenler keşfetti. Birkaç topluluk üyesi, önerilen kullanım kalıplarının uygulanmasını sağlayan çözümleyiciler oluşturmuştur. Daha fazla bilgi edindikçe, yeni fikirlere her zaman yer vardır.

Bu çözümleyiciler Visual Studio Market'e yüklenebilir ve Visual Studio kullanılarak geliştiriciler tarafından indirilebilir. Dile ve platforma yeni gelenler kabul edilen uygulamaları hızlı bir şekilde öğrenir ve .NET yolculuklarının başlarında üretken olurlar. Topluluk bu uygulamaları, bunlar daha yaygın olarak kullanılmaya başladıkça benimser.

Kaynak oluşturucular

Kaynak oluşturucular, derleme zamanlı metaprogramlamayı etkinleştirmeyi hedefler; yani, derleme zamanında oluşturulabilen ve derlemeye eklenebilen kod. Kaynak oluşturucular çalıştırmadan önce derlemenin içeriğini okuyabilir ve ek dosyalara erişebilir. Bu özellik, hem kullanıcı C# koduna hem de oluşturucuya özgü dosyalara giriş yapmalarını sağlar. Kaynak oluşturucu kılavuzunu kullanarak kademeli kaynak üreticileri oluşturmayı öğrenebilirsiniz.

Sonraki Adımlar

.NET Derleyici Platformu SDK'sı kod oluşturma, çözümleme ve yeniden düzenleme için en son dil nesne modellerini içerir. Bu bölümde .NET Derleyici Platformu SDK'sı hakkında kavramsal bir genel bakış sağlanmaktadır. Diğer ayrıntılara hızlı başlangıçlar, örnekler ve öğreticiler bölümlerinden ulaşabilirsiniz.

.NET Derleyici Platformu SDK'sı kavramları hakkında daha fazla bilgiyi şu beş konuda bulabilirsiniz:

• Söz dizimi görselleştiricisi ile kodu keşfetme
• Derleyici API modelini anlama
• Sözdizimi ile çalışmak
• Semantik ile çalışma
• Bir çalışma alanında çalışmak

Başlamak için .NET Derleyici Platformu SDK'sını yüklemeniz gerekir:

Yükleme yönergeleri - Visual Studio Yükleyicisi

Visual Studio Yükleyicisi'nde.NET Derleyici Platformu SDK'sını bulmanın iki farklı yolu vardır:

Visual Studio Yükleyicisi - İş Yükleri görünümünü kullanarak yükleme

.NET Derleyici Platformu SDK'sı, Visual Studio uzantısı geliştirme iş yükünün bir parçası olarak otomatik olarak seçilmez. İsteğe bağlı bir bileşen olarak seçmelisiniz.

1. Visual Studio Yükleyicisi'nin çalıştırılması
2. Değiştir'i seçin
3. Visual Studio uzantısı geliştirme iş yükünü denetleyin.
4. Özet ağacında Visual Studio uzantısı geliştirme düğümünü açın.
5. .NET Derleyici Platformu SDK'sı kutusunu işaretleyin. Bunu isteğe bağlı bileşenler altında son olarak bulacaksınız.

İsteğe bağlı olarak , DGML düzenleyicisinin görselleştiricide grafikleri görüntülemesini de istersiniz:

1. Özet ağacında Tek tek bileşenler düğümünü açın.
2. DGML düzenleyicisi kutusunu işaretleyin

Visual Studio Yükleyicisi - Tek bileşenler sekmesini kullanarak yükleme

1. Visual Studio Yükleyicisi'nin çalıştırılması
2. Değiştir'i seçin
3. Tek tek bileşenler sekmesini seçin
4. .NET Derleyici Platformu SDK'sı kutusunu işaretleyin. Derleyiciler, derleme araçları ve çalışma zamanları bölümünün altında en üstte bulabilirsiniz.

İsteğe bağlı olarak , DGML düzenleyicisinin görselleştiricide grafikleri görüntülemesini de istersiniz:

1. DGML düzenleyicisi kutusunu işaretleyin. Kod araçları bölümünde bulabilirsiniz.