Руководство. Создание первого приложения пакета SDK для приложений Windows в Visual Studio с помощью XAML и C#
В этом руководстве по интегрированной среде разработки Visual Studio вы создадите приложение Hello World, которое работает на любом устройстве с Windows 10 или более поздней версии. Для этого вы будете использовать шаблон проекта пакета SDK для приложений Windows (WinUI 3), язык разметки расширяемых приложений (XAML) и язык программирования C#.
Заметка
WinUI 3 — это собственный компонент платформы пользовательского интерфейса, поставляемый с Windows App SDK (полностью отделённый от Windows SDKs). Дополнительные сведения см. в WinUI 3.
Если вы еще не установили Visual Studio, перейдите на страницу загрузки Visual Studio, чтобы установить её бесплатно.
Необходимые условия
Для работы с этим руководством вам потребуется Visual Studio. Посетите страницу загрузки Visual Studio, чтобы скачать бесплатную версию.
Рабочие нагрузки и компоненты, необходимые для разработки с помощью WinUI и пакета SDK для приложений Windows. Чтобы проверить или установить рабочую нагрузку в Visual Studio, выберите Tools>Get Tools and Features. Дополнительные сведения см. в разделе Изменение рабочих нагрузок или отдельных компонентов.
На вкладке рабочие нагрузки установщика Visual Studio выберите следующие рабочие нагрузки и компоненты:
- Для разработки приложений C# с помощью пакета SDK для приложений Windows выберите разработку приложений Windows.
Создание проекта
Сначала создайте проект WinUI 3. Тип проекта включает в себя все необходимые файлы шаблона, еще до того, как вы что-либо добавите!
Важный
Visual Studio 2019 поддерживает только пакет SDK для приложений Windows 1.1 и более ранних версий. Visual Studio 2022 рекомендуется для разработки приложений со всеми версиями пакета SDK для приложений Windows.
Шаблоны Windows App SDK 1.1.x доступны через установку расширения Visual Studio (VSIX) .
Заметка
Если у вас уже установлено расширение Visual Studio для пакета SDK для приложений Windows (VSIX), удалите его перед установкой другой версии. Для получения инструкций см. раздел Управление расширениями для Visual Studio.
- Вы можете установить последнюю стабильную версию 1.1.x vsIX из Visual Studio. Выберите Расширения>Управление расширениями, найдите Windows App SDKи скачайте расширение Windows App SDK. Закройте и откройте Visual Studio и следуйте инструкциям по установке расширения. Обязательно установите шаблоны для пакета SDK для приложений Windows 1.1.
- Кроме того, можно скачать расширение непосредственно из Visual Studio Marketplaceи установить его:
После установки расширения шаблонов можно создать первый проект. Дополнительные сведения о поддержке Visual Studio 2019 см. в статье Средства установки для пакета SDK для приложений Windows. В остальной части этого руководства предполагается, что вы используете Visual Studio 2022.
Откройте Visual Studio и в окне запуска выберите Создать проект.
На экране Создание нового проекта введите WinUI в поле поиска, выберите шаблон C# для пустого приложения, упакованный (WinUI 3 на рабочем столе), и нажмите кнопку Далее.
Присвойте проекту имя, HelloWorldи выберите Создать.
Заметка
Если вы впервые используете Visual Studio для создания приложения Windows App SDK, может появиться диалоговое окно настроек . Выберите режим разработчика, а затем выберите Да.
Visual Studio устанавливает дополнительный пакет режима разработчика. По завершении установки пакета закройте диалоговое окно "Параметры".
Создание приложения
Пришло время начать разработку. Вы добавите элемент управления кнопкой, добавьте действие в кнопку, а затем запустите приложение Hello World, чтобы увидеть, как это выглядит.
Добавление кнопки на холст конструктора
В Обозревателе решенийдважды щелкните MainWindow.xaml, чтобы открыть редактор разметки XAML.
В редакторе XAML можно добавить или изменить разметку. В отличие от проектов UWP, WinUI 3 не имеет режима проектирования .
Просмотрите кнопку , элемент управления, вложенный в StackPanel , находящийся в корне окна .
Изменение метки на кнопке
В редакторе XAMLизмените значение содержимого кнопки с "Click me" на "Hello World!".
Обратите внимание, что для кнопки также указан обработчик событий Click с именем myButton_Click. Мы перейдем к этой области на следующем шаге.
Изменение обработчика событий
Обработчик событий звучит сложно, но это просто другое имя кода, вызываемого при возникновении события. В этом случае добавляется действие, которое запускается нажатием кнопки "Hello World!".
В обозревателе решенийдважды щелкните страницу кода MainWindow.xaml.cs.
Измените код обработчика событий в открываемом окне редактора C#.
Вот где все интересно. Обработчик событий по умолчанию выглядит следующим образом:
Давайте изменим его, так что выглядит следующим образом:
Ниже приведен код для копирования и вставки:
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.)
Запуск приложения
Пришло время создать, развернуть и запустить приложение Windows App SDK "Hello World", чтобы увидеть, как оно выглядит. Вот как.
Нажмите кнопку воспроизведения (текст HelloWorld (пакет)), чтобы запустить приложение на локальном компьютере.
(Кроме того, можно выбрать Отладка>Начать отладку в строке меню или нажать F5, чтобы запустить приложение.)
Откройте своё приложение, которое появится сразу после исчезновения заставки. Приложение должно выглядеть примерно так:
Нажмите кнопку Hello World.
На устройстве с Windows 10 или более поздней версии появится сообщение с надписью "Добро пожаловать в свое первое приложение пакета SDK для приложений Для Windows" с названием Hello from HelloWorld. Нажмите кнопку ОК, чтобы закрыть сообщение.
Чтобы закрыть приложение, нажмите кнопку Остановить отладку на панели инструментов. (Кроме того, выберите Отладка>Остановить отладку из строки меню или нажмите клавиши Shift+F5.)
Дальнейшие действия
Поздравляем с завершением работы с этим руководством! Мы надеемся, что вы узнали некоторые основы о пакете SDK для приложений Windows, WinUI 3 и интегрированной среде разработки Visual Studio. Дополнительные сведения см. в следующем руководстве: