WindowsAppSDK Samples

Примеры SDK приложений для Windows

В этом репозитории размещены образцы для Windows App SDK. В этот репозиторий будут добавлены образцы различных функций, поставляемых в Windows App SDK. Дополнительные сведения о Windows App SDK см. в документации Windows App SDK. Чтобы узнать больше о дизайне Windows App SDK или внести свой вклад в проект, внести предложения по функциям или начать обсуждения, посетите страницу Windows App SDK GitHub.

Список образцов

Жизненный цикл приложения и системные службы

• Жизненный цикл приложения. Эти примеры демонстрируют создание экземпляров приложений с использованием API AppLifecycle. Они включают в себя следующие функции:
  • Активация. Эти примеры демонстрируют поддержку расширенных типов активации.
  • Создание экземпляров. Эти примеры демонстрируют поддержку одиночного и выборочного создания нескольких экземпляров.
  • Уведомления о питании. Эти примеры демонстрируют уведомления о состоянии питания/системы для управления рабочей нагрузкой приложений.
  • Перезапуск. Эти примеры демонстрируют синхронный перезапуск приложения с аргументами перезапуска командной строки.
  • Цель общего доступа. В этом примере показано приложение, которое можно активировать в качестве цели общего доступа.

Данные и файлы

• Управление ресурсами. Эти примеры демонстрируют управление ресурсами приложения с помощью API-интерфейсов MRT Core.

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

• Диспетчер развертывания. В этом примере показано, как инициализировать и получить доступ к информации о развертывании для среды выполнения Windows App SDK.
• Установщик. В этом примере показано, как запустить установщик Windows App SDK без окна консоли.
• Неупакованный: эти примеры демонстрируют автоматическую инициализацию с помощью пакета Windows App SDK из не-MSIX (неупакованного) приложения.

Динамические зависимости

• DirectX: в этом примере показано, как использовать API динамических зависимостей для динамической загрузки пакета платформы MSIX среды выполнения DirectX.

Графика

• Рендеринг текста. Этот пример представляет собой галерею API-интерфейсов DWriteCore, демонстрирующих рендеринг текста.

Уведомления

• Push-уведомления: это пример приложения, демонстрирующего push-уведомления.
• Уведомления приложений: это пример приложения, демонстрирующего уведомления приложений.

Компоненты среды выполнения

• Настраиваемые элементы управления. В этом примере показано, как создать компонент среды выполнения Windows на C# с настраиваемыми элементами управления WinUI.

Пользовательский интерфейс и ввод

• Работа с окнами. В этом примере показано, как управлять окнами приложения с помощью API окон.
• Галерея ввода и композиции Windows. В этой коллекции примеров демонстрируются API Microsoft.UI.Composition и Microsoft.UI.Input.
• Галерея WinUI 3. Это пример приложения, демонстрирующий все элементы управления WinUI 3 в действии.

Требования

Эти образцы Windows App SDK имеют следующие системные требования:

• Windows 10 версии 1809 (сборка 17763) или более поздней версии.

• Visual Studio 2022 или Visual Studio 2019 версии 16.9 или новее со следующими рабочими нагрузками и компонентами:

  • Разработка универсальной платформы Windows
  • .NET Desktop Development (необходимо, даже если вы создаете только приложения C++ Win32)
  • Разработка настольных компьютеров на C++ (необходима, даже если вы создаете только приложения .NET)
  • Windows SDK версии 2004 (сборка 19041) или более поздней версии. Он устанавливается вместе с Visual Studio по умолчанию.

• Для создания примеров .NET C# с помощью Windows App SDK 1.1 также требуется одна из следующих версий .NET SDK или более поздняя:

  • 6.0.202
  • 6.0.104
  • 5.0.407
  • 5.0.213

Подробный список требований для разработки приложений с помощью Windows App SDK см. в документации по системным требованиям и инструментам для разработки приложений для Windows.

Использование образцов

Чтобы использовать примеры с Git, клонируйте репозиторий WindowsAppSDK-Samples, запустив git clone https://github.com/microsoft/WindowsAppSDK-Samples.git из командной строки. Затем вы можете перейти в каталог примера и открыть файл решения в Visual Studio.

Самый простой способ использовать эти примеры без Git — загрузить ZIP-файл. Выберите «Загрузить ZIP» в раскрывающемся списке загрузок, разархивируйте весь архив и откройте примеры в Visual Studio.

Примеры версий

Образцы будут обновляться общедоступными выпусками Windows App SDK. main ветка включает последние образцы, которые также могут включать экспериментальные или предварительные функции. Конкретные ветки выпуска называются release/xy и содержат образцы, ссылающиеся на соответствующую общедоступную версию Windows App SDK. В настоящее время этот репозиторий включает в себя следующие ветки выпуска:

• релиз/1.0
• выпуск/0.8
• выпуск/0,5

Содействие

Эти образцы предоставлены специализированными группами, и мы будем рады вашим отзывам о проблемах и предложениям по новым образцам. Мы рекомендуем вам подать новый выпуск для любых отзывов или вопросов!

Авторы образцов должны следовать рекомендациям по выборке, чтобы приступить к разработке своих образцов. Для примеров пакета SDK для приложений Windows на основе WinUI используйте примеры шаблонов. Файл VSIX доступен для загрузки на странице выпусков Github здесь.

В этом проекте принят Кодекс поведения Microsoft с открытым исходным кодом. Для получения дополнительной информации ознакомьтесь с часто задаваемыми вопросами по Кодексу поведения или свяжитесь с нами по адресу [email protected], если у вас возникнут дополнительные вопросы или комментарии.

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

• Включите регулярную сборку нового примера приложения.
• Добавьте новый тестовый пример к существующему тестовому драйверу SampleTests TAEF, чтобы регулярно проверять успешный запуск примера приложения по последней версии Windows App SDK.

Инструкции см. в документации внутреннего репозитория агрегатора на этапах BuildSampleApps и TestSampleApps.