🚴♂️İlk Projeyi Oluşturma | VSIX
Visual Studio 2019 üzerinde ilk eklentimizi oluşturma, ikon ve komutlar ekleme
Last updated
Visual Studio 2019 üzerinde ilk eklentimizi oluşturma, ikon ve komutlar ekleme
Last updated
© 2024 ~ Yunus Emre Ak ~ yEmreAk
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
☀️ Create New Project - VSIX Project alanından proje oluşturulur
🤔 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
🌟 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
🔨 *.vsixmanifest dosyasına ikon ve ön izleme resmi eklenmeli
➕ 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
