Compartir a través de

Introducción a .NET Native

Tanto si estás escribiendo una nueva aplicación para UWP como si vas a migrar una aplicación existente de Windows 8.x (anteriormente denominada aplicación de Microsoft Store), puedes seguir el mismo conjunto de procedimientos. Para crear una aplicación .NET Native, siga estos pasos:

  1. Desarrollar una aplicación para la Plataforma universal de Windows (UWP)y probar las compilaciones de depuración de la aplicación para asegurarse de que funciona correctamente.

  2. Manejo del uso adicional de la reflexión y la serialización.

  3. Implementar y probar las versiones de lanzamiento de la aplicación.

  4. Resolver manualmente los metadatos que faltany repetir paso 3 hasta que se resuelvan todos los problemas.

Nota:

Si va a migrar una aplicación de Windows 8.x existente a .NET Native, asegúrese de revisar Migrar la aplicación de Windows 8.x a .NET Native.

Paso 1: Desarrollar y probar compilaciones de depuración de su aplicación UWP

Tanto si va a desarrollar una nueva aplicación como si va a migrar una existente, sigue el mismo proceso que para cualquier aplicación de Windows.

  1. Cree un nuevo proyecto para UWP en Visual Studio mediante la plantilla de aplicación universal de Windows para Visual C# o Visual Basic. De forma predeterminada, todas las aplicaciones para UWP tienen como destino CoreCLR y sus compilaciones de versión se compilan mediante la cadena de herramientas de .NET Native.

  2. Tenga en cuenta que hay algunos problemas de compatibilidad conocidos entre la compilación de proyectos de aplicaciones para UWP con la cadena de herramientas .NET Native y sin ella. Consulte la guía de migración de para obtener más información.

Ahora puede escribir código C# o Visual Basic para la superficie de .NET Native que se ejecuta en el sistema local (o en el simulador).

Importante

A medida que desarrolle la aplicación, tenga en cuenta cualquier uso de la serialización o reflexión en el código.

De forma predeterminada, las compilaciones de debug se compilan JIT para habilitar la implementación rápida de F5, mientras que las compilaciones de release se compilan mediante la tecnología de compilación previa de .NET Native. Esto significa que debe compilar y probar las compilaciones de depuración de la aplicación para asegurarse de que funcionan normalmente antes de compilarlas con la cadena de herramientas de .NET Native.

Paso 2: Control del uso adicional de reflexión y serialización

Un archivo de directivas en tiempo de ejecución, Default.rd.xml, se agrega automáticamente al proyecto al crearlo. Si desarrollas en C#, se encuentra en la carpeta Propiedades del proyecto. Si desarrolla en Visual Basic, se encuentra en la carpeta Mi proyecto.

Nota:

Para obtener información general sobre el proceso de compilación nativo de .NET que proporciona información general sobre por qué se necesita un archivo de directivas en tiempo de ejecución, consulte .NET Native and Compilation.

El archivo de directivas en tiempo de ejecución se usa para definir los metadatos que la aplicación necesita en tiempo de ejecución. En algunos casos, la versión predeterminada del archivo puede ser adecuada. Sin embargo, algunos código que se basa en la serialización o reflexión pueden requerir entradas adicionales en el archivo de directivas en tiempo de ejecución.

Serialización de

Hay dos categorías de serializadores y ambas pueden requerir entradas adicionales en el archivo de directivas en tiempo de ejecución:

  • Serializadores no basados en reflexión. Los serializadores que se encuentran en la biblioteca de clases de .NET Framework, como las clases DataContractSerializer, DataContractJsonSerializery XmlSerializer, no se basan en la reflexión. Sin embargo, requieren que el código se genere en función del objeto que se va a serializar o deserializar. Para obtener más información, vea la sección "Serializadores de Microsoft" en Serialización y Metadatos.

  • Serializadores de terceros. Las bibliotecas de serialización de terceros, la más común de las cuales es el serializador JSON Newtonsoft, suelen basarse en la reflexión y requieren entradas en el archivo *.rd.xml para admitir la serialización y deserialización de objetos. Para obtener más información, consulte la sección "Serializadores de terceros" en Serialización y Metadatos.

Métodos que se basan en la reflexión

En algunos casos, el uso de la reflexión en el código no es obvio. Algunas API comunes o patrones de programación no se consideran parte de la API de reflexión, pero dependen de la reflexión para ejecutarse correctamente. Esto incluye los siguientes métodos de creación de instancias de tipo y método:

Para obtener más información, consulte APIs que se basan en la reflexión.

Nota:

Los nombres de tipo utilizados en los archivos de directivas en tiempo de ejecución deben estar completamente calificados. Por ejemplo, el archivo debe especificar "System.String" en lugar de "String".

Paso 3: Implementar y probar las compilaciones de versión de la aplicación

Después de actualizar el archivo de directivas del tiempo de ejecución, puede volver a compilar e implementar versiones de lanzamiento de la aplicación. Los archivos binarios nativos de .NET se colocan en el subdirectorio ILC.out del directorio especificado en la ruta de acceso de salida de compilación cuadro de texto del cuadro de diálogo propiedades de del proyecto, pestaña Compilar. Los archivos binarios que no están en esta carpeta no se han compilado con .NET Native. Pruebe exhaustivamente la aplicación y pruebe todos los escenarios, incluidos los escenarios de error, en cada una de sus plataformas de destino.

Si la aplicación no funciona correctamente (especialmente en los casos en los que produce MissingMetadataException o MissingInteropDataException excepciones en tiempo de ejecución), siga las instrucciones de la sección siguiente, Paso 4: Resolver manualmente los metadatos que faltan. La habilitación de excepciones de primera oportunidad puede ayudarle a encontrar estos errores.

Cuando hayas probado y depurado las versiones de depuración de tu aplicación y estés seguro de que has eliminado las excepciones MissingMetadataException y MissingInteropDataException, deberías probar tu aplicación como una aplicación .NET Native optimizada. Para ello, cambie la configuración del proyecto activo de Debug a Release.

Paso 4: Resolver manualmente los metadatos que faltan

El error más común que encontrará con .NET Native y que no se presenta en el escritorio es una excepción de tiempo de ejecución, ya sea MissingMetadataException, MissingInteropDataException, o MissingRuntimeArtifactException. En algunos casos, la ausencia de metadatos puede manifestarse en un comportamiento imprevisible o incluso en errores de aplicación. En esta sección se describe cómo puede depurar y resolver estas excepciones agregando directivas al archivo de directivas en tiempo de ejecución. Para obtener información sobre el formato de las directivas en tiempo de ejecución, vea Directivas en tiempo de ejecución (rd.xml) Referencia de archivo de configuración. Después de agregar directivas en tiempo de ejecución, debe implementar y probar su aplicación de nuevo y resolver cualquier MissingMetadataException, MissingInteropDataException, y MissingRuntimeArtifactException hasta que no encuentre más excepciones.

Sugerencia

Especifique las directivas en tiempo de ejecución en un nivel alto para permitir que la aplicación sea resistente a los cambios de código. Se recomienda agregar directivas de tiempo de ejecución a nivel de espacio de nombres y tipo en lugar de a nivel de miembro. Tenga en cuenta que puede haber un equilibrio entre resistencia y archivos binarios más grandes con tiempos de compilación más largos.

Al solucionar una excepción de metadatos que falta, tenga en cuenta estos problemas:

  • ¿Qué era la aplicación que intentaba hacer antes de la excepción?

    • Por ejemplo, ¿es el enlace de datos, la serialización o deserialización de datos, o directamente mediante la API de reflexión?

  • ¿Se trata de un caso aislado o cree que encontrará el mismo problema para otros tipos?

    • Por ejemplo, se produce una excepción MissingMetadataException al serializar un tipo en el modelo de objetos de la aplicación. Si conoce otros tipos que se serializarán, puede agregar directivas en tiempo de ejecución para esos tipos (o para sus espacios de nombres que contengan, dependiendo de la organización del código) al mismo tiempo.

  • ¿Puede volver a escribir el código para que no use la reflexión?

    • Por ejemplo, ¿usa el código la palabra clave dynamic cuando sabe qué tipo esperar?

    • ¿El código llama a un método que depende de la reflexión cuando hay disponible alguna alternativa mejor?

Nota:

Para obtener información adicional sobre cómo gestionar problemas que se derivan de diferencias en la reflexión y la disponibilidad de metadatos en aplicaciones de escritorio y .NET Native, consulte APIs que dependen de la reflexión.

Para obtener algunos ejemplos específicos de control de excepciones y otros problemas que se producen al probar la aplicación, consulta:

Consulte también