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 Code w systemie Windows, macOS lub Linux. 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łączanie trybu 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 Code

Wymagania wstępne

• Program Visual Studio Code z zainstalowanym rozszerzeniem .NET MAUI. Aby uzyskać więcej informacji, zobacz Instalacja.

Utwórz aplikację

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

1. Uruchom program Visual Studio Code. W Eksploratorze kliknij pozycję Utwórz projekt .NET w Eksploratorze. Alternatywnie wybierz 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 zostanie otwarty 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.

Uwaga

Możesz również otworzyć istniejący projekt MAUI platformy .NET w programie Visual Studio Code za pomocą menu Plik > 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

Aby wybrać urządzenie docelowe, kliknij symbol nawiasów klamrowych { } w prawym dolnym rogu programu Visual Studio Code. Możesz użyć tego symbolu, aby zmienić projekt startowy, zmienić element docelowy debugowania na dowolny prawidłowy 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 w palecie poleceń przy użyciu CTRL/CMD+SHIFT+P i wyszukać ciąg ".NET MAUI".

Możesz wdrożyć na lokalnej maszynie programistycznej (komputer z systemem Windows lub macOS z programem Xcode) bez żadnych dodatkowych kroków.

Nakierowywanie na system Android

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

1. Przejdź do terminalu na <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/adres .

2. Użyj polecenia sdkmanager , aby zainstalować emulator.

   W systemie Windows uruchom następujące polecenia w terminalu:

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   W systemie macOS uruchom następujące polecenia w terminalu:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Uwaga

   Cudzysłowy wokół sdkmanager argumentów wiersza polecenia są ważne.

3. Następnie możesz utworzyć nowy emulator w wierszu polecenia za pomocą menedżera avdmanager systemu Android.

   W systemie Windows uruchom następujące polecenia w terminalu:

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   W systemie macOS uruchom następujące polecenia w terminalu:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Uwaga

   Cudzysłowy wokół avdmanager argumentów wiersza polecenia są ważne.

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

Docelowy system iOS

Symulatory systemu iOS są wbudowane w program Xcode. Aby pobrać symulatory, upewnij się, że opcja jest wybrana do zainstalowania podczas pierwszego uruchomienia programu Xcode lub przejdź do pozycji Platformy ustawień > Xcode > i wybierz środowisko uruchomieniowe symulatora do zainstalowania.

Aby debugować przy użyciu urządzenia z systemem iOS, wykonaj następujące kroki przed podjęciem próby debugowania:

1. Określ identyfikator Apple ID na koncie ustawień > Xcode>.
2. Zarejestruj urządzenie z zespołem, jeśli należysz do programu Apple Developer Program.
3. Włącz tryb dewelopera na urządzeniu zgodnie z opisem w temacie Włączanie trybu dewelopera na urządzeniu. Przy pierwszym uruchomieniu aplikacji może zostać wyświetlone wyskakujące okienko na urządzeniu — upewnij się, że wybierzesz pozycję Zezwalaj.

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 , aby rozpocząć sesję debugowania. Jeśli program Visual Studio Code wyświetli monit o wybranie debugera, upewnij się, że wybrano język C#.

Uwaga

W wersji zapoznawczej rozszerzenia debuger został wymieniony jako .NET MAUI. W stabilnej wersji ta konfiguracja została zastąpiona językiem C#.

Debuger automatycznie wybierze docelowy i startowy projekt debugowania ustawiony w nawiasach klamrowych { } menu. Jeśli nic nie zostało wybrane, zostanie wyświetlony monit o wybranie miejsca 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ę ze 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.