Öğretici: Mac için Visual Studio kullanarak .NET sınıf kitaplığı oluşturma

Önemli

Microsoft, Mac için Visual Studio kullanımdan kaldırıldığını duyurdu. Mac için Visual Studio artık 31 Ağustos 2024'den itibaren desteklenmeyecektir. Alternatifler şunlardır:

  • C# Dev Kit ile Visual Studio Code ve .NET MAUI ve Unity gibi ilgili uzantılar.
  • Mac'teki bir VM'de Windows üzerinde çalışan Visual Studio.
  • Bulutta bir VM'de Windows üzerinde çalışan Visual Studio.

Daha fazla bilgi için bkz. Mac için Visual Studio kullanımdan kaldırma duyurusu.

Bu öğreticide, tek bir dize işleme yöntemi içeren bir sınıf kitaplığı oluşturacaksınız.

Sınıf kitaplığı, bir uygulama tarafından çağrılan türleri ve yöntemleri tanımlar. Kitaplık .NET Standard 2.0'ı hedeflerse, .NET Standard 2.0'ı destekleyen herhangi bir .NET uygulaması (.NET Framework dahil) tarafından çağrılabilir. Kitaplık .NET 5'i hedeflerse, .NET 5'i hedefleyen herhangi bir uygulama tarafından çağrılabilir. Bu öğreticide .NET 5'i hedefleme gösterilmektedir.

Dekont

Geri bildiriminiz çok değerlidir. Mac için Visual Studio geliştirme ekibine geri bildirim sağlamanın iki yolu vardır:

  • Mac için Visual Studio menüsünden Sorun Bildirmeye Yardımcı Olun>veya Hoş Geldiniz ekranından Sorun Bildir'i seçin. Bu seçenek hata raporu oluşturmak için bir pencere açar. Geri bildiriminizi Geliştirici Topluluğu portalında izleyebilirsiniz.
  • Öneride bulunmak için menüden Yardım>Öneri Sağla'yı veya Hoş Geldiniz ekranından Öneri Sağla'yı seçerek Mac için Visual Studio Geliştirici Topluluğu web sayfasına gidin.

Ön koşullar

Sınıf kitaplığı projesiyle çözüm oluşturma

Visual Studio çözümü, bir veya daha fazla proje için kapsayıcı görevi görür. Çözümde bir çözüm ve sınıf kitaplığı projesi oluşturun. Daha sonra aynı çözüme ilgili başka projeler de ekleyeceksiniz.

  1. Mac için Visual Studio'ı başlatın.

  2. Başlangıç penceresinde Yeni Proje'yi seçin.

  3. Yeni projeniz için şablon seçin iletişim kutusunda Web ve Konsol>Kitaplığı>Sınıf Kitaplığı'nı ve ardından İleri'yi seçin.

    New Project dialog

  4. Yeni Sınıf Kitaplığınızı yapılandırın iletişim kutusunda .NET 5.0'ı ve ardından İleri'yi seçin.

  5. Projeyi "StringLibrary" olarak adlandırın ve çözümü "ClassLibraryProjects" olarak adlandırın. Çözüm dizini içinde proje dizini oluştur'u seçili bırakın. Create'u seçin.

    Visual Studio for Mac New project dialog options

  6. Ana menüden Çözümü Görüntüle'yi>seçin ve bölmeyi açık tutmak için takma birimi simgesini seçin.

    Dock icon for Solution pad

  7. Çözüm panelinde, class1.cs şablonu tarafından sağlanan sınıf dosyasını göstermek için düğümü genişletinStringLibrary. ctrl tuşunu basılı tutarak dosyaya tıklayın, bağlam menüsünden Yeniden Adlandır'ı seçin ve dosyayı StringLibrary.cs olarak yeniden adlandırın. Dosyasını açın ve içeriğini aşağıdaki kodla değiştirin:

    using System;
    
    namespace UtilityLibraries
    {
        public static class StringLibrary
        {
            public static bool StartsWithUpper(this string str)
            {
                if (string.IsNullOrWhiteSpace(str))
                    return false;
    
                char ch = str[0];
                return char.IsUpper(ch);
            }
        }
    }
    
  8. Dosyayı kaydetmek için ⌘S (komut+S) tuşlarına basın.

  9. IDE penceresinin alt kısmındaki kenar boşluğunda Hatalar'ı seçerek Hatalar panelini açın. Çıkış Oluştur düğmesini seçin.

    Bottom margin of the Visual Studio Mac IDE showing the Errors button

  10. Menüden Tümünü Derle'yi> seçin.

    Çözüm derlemeleri. Derleme çıkış paneli, derlemenin başarılı olduğunu gösterir.

    Visual Studio Mac Build output pane of the Errors panel with Build successful message

Çözüme konsol uygulaması ekleme

Sınıf kitaplığını kullanan bir konsol uygulaması ekleyin. Uygulama, kullanıcıdan bir dize girmesini ister ve dizenin büyük harf karakterle başlayıp başlamadığını bildirir.

  1. Çözüm panelinde ctrl tuşunu basılı tutarak çözüme ClassLibraryProjects tıklayın. Web ve Konsol Uygulaması şablonlarından şablonu seçerek yeni bir Konsol>Uygulaması projesi ekleyin ve İleri'yi seçin.

  2. Hedef Çerçeve olarak .NET 5.0'ı ve ardından İleri'yi seçin.

  3. Projeyi ShowCase olarak adlandırın. Projeyi çözümde oluşturmak için Oluştur'u seçin.

    Add ShowCase project

  4. Program.cs dosyasını açın. Kodu aşağıdaki kodla değiştirin:

    using System;
    using UtilityLibraries;
    
    class Program
    {
        static void Main(string[] args)
        {
            int row = 0;
    
            do
            {
                if (row == 0 || row >= 25)
                    ResetConsole();
    
                string? input = Console.ReadLine();
                if (string.IsNullOrEmpty(input)) break;
                Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                                  $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
                row += 3;
            } while (true);
            return;
    
            // Declare a ResetConsole local method
            void ResetConsole()
            {
                if (row > 0)
                {
                    Console.WriteLine("Press any key to continue...");
                    Console.ReadKey();
                }
                Console.Clear();
                Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
                row = 3;
            }
        }
    }
    

    Program, kullanıcıdan bir dize girmesini ister. Dizenin büyük harf karakterle başlayıp başlamadığını gösterir. Kullanıcı bir dize girmeden enter tuşuna basarsa uygulama sona erer ve konsol penceresi kapanır.

    Kod, konsol penceresine row yazılan veri satırlarının sayısını korumak için değişkenini kullanır. 25'ten büyük veya 25'e eşit olduğunda kod konsol penceresini temizler ve kullanıcıya bir ileti görüntüler.

Proje başvurusu ekleme

Başlangıçta, yeni konsol uygulaması projesinin sınıf kitaplığına erişimi yoktur. Sınıf kitaplığında yöntemleri çağırmasına izin vermek için, sınıf kitaplığı projesine bir proje başvurusu oluşturun.

  1. Çözümler panelinde, yeni ShowCase projesinin Bağımlılıklar düğümüne ctrl tuşunu basılı tutarak tıklayın. Bağlam menüsünde Başvuru Ekle'yi seçin.

  2. Başvurular iletişim kutusunda StringLibrary'yi ve ardından Tamam'ı seçin.

Uygulamayı çalıştırma

  1. ctrl tuşunu basılı tutarak ShowCase projesine tıklayın ve bağlam menüsünden Projeyi çalıştır'ı seçin.

  2. Dizeleri girip Enter tuşuna basarak programı deneyin, ardından çıkmak için Enter tuşuna basın.

    Visual Studio for Mac console window showing your app running

Ek kaynaklar

Sonraki adımlar

Bu öğreticide bir çözüm ve kitaplık projesi oluşturdunuz ve kitaplığı kullanan bir konsol uygulaması projesi eklediniz. Sonraki öğreticide çözüme bir birim testi projesi ekleyebilirsiniz.