Поделиться через


Руководство. Создание первого приложения пакета SDK для приложений Windows в Visual Studio с помощью XAML и C#

В этом руководстве по интегрированной среде разработки Visual Studio вы создадите приложение Hello World, которое работает на любом устройстве с Windows 10 или более поздней версии. Для этого вы используете шаблон проекта пакета SDK для приложений Windows (WinUI 3), язык разметки расширяемых приложений (XAML) и язык программирования C#.

Заметка

WinUI 3 — это собственный компонент платформы пользовательского интерфейса, который поставляется с пакетом SDK для приложений Windows. Он полностью отделяется от пакетов SDK для Windows. Дополнительные сведения см. в WinUI 3.

Необходимые условия

  • Для работы с этим руководством вам потребуется Visual Studio 2026 или последняя версия Visual Studio 2022. Бесплатная версия см. в разделе "Скачивание Visual Studio".
  • Рабочие нагрузки и компоненты, необходимые для разработки с помощью WinUI и пакета SDK для приложений Windows. Чтобы проверить или установить рабочую нагрузку в Visual Studio, выберите Tools>Get Tools and Features. Дополнительные сведения см. в разделе Изменение рабочих нагрузок или отдельных компонентов.

На вкладке "Рабочие нагрузки " установщика Visual Studio выберите следующее:

Для разработки приложений C# с помощью пакета SDK для приложений Windows выберите разработку приложений WinUI.

Для разработки приложений C# с помощью пакета SDK для приложений Windows выберите разработку приложений WinUI.

Заметка

В Visual Studio 17.10 – 17.12 эта рабочая нагрузка называется разработкой приложений Windows.

Дополнительные сведения см. в статье "Установка средств для пакета SDK для приложений Windows".

Создание проекта

Сначала создайте проект WinUI 3. Тип проекта содержит все нужные файлы шаблона еще до того, как вы что-либо добавите!

  1. Откройте Visual Studio и в окне запуска выберите Создать проект.

  2. На экране "Создание нового проекта " введите WinUI в поле поиска, выберите шаблон C# для пустого приложения WinUI (Упаковано) и нажмите кнопку "Далее".

    Снимок экрана: диалоговое окно

  3. Присвойте проекту имя, HelloWorldи выберите Создать.

    снимок экрана диалогового окна

  1. Откройте Visual Studio и в окне запуска выберите Создать проект.

  2. На экране создания проекта введите winui в поле поиска, выберите шаблон шаблон C# для пустого приложения, упакованное (WinUI 3 для рабочего стола), и нажмите Далее.

    Снимок экрана: диалоговое окно

  3. Присвойте проекту имя, HelloWorldи выберите Создать.

    Снимок экрана: диалоговое окно

Заметка

Если вы впервые используете Visual Studio для создания приложения с Windows App SDK, может появиться диалоговое окно "Параметры". Выберите режим разработчика, а затем выберите Да.

Снимок экрана: диалоговое окно

Visual Studio устанавливает другой пакет режима разработчика для вас. После завершения установки пакета закройте диалоговое окно "Параметры ".

Создание приложения

Пришло время начать разработку. Здесь вы добавите элемент управления кнопкой, добавьте действие в кнопку, а затем запустите приложение Hello World , чтобы увидеть, как это выглядит.

Добавление кнопки на холст конструктора

  1. В Обозревателе решенийдважды щелкните MainWindow.xaml, чтобы открыть редактор разметки XAML.

    Снимок экрана: окно обозревателя решений с свойствами, ссылками, ресурсами и файлами в проекте HelloWorld с выбранным файлом MainWindow.xaml.

    В редакторе XAML можно добавить или изменить разметку. В отличие от проектов UWP, WinUI 3 не имеет режима проектирования .

    снимок экрана, на котором MainWindow.xaml открыт в среде разработки Visual Studio. В области редактора XAML отображается разметка XAML для окна.

  2. В элементе <Grid> начните вводить <Button. Intellisense предлагает вам вариант кнопки. Нажмите клавишу TAB , чтобы принять.

    снимок экрана: кнопка, выделенная в редакторе XAML.

  1. В Обозревателе решенийдважды щелкните MainWindow.xaml, чтобы открыть редактор разметки XAML.

    Снимок экрана: окно обозревателя решений в Visual Studio 2022 с выбранными свойствами, ссылками, ресурсами и файлами в проекте HelloWorld с выбранным файлом MainWindow.xaml.

    В редакторе XAML можно добавить или изменить разметку. В отличие от проектов UWP, WinUI 3 не имеет режима проектирования .

    Снимок экрана: Файл MainWindow.xaml открыт в интегрированной среде разработки Visual Studio 2022. В области редактора XAML отображается разметка XAML для окна.

  2. Просмотрите кнопку , элемент управления, вложенный в StackPanel , находящийся в корне окна .

    снимок экрана: кнопка, выделенная в редакторе XAML.

Изменение метки на кнопке

  1. В редакторе XAML измените значение "Содержимое кнопки" с текущего значения на "Hello World!".

    Снимок экрана: код XAML для кнопки в редакторе XAML с значением свойства Content, измененным на Hello World!

  2. Поместите курсор в начальный тег элемента <Button> (после существующих атрибутов, например Content) и начните вводить: Щелкните. Intellisense предлагает новый обработчик событий с именем Button_Click. Вы работаете с этим кодом в следующем разделе.

    Снимок экрана: код XAML для кнопки в редакторе XAML с выделенным событием нажатия кнопки.

  1. В редакторе XAML измените значение "Содержимое кнопки" с текущего значения на "Hello World!".

    Снимок экрана: код XAML для кнопки в редакторе XAML в Visual Studio 2022 с значением свойства Content, измененным на Hello World!

  2. Обратите внимание, что для кнопки также указан обработчик событий Click с именем myButton_Click. На следующем этапе вы работаете с этим.

    Снимок экрана: код XAML для кнопки в редакторе XAML в Visual Studio 2022 с выделенным событием нажатия кнопки.

Изменение обработчика событий

Обработчик событий звучит сложно, но это просто другое имя кода, вызываемого при возникновении события. В этом случае он добавляет действие, инициированное Hello World! Кнопка.

  1. В обозревателе решенийдважды щелкните страницу кода MainWindow.xaml.cs.

  2. Измените код обработчика событий в открываемом окне редактора C#.

    Вот где начинается самое интересное. Обработчик событий по умолчанию выглядит следующим образом:

    снимок экрана: код C# для обработчика событий по умолчанию Button_Click.

    Давайте изменим его, так что выглядит следующим образом:

    снимок экрана: код C# для нового асинхронного обработчика событий myButton_Click.

    Ниже приведен код для копирования и вставки:

    private async void Button_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = ((FrameworkElement)sender).XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    
  1. В обозревателе решенийдважды щелкните страницу кода MainWindow.xaml.cs.

  2. Измените код обработчика событий в открываемом окне редактора C#.

    Вот где начинается самое интересное. Обработчик событий по умолчанию выглядит следующим образом:

    Снимок экрана: код C# для обработчика событий по умолчанию Button_Click в Visual Studio 2022.

    Давайте изменим его, так что выглядит следующим образом:

    Снимок экрана: код C# для нового асинхронного обработчика событий myButton_Click в Visual Studio 2022.

    Ниже приведен код для копирования и вставки:

    private async void myButton_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = myButton.XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    

Что мы только что сделали?

Код использует элемент управления ContentDialog для отображения приветственного сообщения в модальном всплывающем элементе управления в текущем окне. Дополнительные сведения об использовании Microsoft.UI.Xaml.Controls.ContentDialogсм. в классе ContentDialog.

Запуск приложения

Пришло время создать, развернуть и запустить приложение Hello World Windows App SDK, чтобы увидеть, как оно выглядит. Вот как.

  1. Нажмите кнопку запуска, чтобы начать приложение на локальном компьютере. Он содержит текст HelloWorld (Package).

    Снимок экрана: раскрывающийся список рядом с кнопкой

    Кроме того, можно выбрать Отладка>Начать отладку из строки меню или нажать клавишу F5, чтобы запустить приложение.

  2. Откройте своё приложение, которое появится сразу после исчезновения заставки. Приложение должно выглядеть примерно так:

    снимок экрана работающего приложения Windows App SDK 'Hello World'.

  3. Нажмите кнопку Hello World.

    Устройство с Windows 10 или более поздней версии отображает сообщение с надписью "Добро пожаловать в свое первое приложение пакета SDK для приложений Для Windows" с названием Hello from HelloWorld. Нажмите кнопку "ОК ", чтобы закрыть сообщение.

    снимок экрана: работающее приложение Hello World с всплывающей окном

  4. Чтобы закрыть приложение, нажмите кнопку Остановить отладку на панели инструментов. Кроме того, выберите "Отладка>Прекратить отладку" в строке меню или нажмите клавиши Shift+F5.

Поздравляем с завершением работы с этим руководством! Мы надеемся, что вы узнали некоторые основы о пакете SDK для приложений Windows, WinUI 3 и интегрированной среде разработки Visual Studio. Дополнительные сведения см. в следующем руководстве:

Руководство: создание простого фото просмотрщика с помощью WinUI 3

Эти ресурсы также могут быть полезны: