Projeleri bağlama MSBuild öğeleri

Uyarı

Android için .NET'te teknik olarak bir uygulama ile bağlama projesi arasında ayrım yoktur, bu nedenle bu öğeler her ikisinde de çalışır. Uygulamada ayrı uygulama ve bağlama projeleri oluşturmanız kesinlikle önerilir. Öncelikli olarak uygulama projelerinde kullanılan derleme öğeleri MSBuild öğeleri başvuru kılavuzunda belgelenmiştir.

Öğe oluştur

Öğe	Açıklama
AndroidAdditionalJavaManifest .NET 9'da eklendi	Java bağımlılıklarını doğrulamak için gereken ek POM dosyalarını temsil eder. Dokümantasyon
AndroidIgnoredJavaDependency .NET 9'da eklendi	Java bağımlılığı doğrulandığında yoksayılması gereken bir Java bağımlılıklarını temsil eder. Dokümantasyon
AndroidJavaSource	Derlenmesi ve projeye dahil edilmesi gereken Java kaynak dosyalarını (.java) temsil eder. Dokümantasyon
AndroidLibrary	Bağlamalar projesi tarafından bağlanacak bir .jar/.aar dosyayı temsil eder. Dokümantasyon
AndroidMavenLibrary .NET 9'da eklendi	.jar / .aar Maven deposundan indirilmesi gereken ve bağlamalar projesine bağlı olan bir dosyayı temsil eder. Dokümantasyon
AndroidNamespaceReplacement	Sonuçta elde edilen yönetilen ad alanının .NET kurallarına daha uygun olmasını sağlamak için Java paket adına uygulanması gereken bir dönüşümü temsil eder. Dokümantasyon
JavaSourceJar	API belgelerinin içeri aktarılması gereken bir Java kaynak kodunu.jar temsil eder. Dokümantasyon

Kullanım dışı derleme öğeleri

Bu MSBuild öğeleri kullanım dışı bırakıldı. Bunlar çalışmaya devam ederken, listelenen yeni öğelere geçiş önerilir.

Öğe	Açıklama
AndroidAarLibrary Kullanım Dışı	Proje çıkışına eklenecek bir Android .aar dosyasını temsil eder. Dokümantasyon
AndroidJavaLibrary Kullanım Dışı	Proje çıkışına eklenecek bir Android .jar dosyasını temsil eder. Dokümantasyon
EmbeddedJar Kullanım Dışı	Bağlanacak ve proje çıkışına eklenecek bir Android .jar dosyasını temsil eder. Dokümantasyon
EmbeddedReferenceJar Kullanım Dışı	Proje çıkışına eklenecek bir Android .jar dosyasını temsil eder. Dokümantasyon
LibraryProjectZip Kullanım Dışı	Proje çıkışına eklenecek bir Android .aar dosyasını temsil eder. Dokümantasyon

AndroidAarLibrary

Bu derleme öğesi kullanım dışıdır ve AndroidLibrary öğesiyle değiştirilir.

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

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

AndroidAarLibrary derleme eylemi, .aar dosyalarına doğrudan başvurmak için kullanılmalıdır. Bu derleme eylemi en yaygın olarak Xamarin Bileşenleri tarafından kullanılır. Diğer bir deyişle, Google Play ve diğer hizmetlerin çalışması için gereken dosyalara referanslar .aar eklemektir.

Bu Derleme eylemine sahip dosyalar, Kitaplık projelerinde bulunan ekli kaynaklara benzer şekilde ele alınacaktır. .aar, ara dizine ayıklanacaktır. Ardından tüm varlıklar, kaynaklar ve .jar dosyalar uygun öğe gruplarına dahil edilecek.

AndroidAdditionalJavaManifest

<AndroidAdditionalJavaManifest> Java Bağımlılık Çözümlemesi ile birlikte kullanılır.

Bağımlılıkları doğrulamak için gereken ek POM dosyalarını belirtmek için kullanılır. Bunlar genellikle bir Java kitaplığının POM dosyası tarafından referans alınan ebeveyn veya içe aktarılan POM dosyalarıdır.

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

Öğe meta veri adı	Açıklama
JavaArtifact	Zorunlu dize. Belirtilen POM dosyasıyla eşleşen Java kitaplığının grup ve yapıt kimliği, {GroupId}:{ArtifactId} biçimindedir.
JavaVersion	Zorunlu dize. Belirtilen POM dosyasıyla eşleşen Java kitaplığının sürümü.

Daha fazla ayrıntı için Java Bağımlılık Çözümü belgelerine bakın.

Bu derleme öğesi için destek .NET 9'da kullanıma sunulmuştur.

AndroidYoksayılanJavaBağımlılık

<AndroidIgnoredJavaDependency> Java Bağımlılık Çözümlemesi ile birlikte kullanılır.

Yoksayılması gereken bir Java bağımlılığı belirtmek için kullanılır. Bu, java bağımlılık çözümlemesi tarafından algılanamayacak şekilde bir bağımlılığın karşılanması durumunda kullanılabilir.

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

Öğe meta veri adı	Açıklama
Sürüm	Zorunlu dize. Belirtilen bağımlılıkla eşleşen Java kitaplığı sürümü.

Daha fazla ayrıntı için Java Bağımlılık Çözümü belgelerine bakın.

Bu derleme öğesi için destek .NET 9'da kullanıma sunulmuştur.

AndroidJavaLibrary

Bu derleme öğesi kullanım dışıdır ve AndroidLibrary öğesiyle değiştirilir.

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

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

Derleme eylemi AndroidJavaLibrary olan dosyalar, son Android paketine dahil edilecek Java Arşivleri (.jar dosyaları) 'dir.

AndroidJavaSource

AndroidJavaSource dosyaları derlenecek ve son Android paketine dahil edilecek Java kaynak kodulardır.

.NET 7'den başlayarak, proje dizinindeki tüm **\*.java dosyalar otomatik olarak derleme eylemine AndroidJavaSourcesahip olur ve Derleme derlemesi öncesinde bağlanır. C# kodunun dosyaların içinde bulunan türleri ve üyeleri kolayca kullanmasına **\*.java olanak tanır.

Öğe meta veri adı	Açıklama
Bağlamak	İsteğe bağlı boole değeri. Java kaynak dosyası için bir C# bağlayıcısının oluşturulup oluşturulmayacağını belirtir. Varsayılan olarak true değerini alır.

Bu derleme öğesi için destek .NET 7'de sunulmuştur.

Android Kütüphanesi

Bağlanacak ve projeye dahil edilecek bir .jar/.aar dosyayı temsil eder.

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

Öğe meta veri adı	Açıklama
Bağlamak	İsteğe bağlı boole değeri. Java kütüphanesi için bir C# bağlamasının oluşturulup oluşturulmayacağını belirtir. Varsayılan olarak true değerini alır.
Paket	İsteğe bağlı boole değeri. Java kitaplığının proje çıkışına eklenip eklenmeyeceğini belirtir. Varsayılan olarak true değerini alır.

AndroidMavenLibrary

.jar / .aar Maven deposundan indirilmesi gereken ve bağlamalar projesine bağlı olan bir dosyayı temsil eder.

Bu, Maven'da barındırılan yapıtlar için Android bağlamaları için .NET'in bakımını basitleştirmek için yararlı olabilir.

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

Öğe meta veri adı	Açıklama
Sürüm	Zorunlu dize. Maven'dan indirilmesi gereken Java kitaplığı sürümü. Varsayılan olarak true değerini alır.
Depo	İsteğe bağlı dize. Kullanılacak Maven deposunu belirtir. Desteklenen değerler , Centralveya Google Bir Maven deposunun URL'sidirhttps. Varsayılan olarak Central değerini alır.
Bağlamak	İsteğe bağlı boole değeri. Java kütüphanesi için bir C# bağlamasının oluşturulup oluşturulmayacağını belirtir. Varsayılan olarak true değerini alır.
Paket	İsteğe bağlı boole değeri. Java kitaplığının proje çıkışına eklenip eklenmeyeceğini belirtir. Varsayılan olarak true değerini alır.

Daha fazla ayrıntı için AndroidMavenLibrary belgelerine bakın.

Bu derleme öğesi için destek .NET 9'da kullanıma sunulmuştur.

EmbeddedJar

Bu derleme öğesi kullanım dışıdır ve AndroidLibrary öğesiyle değiştirilir.

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

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

Android için .NET bağlama projesinde EmbeddedJar derleme eylemi Java/Kotlin kitaplığını bağlar ve dosyayı kitaplığa ekler .jar . Android için .NET uygulama projesi kitaplığını tükettiğinde, C# dilinden Java/Kotlin API'lerine erişimi olur ve son Android uygulamasına Java/Kotlin kodunu ekler.

EmbeddedReferenceJar

Bu derleme öğesi kullanım dışıdır ve AndroidLibrary öğesiyle Bind meta verisi false olarak ayarlanmış şekilde değiştirilmiştir.

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

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

Android için .NET bağlama projesinde EmbeddedReferenceJar derleme eylemi dosyayı kitaplığa ekler .jar ancak EmbeddedJar'ın yaptığı gibi C# bağlaması oluşturmaz. Android için .NET uygulama projesi kitaplığını tükettiğinde, son Android uygulamasında Java/Kotlin kodunu içerir.

JavaSourceJar

API belgelerinin içeri aktarılması gereken Javadoc belge açıklamalarını içeren bir Java .jar temsil eder.

Javadoc, oluşturulan bağlama kaynak kodu içinde C# XML Belge Açıklamalarına dönüştürülecek.

$(AndroidJavadocVerbosity) içeri aktarılan Javadoc'un nasıl "ayrıntılı" veya "tamam" olduğunu denetler.

Öğe meta veri adı	Açıklama
Telif Hakkı Dosyası	İsteğe bağlı dize. Javadoc içeriği için telif hakkı bilgilerini içeren bir dosyanın yolu, bu içerik aktarılan tüm belgelere eklenecektir.
URL Öneki	İsteğe bağlı dize. İçeri aktarılan belgelerde çevrimiçi belgelere bağlanmayı destekleyen bir URL ön eki.
UrlTarzı	İsteğe bağlı dize. Çevrimiçi belgelere bağlanırken oluşturulacak URL'lerin "stili". Şu anda yalnızca bir stil desteklenmektedir: developer.android.com/reference@2020-Nov.
DocRootUrl	İsteğe bağlı dize. İçeri aktarılan belgelerde tüm {@docroot} örneklerin yerine kullanılacak bir URL ön eki.

LibraryProjectZip

Bu derleme öğesi kullanım dışıdır ve AndroidLibrary derleme öğesiyle değiştirilir.

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

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

LibraryProjectZip derleme eylemi Java/Kotlin kitaplığını bağlar ve veya .zip dosyasını kitaplığa ekler.aar. Android için .NET uygulama projesi kitaplığını tükettiğinde, C# dilinden Java/Kotlin API'lerine erişimi olur ve son Android uygulamasına Java/Kotlin kodunu ekler.