Демонстрация Delphi WinUI 3

Marco Cantu

3 года назад

Вчера, в 27-ю годовщину Delphi, Embarcadero выпустила демонстрацию WinUI 3, которую я представил на юбилейном вебинаре. Вот официальное объявление вместе с дополнительной технической информацией. Демо доступно в GetIt.

Table of Contents

Введение

Microsoft Windows App SDK (ранее известный как Project Reunion) включает новую собственную платформу пользовательского интерфейса под названием WinUI 3. WinUI 3 — это текущая платформа пользовательского интерфейса в архитектуре WinRT (Windows Runtime), и она доступна для упакованных приложений (через контейнеры APPX или MSIX). и неупакованные приложения с графическим интерфейсом (то есть обычные родные приложения Win32/Win64, например, созданные с помощью Delphi и RAD Studio. Эта ссылка на упакованные приложения не имеет ничего общего с пакетами Delphi.

Имейте также в виду, что Windows App SDK — это набор инструментов, отличный от одноименного Windows SDK, который уже давно доступен как часть установки Delphi.
Пример проекта SampleWinRT предназначен для того, чтобы показать, как создать простое приложение Delphi с графическим интерфейсом пользователя исключительно на основе среды Microsoft WinUI 3 (1.0), выпущенной в ноябре 2021 года. Предварительные версии WinUI3 требовали, чтобы приложение было развернуто как упакованное приложение Windows. но WinUI 3 (1.0) снимает это ограничение, что означает, что вы можете создать приложение WinUI 3 в Delphi как обычное приложение.

Дополнительную информацию о WinUI 3 можно найти здесь: https://docs.microsoft.com/en-us/windows/apps/winui/winui3
. Дополнительную информацию о Windows App SDK можно найти здесь: https://docs.microsoft.com . /en-us/окна/приложения/окна-приложение-SDK/

Демо поставляется с обновленными версиями модулей импорта WinRT Delphi RTL для поддержки версии 1.0 WinUI 3. Текущая версия Delphi 11 Alexandria поставляется с более старым набором таких же модулей импорта.

Предварительные требования: установщик среды выполнения приложений Windows и библиотека DLL загрузчика среды выполнения приложений Windows.

Чтобы создать и развернуть неупакованное приложение, вам потребуется несколько вещей, как подробно описано на странице https://docs.microsoft.com/en-us/windows/apps/windows-app-sdk/deploy-unpackaged-apps .

1. Во-первых, вам нужен установщик Windows App SDK , который вы можете получить по ссылке для скачивания на вышеупомянутой странице Microsoft или скачать его с https://aka.ms/windowsappsdk/1.0-stable/msix-installer. Это дает вам распространяемый файловый архив, в настоящее время называемый Microsoft.WindowsAppRuntime.Redist.1.0.0.zip, который содержит установщики для платформ x86 и x64 (оба называются WindowsAppRuntimeInstaller.exe) в папках с разумными именами.

Запуск установщика (с повышенными привилегиями) гарантирует, что у вас установлена среда выполнения приложений Windows — она находится в скрытых папках в C: Program FilesWindowsApps, например, версия x86 может быть установлена в C: Program FilesWindowsAppsMicrosoft.WindowsAppRuntime.1.0_0.319.455 .0_x86__8wekyb3d8bbwe.

2. Второе, что вам нужно, это DLL-загрузчик среды выполнения приложений Windows , Microsoft.WindowsAppRuntime.Bootstrap.dll. Этот файл получен из пакета NuGet Windows App SDK, в настоящее время Microsoft.WindowsAppSDK.1.0.0.nupkg, который доступен по адресу https://www.nuget.org/packages/Microsoft.WindowsAppSDK в папке runtimeswin10-x86native или среды выполненияwin10-x64native. Эта DLL должна быть размещена рядом с вашим исполняемым файлом, чтобы ее можно было найти при запуске приложения при вызове соответствующих API. DLL-загрузчик (или DLL-библиотека начальной загрузки) отвечает за поиск подходящей версии среды выполнения приложений Windows, которая реализует WinUI 3, на основе значений версии, переданных в его API запуска.

Примечание. Если вы использовали поддержку компонента Delphi TEdgeBrower, который является оберткой для другой функции SDK Window App, вы можете заметить сходство требований к среде выполнения (также необходимой конечным пользователям) и SDK с загружаемой распространяемой библиотекой DLL.

Скачивание демо

Демо-версия Delphi WinUI 3 доступна на сайте GetIt для клиентов RAD Studio 11 Alexandria. При его установке исходный код демонстрации и необходимых файлов библиотеки устанавливается вместе с файлом readme с содержимым, аналогичным этому сообщению в блоге. Это пакет GetIt:

Знакомство с демонстрацией

Демонстрационное приложение построено как консольное приложение не по необходимости, но для того, чтобы информация могла быть записана в окно консоли по мере выполнения приложения, предлагая также способ отображения сообщений об ошибках (например, отсутствующих зависимостях).

Примечание. WinUI 3 требует, чтобы вы запускали процесс без повышенных привилегий. Таким образом, демо проверяет это и завершается с простым сообщением, если обнаруживает повышенные привилегии. Без этой проверки WinUI 3 приводит к сбою приложения, казалось бы, некрасивым образом.

Предполагая, что мы передаем проверку привилегий, приложение вызывает API инициализации в DLL-загрузчике, MddBootstrapInitialize , и если это находит и запускает среду выполнения приложений Windows, приложение затем переходит к дальнейшей инициализации. Перед выходом приложение вызывает MddBootstrapShutdown для очистки:
[crayon-6762ea3ae0c41998393276/]
Как видите, версия пакета SDK и версия пакета среды выполнения заимствованы из файла заголовка (.h), расположенного в пакете NuGet SDK Windows App.
В Main мы вызываем статический метод Start объекта приложения WinUI 3 — см. https:// docs.microsoft.com/en-us/windows/winui/api/microsoft.ui.xaml.application.start . Это требует обратного вызова, который будет запущен при инициализации приложения, что позволит нам настроить все по своему усмотрению. К счастью, обратные вызовы WinRT (включая обратные вызовы WinUI 3) имеют ту же реализацию, что и анонимный метод Delphi, поэтому мы используем анонимный метод для настройки обработчика событий OnLaunched нашего приложения.

В WinUI 3 OnLaunched на самом деле не является обработчиком событий. Вместо этого OnLaunched — https://docs.microsoft.com/en-us/windows/winui/api/microsoft.ui.xaml.application.onlaunched — это метод, который мы должны переопределить в классе, наследующемся от WinUI. Класс приложения. Как нам справиться с этим требованием наследования от класса WinRT из Delphi?

WinUI помогает нам, предоставляя механизм, который мы можем использовать. В таком случае наследование от класса WinUI 3 включает 3 объекта:

1) Внутренний объект, дающий базовую реализацию, предоставляемую WinUI, в данном случае базовую реализацию приложения. Этот внутренний объект будет реализовывать интерфейс, который определяет методы, для которых мы будем предоставлять реализации; IApplicationOverrides в этом случае.

2) Внешний объект (иногда называемый базовым объектом), который обеспечивает пользовательскую реализацию рассматриваемого метода (методов). Этот внешний объект, который мы предоставим, также реализует IApplicationOverrides .

3) Объект-оболочка, который объединяет внутренний и внешний объекты и предоставляется WinUI.

Вот код из Main :
[crayon-6762ea3ae0c47903035033/]
Код настройки приложения из этого класса:
[crayon-6762ea3ae0c49567986966/]
Затем метод OnLaunched может выполнить всю необходимую настройку приложения. В этом случае мы создаем и настраиваем окно — https://docs.microsoft.com/en-us/windows/winui/api/microsoft.ui.xaml.window и заполняем его некоторыми элементами управления, создавая следующий пользовательский интерфейс:

Посмотрите в коде все подробности того, что происходит, но вкратце:

Мы создаем элемент управления StackPanel и помещаем его в окно, затем создается кнопка с обработчиком события Click и добавляется в StackPanel .
Затем мы используем некоторый XAML для создания еще одного StackPanel и дочернего элемента управления кнопки, снова с обработчиком событий Click, добавляя StackPanel в окно. Это дает нам 2 подхода для достижения одной и той же цели.
Наконец, еще немного XAML используется для создания Grid и внутри него TextBlock , к которому затем добавляется пара обработчиков событий для OnPointerEntered и OnPointerExited .
В конечном итоге мы получаем окно с парой кнопок и текстовым блоком. На кнопки можно нажимать, чтобы изменить их заголовок, а текстовый блок меняет цвет, когда вы перемещаете мышь в него и из него.

Обратите внимание, что для динамически создаваемых элементов управления пользовательского интерфейса (таких как первая кнопка) обработчики событий могут быть связаны напрямую, а когда элементы управления создаются с загрузкой конфигурации XAML, код должен найти соответствующий объект, чтобы связать с ним обработчик событий.

Примечание. В отличие от C# и C++ языковая проекция для Delphi в настоящее время не включает все различные интерфейсы, реализованные объектами WinRT и WinUI 3, в унифицированные прокси-классы, поэтому над интерфейсом ведется гораздо больше работы, чем в других местах.

Что дальше

Эта демонстрация использования Win UI 3 в упакованном или неупакованном приложении Delphi 11 в первую очередь предназначена для всех, кто хочет поэкспериментировать с этой новой технологией пользовательского интерфейса с точки зрения Delphi. Как Embarcadero, мы следим за развитием WinUI 3 и планируем, как поддерживать его в будущем. Microsoft объявила о будущей поддержке размещения элементов управления WinUI 3 в традиционном дескрипторе формы Windows (то есть в приложении VCL или FMX) через XAML Islands для Win UI 3 — функция, ожидаемая в конце 2022 года, поэтому нам еще рано обсуждать план более плавной интеграции. Следите за обновлениями.