Bindingprojecten MSBuild-items

Opmerking

In .NET voor Android is er technisch gezien geen onderscheid tussen een toepassing en een bindingsproject, zodat deze items in beide werken. In de praktijk wordt het ten zeerste aanbevolen om afzonderlijke toepassings- en bindingsprojecten te maken. Build-items die voornamelijk worden gebruikt in toepassingsprojecten, worden beschreven in de referentiehandleiding voor MSBuild-items .

Items bouwen

Item Beschrijving
AndroidAdditionalJavaManifest
Toegevoegd in .NET 9		 Vertegenwoordigt extra POM-bestanden die nodig zijn om Java-afhankelijkheden te verifiëren.

Documentatie
AndroidIgnoredJavaDependency
Toegevoegd in .NET 9		 Vertegenwoordigt een Java-afhankelijkheden die moeten worden genegeerd bij het verifiëren van Java-afhankelijkheid.

Documentatie
AndroidJavaSource Vertegenwoordigt Java-bronbestanden (.java) die moeten worden gecompileerd en opgenomen in het project.

Documentatie
AndroidLibrary Vertegenwoordigt een .jar/.aar bestand dat moet worden gebonden door het bindingsproject.

Documentatie
AndroidMavenLibrary
Toegevoegd in .NET 9		 Vertegenwoordigt een .jar/.aar bestand dat moet worden gedownload uit een Maven-opslagplaats en die afhankelijk is van het bindingsproject.

Documentatie
AndroidNamespaceReplacement Vertegenwoordigt een transformatie die moet worden toegepast op een Java-pakketnaam om ervoor te zorgen dat de resulterende beheerde naamruimte beter past bij .NET-conventies.

Documentatie
JavaSourceJar Vertegenwoordigt een Java-broncode.jar waaruit API-documentatie moet worden geïmporteerd.

Documentatie

Gedeprecateerde build-items

Deze MSBuild-items zijn afgeschaft. Hoewel ze blijven functioneren, wordt het aanbevolen om te migreren naar de vermelde nieuwere items.

Item Beschrijving
AndroidAarLibrary
Afgeschaft		 Vertegenwoordigt een Android-bestand .aar dat moet worden opgenomen in de projectuitvoer.

Documentatie
AndroidJavaLibrary
Afgeschaft		 Vertegenwoordigt een Android-bestand .jar dat moet worden opgenomen in de projectuitvoer.

Documentatie
EmbeddedJar
Afgeschaft		 Vertegenwoordigt een Android-bestand .jar dat moet worden gebonden en opgenomen in de projectuitvoer.

Documentatie
EmbeddedReferenceJar
Afgeschaft		 Vertegenwoordigt een Android-bestand .jar dat moet worden opgenomen in de projectuitvoer.

Documentatie
LibraryProjectZip
Afgeschaft		 Vertegenwoordigt een Android-bestand .aar dat moet worden opgenomen in de projectuitvoer.

Documentatie

AndroidAarLibrary

Dit build-item is afgeschaft en wordt vervangen door het AndroidLibrary-item .

<!-- Deprecated -->
<AndroidAarLibrary Include="mylib.aar" />

<!-- Recommended -->
<AndroidLibrary Include="mylib.aar" />

De build-actie van AndroidAarLibrary moet worden gebruikt om rechtstreeks naar bestanden te verwijzen .aar . Deze buildactie wordt het meest gebruikt door Xamarin Components. Te weten verwijzingen naar .aar bestanden die nodig zijn om Google Play en andere services te laten werken.

Bestanden met deze buildactie worden op dezelfde manier behandeld als de ingebedde resources in Library-projecten. De .aar wordt in de tussenliggende map geëxtraheerd. Vervolgens worden alle assets, resources en .jar bestanden opgenomen in de juiste itemgroepen.

AndroidAdditionalJavaManifest

<AndroidAdditionalJavaManifest> wordt gebruikt in combinatie met Java Dependency Resolution.

Het wordt gebruikt om extra POM-bestanden op te geven die nodig zijn om afhankelijkheden te verifiëren. Dit zijn vaak bovenliggende of geïmporteerde POM-bestanden waarnaar wordt verwezen door het POM-bestand van een Java-bibliotheek.

<ItemGroup>
  <AndroidAdditionalJavaManifest Include="mylib-parent.pom" JavaArtifact="com.example:mylib-parent" JavaVersion="1.0.0" />
</ItemGroup>
Naam van metagegevens van item Beschrijving
JavaArtifact Vereiste tekenreeks. De groeps- en artefact-id van de Java-bibliotheek die overeenkomt met het opgegeven POM-bestand in de vorm {GroupId}:{ArtifactId}.
JavaVersion Vereiste tekenreeks. De versie van de Java-bibliotheek die overeenkomt met het opgegeven POM-bestand.

Zie de documentatie voor java-afhankelijkheidsoplossing voor meer informatie.

Ondersteuning voor dit build-item is geïntroduceerd in .NET 9.

AndroidGenegeerdeJavaAfhankelijkheid

<AndroidIgnoredJavaDependency> wordt gebruikt in combinatie met Java Dependency Resolution.

Deze wordt gebruikt om een Java-afhankelijkheid op te geven die moet worden genegeerd. Dit kan worden gebruikt als aan een afhankelijkheid wordt voldaan op een manier die door java-afhankelijkheidsresolutie niet kan worden gedetecteerd.

<!-- Include format is {GroupId}:{ArtifactId} -->
<ItemGroup>
  <AndroidIgnoredJavaDependency Include="com.google.errorprone:error_prone_annotations" Version="2.15.0" />
</ItemGroup>
Naam van metagegevens van item Beschrijving
Versie Vereiste tekenreeks. De versie van de Java-bibliotheek die overeenkomt met de opgegeven afhankelijkheid.

Zie de documentatie voor java-afhankelijkheidsoplossing voor meer informatie.

Ondersteuning voor dit build-item is geïntroduceerd in .NET 9.

AndroidJavaLibrary

Dit build-item is afgeschaft en wordt vervangen door het AndroidLibrary-item .

<!-- Deprecated -->
<AndroidJavaLibrary Include="mylib.jar" />

<!-- Recommended -->
<AndroidLibrary Include="mylib.jar" />

Bestanden met een Build-actie van AndroidJavaLibrary zijn Java-archieven (.jar-bestanden) die zullen worden opgenomen in het uiteindelijke Android-pakket.

AndroidJavaSource

AndroidJavaSource bestanden zijn Java-broncode die wordt gecompileerd en opgenomen in het uiteindelijke Android-pakket.

Vanaf .NET 7 hebben alle **\*.java bestanden in de projectmap automatisch een build-actie AndroidJavaSourceen worden ze gebonden vóór de assembly-build. Met C#-code kunt u eenvoudig typen en leden gebruiken die aanwezig zijn in de **\*.java bestanden.

Naam van metagegevens van item Beschrijving
Binden Optionele Booleaanse waarde. Hiermee geeft u op of voor het Java-bronbestand een C#-binding moet worden gegenereerd. Wordt standaard ingesteld op true.

Ondersteuning voor dit build-item is geïntroduceerd in .NET 7.

AndroidLibrary

Vertegenwoordigt een .jar/.aar bestand dat moet worden gebonden en opgenomen in het project.

<ItemGroup>
  <AndroidLibrary Include="foo.jar" />
  <AndroidLibrary Include="bar.aar" />
</ItemGroup>
Naam van metagegevens van item Beschrijving
Binden Optionele Booleaanse waarde. Hiermee geeft u op of voor de Java-bibliotheek een C#-binding moet worden gegenereerd. Wordt standaard ingesteld op true.
Inpakken Optionele Booleaanse waarde. Hiermee geeft u op of de Java-bibliotheek moet worden opgenomen in de projectuitvoer. Wordt standaard ingesteld op true.

AndroidMavenLibrary

Vertegenwoordigt een .jar/.aar bestand dat moet worden gedownload uit een Maven-opslagplaats en die afhankelijk is van het bindingsproject.

Dit kan handig zijn om het onderhoud van .NET voor Android-bindingen te vereenvoudigen voor artefacten die worden gehost in Maven.

<!-- Include format is {GroupId}:{ArtifactId} -->
<ItemGroup>
  <AndroidMavenLibrary Include="com.squareup.okhttp3:okhttp" Version="4.9.3" />
</ItemGroup>
Naam van metagegevens van item Beschrijving
Versie Vereiste tekenreeks. De versie van de Java-bibliotheek die moet worden gedownload van Maven. Wordt standaard ingesteld op true.
Opslagplaats Optionele tekenreeks. Hiermee specificeert u de te gebruiken Maven-opslagplaats. Ondersteunde waarden zijn Central, Googleof een https URL naar een Maven-opslagplaats. Wordt standaard ingesteld op Central.
Binden Optionele booleaanse. Hiermee geeft u op of voor de Java-bibliotheek een C#-binding moet worden gegenereerd. Wordt standaard ingesteld op true.
Inpakken Optionele Booleaanse waarde. Hiermee geeft u op of de Java-bibliotheek moet worden opgenomen in de projectuitvoer. Wordt standaard ingesteld op true.

Zie de AndroidMavenLibrary-documentatie voor meer informatie.

Ondersteuning voor dit build-item is geïntroduceerd in .NET 9.

EmbeddedJar

Dit build-item is afgeschaft en wordt vervangen door het AndroidLibrary-item .

<!-- Deprecated -->
<EmbeddedJar Include="mylib.jar" />

<!-- Recommended -->
<AndroidLibrary Include="mylib.jar" />

In een .NET voor Android-bindingsproject verbindt de EmbeddedJar-buildactie de Java/Kotlin-bibliotheek en embedt het .jar-bestand in de bibliotheek. Wanneer een .NET voor Android-toepassingsproject de bibliotheek verbruikt, heeft het toegang tot de Java/Kotlin-API's van C# en bevat het de Java/Kotlin-code in de uiteindelijke Android-toepassing.

EmbeddedReferenceJar

Dit build-item is afgeschaft en vervangen door het AndroidLibrary-item met de Bind-metadata ingesteld op false.

<!-- Deprecated -->
<EmbeddedReferenceJar Include="mylib.jar" />

<!-- Recommended -->
<AndroidLibrary Include="mylib.jar" Bind="false" />

In een .NET voor Android-bindingsproject sluit de buildactie EmbeddedReferenceJar het .jar bestand in de bibliotheek in, maar maakt geen C#-binding zoals EmbeddedJar wel doet. Wanneer een .NET voor Android-toepassingsproject de bibliotheek verbruikt, bevat het de Java/Kotlin-code in de uiteindelijke Android-toepassing.

JavaSourceJar

Vertegenwoordigt een Java-broncode.jar met Javadoc-documentatieopmerkingen waaruit API-documentatie moet worden geïmporteerd.

Javadoc wordt geconverteerd naar C# XML-documentatieopmerkingen binnen de gegenereerde bindingsbroncode.

$(AndroidJavadocVerbosity) bepaalt hoe uitgebreid of volledig de geïmporteerde Javadoc is.

Naam van metagegevens van item Beschrijving
CopyrightFile Optionele tekenreeks. Een pad naar een bestand met copyrightinformatie voor de Javadoc-inhoud, die wordt toegevoegd aan alle geïmporteerde documentatie.
UrlPrefix Optionele tekenreeks. Een URL-voorvoegsel ter ondersteuning van het koppelen aan onlinedocumentatie in geïmporteerde documentatie.
UrlStyle Optionele tekenreeks. De stijl van URL's die moeten worden gegenereerd bij het koppelen aan onlinedocumentatie. Er wordt momenteel slechts één stijl ondersteund: developer.android.com/reference@2020-Nov.
DocRootUrl Optionele tekenreeks. Een URL-voorvoegsel dat moet worden gebruikt in plaats van al de {@docroot} voorkomens in de geïmporteerde documentatie.

LibraryProjectZip

Dit build-item is afgeschaft en wordt vervangen door het Build-item AndroidLibrary .

<!-- Deprecated -->
<LibraryProjectZip Include="mylib.aar" />

<!-- Recommended -->
<AndroidLibrary Include="mylib.aar" />

De buildactie LibraryProjectZip verbindt de Java/Kotlin-bibliotheek en voegt het .zip- of .aar-bestand in de bibliotheek in. Wanneer een .NET voor Android-toepassingsproject de bibliotheek verbruikt, heeft het toegang tot de Java/Kotlin-API's van C# en bevat het de Java/Kotlin-code in de uiteindelijke Android-toepassing.

  • Last updated on