WindowsAppSDK Samples

Ejemplos de SDK de aplicaciones de Windows

Este repositorio alberga ejemplos para el SDK de aplicaciones de Windows. Se agregarán a este repositorio ejemplos de varias funciones incluidas en el SDK de aplicaciones de Windows. Para obtener más información sobre el SDK de aplicaciones de Windows, visite la documentación del SDK de aplicaciones de Windows. Para obtener más información sobre el diseño del SDK de aplicaciones de Windows o para contribuir al proyecto, hacer propuestas de funciones o iniciar debates, visite la página de GitHub del SDK de aplicaciones de Windows.

Lista de muestras

Ciclo de vida de la aplicación y servicios del sistema

• Ciclo de vida de la aplicación: estos ejemplos demuestran la creación de instancias de aplicaciones mediante las API de AppLifecycle. Incluyen las siguientes características:
  • Activación: estos ejemplos demuestran compatibilidad con tipos de activación enriquecidos.
  • Creación de instancias: estos ejemplos demuestran compatibilidad con instancias múltiples únicas y selectivas.
  • Notificaciones de energía: estos ejemplos demuestran las notificaciones de estado del sistema/energía para administrar la carga de trabajo de la aplicación.
  • Reiniciar: estos ejemplos demuestran el reinicio sincrónico de una aplicación con argumentos de reinicio de la línea de comandos.
  • Compartir destino: este ejemplo muestra una aplicación que se puede activar como destino para compartir.

Datos y archivos

• Gestión de recursos: estos ejemplos demuestran la gestión de recursos de aplicaciones mediante las API principales de MRT.

Despliegue

• Administrador de implementación: este ejemplo muestra cómo inicializar y acceder a la información de implementación para el tiempo de ejecución del SDK de aplicaciones de Windows.
• Instalador: este ejemplo muestra cómo iniciar el instalador del SDK de aplicaciones de Windows sin una ventana de consola.
• Sin empaquetar: estos ejemplos demuestran la inicialización automática con el paquete SDK de aplicaciones de Windows desde una aplicación que no es MSIX (sin empaquetar).

Dependencias dinámicas

• DirectX: este ejemplo demuestra cómo utilizar la API de dependencias dinámicas para cargar dinámicamente el paquete de marco DirectX Runtime MSIX.

Gráficos

• Representación de texto: esta muestra es una galería de las API de DWriteCore que demuestran la representación de texto.

Notificaciones

• Notificaciones push: esta es una aplicación de muestra que muestra notificaciones push.
• Notificaciones de aplicaciones: esta es una aplicación de muestra que muestra notificaciones de aplicaciones.

Componentes de tiempo de ejecución

• Controles personalizados: este ejemplo muestra cómo crear un componente de Windows Runtime en C# con controles personalizados de WinUI.

Interfaz de usuario y entrada

• Ventanas: este ejemplo muestra cómo administrar ventanas de aplicaciones utilizando las API de ventanas.
• Galería de composición y entrada de Windows: esta colección de ejemplos muestra las API Microsoft.UI.Composition y Microsoft.UI.Input.
• Galería WinUI 3: esta es una aplicación de muestra que muestra todos los controles de WinUI 3 en acción.

Requisitos

Estos ejemplos de SDK de aplicaciones de Windows tienen los siguientes requisitos del sistema:

• Windows 10, versión 1809 (compilación 17763) o posterior.

• Visual Studio 2022 o Visual Studio 2019 versión 16.9 o posterior, con las siguientes cargas de trabajo y componentes:

  • Desarrollo de la plataforma universal de Windows
  • Desarrollo de escritorio .NET (necesario incluso si solo está creando aplicaciones C++ Win32)
  • Desarrollo de escritorio con C++ (necesario incluso si solo estás creando aplicaciones .NET)
  • Windows SDK versión 2004 (compilación 19041) o posterior. Esto se instala con Visual Studio de forma predeterminada.

• La creación de ejemplos de .NET C# con Windows App SDK 1.1 también requiere una de las siguientes versiones de .NET SDK o posterior:

  • 6.0.202
  • 6.0.104
  • 5.0.407
  • 5.0.213

Consulte los documentos sobre requisitos del sistema y herramientas para el desarrollo de aplicaciones de Windows para obtener una lista detallada de los requisitos para desarrollar aplicaciones con el SDK de aplicaciones de Windows.

Usando las muestras

Para usar los ejemplos con Git, clone el repositorio WindowsAppSDK-Samples ejecutando git clone https://github.com/microsoft/WindowsAppSDK-Samples.git desde un símbolo del sistema. Luego puede navegar hasta el directorio de una muestra y abrir el archivo de la solución en Visual Studio.

La forma más sencilla de utilizar estos ejemplos sin Git es descargar el archivo ZIP. Seleccione Descargar ZIP en el menú desplegable de descargas, descomprima el archivo completo y abra las muestras en Visual Studio.

Versionado de muestras

Las muestras se actualizarán con las versiones GA del SDK de aplicaciones de Windows. La rama main incluye las muestras más recientes, que también pueden incluir funciones experimentales o de vista previa. Las ramas de lanzamiento específicas se denominan release/xy y contienen ejemplos que hacen referencia a la versión GA correspondiente del SDK de la aplicación de Windows. Este repositorio incluye actualmente las siguientes ramas de lanzamiento:

• lanzamiento/1.0
• lanzamiento/0.8
• lanzamiento/0.5

Contribuyendo

Estos ejemplos los proporcionan equipos de funciones y agradecemos sus comentarios sobre problemas y sugerencias para nuevos ejemplos. ¡Le recomendamos que presente un nuevo número para recibir comentarios o preguntas!

Los autores de muestras deben seguir las pautas de muestras para comenzar a desarrollar sus muestras. Para muestras del SDK de aplicaciones de Windows basadas en WinUI, utilice las plantillas de muestra. El archivo VSIX está disponible para descargar en la página de lanzamientos de Github aquí.

Este proyecto ha adoptado el Código de conducta de código abierto de Microsoft. Para obtener más información, consulte las preguntas frecuentes sobre el Código de conducta o comuníquese con [email protected] si tiene alguna pregunta o comentario adicional.

Una vez que se haya agregado una nueva aplicación de muestra, los desarrolladores de Microsoft deberán considerar actualizar la canalización interna del Agregador para:

• Habilite la creación de la nueva aplicación de muestra con regularidad.
• Agregue un nuevo caso de prueba al controlador de prueba TAEF SampleTests existente para verificar periódicamente el inicio exitoso de la aplicación de muestra con la última versión del SDK de aplicaciones de Windows.

Consulte la documentación en el repositorio interno de Aggregator para obtener instrucciones en las etapas BuildSampleApps y TestSampleApps.