🚴‍♂️İlk Projeyi Oluşturma | VSIX

Visual Studio 2019 üzerinde ilk eklentimizi oluşturma, ikon ve komutlar ekleme

💎 Ön Gereksinimler

Eklentiyi Visual Studio için C# ile programlayacağımızdan dolayı:

⏬ Visual Studio ve Visual Studio extension development iş yükü indirilmelidir
💁‍♂️ Eklenti için derinden bir C# bilgisi yerine hızlı bir öğrenmeye odaklanılması kafidir
🏃‍♂️ Hızlıca C# öğrenmek için CSharp Quick Guide sayfasına bakmalısın
👮‍♂️ Yazım standartları için CSharp Coding Standarts alanına da bakabilirsin

👨‍💻 Eklenti programlanır, derlenir ve çalıştırılır
🐙 GitHub üzerinden versiyon kontrol sistemi ile ilerleme kontrol edilir
⚗️ Derlenme ve test işlemleri Continuous Integration (CI) ile otomatikleştirilir
📡 Herkese açık stabil bir sürümü üzerinden eklenti yayınlanır
- 😅 Tabi bu sadece açık kaynak olmasını isterseniz yapılır
⏫ VS Gallery üzerine eklenti aktarılır

🤔 Proje isminden vazgeçmeniz veya ismini yanlış belirtmeniz durumunda projenin adını güncellemeniz gerekebilir
🔨 Solution Explorer üzerinden Properties alanından güncellenir

📃 *.vsix.manifest dosyası mafisesto dosyasıdır ve projenin ayarlarını içerir
🆔 Product ID kısmında <Projeİsmi>.<GUID> şeklinde olan değerden Projeİsmi silinir
🤵 Author alanında eklentiyi geliştiren ekibin ve kişinin adı bulunur
🏷️ Version kısmı Semantic Versionin tarzı ile uygulama sürüm bilgisini tutar
📖 Description alanına eklentinin ne işe yaradığına dair bilgi verilir
🎫 Tags kısmında eklentinin hitap ettiği konulara <konu>, <konu2>, ... şeklinde yer verilir, aramalarda bu şekilde çıkar
🖼️ Preview Image 175x175 ve Icon ise 90x90 boyutunda eklentinin ikon resmini barındırır
🔐 License alanına kendi lisans dosyanızın yolunu eklersiniz (örn. Apache License 2)

🌇 Install Targets alanından hangi sürümler üzerinde kullanabileceğinin tanımlaması yapılır
🆔 Identifier Visual Studio IDE türünün seçildiği alandır
🏷️ Version Range ise seçilen türde hangi sürümlere kadar desteklendiğini belirtir
📦 Dependencies kısmı eklentinin kullandığı veya bağlı olduğu framework veya kütüphanelerin belirtildiği kısımdır
🧰 Prerequisites ile gereksinimleri ve sürümlerini tanımlarız

🧙‍♂ Detaylı bilgi için YEmoji - Bağlantılar yapısına uygun oluşturulmuş:

alanlarına bakabilirsin.

🌟 PNG dışındaki formatları da destekler ama PNG kullan
📦 VSIX'de 3000 icon vardır bunları kullanabilmek için Extensibility Essentials 2019 eklentisini indir
⚙️ View -> Other Windows -> KnownMonikers

📝 Çıkan panelde seçilen ikonu Resource içerisine alttak özelliklerle eklemeliyiz:
- 16 width ile *Command.png icon dosyasını overwrite ederek
- 175 width ile Preview isimle
- 90 width ile Icon isimle
💦 *.vsct dosyası içerisinde silmen gereken kısımlar
- Bitmap alanında usedList kısmındaki değerlerden ilki hariç diğerlerini
- GuidSymbol alanındaki IDSymbol satırlarından ilki hariç diğerlerini
➕ Son eklenen resimleri projeye dahil etmek için Solution Explorer alanında sağdan 3. ikon Show all files ile resimleri bulup, onları seçip, sağ tıklayıp Include From Project demeliyiz

➕ Solution Explorer üzerinden projeye sağ tıklayıp Add -> New Item-> Command ile ilk komutumuzu ekliyoruz

🗃️ Yukarıdaki işlem ile projeye eklenen dosyalar
- <dosya ismi>.cs ve
- <proje ismi>.vsct ile butonları ve diğer fonksiyonelliklerin tanımlandığı dosya
- Resources dizini içerisine eklenti ile ilgili görsel objeler
🌟 İlerleyen konularda da yöneleceğimiz ve önerilen proje yapısı aşağıdaki gibidir

Last updated 2 months ago