Öğretici - İlk uzantınızı oluşturma: Merhaba Dünya

  • Makale

Bu Merhaba Dünya örnek, Visual Studio için ilk uzantınızı oluşturma konusunda size yol gösterir. Bu öğreticide Visual Studio'ya yeni bir komutun nasıl ekleneceği gösterilmektedir.

Bu süreçte şunların nasıl yapılacağını öğrenirsiniz:

Bu örnekte, Visual C# kullanarak şuna benzeyen "Merhaba Dünya Say!" adlı özel bir menü düğmesi eklersiniz:

Screenshot showing a custom menu command.

Not

Bu makale, Windows üzerinde Visual Studio için geçerlidir. Mac için Visual Studio için bkz. Mac için Visual Studio'da Genişletilebilirlik kılavuzu.

Önkoşullar

Başlamadan önce, VSIX şablonunu ve örnek kodu içeren Visual Studio uzantısı geliştirme iş yükünü yüklediğinizden emin olun.

Not

Visual Studio genişletilebilirlik projesi oluşturmak için herhangi bir Visual Studio sürümünü (Community, Professional veya Enterprise) kullanabilirsiniz.

Genişletilebilirlik projesi oluşturma

  1. Dosya menüsünden Yeni Proje'yi> seçin. "vsix" araması yapın ve C# VSIX Projesini ve ardından İleri'yi seçin.

  2. Proje adı olarak "HelloWorld" yazın ve Oluştur'u seçin.

Screenshot showing creating a new VSIX project.

Şimdi helloworld projesini Çözüm Gezgini görmeniz gerekir.

Özel komut ekleme

  1. Bildirim dosyasını seçerseniz .vsixmanifest açıklama, yazar ve sürüm gibi değiştirilebilir seçenekleri görebilirsiniz.

  2. Projeye sağ tıklayın (çözüme değil). Bağlam menüsünde Ekle'yi ve ardından Yeni Öğe'yi seçin.

  3. Genişletilebilirlik bölümünü ve ardından Komut'u seçin.

  4. Alttaki Ad alanına Command.cs gibi bir dosya adı girin.

Screenshot showing creating a custom command.

Yeni komut dosyanız Çözüm Gezgini görünür. Kaynaklar düğümü altında, komutunuzla ilgili diğer dosyaları bulabilirsiniz. Örneğin, resmi değiştirmek istiyorsanız PNG dosyası buradadır.

Kaynak kodu değiştirme

Bu noktada, komut ve Düğme metni otomatik olarak oluşturulur ve bu kadar ilginç değildir. Değişiklik yapmak istiyorsanız VSCT dosyasını ve CS dosyasını değiştirebilirsiniz.

  • VSCT dosyası, komutlarınızı yeniden adlandırabileceğiniz ve Visual Studio komut sisteminde nereye gideceklerini tanımlayabildiğiniz yerdir. VSCT dosyasını keşfederken, VSCT kodu denetimlerinin her bölümünü açıklayan açıklamalara dikkat edin.

  • CS dosyası, tıklama işleyicisi gibi eylemleri tanımlayabileceğiniz yerdir.

  1. Çözüm Gezgini uzantısı VSPackage için VSCT dosyasını bulun. Bu örnekte buna HelloWorldPackage.vsct adı verilir.

  2. parametresini ButtonText olarak Say Hello World!değiştirin.

      ...
  <Button guid="guidCommandPackageCmdSet" id="CommandId" priority="0x0100" type="Button">
    <Parent guid="guidCommandPackageCmdSet" id="MyMenuGroup" />
    <Icon guid="guidImages" id="bmpPic1" />
    <Strings>
        <ButtonText>Say Hello World!</ButtonText>
    </Strings>
  </Button>
  ...

  3. Çözüm Gezgini dönün ve Command.cs dosyasını bulun. yönteminde Execute dizesini message olarak string.Format(..)Hello World!değiştirin.

      ...
  private void Execute(object sender, EventArgs e)
  {
    ThreadHelper.ThrowIfNotOnUIThread();
    string message = "Hello World!";
    string title = "Command";

    // Show a message box to prove we were here
    VsShellUtilities.ShowMessageBox(
        this.ServiceProvider,
        message,
        title,
        OLEMSGICON.OLEMSGICON_INFO,
        OLEMSGBUTTON.OLEMSGBUTTON_OK,
        OLEMSGDEFBUTTON.OLEMSGDEFBUTTON_FIRST);
  }
  ...

Değişikliklerinizi her dosyaya kaydettiğinizden emin olun.

Çalıştırın

Artık kaynak kodunu Visual Studio Deneysel Örneği'nde çalıştırabilirsiniz.

1. Adım. Hata Ayıklamayı Başlat komutunu çalıştırmak için F5 tuşunabasın. Bu komut projenizi oluşturur ve hata ayıklayıcısını başlatır ve Deneysel Örnek adlı yeni bir Visual Studio örneği başlatır.

2. Adım. Deneysel Örneğin Araçlar menüsünde say Merhaba Dünya! seçeneğine tıklayın.

Screenshot showing that the custom command displays a message box.

Yeni özel komutunuzun çıkışını görmeniz gerekir; bu örnekte ekranın ortasında size Merhaba Dünya! iletisini veren iletişim kutusu görüntülenir.

Sonraki adımlar

Visual Studio Genişletilebilirliği ile çalışmanın temellerini öğrendiğinize göre, burada daha fazla bilgi edinebilirsiniz: