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

Заметки о выпуске канала предварительной версии для пакета SDK для приложений Windows 1.1

  • Статья

Внимание

Канал предварительной версии не поддерживается для использования в рабочих средах, а приложения, использующие предварительные версии, не могут быть опубликованы в Microsoft Store.

Канал предварительной версии включает выпуски пакета SDK для приложений Windows с функциями предварительной версии канала на поздних этапах разработки. Предварительные версии не включают экспериментальные функции и API, но могут по-прежнему подвергаться критическим изменениям до следующего стабильного выпуска.

Важные ссылки:

Последний выпуск канала предварительной версии:

Последний выпуск стабильного канала:

Версия 1.1(предварительная версия 3) (1.1.0-preview3)

Это последний выпуск канала предварительной версии для версии 1.1. Она поддерживает все функции канала предварительной версии (см. сведения о функциях, доступных по каналу выпуска).

В существующем приложении с помощью пакета SDK для приложений Windows 1.0 можно обновить пакет Nuget до версии 1.1.0-preview3 (см. раздел "Обновление пакета" в Visual Studio и управление ими с помощью диспетчер пакетов NuGet). Кроме того, ознакомьтесь с последними скачиваемыми пакетами SDK для приложений Windows для обновленной среды выполнения и MSIX.

Примечание.

Для разработчиков C# требуется одна из следующих версий пакета SDK для .NET (или более поздней версии): 6.0.202, 6.0.104, 5.0.407, 5.0.213. Чтобы обновить версию пакета SDK для .NET, посетите .NET Downloads or update to the latest version of Visual Studio. Без требуемой версии пакета SDK для .NET при обновлении пакета NuGet появится сообщение об ошибке: "Для этой версии WindowsAppSDK требуется WinRT.Runtime.dll версии 1.6 или более поздней.".

Помимо всех функций предварительной версии 2 , в следующих разделах описываются новые и обновленные функции, ограничения и известные проблемы для этого выпуска.

WinUI 3 (1.1.0-preview3)

Мика и фоновый акрил теперь доступны для приложений WinUI 3.

Дополнительные сведения об этих материалах см . в разделе "Материалы" в Windows 11. Ознакомьтесь с нашим примером кода для применения Mica в приложениях C++ на сайте Apply Mica или Акриловые материалы в классических приложениях для Windows 11 и в приложениях C# на сайте GitHub в составе коллекции элементов управления WinUI.

Уведомления (1.1.0-preview3)

Исправленные проблемы:

  • В версии 1.1.0-preview1 и 1.1.0-preview2 некоторые непакованные приложения будут неправильно скопированы в AppData\LocalMicrosoftWindowsAppSDK. Для этого выпуска они будут скопированы в AppData\Local\Microsoft\WindowsAppSDK. Чтобы избежать утечки значков, следует вручную удалить значок приложения по неправильному пути после обновления до версии 1.1.0-preview3.
  • Теперь поддерживается получение значка приложения и отображаемого имени приложения для уведомлений о приложении с помощью ярлыков. Этот значок приложения будет иметь приоритет над любым значком, указанным в файлах ресурсов.
  • Поддержка push-уведомлений для распакованных приложений восстановлена (см . ограничения для указанного исключения). Мы представили API PushNotificationManager::IsSupported, чтобы проверить, поддерживает ли ваше приложение push-уведомления.

Ограничения:

  • Уведомления для приложения с повышенными привилегиями не поддерживаются. PushNotificationManager::IsSupported не будет проверять режим с повышенными привилегиями. Однако мы работаем над поддержкой этого в будущем выпуске.

Упаковка MSIX

Мы усовершенствовали MSIX, добавив новые и расширяющие существующие функции с помощью категорий расширений:

  • windows.appExecutionAlias;
  • windows.customDesktopEventLog
  • windows.dataShortcuts
  • windows.fileTypeAssociation
  • windows.fileTypeAssociation.iconHandler
  • windows.folder
  • windows.shortcut

Для них требуется установить пакет пакета SDK для приложений Windows. Чтобы установить среду выполнения, см . последние загрузки пакета SDK для приложений Windows.

Диспетчер среды (1.1.0-preview3)

Набор API, позволяющий разработчикам добавлять, удалять и изменять переменные среды без необходимости напрямую использовать API реестра.

Уточнение от версии 1.1 (предварительная версия 1): автоматическое удаление любых переменных среды при удалении приложения, использующее диспетчер среды, доступно только для упакованных приложений. Кроме того, для восстановления изменений в переменных среды требуется установка пакета пакета sdk для приложений Для Windows, см . последние загрузки пакета SDK для приложений Windows для среды выполнения.

Прочие известные ограничения

Регрессии из версии 1.1( предварительная версия 2):

  • Для приложений .NET с помощью API MRT Core и приложений WinUI, которые не развертываются с помощью msIX с одним проектом:
    • ФАЙЛЫ RESW и изображения, которые были добавлены в проект как существующие элементы и ранее автоматически включены в PRIResource и Content ItemGroups соответственно, не будут включены в эти группы элементов. В результате эти ресурсы не будут индексированы во время создания PRI, поэтому они не будут доступны во время выполнения.
      • Обходной путь. Вручную включите ресурсы в файл проекта и удалите их из Группы элементов None.
      • Альтернативное решение. При наличии обновите пакет SDK для .NET для приложений до версии 6.0.300. Дополнительные сведения см . в разделе "Требования к версиям" для пакета SDK для .NET.
  • Для приложений .NET, которые не развертываются с одним проектом MSIX:
    • Если файл добавляется в группу содержимого ItemGroup дважды или более, произойдет ошибка сборки.
      • Обходной путь. Удалите повторяющееся включение/с или задайте для EnableDefaultContentItems значение false в файле проекта.

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

Версия 1.1(предварительная версия 2) (1.1.0-preview2)

Это второй выпуск канала предварительной версии для версии 1.1. Она поддерживает все функции канала предварительной версии (см. сведения о функциях, доступных по каналу выпуска).

В существующем приложении с помощью пакета SDK для приложений Windows 1.0 можно обновить пакет Nuget до версии 1.1.0-preview2 (см. раздел "Обновление пакета" в Visual Studio и управление ими с помощью диспетчер пакетов NuGet). Кроме того, ознакомьтесь с последними скачиваемыми пакетами SDK для приложений Windows для обновленной среды выполнения и MSIX.

Примечание.

Для разработчиков C# требуется одна из следующих версий пакета SDK для .NET (или более поздней версии): 6.0.202, 6.0.104, 5.0.407, 5.0.213. Чтобы обновить версию пакета SDK для .NET, посетите .NET Downloads or update to the latest version of Visual Studio. Без требуемой версии пакета SDK для .NET при обновлении пакета NuGet появится сообщение об ошибке: "Для этой версии WindowsAppSDK требуется WinRT.Runtime.dll версии 1.6 или больше".

Помимо всех функций предварительной версии 1 , в следующих разделах описываются новые и обновленные функции, ограничения и известные проблемы для этого выпуска.

Уведомления (1.1.0-preview2)

Исправленные проблемы:

  • Приложение без удостоверений пакета, отправляющего уведомления, теперь увидит его значок приложения в уведомлении, если значок является частью ресурса приложения. Если ресурс приложения не имеет значка, используется значок приложения Windows по умолчанию.
  • Приложение WinUI 3, которое не запущено, теперь может быть активировано в фоновом режиме с помощью уведомления.

Регрессия от версии 1.1(предварительная версия 1): поддержка push-уведомлений для распакованных приложений. Ожидается восстановление в следующем выпуске.

Известные ограничения:

  • Мы представили API PushNotificationManager::IsSupported, чтобы проверить, поддерживают ли автономные приложения push-уведомления. Однако этот API еще не работает должным образом, поэтому следите за поддержкой API IsSupported в следующем предварительном выпуске.
  • Некоторые непакованные приложения увидят их значки приложения неправильно скопированы в AppData\LocalMicrosoftWindowsAppSDK. Для следующего выпуска они будут скопированы в AppData\Local\Microsoft\WindowsAppSDK. Чтобы избежать утечки значков, разработчик должен вручную удалить значок приложения по неправильному пути после обновления до следующего выпуска.
  • Значок приложения и получение отображаемого имени приложения для уведомлений с помощью ярлыков не поддерживается. Но мы работаем над поддержкой этого в будущем выпуске.

Развертывание

Новые функции:

Известные ограничения:

  • Автономное развертывание поддерживается только в Windows 10, 1903 и более поздних версиях.

Оконное расширение

Чтобы упростить программный доступ к функциям, реализованным в (см. Windows и сообщения), этот выпуск предоставляет больше возможностей в AppWindow.USER32.dll

Новые функции:

  • Приложения с существующими окнами имеют больше контроля над отображением окна путем вызова AppWindow.ShowOnceWithRequestedStartupState — эквивалента ShowWindow(SW_SHOWDEFAULT).
  • Приложения могут отображать, свернуть или восстановить окно и указать, следует ли активировать окно во время вызова.
  • Теперь приложения могут задать размер клиентской области окна в координатах Win32.
  • Мы добавили API для поддержки управления окнами z-порядка.
  • Приложения, рисуемые настраиваемыми строками заголовков с помощью AppWindowTitleBar.ExtendsContentIntoTitleBar, могут задать параметр PreferredTitleBarHeight. У вас есть выбор стандартной высоты заголовка или высоты заголовка, которая обеспечивает больше места для интерактивного содержимого. Ознакомьтесь со строкой заголовков в рекомендациях по проектированию Fluent, чтобы узнать, когда использовать высокую панель заголовков.

Известные ограничения:

  • Поддержка высокой панели заголовков доступна только в Windows 11. Мы работаем над тем, чтобы уменьшить этот формат вместе с другими пользовательскими API панели заголовков.

WinUI 3 (1.1.0-preview2)

Исправленные проблемы:

  • Исправлена проблема, из-за которой приложения C# с WebView2 завершались сбоем при запуске, когда среда выполнения C/C++ (CRT) не установлена путем обновления пакета SDK WebView2 с версии 1020.46 до 1185.39.
  • Исправлена проблема, из-за которой некоторые округленные угловы отображали градиент, когда они должны быть сплошным цветом. Дополнительные сведения см . в выпуске 6076 и выпуске 6194 на сайте GitHub.
  • Исправлена проблема, из-за которой обновленные стили отсутствуют из generic.xaml.
  • Исправлена проблема с циклом макета, приводя к сбою приложения при прокрутке до конца ListView. Дополнительные сведения см . в статье 6218 на сайте GitHub.

Производительность

Приложения C# имеют несколько улучшений производительности. Дополнительные сведения см. в заметках о выпуске C#/WinRT 1.6.1.

Версия 1.1(предварительная версия 1) (1.1.0-preview1)

Это первый выпуск канала предварительной версии для версии 1.1. Она поддерживает все функции канала предварительной версии (см. сведения о функциях, доступных по каналу выпуска).

В существующем приложении с помощью пакета SDK для приложений Windows 1.0 можно обновить пакет Nuget до версии 1.1.0-preview1 (см. раздел "Обновление пакета" в Visual Studio и управление ими с помощью диспетчер пакетов NuGet). Кроме того, ознакомьтесь с последними скачиваемыми пакетами SDK для приложений Windows для обновленной среды выполнения и MSIX.

В следующих разделах описываются новые и обновленные функции, ограничения и известные проблемы для этого выпуска.

WinUI 3 (1.1.0-preview1)

Известная проблема: пользователи не могут удалить элемент при включении перетаскивания.

Поддержка с повышенными привилегиями (администратор)

С помощью пакета SDK для приложений Windows 1.1 (предварительная версия 1) приложения (включая WinUI 3) смогут выполняться с повышенными привилегиями.

Важные ограничения:

  • Сейчас доступно только в Windows 11. Но мы оцениваем снижение этой поддержки в более позднем выпуске.

Известные проблемы:

  • При перетаскивании элемента во время взаимодействия с перетаскиванием приложений WinUI 3 происходит сбой.

Автономное развертывание

Пакет SDK для приложений Windows 1.1 предоставляет поддержку автономного развертывания. Обзор развертывания пакета SDK для приложений Windows содержит сведения о различиях между зависимым от платформы и автономным развертыванием, а также о том, как приступить к работе.

Известные проблемы:

  • Приложение C++, которое упаковано, должно добавить приведенный ниже файл проекта в нижней части файла проекта, чтобы обойти ошибку в автономном .targets файле, который удаляет ссылки платформы на VCLibs:

    <PropertyGroup>
    <IncludeGetResolvedSDKReferences>true</IncludeGetResolvedSDKReferences>
</PropertyGroup>

<Target Name="_RemoveFrameworkReferences"
    BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
    <ItemGroup>
        <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="'%(FrameworkSdkReference.SDKName)' == 'Microsoft.WindowsAppRuntime.1.1-preview1'" />
    </ItemGroup>
</Target>

  • Поддерживается только в Windows 10, 1903 и более поздних версиях.

Уведомления (1.1.0-preview1)

Разработчики упакованных (включая упакованные с внешним расположением) и распакованные приложения теперь могут отправлять уведомления Windows.

Новые функции:

  • Поддержка уведомлений приложений для упакованных и распакованных приложений. Полные сведения о GitHub
    • Разработчики могут отправлять уведомления приложений, также известные как всплывающие уведомления, локально или из собственной облачной службы.
  • Поддержка push-уведомлений для упакованных и распакованных приложений. Полные сведения о GitHub
    • Разработчики могут отправлять необработанные уведомления или уведомления приложений из собственной облачной службы.

Ограничения:

  • Приложения, опубликованные как автономные, могут не поддерживать push-уведомления. Следите за следующим предварительным выпуском для API IsSupported , чтобы проверить поддержку push-уведомлений.
  • Приложения, которые распаковываются, отправляющие уведомления приложений, не будут отображать значок приложения в уведомлении о приложении, если они не являются консольными приложениями. Консольные приложения, которые распаковываются, должны соответствовать шаблонам, показанным в примере ToastNotificationsDemoApp .
  • Среда выполнения пакета SDK для Приложений Windows должна быть установлена для поддержки push-уведомлений, см . сведения о последних скачиваемых пакетах SDK для приложений Windows для установщика.
  • Приложение WinUI 3, которое не запущено, не может быть активировано в фоновом режиме с помощью уведомления. Но мы работаем над поддержкой этого в будущем выпуске.

Диспетчер среды (1.1.0-preview1)

Набор API, позволяющий разработчикам добавлять, удалять и изменять переменные среды без необходимости напрямую использовать API реестра.

Новые функции:

  • Обеспечивает автоматическое удаление любых переменных среды при удалении приложения, использующее диспетчер среды.

Ограничения:

  • В настоящее время недоступно в приложениях C#. Но мы оцениваем эту функцию в приложения C# в более позднем выпуске.

Другие ограничения и известные проблемы

  • Если вы используете C# с версией 1.1.0 (предварительная версия 1), необходимо использовать одну из следующих версий пакета SDK для .NET, как минимум: пакет SDK для .NET 6.0.201, 6.0.103, 5.0.212 или 5.0.406. Чтобы обновить пакет SDK для .NET, можно обновить до последней версии Visual Studio или скачать .NET.