🚴♂️İlk Projeyi Oluşturma | VSIX
Visual Studio 2019 üzerinde ilk eklentimizi oluşturma, ikon ve komutlar ekleme
Last updated
Was this helpful?
Visual Studio 2019 üzerinde ilk eklentimizi oluşturma, ikon ve komutlar ekleme
Last updated
Was this helpful?
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