Руководство. Создание библиотеки классов .NET с помощью Visual Studio для Mac

Важно!

Корпорация Майкрософт объявила о прекращении работы Visual Studio для Mac. Visual Studio для Mac больше не будет поддерживаться с 31 августа 2024 г. Ниже представлены возможные альтернативы.

• Visual Studio Code с пакетом разработки C# и связанными расширениями, такими как .NET MAUI и Unity.
• Visual Studio, запущенная в Windows на виртуальной машине Mac.
• Visual Studio, запущенная в Windows на виртуальной машине в облаке.

Дополнительные сведения см. в Visual Studio для Mac объявлении о выходе на пенсию.

В этом учебнике вы создадите библиотеку классов с одним методом для обработки строк.

Библиотека классов определяет типы и методы, которые могут быть вызваны из любого приложения. Если библиотека предназначена для .NET Standard 2.0, она может быть вызвана любой реализацией .NET (включая .NET Framework), которая поддерживает .NET Standard 2.0. Если библиотека предназначена для .NET 5, ее можно вызвать с помощью любого приложения, предназначенного для .NET 5. В этом учебнике показано, как ориентироваться на .NET 5.

Примечание.

Ваш отзыв очень важен. Вы можете отправить отзыв о Visual Studio для Mac команде разработчиков двумя способами.

• В Visual Studio для Mac выберите пункт Справка>Сообщить о проблеме в меню или элемент Сообщить о проблеме на экране приветствия. При этом открывается окно для заполнения отчета об ошибках. Отслеживать свои отзывы можно на портале сообщества разработчиков.
• Чтобы внести предложение, выберите пункт Справка>Отправить предложение в меню или элемент Отправить предложение на экране приветствия. При этом откроется веб-страница сообщества разработчиков Visual Studio для Mac.

Необходимые компоненты

• Установите Visual Studio для Mac 8.8 или более поздней версии. Выберите вариант установки .NET Core. Установка Xamarin является необязательным шагом для разработки в .NET. Дополнительные сведения см. на следующих ресурсах:

  • Руководство. Установка Visual Studio для Mac.
  • Поддерживаемые версии macOS.
  • Версии .NET, поддерживаемые Visual Studio для Mac.

Создание решения с помощью проекта библиотеки классов

Решение Visual Studio служит контейнером для одного или нескольких проектов. Создайте решение и проект библиотеки классов в решении. Позже вы добавите дополнительные связанные проекты в одно решение.

1. Запустите Visual Studio для Mac.

2. В окне запуска выберите Создать проект.

3. В диалоговом окне Выберите шаблон из нового проекта выберите элементы Интернет и консоль>Библиотека>Библиотека классов и нажмите кнопку Далее.

   

4. В диалоговом окне Configure your new Class Library (Настройка новой библиотеки классов) выберите .NET 5.0, а затем нажмите кнопку Далее.

5. Присвойте проекту имя StringLibrary, а решению — ClassLibraryProjects. Оставьте флажок Создайте каталог проекта в каталоге решения установленным. Выберите Создать.

   

6. В главном меню выберите Вид>Решение и щелкните значок закрепления, чтобы панель была открытой.

   

7. На панели решения разверните StringLibrary узел, чтобы открыть файл класса, предоставленный шаблоном Class1.cs. Щелкните файл, выберите "Переименовать" в контекстном меню и переименуйте файл в StringLibrary.cs. Откройте файл и замените его содержимое следующим кодом:

   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. Нажмите ⌘S (Command+S), чтобы сохранить файл.

9. Выберите Ошибки в нижней части окна интегрированной среды разработки, чтобы открыть панель Ошибки. Нажмите кнопку Выходные данные сборки.

   

10. Выберите в меню Сборка>Собрать все.

    Выполняется сборка решения. На панели выходных данных отображается сообщение об успешной сборке.

    

Добавление консольного приложения в решение

Добавьте консольное приложение, использующее библиотеку классов. В приложении пользователю будет предложено ввести строку и сообщить, начинается ли строка с символа верхнего регистра.

1. На панели Решение щелкните решение ClassLibraryProjects при нажатой клавише CTRL. Добавьте новый проект Консольное приложение, выбрав шаблон в области Web and Console (Интернет и консоль)>Приложение, а затем нажмите кнопку Далее.

2. Выберите .NET 5.0 в качестве целевой платформы, а затем нажмите кнопку Далее.

3. Назовите проект ShowCase. Выберите Создать, чтобы создать проект в решении.

   

4. Откройте файл Program.cs. Замените код следующим кодом:

   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;
           }
       }
   }
   

   Сама программа предлагает пользователю ввести строку. Она сообщает, начинается ли строка с символа верхнего регистра. Если пользователь нажимает клавишу ВВОД, не введя никакой строки, приложение завершает свою работу и окно консоли закрывается.

   В этом коде используется переменная row для сохранения количества строк данных, записываемых в окно консоли. Всякий раз, когда оно достигает значения 25 или превышает его, код очищает окно консоли и отображается сообщение для пользователя.

Добавление ссылки на проект

Изначально новый проект консольного приложения не имеет доступа к библиотеке классов. Чтобы позволить приложению вызывать методы из библиотеки классов, создайте в проекте ссылку на проект библиотеки классов.

1. На панели Решения, удерживая нажатой клавишу CTRL, щелкните узел Зависимости нового проекта ShowCase. В контекстном меню выберите пункт Добавить ссылку.

2. В диалоговом окне Ссылки выберите проект StringLibrary и нажмите кнопку OK.

Выполнить приложение

1. Удерживая нажатой клавишу CTRL, щелкните проект ShowCase и выберите Запустить проект в контекстном меню.

2. Проверьте, как работает программа: вводите строки и нажимайте клавишу ВВОД. Чтобы выйти, просто нажмите клавишу ВВОД.

   

Дополнительные ресурсы

• Разработка библиотек с помощью .NET CLI
• Заметки о выпуске Visual Studio 2019 для Mac
• Список версий .NET Standard и поддерживаемых ими платформ

Следующие шаги

В этом учебнике вы создали решение и проект библиотеки, а также добавили проект консольного приложения, использующего эту библиотеку. В следующем руководстве вы добавите в решение проект модульного теста.

Тестирование библиотеки классов .NET с помощью Visual Studio для Mac