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.12 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 proces instalowania domyślnego zestawu ANDROID SDK i emulatora systemu Android.

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

   

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

   

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

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

    

11. W oknie dialogowym Brak platformy zestawu SDK systemu Android naciśnij przycisk Zainstaluj:

    

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

    

    Poczekaj, aż program Visual Studio zainstaluje składniki zestawu Android SDK.

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

    

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

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

    

15. Na pasku narzędzi programu Visual Studio naciśnij przycisk Pixel 7 — API 35 (Android 15.0 — API 35):

    

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

    

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

    

    Poczekaj na zainstalowanie programu Visual Studio, aby pobrać zestaw SDK systemu Android.

18. Na pasku narzędzi programu Visual Studio naciśnij przycisk Pixel 7 — API 35 (Android 15.0 — API 35), 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).

19. 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 naciśnij przycisk Maszyna z systemem Windows, aby skompilować i uruchomić aplikację:

   

7. 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 Code.

Visual Studio Code

Wymagania wstępne

• Program Visual Studio Code z zainstalowanym i skonfigurowanym rozszerzeniem .NET MAUI:
  • Twoje konto Microsoft połączone z zestawem deweloperskim języka C#.
  • Zainstalowany zestaw SDK platformy .NET.
  • Zainstalowany zestaw .NET MAUI SDK.
  • Program Xcode zainstalowany na komputerze Mac, w tym środowiska uruchomieniowe symulatora i narzędzia wiersza polecenia Xcode, jeśli są przeznaczone dla platform firmy Apple.
  • Na komputerze powinny być zainstalowane Microsoft OpenJDK, SDK systemu Android i emulator Androida, jeśli celem jest rozwijanie na platformę Android.

Aby uzyskać więcej informacji, zobacz Instalacja.

Utwórz aplikację

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

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

W tym samouczku utworzysz pierwszą aplikację .NET MAUI w programie Visual Studio Code na komputerze Mac i uruchomisz ją w systemie macOS:

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

1. Uruchom program Visual Studio Code. W eksploratorze naciśnij Utwórz projekt platformy .NET:

   

   Alternatywnie naciśnij CTRL+SHIFT+P w systemie Windows lub CMD+SHIFT+P w systemie macOS, a następnie polecenie .NET: New Project....

2. W palecie poleceń wybierz szablon .NET MAUI App:

   

3. W oknie dialogowym Lokalizacja projektu wybierz lokalizację, w której ma zostać utworzony nowy projekt.

   Ważny

   Projekty muszą być tworzone w pustym folderze.

4. W palecie poleceń wprowadź nazwę nowego projektu i naciśnij ENTER:

   

5. W palecie poleceń naciśnij Utwórz projekt:

   

   Poczekaj na utworzenie projektu, akceptując folder jako zaufaną lokalizację, jeśli jest to wymagane.

6. W eksploratorze rozwiń węzeł główny projektu, a następnie otwórz plik C#, taki jak MainPage.xaml.cs:

   

7. W programie Visual Studio Code sprawdź, czy środowisko systemu Android jest poprawnie skonfigurowane, naciskając CTRL+SHIFT+P w systemie Windows lub CMD+SHIFT+P w systemie macOS, a następnie wybierając pozycję .NET MAUI: Konfigurowaniesystemu Android, a następnie Odśwież środowisko systemu Android. Wszelkie wykryte błędy muszą zostać rozwiązane.

8. Na pasku stanu w dolnej części programu Visual Studio Code naciśnij symbol nawiasów klamrowych { } i upewnij się, że Cel debugowania jest ustawiony na określony emulator systemu Android.

   

   Można również ustawić cel debugowania, naciskając CTRL+SHIFT+P w systemie Windows lub CMD+SHIFT+P w systemie macOS i wybierając .NET MAUI: Wybierz urządzenie z systemem Android z palety poleceń.

9. Skompiluj i uruchom aplikację w systemie Android, naciskając F5 lub naciskając przycisk Uruchom w prawym górnym rogu programu Visual Studio Code:

   

   Jeśli zostanie wyświetlony monit o wybranie debugera w palecie poleceń, wybierz pozycję C#, a następnie konfigurację uruchamiania projektu.

10. W uruchomionej aplikacji w wybranym emulatorze systemu Android naciśnij przycisk Kliknij mnie kilka razy i zobacz, że liczba kliknięć przycisku wzrasta.

    

Debugowanie aplikacji na urządzeniu z systemem Android

Aby debugować aplikację na urządzeniu z systemem Android:

1. Upewnij się, że urządzenie zostało skonfigurowane do wdrożenia. Aby uzyskać więcej informacji, zobacz Konfigurowanie urządzenia na potrzeby wdrażania.
2. Podłącz urządzenie do maszyny i wybierz je jako element docelowy debugowania w programie Visual Studio Code.
3. Uruchom aplikację.

7. W programie Visual Studio Code sprawdź, czy środowisko firmy Apple jest poprawnie skonfigurowane, naciskając CMD+SHIFT+P, a następnie wybierając pozycję .NET MAUI: SkonfigurujApple, a następnie Odśwież środowisko firmy Apple. Wszelkie wykryte błędy muszą zostać rozwiązane.

8. Na pasku stanu w dolnej części programu Visual Studio Code naciśnij symbol nawiasów klamrowych { } i upewnij się, że Debug Target jest ustawiony na określony symulator iOS.

   

   Można również ustawić docelowy debugowania, naciskając CMD+SHIFT+P i wybierając pozycję .NET MAUI: Wybierz urządzenia z systemem iOS z palety poleceń.

9. Skompiluj i uruchom aplikację w systemie iOS, naciskając F5 lub naciskając przycisk Uruchom w prawym górnym rogu programu Visual Studio Code:

   

   Jeśli zostanie wyświetlony monit o wybranie debugera w palecie poleceń, wybierz pozycję C#, a następnie konfigurację uruchamiania projektu.

10. W uruchomionej aplikacji w wybranym symulatorze systemu iOS naciśnij przycisk Kliknij mnie kilka razy i sprawdź, czy liczba kliknięć przycisku jest zwiększana.

    

Debugowanie aplikacji na urządzeniu z systemem iOS

Aby debugować aplikację na urządzeniu z systemem iOS:

1. Upewnij się, że dodałeś swój identyfikator Apple ID do Xcode w Xcode > Ustawienia > Konta.
2. Upewnij się, że urządzenie zostało zarejestrowane w twoim zespole, jeśli należysz do programu Apple Developer Program.
3. Włącz tryb 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. Aby uzyskać więcej informacji na temat trybu dewelopera, zobacz Włączanie trybu dewelopera na urządzeniu na developer.apple.com.
4. Podłącz urządzenie do maszyny i wybierz je jako element docelowy debugowania w programie Visual Studio Code.
5. Uruchom aplikację.

7. W programie Visual Studio Code sprawdź, czy środowisko firmy Apple jest poprawnie skonfigurowane, naciskając CMD+SHIFT+P, a następnie wybierając pozycję .NET MAUI: SkonfigurujApple, a następnie Odśwież środowisko firmy Apple. Wszelkie wykryte błędy muszą zostać rozwiązane.

8. Na pasku stanu w dolnej części programu Visual Studio Code naciśnij symbol nawiasów klamrowych { } i upewnij się, że Cel debugowania jest ustawiony na Twojego Maca.

   

   Można również ustawić cel debugowania, naciskając CMD+SHIFT+P i wybierając pozycję .NET MAUI: Wybierz urządzenia z systemem macOS z palety poleceń.

9. Skompiluj i uruchom aplikację w systemie macOS, naciskając F5 lub naciskając przycisk Uruchom w prawym górnym rogu programu Visual Studio Code:

   

   Jeśli zostanie wyświetlony monit o wybranie debugera w palecie poleceń, wybierz pozycję C#, a następnie konfigurację uruchamiania projektu.

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

    

7. Na pasku stanu w dolnej części programu Visual Studio Code naciśnij symbol nawiasów klamrowych { } i upewnij się, że Cel debugowania jest ustawiony na Windows:

   

   Możesz również ustawić cel debugowania, naciskając CTRL+SHIFT+P i wybierając pozycję .NET MAUI: Wybierz urządzenia z systemem Windows z palety poleceń.

8. Skompiluj i uruchom aplikację w systemie Windows, naciskając F5 lub naciskając przycisk Uruchom w prawym górnym rogu programu Visual Studio Code:

   

   Jeśli zostanie wyświetlony monit o wybranie debugera w palecie poleceń, wybierz pozycję C#, a następnie konfigurację uruchamiania projektu.

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 nie można skompilować i wdrożyć aplikacji, zapoznaj się z Rozwiązywanie znanych problemów, gdzie może znajdować się rozwiązanie twojego problemu.

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.