Propiedades de MSBuild de proyectos de enlace

Nota:

En .NET para Android no hay técnicamente ninguna distinción entre una aplicación y un proyecto de enlaces, por lo que estas propiedades funcionarán en ambos. En la práctica, se recomienda crear proyectos de aplicación y enlaces independientes. Las propiedades de compilación que se utilizan principalmente en proyectos de aplicaciones se documentan en la guía de referencia Propiedades de MSBuild.

Propiedades de compilación

Propiedad	Valor predeterminado	Descripción
AndroidBoundInterfacesContainConstants	true	Propiedad booleana que especifica si se admitirán constantes de enlace en interfaces o si se usará la solución alternativa heredada para crear una IMyInterfaceConsts clase. Documentación
AndroidBoundInterfacesContainStatic AndDefaultInterfaceMethods	true	Una propiedad booleana que especifica si se admitirán miembros predeterminados y estáticos en interfaces, o bien se usará la solución alternativa heredada para crear una clase del mismo nivel que contenga miembros estáticos como abstract class MyInterface . Documentación
AndroidBoundInterfacesContainTypes	true	Propiedad booleana que especifica si se admitirán tipos anidados en interfaces o la solución alternativa heredada de crear un tipo no anidado como IMyInterfaceMyNestedClass se usará. Documentación
AndroidEnableObsoleteOverrideInheritance Agregado en .NET 8	true	Propiedad booleana que especifica si los métodos enlazados que invalidan @Deprecated los métodos de Java se marcan automáticamente como @Deprecated. Documentación
AndroidEnableRestrictToAttributes Agregado en .NET 8	obsolete	Propiedad de estilo de enumeración con valores válidos de obsolete y disable que especifica si el atributo .NET [Obsolete] se agrega a la API enlazada marcada con @RestrictTo en una biblioteca de Java. Documentación
AndroidJavadocVerbosity	intellisense	Una propiedad de tipo enumeración con valores válidos intellisense y full que especifica el nivel de detalle que deben tener los comentarios de documentación XML de C# al importar documentación Javadoc en proyectos vinculados mediante la @(JavaSourceJar)acción de compilación. Documentación
GenerateDocumentationFile	true	Propiedad booleana que especifica si se genera un archivo de documentación XML de C# durante la compilación y (al empaquetar) incluido en el paquete NuGet generado. Documentación

AndroidBoundInterfacesContainConstants

Propiedad booleana que especifica si se admitirán constantes de enlace en interfaces o si se usará la solución alternativa heredada para crear una IMyInterfaceConsts clase.

El valor predeterminado es true.

Esto solo se recomienda si se intenta mantener la compatibilidad de api pública con una biblioteca de enlaces heredada creada antes de que se publicara C# 8.

Más detalles

AndroidBoundInterfacesContainStaticAndDefaultInterfaceMethods

Una propiedad booleana que especifica si se admitirán los miembros predeterminados y estáticos en las interfaces, o si se usará la solución alternativa heredada para crear una clase del mismo nivel que contenga miembros estáticos como abstract class MyInterface .

El valor predeterminado es true.

Esto solo se recomienda si se intenta mantener la compatibilidad de api pública con una biblioteca de enlaces heredada creada antes de que se publicara C# 8.

Más detalles

AndroidBoundInterfacesContainTypes

Una propiedad booleana que especifica si se admitirán tipos anidados en interfaces o si se usará la solución alternativa heredada para crear un tipo no anidado como IMyInterfaceMyNestedClass .

El valor predeterminado es true.

Esto solo se recomienda si se intenta mantener la compatibilidad de api pública con una biblioteca de enlaces heredada creada antes de que se publicara C# 8.

Más detalles

AndroidEnableRestrictToAttributes

Propiedad de estilo de enumeración con valores válidos de obsolete y disable que controla si el atributo .NET [Obsolete] se agrega a la API enlazada marcada con @RestrictTo en una biblioteca de Java.

Esta propiedad se establece en obsolete de forma predeterminada.

Cuando se establece en obsolete, los tipos y los miembros que están marcados con la anotación androidx.annotation.RestrictTo de Java o que están en paquetes de Java no exportados se marcarán con un atributo [Obsolete] en el enlace de C#.

Este [Obsolete] atributo tiene un mensaje descriptivo que explica que el propietario del paquete de Java considera que la API es "interna" y advierte sobre su uso.

Este atributo también tiene un código XAOBS001 de advertencia personalizado para que se pueda suprimir independientemente de la API obsoleta "normal".

Cuando se establece disable, la API se generará de manera normal sin atributos adicionales. (Este es el mismo comportamiento que antes de .NET 8).

La incorporación de atributos [Obsolete] en lugar de eliminar automáticamente la API se ha realizado para conservar la compatibilidad de la API con los paquetes existentes. Si, por el contrario, prefieres eliminar los miembros que tengan la @RestrictToanotación o se encuentren en paquetes Java no exportados, puedes utilizar metadatos además de esta propiedad para evitar que estos tipos se vinculen:

<remove-node path="//*[@annotated-visibility]" />

Se ha agregado compatibilidad con esta propiedad en .NET 8.

AndroidEnableObsoleteOverrideInheritance

Propiedad booleana que especifica si los métodos enlazados que invalidan @Deprecated los métodos de Java se marcan automáticamente como @Deprecated.

Es muy poco frecuente que necesite cambiar esta propiedad.

Se ha agregado compatibilidad con esta propiedad en .NET 8.

GenerateDocumentationFile

Propiedad booleana que especifica si se genera un archivo de documentación XML de C# y se incluye al empaquetar el proyecto de enlace.

La generación de documentación XML está habilitada de forma predeterminada para los proyectos de enlace. Establezca esta propiedad en false para deshabilitar la generación de documentación XML.

AndroidJavadocVerbosity

Una propiedad de tipo enumeración con valores válidos intellisense y full que especifica el nivel de detalle que deben tener los comentarios de documentación XML de C# al importar documentación Javadoc en proyectos vinculados mediante la @(JavaSourceJar)acción de compilación.

Esta propiedad se establece en intellisense de forma predeterminada.

• intellisense: solo emite los comentarios XML: <exception/>, <param/>, <returns/>, <summary/>.
• full: emita elementos enumerados intellisense , así como <remarks/>, <seealso/>y cualquier otra cosa que sea compatible.