Utwórz aplikację UWP „Witaj, Świecie!” (XAML)

W tym samouczku pokazano, jak używać języka XAML i języka C# z Native AOT (przed czasem) w celu utworzenia prostej aplikacji "Hello, World!" dla Universal Windows Platform (UWP) w Windows. Za pomocą pojedynczego projektu w Microsoft Visual Studio można utworzyć aplikację działającą we wszystkich obsługiwanych wersjach Windows 10 i Windows 11.

Tutaj dowiesz się, jak wykonywać następujące czynności:

  • Utwórz nowy projekt UWP w Visual Studio.
  • Napisz kod XAML, aby zmienić interfejs użytkownika na stronie początkowej.
  • Uruchom projekt na komputerze lokalnym w Visual Studio.
  • Użyj narzędzia SpeechSynthesizer , aby podczas naciskania przycisku komunikować się z aplikacją.

Wymagania wstępne

Uwaga / Notatka

W tym samouczku używany jest Visual Studio 2026. Jeśli używasz innej wersji Visual Studio, może to wyglądać nieco inaczej.

Krok 1. Tworzenie nowego projektu w Visual Studio

  1. Uruchom Visual Studio.

  2. W menu File wybierz Nowy > Project aby otworzyć okno dialogowe Nowy Project.

  3. Filtruj listę dostępnych szablonów, wybierając C# z listy rozwijanej Languages oraz UWP z listy rozwijanej Project types, aby zobaczyć listę dostępnych szablonów projektów UWP dla deweloperów C#.

    Zrzut ekranu przedstawiający ekran Tworzenie nowego projektu

    (Jeśli nie widzisz żadnych szablonów UWP, może brakować składników do tworzenia aplikacji UWP. Możesz powtórzyć proces instalacji i dodać obsługę UWP, otwierając Instalatora Visual Studio z menu Start Windows. Aby uzyskać więcej informacji, zobacz Konfigurowanie Visual Studio na potrzeby programowania na platformie UWP.)

  4. Wybierz szablon Pusta aplikacja UWP.

    Ważne

    Szablon pustej aplikacji UWP jest domyślny i jest przeznaczony dla najnowszej .NET z natywną funkcją AOT. Jeśli widzisz szablon UWP Blank App (.NET Native), jest to starszy szablon przeznaczony dla starszego środowiska uruchomieniowego .NET Native. Aplikacje korzystające z nowoczesnego szablonu .NET mają dostęp do najnowszych funkcji .NET i języka C#, lepszej wydajności i lepszych narzędzi. Aby uzyskać więcej informacji na temat różnic, zobacz Modernizenie aplikacji platformy UWP przy użyciu .NET i natywnego AOT.

  5. Wybierz Dalej i wprowadź ciąg "HelloWorld" jako nazwę projektu. Wybierz Utwórz.

    Zrzut ekranu przedstawiający ekran Konfigurowanie nowego projektu

    Uwaga / Notatka

    Jeśli po raz pierwszy użyto Visual Studio, może zostać wyświetlone okno dialogowe Ustawienia z prośbą o włączenie trybu Developer. Tryb dewelopera to specjalne ustawienie, które umożliwia korzystanie z określonych funkcji, takich jak uprawnienia do bezpośredniego uruchamiania aplikacji, a nie tylko ze Sklepu. Aby uzyskać więcej informacji, przeczytaj Włączanie urządzenia na potrzeby programowania. Aby kontynuować pracę z tym przewodnikiem, wybierz tryb dewelopera, kliknij przycisk Taki zamknij okno dialogowe.

    zrzut ekranu przedstawiający ekran Ustawień Windows dla deweloperów

  6. Zostanie wyświetlone okno dialogowe Wersja docelowa/Minimalna wersja. Ustawienia domyślne są odpowiednie dla tego samouczka, dlatego wybierz pozycję OK, aby utworzyć projekt.

    zrzut ekranu okna dialogowego Nowy projekt Windows w Visual Studio

  7. Po otwarciu nowego projektu jego pliki są wyświetlane w okienku Eksplorator rozwiązań po prawej stronie. Może być konieczne wybranie karty Eksplorator rozwiązań zamiast karty Properties lub GitHub Copilot Chat, aby wyświetlić pliki.

    Zrzut ekranu przedstawiający okienko Visual Studio Eksplorator rozwiązań z wyróżnionym projektem HelloWorld ze wszystkimi rozwiniętymi folderami

Mimo że UWP Blank App jest minimalnym szablonem, nadal zawiera wiele plików. Te pliki są niezbędne dla wszystkich aplikacji platformy UWP korzystających z języka C#. Każdy projekt platformy UWP tworzony w Visual Studio zawiera je.

Co znajduje się w plikach?

Aby wyświetlić i edytować plik w projekcie, kliknij dwukrotnie plik w Eksplorator rozwiązań. Rozwiń plik XAML tak samo jak folder, aby wyświetlić skojarzony z nim plik kodu. Pliki XAML otwarte w widoku podzielonym, który pokazuje zarówno powierzchnię projektową, jak i edytor XAML.

Uwaga / Notatka

Co to jest XAML? Extensible Application Markup Language (XAML) to język używany do definiowania interfejsu użytkownika aplikacji. Można go wprowadzić ręcznie lub utworzyć przy użyciu narzędzi do projektowania Visual Studio. Plik .xaml ma powiązany plik .xaml.cs, który zawiera logikę. Razem kod XAML i kod-behind tworzą kompletną klasę. Aby uzyskać więcej informacji, zobacz XAML overview.

App.xaml i App.xaml.cs

  • App.xaml to plik, w którym deklarujesz zasoby używane w aplikacji.
  • App.xaml.cs jest plikiem za pomocą kodu dla pliku App.xaml. Podobnie jak wszystkie strony kodu, zawiera konstruktor, który wywołuje metodę InitializeComponent. Nie piszesz metody InitializeComponent. Jest on generowany przez Visual Studio, a jego głównym celem jest zainicjowanie elementów zadeklarowanych w pliku XAML.
  • App.xaml.cs to punkt wejścia aplikacji.
  • App.xaml.cs zawiera także metody obsługi aktywacji oraz zawieszenia aplikacji.

MainPage.xaml

  • Plik MainPage.xaml służy do definiowania interfejsu użytkownika aplikacji. Elementy można dodawać bezpośrednio przy użyciu znaczników XAML lub użyć narzędzi projektowych udostępnianych przez Visual Studio.
  • MainPage.xaml.cs jest plikiem zaplecza kodowego dla pliku MainPage.xaml. Jest to miejsce, w którym dodajesz logikę aplikacji i procedury obsługi zdarzeń.
  • Te dwa pliki definiują nową klasę o nazwie MainPage, która dziedziczy z Page w przestrzeni nazw HelloWorld.

Package.appxmanifest

  • Plik manifestu opisujący aplikację: jego nazwę, opis, kafelek, stronę początkową itp.
  • Zawiera listę zależności, zasobów i plików, które zawiera aplikacja.

zestaw obrazów logo

  • Zasoby/Square150x150Logo.scale-200.png i Wide310x150Logo.scale-200.png reprezentują aplikację (średni lub szeroki rozmiar) w menu Start.
  • Zasoby/Square44x44Logo.png reprezentuje aplikację na liście aplikacji menu Start, paska zadań i menedżera zadań.
  • Zasoby/StoreLogo.png reprezentuje aplikację w Microsoft Store.
  • Assets/SplashScreen.scale-200.png to ekran powitalny wyświetlany podczas uruchamiania aplikacji.
  • Zasoby/LockScreenLogo.scale-200.png mogą służyć do reprezentowania aplikacji na ekranie blokady, gdy system jest zablokowany.

Krok 2. Dodawanie przycisku

Korzystanie z widoku projektanta

Dodajmy przycisk do naszej strony. W tym samouczku będziesz pracować z kilkoma wymienionymi wcześniej plikami: App.xaml, MainPage.xaml i MainPage.xaml.cs.

  1. Kliknij dwukrotnie plik MainPage.xaml , aby otworzyć go w edytorze XAML.

    Zrzut ekranu z Visual Studio przedstawiający stronę główną w edytorze XAML

    Uwaga / Notatka

    Podczas pracy z szablonem UWP Blank App, który używa nowoczesnej platformy .NET, widok projektu nie będzie widoczny. Jeśli chcesz pracować z projektem platformy UWP z widokiem projektu XAML, możesz użyć szablonu UWP Pusta aplikacja (.NET Natywna) zamiast tego. Jak wspomniano wcześniej, szablon UWP Pusta aplikacja (.NET Natywna) jest nieco inny niż szablon UWP Pusta aplikacja ale ma tę samą podstawową strukturę. Główną różnicą jest to, że szablon UWP Pusta aplikacja (.NET Native) używa .NET Native do skompilowania aplikacji. Aby uzyskać informacje na temat zalet korzystania z nowoczesnego szablonu .NET, zobacz sekcję Modernizuj aplikację platformy UWP za pomocą .NET i Natywnego AOT.

  2. Dodaj następujący kod XAML do elementu <Grid> w pliku MainPage.xaml. Możesz wpisać go lub skopiować i wkleić z tego miejsca:

    <Button x:Name="button" Content="Button" HorizontalAlignment="Left" Margin = "152,293,0,0" VerticalAlignment="Top"/>
    
  3. W tym momencie utworzono bardzo prostą aplikację. Jest to dobry moment, aby skompilować, wdrożyć i uruchomić aplikację i zobaczyć, jak wygląda. Aplikację można debugować na komputerze lokalnym, w symulatorze lub emulatorze albo na urządzeniu zdalnym. Oto menu urządzenia docelowego w Visual Studio:

    Lista rozwijana urządzeń docelowych do debugowania aplikacji

    Domyślnie aplikacja jest uruchamiana na komputerze lokalnym. Menu urządzenia docelowego zawiera kilka opcji debugowania aplikacji na urządzeniach z rodziny urządzeń stacjonarnych.

    • HelloWorld (uruchamia go na komputerze lokalnym)
    • WSL
    • Pobierz nowe emulatory...
  4. Uruchom aplikację, aby zobaczyć przycisk w akcji. Aby rozpocząć debugowanie na komputerze lokalnym, możesz uruchomić aplikację, wybierając pozycję Debuguj | Uruchom element Debugowanie w menu, klikając przycisk Rozpocznij debugowanie na pasku narzędzi (z etykietą HelloWorld ) lub naciskając F5.

    Aplikacja zostanie otwarta w oknie i zostanie wyświetlony domyślny ekran powitalny. Ekran powitalny jest definiowany przez obraz (SplashScreen.png) i kolor tła (określony w pliku manifestu aplikacji).

    Ekran powitalny zniknie, a następnie zostanie wyświetlona aplikacja. Wygląda na to:

    Zrzut ekranu przedstawiający uruchomioną aplikację HelloWorld, która zawiera teraz przycisk z etykietą Przycisk

  5. Naciśnij klawisz Windows, aby otworzyć menu Start, a następnie wybierz pozycję All aby wyświetlić wszystkie aplikacje. Zwróć uwagę, że wdrożenie aplikacji lokalnie dodaje ją do listy programów w menu Start . Aby ponownie uruchomić aplikację później (nie w trybie debugowania), możesz ją wybrać w menu Start .

    Nie robi to zbyt wiele — ale gratulacje, utworzono i wdrożono pierwszą aplikację platformy UWP na komputerze lokalnym.

  6. Aby zatrzymać debugowanie:

    Kliknij przycisk Zatrzymaj debugowanie (przycisk Zatrzymaj debugowanie) na pasku narzędzi.

    –lub–

    W menu Debugowanie kliknij pozycję Zatrzymaj debugowanie.

    –lub–

    Zamknij okno aplikacji.

  7. Zmień tekst przycisku, zmieniając Content wartość z Button na Hello, world!.

    <Button x:Name="button" Content="Hello, world!" HorizontalAlignment="Left" Margin = "152,293,0,0" VerticalAlignment="Top"/>
    

    Jeśli ponownie uruchomisz aplikację, przycisk zostanie zaktualizowany, aby wyświetlić nowy tekst.

Krok 3. Programy obsługi zdarzeń

"Procedura obsługi zdarzeń" wydaje się skomplikowana, ale jest to po prostu inna nazwa kodu wywoływanego w przypadku wystąpienia zdarzenia (na przykład kliknięcie przycisku przez użytkownika).

  1. Zatrzymaj uruchamianie aplikacji, jeśli jeszcze tego nie zrobiono.

  2. Zacznij wpisywać Click w edytorze XAML, a Visual Studio wyświetli listę możliwych zdarzeń. Wybierz Kliknij z listy.

    Zrzut ekranu edytora XAML przedstawiający zdarzenie Click w okienku właściwości

  3. Następnie wybierz <New Event Handler> z listy. Spowoduje to utworzenie nowej metody obsługi zdarzeń w pliku code-behind (MainPage.xaml.cs) i dodanie zdarzenia Click do elementu przycisku w kodzie XAML.

    Zrzut ekranu edytora XAML przedstawiający monit o utworzenie nowej procedury obsługi zdarzeń w okienku właściwości

    Edytor XAML automatycznie dodaje Click zdarzenie do elementu przycisku w kodzie XAML:

    <Button x:Name="button" Content="Hello, world!" HorizontalAlignment="Left" Margin = "152,293,0,0" VerticalAlignment="Top" Click="button_Click"/>
    

    Dodaje to również program obsługi zdarzeń do pliku zaplecza (MainPage.xaml.cs). Procedura obsługi zdarzeń to metoda, która zostanie wywołana po kliknięciu przycisku. Nazwa metody to button_Click, a ma dwa parametry: object sender i RoutedEventArgs e.

    private void button_Click(object sender, Windows.UI.Xaml.RoutedEventArgs e)
    {
    
    }
    

    Zdarzenie Click to standardowe zdarzenie dla przycisków. Gdy użytkownik kliknie przycisk, metoda button_Click jest wywoływana.

  4. Edytuj kod programu obsługi zdarzeń w MainPage.xaml.cs, pliku zaplecza. To jest miejsce, w którym rzeczy są interesujące. Zmieńmy ją, tak aby wyglądała następująco:

    private async void button_Click(object sender, Windows.UI.Xaml.RoutedEventArgs e)
    {
        var mediaElement = new MediaElement();
        var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();
        Windows.Media.SpeechSynthesis.SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello, World!");
        mediaElement.SetSource(stream, stream.ContentType);
        mediaElement.Play();
    }
    

    Upewnij się, że podpis metody teraz zawiera słowo kluczowe async, w przeciwnym razie wystąpi błąd podczas próby uruchomienia aplikacji.

Co właśnie zrobiliśmy?

Ten kod używa niektórych interfejsów API Windows do utworzenia obiektu syntezy mowy, a następnie podaje tekst do powiedzenia. (Aby uzyskać więcej informacji na temat używania SpeechSynthesis, zobacz sekcję SpeechSynthesis namespace w dokumentacji interfejsu API środowisko wykonawcze systemu Windows (WinRT).)

Po uruchomieniu aplikacji i kliknięciu przycisku komputer (lub telefon) dosłownie powie "Hello, World!".

Podsumowanie

Gratulacje, udało Ci się utworzyć pierwszą aplikację platformy UWP dla Windows z nowoczesnym .NET!

Aby dowiedzieć się, jak używać języka XAML do układania kontrolek używanych przez aplikację, wypróbuj samouczek siatkilub przejdź prosto do kolejnych kroków .