Stwórz swoją pierwszą aplikację

Z tego samouczka dowiesz się, jak utworzyć i uruchomić pierwszą aplikację interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI) w programie Visual Studio 2022 w systemie Windows lub Visual Studio 2022 dla komputerów Mac. Pomoże to upewnić się, że środowisko deweloperskie jest poprawnie skonfigurowane.

Program Visual Studio

Wymagania wstępne

• Program Visual Studio 2022 w wersji 17.8 lub nowszej z zainstalowanym obciążeniem interfejsu użytkownika aplikacji wieloplatformowej platformy .NET. Aby uzyskać więcej informacji, zobacz Instalacja.

Utwórz aplikację

W tym samouczku utworzysz pierwszą aplikację .NET MAUI w programie Visual Studio 2022 i uruchomisz ją w emulatorze systemu Android:

Tworzenie aplikacji MAUI platformy .NET dla systemu iOS w systemie Windows wymaga hosta kompilacji dla komputerów Mac. Jeśli nie musisz specjalnie kierować do systemu iOS i nie masz komputera Mac, rozważ rozpoczęcie pracy z systemem Android lub Windows.

W tym samouczku utworzysz pierwszą aplikację .NET MAUI w programie Visual Studio i uruchomisz ją w symulatorze systemu iOS:

W tym samouczku utworzysz pierwszą aplikację .NET MAUI w programie Visual Studio 2022 i uruchomisz ją w systemie Windows:

1. Uruchom program Visual Studio 2022. W oknie startowym kliknij pozycję Utwórz nowy projekt, aby utworzyć nowy projekt :

   

2. W oknie Tworzenie nowego projektu wybierz pozycję MAUI z listy rozwijanej Wszystkie typy projektów, wybierz szablon aplikacja .NET MAUI, a następnie kliknij przycisk Dalej:

   

3. W oknie Konfigurowanie nowego projektu nadaj projektowi nazwę, wybierz odpowiednią lokalizację, a następnie kliknij przycisk Dalej:

   

4. W oknie Dodatkowe informacje wybierz wersję platformy .NET, którą chcesz kierować, a następnie kliknij przycisk Utwórz:

   

5. Poczekaj na utworzenie projektu i jego zależności, które mają zostać przywrócone:

   

6. Na pasku narzędzi programu Visual Studio użyj listy rozwijanej Debuguj element docelowy , aby wybrać pozycję Emulatory systemu Android, a następnie wpis Emulator systemu Android:

   

7. Na pasku narzędzi programu Visual Studio naciśnij przycisk Emulator systemu Android:

   

   Program Visual Studio rozpocznie instalowanie domyślnego zestawu Android SDK i emulatora systemu Android.

8. W oknie Android SDK — Umowa licencyjna naciśnij przycisk Akceptuj:

   

9. W oknie Android SDK — Umowa licencyjna naciśnij przycisk Akceptuj:

   

10. W oknie dialogowym Kontrola konta użytkownika naciśnij przycisk Tak:

    

11. W oknie Akceptacja licencji naciśnij przycisk Akceptuj:

    

    Poczekaj, aż program Visual Studio pobierze zestaw SDK systemu Android i emulator systemu Android.

12. Na pasku narzędzi programu Visual Studio naciśnij przycisk Emulator systemu Android:

    

    Program Visual Studio rozpocznie tworzenie domyślnego emulatora systemu Android.

13. W oknie dialogowym Kontrola konta użytkownika naciśnij przycisk Tak:

    

14. W oknie Nowe urządzenie naciśnij przycisk Utwórz:

    

    Poczekaj, aż program Visual Studio pobierze, rozpakuj i utwórz emulator systemu Android.

15. Zamknij okno Menedżer urządzeń systemu Android:

    

16. Na pasku narzędzi programu Visual Studio naciśnij przycisk Pixel 5 — API 34 (Android 14.0 — API 33), aby skompilować i uruchomić aplikację:

    

    Program Visual Studio uruchomi emulator systemu Android, skompiluje aplikację i wdroży aplikację w emulatorze.

    Ostrzeżenie

    Przyspieszanie sprzętowe musi być włączone, aby zmaksymalizować wydajność emulatora systemu Android. Niepowodzenie w tym celu spowoduje, że emulator działa bardzo wolno. Aby uzyskać więcej informacji, zobacz Jak włączyć przyspieszanie sprzętowe za pomocą emulatorów systemu Android (Hyper-V i AEHD).

17. W uruchomionej aplikacji w emulatorze systemu Android naciśnij przycisk Kliknij mnie kilka razy i sprawdź, czy liczba kliknięć przycisków jest zwiększana.

    

Rozwiązywanie problemów

Jeśli kompilacja aplikacji nie powiedzie się, zapoznaj się z artykułem Rozwiązywanie znanych problemów, które mogą mieć rozwiązanie problemu. Jeśli problem jest związany z emulatorem systemu Android, zobacz Rozwiązywanie problemów z emulatorem systemu Android.

6. Na pasku narzędzi programu Visual Studio użyj listy rozwijanej Debuguj element docelowy , aby wybrać pozycję Framework , a następnie wpis net8.0-windows :

   

7. Na pasku narzędzi programu Visual Studio naciśnij przycisk Maszyna z systemem Windows, aby skompilować i uruchomić aplikację:

   

   Jeśli tryb dewelopera nie został włączony, program Visual Studio wyświetli monit o jego włączenie. W oknie dialogowym Włącz tryb dewelopera dla systemu Windows kliknij pozycję Ustawienia dla deweloperów, aby otworzyć aplikację Ustawienia:

   

   W aplikacji Ustawienia włącz tryb dewelopera i zaakceptuj zastrzeżenie:

   

   Zamknij aplikację Ustawienia, a następnie zamknij okno dialogowe Włącz tryb dewelopera dla systemu Windows.

8. W uruchomionej aplikacji naciśnij przycisk Kliknij mnie kilka razy i sprawdź, czy liczba kliknięć przycisków jest zwiększana:

   

Rozwiązywanie problemów

Jeśli kompilacja aplikacji nie powiedzie się, zapoznaj się z artykułem Rozwiązywanie znanych problemów, które mogą mieć rozwiązanie problemu.

6. W programie Visual Studio połącz środowisko IDE z hostem kompilacji dla komputerów Mac. Aby uzyskać więcej informacji, zobacz Pair to Mac for iOS development (Parowanie do komputerów Mac na potrzeby programowania w systemie iOS).

7. Na pasku narzędzi programu Visual Studio użyj listy rozwijanej Debuguj element docelowy , aby wybrać pozycję Symulatory systemu iOS, a następnie określony symulator systemu iOS:

   

8. Na pasku narzędzi programu Visual Studio naciśnij przycisk Uruchom dla wybranego symulatora systemu iOS, aby skompilować i uruchomić aplikację:

   

   Program Visual Studio skompiluje aplikację, uruchom zdalny symulator systemu iOS dla systemu Windows i wdroży aplikację w symulatorze zdalnym. Aby uzyskać więcej informacji na temat zdalnego symulatora systemu iOS dla systemu Windows, zobacz Remote iOS Simulator for Windows (Zdalny symulator systemu iOS dla systemu Windows).

9. W uruchomionej aplikacji naciśnij przycisk Kliknij mnie kilka razy i sprawdź, czy liczba kliknięć przycisków jest zwiększana.

   

Rozwiązywanie problemów

Jeśli kompilacja aplikacji nie powiedzie się, zapoznaj się z artykułem Rozwiązywanie znanych problemów, które mogą mieć rozwiązanie problemu.

Aplikacje MAUI platformy .NET przeznaczone dla komputerów Mac Catalyst można uruchamiać i debugować tylko przy użyciu programu Visual Studio 2022 dla komputerów Mac.

Visual Studio dla komputerów Mac

Uwaga

Visual Studio dla komputerów Mac ma zostać wycofany do 31 sierpnia 2024 r.Nowoczesne zasady cyklu życia firmy Microsoft. Visual Studio dla komputerów Mac 17.6 będzie nadal obsługiwany do 31 sierpnia 2024 r. wraz z aktualizacjami obsługi problemów z zabezpieczeniami i zaktualizowanymi platformami firmy Apple. Aby uzyskać więcej informacji, w tym alternatywne opcje programowania na komputerze Mac, zobacz Co się dzieje z Visual Studio dla komputerów Mac?.

Wymagania wstępne

• Zainstalowany program Visual Studio 2022 dla komputerów Mac w wersji 17.6 z zainstalowanymi obciążeniami .NET, .NET MAUI, Android i iOS. Aby uzyskać więcej informacji, zobacz Instalacja.

Ważne

Aby użyć Visual Studio dla komputerów Mac z platformą .NET 8, włącz pole wyboru Preferencje > programu Visual Studio > Inne > funkcje > w wersji zapoznawczej Użyj zestawu .NET 8 SDK, jeśli jest zainstalowany (wymaga ponownego uruchomienia).

Utwórz aplikację

W tym samouczku utworzysz pierwszą aplikację .NET MAUI w programie Visual Studio 2022 dla komputerów Mac i uruchomisz ją na wybranej platformie:

1. Uruchom program Visual Studio 2022 dla komputerów Mac. W oknie startowym kliknij pozycję Nowy , aby utworzyć nowy projekt:

   

2. W oknie Wybieranie szablonu dla nowego projektu wybierz pozycję Aplikacja wieloplatformowa>, wybierz szablon aplikacji .NET MAUI, a następnie kliknij przycisk Kontynuuj:

   

3. W oknie Konfigurowanie nowej aplikacji .NET MAUI wybierz wersję platformy .NET, którą chcesz wybrać jako docelową, a następnie kliknij przycisk Kontynuuj:

   

4. W oknie Konfigurowanie nowej aplikacji .NET MAUI wprowadź myMauiAppjako nazwę projektu, wybierz odpowiednią lokalizację dla projektu, a następnie kliknij przycisk Utwórz:

   

5. Poczekaj na utworzenie projektu i jego zależności, które mają zostać przywrócone:

   

6. Program Visual Studio 2022 dla komputerów Mac wyświetli pasek informacyjny, jeśli komputer Mac nie ma składników zestawu Android SDK. Kliknij przycisk Zainstaluj, aby zainstalować zestaw ANDROID SDK:

   

7. W oknie Zestaw SDK systemu Android zaznacz pole wyboru Pobierz i zainstaluj zależności systemu Android automatycznie, a następnie kliknij przycisk Pobierz i zainstaluj:

   

8. W oknie Akceptacja licencji kliknij przycisk Akceptuj:

   

   Poczekaj, aż program Visual Studio 2022 dla komputerów Mac pobierz zestaw Android SDK:

9. Na pasku narzędzi programu Visual Studio 2022 dla komputerów Mac zmień element docelowy debugowania na Emulator systemu Android:

   

10. Na pasku narzędzi programu Visual Studio 2022 dla komputerów Mac naciśnij przycisk Odtwarzania , aby skompilować aplikację i spróbować ją uruchomić:

    

    Program Visual Studio 2022 dla komputerów Mac skompiluje aplikację, a następnie utworzy domyślny emulator systemu Android.

11. W oknie Nowe urządzenie kliknij przycisk Utwórz:

    

12. W oknie Akceptacja licencji kliknij przycisk Akceptuj:

    

    Poczekaj, aż program Visual Studio 2022 dla komputerów Mac pobierze i zainstaluj emulator systemu Android.

13. Zamknij okno Menedżer urządzeń systemu Android:

    

14. Na pasku narzędzi programu Visual Studio 2022 dla komputerów Mac zmień element docelowy debugowania na Pixel 5 — API 34 (API 34):

    

15. Na pasku narzędzi programu Visual Studio 2022 dla komputerów Mac naciśnij przycisk Odtwarzania , aby uruchomić aplikację w emulatorze systemu Android:

    

    Program Visual Studio 2022 dla komputerów Mac uruchomi emulator systemu Android, skompiluje aplikację i wdroży aplikację w emulatorze.

16. W uruchomionej aplikacji w emulatorze systemu Android naciśnij przycisk Kliknij mnie kilka razy i sprawdź, czy liczba kliknięć przycisków jest zwiększana:

    

6. Na pasku narzędzi programu Visual Studio 2022 dla komputerów Mac upewnij się, że element docelowy debugowania jest ustawiony na symulator systemu iOS:

   

7. Na pasku narzędzi programu Visual Studio 2022 dla komputerów Mac naciśnij przycisk Odtwarzania , aby uruchomić aplikację w wybranym symulatorze systemu iOS:

   

   Program Visual Studio 2022 dla komputerów Mac uruchomi symulator systemu iOS, skompiluje aplikację i wdroży aplikację w symulatorze.

8. W uruchomionej aplikacji naciśnij przycisk Kliknij mnie kilka razy i sprawdź, czy liczba kliknięć przycisków jest zwiększana:

   

6. Na pasku narzędzi programu Visual Studio 2022 dla komputerów Mac upewnij się, że element docelowy debugowania ma wartość My Mac (MacCatalyst):

   

7. W programie Visual Studio 2022 dla komputerów Mac kliknij prawym przyciskiem myszy projekt MyMauiApp i wybierz polecenie Edytuj plik projektu. Następnie w edytorze plików projektu wstaw następujący kod XML przed pierwszym <ItemGroup>kodem :

   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-maccatalyst|AnyCPU'">
       <RuntimeIdentifiers>maccatalyst-x64;maccatalyst-arm64</RuntimeIdentifiers>
   </PropertyGroup>
   

8. Na pasku narzędzi programu Visual Studio 2022 dla komputerów Mac naciśnij przycisk Odtwarzania , aby uruchomić aplikację na komputerze Mac:

   

   Program Visual Studio 2022 dla komputerów Mac skompiluje i wdroży aplikację.

9. W uruchomionej aplikacji naciśnij przycisk Kliknij mnie kilka razy i sprawdź, czy liczba kliknięć przycisków jest zwiększana:

   

Aplikacje MAUI platformy .NET przeznaczone dla systemu Windows można uruchamiać i debugować tylko przy użyciu programu Visual Studio 2022.

Visual Studio Code (wersja zapoznawcza)

Uwaga

Obsługa interfejsu MAUI platformy .NET w programie Visual Studio Code jest nadal dostępna w wersji zapoznawczej. Wypróbuj i podziel się swoją opinią!

Instalowanie rozszerzenia

Postępuj zgodnie z instrukcjami , aby skonfigurować rozszerzenie .NET MAUI dla programu Visual Studio Code.

Tworzenie aplikacji

Aby utworzyć nową aplikację MAUI platformy .NET:

1. Kliknij pozycję Utwórz projekt .NET w Eksploratorze LUB CTRL/CMD+SHIFT+P>.NET: Nowy projekt....
2. Wybierz pozycję Aplikacja .NET MAUI lub Aplikacja platformy .NET MAUI Blazor.
3. Wybierz pusty folder. Jeśli eksplorator plików otworzy się ponownie, folder nie jest pusty.
4. Nazwij projekt.
5. Upewnij się, że projekt zostanie pomyślnie załadowany w Eksplorator rozwiązań, a następnie otwórz plik C# lub XAML.

Możesz również otworzyć istniejący projekt MAUI platformy .NET w programie Visual Studio Code za pośrednictwem pliku > Otwórz....

Aplikacja powinna być teraz widoczna w Eksplorator rozwiązań zestawu deweloperskiego języka C# w programie Visual Studio Code. Ponieważ rozszerzenie .NET MAUI zależy od zestawu deweloperskiego języka C#, możesz użyć wszystkich jego funkcji wraz z rozszerzeniem .NET MAUI.

Wybieranie urządzenia docelowego

Kliknij symbol { } nawiasów klamrowych w prawym dolnym rogu programu Visual Studio Code. W tym miejscu możesz zmienić projekt startowy, zmienić element docelowy debugowania na dowolny prawidłowy element na komputerze deweloperskim i przypiąć dowolne ustawienie na pasek stanu programu Visual Studio Code:

Możesz również ustawić projekt startowy i element docelowy debugowania na palecie poleceń, używając polecenia CTRL/CMD+SHIFT+P i wyszukując ciąg ".NET MAUI".

Domyślnie można wdrożyć na lokalnej maszynie deweloperów z systemem macOS lub Windows. W systemie macOS można również wdrożyć w symulatorach systemu iOS.

Jeśli chcesz używać emulatorów systemu Android, wykonaj następujące kroki:

1. Przejdź do terminalu na <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/latest/bin/adres .
2. Uruchom sdkmanager --install emulator system i sdkmanager --install system-images;android-33;google_apis;x86_64 w systemie Windows lub ./sdkmanager --install emulator w ./sdkmanager --install system-images;android-33;google_apis;x86_64 systemie macOS.
3. Następnie możesz utworzyć nowy emulator w wierszu polecenia za pomocą menedżera avdmanager systemu Android. Można na przykład uruchomić polecenie avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64" w systemie Windows lub ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64" w systemie macOS.

Można również debugować na fizycznych urządzeniach z systemem Android.

Debugowanie aplikacji

Aby debugować aplikację, przejdź do menu Uruchamianie i debugowanie programu Visual Studio Code, a następnie wybierz przycisk "Uruchom i debuguj". Alternatywnie możesz użyć F5 polecenia , aby rozpocząć sesję debugowania. Jeśli program Visual Studio Code wyświetli monit o wybranie debugera, upewnij się, że wybrano pozycję ".NET MAUI".

Debuger automatycznie wybierze docelowy debugowanie i projekt startowy ustawiony w menu nawiasów klamrowych { } . Jeśli nic nie zostało wybrane, zostanie wyświetlony monit o wybranie elementu docelowego debugowania.

Po rozpoczęciu debugowania aplikacji możesz użyć wbudowanych narzędzi debugowania programu Visual Studio Code, aby ustawić punkty przerwania, krok w całym kodzie i nie tylko.

Dowiedz się więcej

Jeśli wystąpią problemy z rozszerzeniem, możesz wykonać kroki rozwiązywania problemów, zapoznać się z naszymi znanymi problemami lub przekazać opinię.

Następne kroki

W tym samouczku przedstawiono sposób tworzenia i uruchamiania pierwszej aplikacji interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI).

Aby poznać podstawy tworzenia aplikacji za pomocą interfejsu MAUI platformy .NET, zobacz Tworzenie aplikacji MAUI platformy .NET. Alternatywnie, aby zapoznać się z pełnym kursem szkoleniowym .NET MAUI, zobacz Tworzenie aplikacji mobilnych i klasycznych przy użyciu programu .NET MAUI.