Samouczek: tworzenie biblioteki klas platformy .NET przy użyciu Visual Studio dla komputerów Mac

Ważne

Firma Microsoft ogłosiła wycofanie Visual Studio dla komputerów Mac. Visual Studio dla komputerów Mac nie będą już obsługiwane od 31 sierpnia 2024 r. Alternatywy obejmują:

• Program Visual Studio Code z zestawem deweloperskim języka C# i powiązanymi rozszerzeniami, takimi jak .NET MAUI i Unity.
• Program Visual Studio uruchomiony w systemie Windows na maszynie wirtualnej na komputerze Mac.
• Program Visual Studio uruchomiony w systemie Windows na maszynie wirtualnej w chmurze.

Aby uzyskać więcej informacji, zobacz Visual Studio dla komputerów Mac ogłoszenie o wycofaniu.

W tym samouczku utworzysz bibliotekę klas zawierającą jedną metodę obsługi ciągów.

Biblioteka klas definiuje typy i metody wywoływane przez aplikację. Jeśli biblioteka jest przeznaczona dla platformy .NET Standard 2.0, może być wywoływana przez dowolną implementację platformy .NET (w tym .NET Framework), która obsługuje platformę .NET Standard 2.0. Jeśli biblioteka jest przeznaczona dla platformy .NET 5, może być wywoływana przez dowolną aplikację docelową platformy .NET 5. W tym samouczku przedstawiono sposób kierowania platformy .NET 5.

Uwaga

Twoja opinia jest bardzo ceniona. Istnieją dwa sposoby przekazywania opinii do zespołu deweloperów w Visual Studio dla komputerów Mac:

• W Visual Studio dla komputerów Mac wybierz pozycję Pomoc>Zgłoś problem z menu lub Zgłoś problem na ekranie powitalnym, co spowoduje otwarcie okna zgłaszania raportu o usterce. Swoje opinie możesz śledzić w portalu Społeczność deweloperów.
• Aby utworzyć sugestię, wybierz pozycję Pomoc>Podaj sugestię z menu lub Podaj sugestię na ekranie powitalnym, który spowoduje przejście do strony internetowej społeczności deweloperów Visual Studio dla komputerów Mac.

Wymagania wstępne

• Zainstaluj Visual Studio dla komputerów Mac w wersji 8.8 lub nowszej. Wybierz opcję instalacji platformy .NET Core. Instalowanie platformy Xamarin jest opcjonalne na potrzeby programowania na platformie .NET. Aby uzyskać więcej informacji, zobacz następujące zasoby:

  • Samouczek: instalowanie Visual Studio dla komputerów Mac.
  • Obsługiwane wersje systemu macOS.
  • Wersje platformy .NET obsługiwane przez Visual Studio dla komputerów Mac.

Tworzenie rozwiązania przy użyciu projektu biblioteki klas

Rozwiązanie programu Visual Studio służy jako kontener dla co najmniej jednego projektu. Utwórz rozwiązanie i projekt biblioteki klas w rozwiązaniu. Później dodasz dodatkowe, powiązane projekty do tego samego rozwiązania.

1. Uruchom Visual Studio dla komputerów Mac.

2. W oknie startowym wybierz pozycję Nowy projekt.

3. W oknie dialogowym Wybieranie szablonu dla nowego projektu wybierz pozycję Biblioteka klas sieci Web i biblioteki>konsoli>, a następnie wybierz przycisk Dalej.

   

4. W oknie dialogowym Konfigurowanie nowej biblioteki klas wybierz pozycję .NET 5.0, a następnie wybierz pozycję Dalej.

5. Nadaj projektowi nazwę "StringLibrary" i rozwiązanie "ClassLibraryProjects". Pozostaw wybraną opcję Utwórz katalog projektu w katalogu rozwiązania. Wybierz pozycję Utwórz.

   

6. Z menu głównego wybierz pozycję Wyświetl>rozwiązanie, a następnie wybierz ikonę docku, aby zachować otwartą konsolę.

   

7. W okienku rozwiązania rozwiń StringLibrary węzeł, aby wyświetlić plik klasy dostarczony przez szablon Class1.cs. Ctrl-kliknij plik, wybierz polecenie Zmień nazwę z menu kontekstowego i zmień nazwę pliku na StringLibrary.cs. Otwórz plik i zastąp zawartość następującym kodem:

   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. Naciśnij klawisze {S (polecenie+S), aby zapisać plik.

9. Wybierz pozycję Błędy na marginesie u dołu okna IDE, aby otworzyć panel Błędy . Wybierz przycisk Build Output (Skompiluj dane wyjściowe ).

   

10. Wybierz pozycję Kompiluj>wszystko z menu.

    Rozwiązanie jest kompilowanie. Panel danych wyjściowych kompilacji pokazuje, że kompilacja zakończyła się pomyślnie.

    

Dodawanie aplikacji konsolowej do rozwiązania

Dodaj aplikację konsolową korzystającą z biblioteki klas. Aplikacja wyświetli użytkownikowi monit o wprowadzenie ciągu i zgłoszenie, czy ciąg zaczyna się od wielkiej litery.

1. W okienku rozwiązania naciśnij klawisze Ctrl-kliknij ClassLibraryProjectsrozwiązanie. Dodaj nowy projekt Aplikacja konsolowa, wybierając szablon z szablonów aplikacji sieci Web i konsoli>, a następnie wybierz pozycję Dalej.

2. Wybierz pozycję .NET 5.0 jako platformę docelową, a następnie wybierz pozycję Dalej.

3. Nadaj projektowi nazwę ShowCase. Wybierz pozycję Utwórz , aby utworzyć projekt w rozwiązaniu.

   

4. Otwórz plik Program.cs. Zastąp kod następującym kodem:

   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 monituje użytkownika o wprowadzenie ciągu. Wskazuje, czy ciąg zaczyna się od wielkiej litery. Jeśli użytkownik naciska klawisz Enter bez wprowadzania ciągu, aplikacja kończy się, a okno konsoli zostanie zamknięte.

   Kod używa zmiennej row do obsługi liczby wierszy danych zapisanych w oknie konsoli. Za każdym razem, gdy jest on większy lub równy 25, kod czyści okno konsoli i wyświetla użytkownikowi komunikat.

Dodawanie odwołania do projektu

Początkowo nowy projekt aplikacji konsolowej nie ma dostępu do biblioteki klas. Aby umożliwić wywoływanie metod w bibliotece klas, utwórz odwołanie projektu do projektu biblioteki klas.

1. W okienku Rozwiązania kliknij ctrl-kliknij węzeł Zależności nowego projektu ShowCase. W menu kontekstowym wybierz pozycję Dodaj odwołanie.

2. W oknie dialogowym Odwołania wybierz pozycję StringLibrary i wybierz przycisk OK.

Uruchom aplikację

1. Ctrl-kliknij projekt ShowCase i wybierz polecenie Uruchom projekt z menu kontekstowego.

2. Wypróbuj program, wprowadzając ciągi i naciskając klawisz Enter, a następnie naciśnij klawisz Enter , aby zakończyć.

   

Dodatkowe zasoby

• Opracowywanie bibliotek przy użyciu interfejsu wiersza polecenia platformy .NET
• Visual Studio 2019 dla komputerów Mac — Informacje o wersji
• Wersje platformy .NET Standard i obsługiwane przez nie platformy.

Następne kroki

W tym samouczku utworzono rozwiązanie i projekt biblioteki oraz dodano projekt aplikacji konsolowej, który korzysta z biblioteki. W następnym samouczku dodasz projekt testu jednostkowego do rozwiązania.

Testowanie biblioteki klas platformy .NET przy użyciu Visual Studio dla komputerów Mac