MSBuild tételek társítása projektekhez

Megjegyzés:

Az Androidhoz készült .NET-ben gyakorlatilag nincs különbség az alkalmazások és a kötések projekt között, így ezek az elemek mindkettőben működni fognak. A gyakorlatban erősen ajánlott külön alkalmazás- és kötésprojekteket létrehozni. Az elsősorban alkalmazásprojektekben használt buildelemeket az MSBuild elemek referencia-útmutatója dokumentálja.

Elemek összeállítása

Termék	Leírás
AndroidAdditionalJavaManifest .NET 9-ben hozzáadva	A Java-függőségek ellenőrzéséhez szükséges további POM-fájlokat jelöli. Dokumentáció
AndroidIgnoredJavaDependency .NET 9-ben hozzáadva	Java-függőségeket jelöl, amelyeket figyelmen kívül kell hagyni a Java-függőség ellenőrzésekor. Dokumentáció
AndroidJavaSource	Java-forrásfájlokat (.java) jelöl, amelyeket a projektben kell lefordítani és belefoglalni. Dokumentáció
AndroidLibrary	.jar / .aar A kötések projekt által kötött fájlt jelöli. Dokumentáció
AndroidMavenLibrary .NET 9-ben hozzáadva	.jar / .aar Olyan fájlt jelöl, amelyet le kell tölteni egy Maven-adattárból, és amelyet a kötések projekt köt össze. Dokumentáció
AndroidNamespaceReplacement	Olyan átalakítást jelöl, amelyet java-csomagnévre kell alkalmazni, hogy az eredményként kapott felügyelt névtér jobban illeszkedjen a .NET-konvenciókhoz. Dokumentáció
JavaSourceJar	Java-forráskódot.jar jelöl, amelyből az API-dokumentációt importálni kell. Dokumentáció

Elavult építési elemek

Ezek az MSBuild elemek elavultak. Bár továbbra is működnek, javasoljuk, hogy váltson át a felsorolt újabb elemekre.

Termék	Leírás
AndroidAarLibrary Elavult	Az Android .aar fájl a projekt kimenetének részeként szerepel. Dokumentáció
AndroidJavaLibrary Elavult	Az Android .jar fájl a projekt kimenetének részeként szerepel. Dokumentáció
EmbeddedJar Elavult	Az Android .jar fájlt jelenti, amelyet be kell kötni és bele kell foglalni a projekt kimenetébe. Dokumentáció
EmbeddedReferenceJar Elavult	Az Android .jar fájl a projekt kimenetének részeként szerepel. Dokumentáció
LibraryProjectZip Elavult	Az Android .aar fájl a projekt kimenetének részeként szerepel. Dokumentáció

AndroidAarLibrary

Ez a buildelem elavult, és az AndroidLibrary elem váltja fel.

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

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

A AndroidAarLibrary buildelési műveletet kell használni a .aar fájlok közvetlen hivatkozásához. Ezt a buildelési műveletet leggyakrabban a Xamarin-összetevők fogják használni. Nevezetesen a Google Play és más szolgáltatások működéséhez szükséges fájlokra mutató hivatkozások .aar belefoglalása.

Az ezzel a buildelési művelettel rendelkező fájlokat a kódtárprojektekben található beágyazott erőforrásokhoz hasonlóan kezeli a rendszer. A .aar ki lesz nyerve a köztes könyvtárba. Ezután minden eszköz, erőforrás és .jar fájl bekerül a megfelelő elemcsoportokba.

AndroidAdditionalJavaManifest

<AndroidAdditionalJavaManifest> java-függőségfeloldással együtt használható.

A függőségek ellenőrzéséhez szükséges további POM-fájlok megadására szolgál. Ezek gyakran egy Java-kódtár POM-fájlja által hivatkozott szülő- vagy importált POM-fájlok.

<ItemGroup>
  <AndroidAdditionalJavaManifest Include="mylib-parent.pom" JavaArtifact="com.example:mylib-parent" JavaVersion="1.0.0" />
</ItemGroup>

Elem metaadatainak neve	Leírás
JavaArtifact	Kötelező karakterlánc. A Java-könyvtár csoportazonosítója és összetevőazonosítója, amely megfelel a megadott POM-fájl {GroupId}:{ArtifactId} formátumának.
Java-verzió	Kötelező karakterlánc. A Java-kódtárnak a megadott POM-fájlnak megfelelő verziója.

További részletekért tekintse meg a Java függőségfeloldási dokumentációját .

Ennek a buildelemnek a támogatása a .NET 9-ben jelent meg.

AndroidFigyelmenKívüliJavaFüggőség

<AndroidIgnoredJavaDependency> java-függőségfeloldással együtt használható.

Java-függőség megadására szolgál, amelyet figyelmen kívül kell hagyni. Ez akkor használható, ha egy függőség olyan módon lesz teljesítve, amelyet a Java-függőség feloldási folyamata nem képes észlelni.

<!-- Include format is {GroupId}:{ArtifactId} -->
<ItemGroup>
  <AndroidIgnoredJavaDependency Include="com.google.errorprone:error_prone_annotations" Version="2.15.0" />
</ItemGroup>

Elem metaadatainak neve	Leírás
Verzió	Kötelező karakterlánc. A Java-kódtár megadott függőségnek megfelelő verziója.

További részletekért tekintse meg a Java függőségfeloldási dokumentációját .

Ennek a buildelemnek a támogatása a .NET 9-ben jelent meg.

Android Java Könyvtár

Ez a buildelem elavult, és az AndroidLibrary elem váltja fel.

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

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

A buildelési művelettel AndroidJavaLibrary rendelkező fájlok java archívumok ( .jar fájlok), amelyeket a végső Android-csomag tartalmaz.

AndroidJavaSource

AndroidJavaSource A fájlok Java-forráskódok, amelyeket lefordítunk és belefoglalunk a végleges Android-csomagba.

A .NET 7-től kezdve a projektkönyvtárban lévő összes **\*.java fájl automatikusan rendelkezik a buildelési művelettel AndroidJavaSource, és a szerelvény buildje előtt lesz kötve. Lehetővé teszi a C#-kód számára a fájlokban **\*.java található típusok és tagok egyszerű használatát.

Elem metaadatainak neve	Leírás
Összekapcsolás	Nem kötelező logikai változó. Megadja, hogy a Java-forrásfájlhoz létre kell-e hozni egy C#-kötést. Alapértelmezett érték: true.

Ennek a buildelemnek a támogatása a .NET 7-ben jelent meg.

Android Könyvtár

.jar / .aar Egy kötendő és a projektbe belefoglalandó fájlt jelöl.

<ItemGroup>
  <AndroidLibrary Include="foo.jar" />
  <AndroidLibrary Include="bar.aar" />
</ItemGroup>

Elem metaadatainak neve	Leírás
Összekapcsolás	Nem kötelező logikai változó. Megadja, hogy a Java-kódtárhoz létre kell-e hozni egy C#-kötést. Alapértelmezett érték: true.
csomag	Nem kötelező logikai változó. Megadja, hogy a Java-kódtár szerepeljen-e a projekt kimenetében. Alapértelmezett érték: true.

AndroidMavenLibrary

.jar / .aar Olyan fájlt jelöl, amelyet le kell tölteni egy Maven-adattárból, és amelyet a kötések projekt köt össze.

Ez hasznos lehet a Mavenben tárolt artifaktumokhoz tartozó .NET-kötések karbantartásának egyszerűsítésére.

<!-- Include format is {GroupId}:{ArtifactId} -->
<ItemGroup>
  <AndroidMavenLibrary Include="com.squareup.okhttp3:okhttp" Version="4.9.3" />
</ItemGroup>

Elem metaadatainak neve	Leírás
Verzió	Kötelező karakterlánc. A Mavenből letöltendő Java-kódtár verziója. Alapértelmezett érték: true.
Raktár	Nem kötelező karaktersor. Megadja a használni kívánt Maven-adattárat. A támogatott értékek a CentralGooglehttps Maven-adattár URL-címei. Alapértelmezett érték: Central.
AllowInsecureHttp	Nem kötelező logikai változó. Ha Repository URL-címről http:// van szó, ezt úgy kell beállítani, hogy true engedélyezze a nem biztonságos kapcsolatot. Alapértelmezett érték: false. A HTTPS használata erősen ajánlott az ellátási lánc biztonsága érdekében.
Összekapcsolás	Nem kötelező logikai változó. Megadja, hogy a Java-kódtárhoz létre kell-e hozni egy C#-kötést. Alapértelmezett érték: true.
csomag	Nem kötelező logikai változó. Megadja, hogy a Java-kódtár szerepeljen-e a projekt kimenetében. Alapértelmezett érték: true.

További részletekért tekintse meg az AndroidMavenLibrary dokumentációját .

Ennek a buildelemnek a támogatása a .NET 9-ben jelent meg.

EmbeddedJar

Ez a buildelem elavult, és az AndroidLibrary elem váltja fel.

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

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

Az Androidhoz készült .NET kötési projektben az EmbeddedJar buildelési művelet köti a Java-/Kotlin-kódtárat, és beágyazza a fájlt a .jar tárba. Amikor egy Android-alapú .NET-alkalmazásprojekt felhasználja a kódtárat, hozzáférése lesz a Java/Kotlin API-khoz a C#-ból, valamint a Java/Kotlin kódot is belefoglalja a végleges Android-alkalmazásba.

EmbeddedReferenceJar

Ez a buildelem elavult, és az Bind metaadatai értékre állítva az false elem váltja fel.

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

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

Az Androidhoz készült .NET kötési projektben az EmbeddedReferenceJar buildelési művelet beágyazza a .jar fájlt a tárba, de nem hoz létre C#-kötést, ahogy az EmbeddedJar teszi. Amikor egy Android-alapú .NET-alkalmazásprojekt használja a kódtárat, az a Java/Kotlin kódot fogja tartalmazni a végleges Android-alkalmazásba.

JavaSourceJar

Java-forráskódot.jar jelöl, amely javadoc dokumentációs megjegyzéseket tartalmaz, amelyekből az API-dokumentációt importálni kell.

A Javadoc c # XML-dokumentációs megjegyzésekké lesz konvertálva a létrehozott kötési forráskódon belül.

$(AndroidJavadocVerbosity) az importált Javadoc "részletes" vagy "teljes" működését szabályozza.

Elem metaadatainak neve	Leírás
Szerzői jogi fájl	Nem kötelező karaktersor. A Javadoc-tartalom szerzői jogi adatait tartalmazó fájl elérési útja, amely hozzá lesz fűzve az összes importált dokumentációhoz.
URL-előtag	Nem kötelező karaktersor. Egy URL-előtag, amely támogatja az online dokumentációhoz való csatolást az importált dokumentációban.
UrlStyle	Nem kötelező karaktersor. Az online dokumentációhoz való csatoláskor létrehozandó URL-címek "stílusa". Jelenleg csak egy stílus támogatott: developer.android.com/reference@2020-Nov.
DocRootUrl	Nem kötelező karaktersor. Az importált dokumentáció összes {@docroot} példánya helyett használandó URL-előtag.

LibraryProjectZip

Ez a buildelem elavult, és az AndroidLibrary buildelem váltja fel.

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

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

A LibraryProjectZip buildelési művelet összekapcsolja a Java/Kotlin könyvtárat, és beágyazza a .zip vagy .aar fájlt a könyvtárba. Amikor egy Android-alapú .NET-alkalmazásprojekt felhasználja a kódtárat, hozzáférése lesz a Java/Kotlin API-khoz a C#-ból, valamint a Java/Kotlin kódot is belefoglalja a végleges Android-alkalmazásba.