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

Создайте свое первое приложение WinUI и просмотрите его на Windows. В этом кратком руководстве вы перейдете из программы установки в работающее приложение, а затем поможет вам выполнить первое обновление интерфейса.

Перед началом работы

Что вы узнаете

  • Выберите и настройте средства разработки.
  • Создайте и запустите приложение WinUI.
  • Обновите интерфейс и просмотрите изменения в работающем приложении.

Выбор средств разработки

Выполните любой рекомендуемый путь с помощью этого краткого руководства.

  • winapp CLI: работа с терминалом в предпочтительном редакторе. Этот рабочий процесс командной строки также хорошо подходит для кода агента.
  • Visual Studio. Используйте интегрированный интерфейс разработки и отладки.

Если средства уже установлены, перейдите к разделу "Создание первого приложения".

Установка инструментов

  1. Включите режим разработчика. Вы можете открыть его параметры в разделе Параметры разработчика.

  2. Установите SDK .NET 10 и приложение для Windows Development CLI. Если вы используете WinGet, выполните следующую команду:

    winget install --id Microsoft.DotNet.SDK.10 --exact --source winget
winget install --id Microsoft.WinAppCli --exact --source winget

    Пропустите установку, если необходимый инструмент уже установлен.

  3. Откройте новый терминал, чтобы терминал распознал установленные команды, а затем проверьте версии:

    dotnet --version
winapp --version

    Используйте пакет SDK .NET 10 или более поздней версии и winapp CLI 0.6 или более поздней версии для этого рабочего процесса.

Note

интерфейс командной строки winapp находится в общедоступной предварительной версии. winapp new отвечает за шаблоны проектов WinUI, но не устанавливает SDK для .NET. См. анонс CLI 0.6 с описанием новой команды проекта и команд запуска.

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

Используйте сценарий, который вы установили выше, чтобы создать и запустить проект.

Находясь в папке, где вы храните свои проекты, выполните следующую команду:

winapp new --name MyWinUIApp --template winui --use-defaults
cd MyWinUIApp
winapp run

winapp new создает пустое приложение WinUI. winapp run собирает проект и запускает его; вам не нужна отдельная команда сборки или регистрации пакета.

Чтобы выбрать другой начальный шаблон, отладить сбои, автоматизировать пользовательский интерфейс или упаковать приложение из командной строки, см. статью Использование winapp CLI с WinUI.

Ваше приложение открывает окно на рабочем столе. Продолжите с внести изменение ниже.

Внесение изменения

Сохраните только что созданный проект. Добавьте сообщение к существующему интерфейсу:

  1. Закройте запущенное приложение. Откройте MainPage.xaml в редакторе. Если в вашем шаблоне нет этого файла, вместо этого откройте MainWindow.xaml.

  2. Найдите панель компоновки, в которой находится содержимое приложения. В текущем пустом шаблоне CLI MainPage.xaml содержит пустой <Grid />. Замените ту пустую сетку следующим образом:

    <Grid>
    <TextBlock
        Text="Hello, WinUI!"
        HorizontalAlignment="Center"
        VerticalAlignment="Center" />
</Grid>

    Если панель уже содержит элементы управления, добавьте только TextBlock внутри этой панели. Сохраняйте существующие элементы управления, имена и обработчики событий. Не заменяйте окружающие Page или Windowфреймы и заголовки в MainWindow.xamlстроке заголовка.

  3. Сохраните файл. Запустите winapp run снова из папки проекта или нажмите клавишу F5 в Visual Studio.

Поздравляем! Вы создали, запустили и обновили свое первое приложение WinUI. В окне теперь отображается Hello, WinUI!

Troubleshooting

Проблема. Что требуется проверить
winapp или dotnet не распознается. Повторно откройте терминал после установки. Используйте команды проверки версии на вкладке CLI, чтобы убедиться, что оба инструмента доступны.
winapp new не распознается. Для этого рабочего процесса требуется winapp CLI 0.6 или более поздней версии. Обновите интерфейс командной строки с помощью выбранного метода установки.
Шаблоны WinUI не отображаются в Visual Studio. Откройте установщик Visual Studio, выберите "Изменить" и убедитесь, что установлена рабочая нагрузка разработки приложений WinUI. Затем перезапустите Visual Studio.
Сборка сообщает об ошибке SDK или восстановления. Проверьте предварительные требования выбранного рабочего процесса и первую ошибку в выходных данных сборки. Используйте Windows App SDK поддержку для проверки требований к версии перед изменением свойств проекта.
Развертывание сообщает, что режим разработчика отключен. Включите режим разработчика, а затем снова запустите приложение.
Новое сообщение не отображается. Сохраните XAML-файл и повторно запустите проект. В шаблонах с текстом MainPage.xamlдобавьте сообщение на страницу, а не замените рамку размещения окна.

Дальнейшие действия

Создайте приложение для заметок

В руководстве "Заметки" используется отдельный WinUINotes проект для обучения страниц, навигации, привязки данных и локального хранилища.

Если вы работаете из терминала, использование winapp CLI с WinUI охватывает полный рабочий процесс командной строки: шаблоны, dotnet run, отладку, автоматизацию пользовательского интерфейса, тестирование и упаковку.

Кроме того, в примерах кода и WinUI Gallery можно найти примеры, посвященные элементам управления.

  • Последнее обновление: