Skip to content

Commit e52cc13

Browse files
committed
Add more documentation.
1 parent ec8fdb9 commit e52cc13

File tree

2 files changed

+49
-0
lines changed

2 files changed

+49
-0
lines changed

Documentation/guides/building-apps/build-items.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,23 @@ ms.date: 07/26/2022
1414
Build items control how a Xamarin.Android application
1515
or library project is built.
1616

17+
## AndroidAdditionalJavaManifest
18+
19+
`<AndroidAdditionalJavaManifest>` is used in conjunction with [Java Dependency Resolution](../JavaDependencyVerification.md).
20+
21+
It is used to specify additional POM files that will be needed to verify dependencies.
22+
These are often parent or imported POM files referenced by a Java library's POM file.
23+
24+
```xml
25+
<ItemGroup>
26+
<AndroidAdditionalJavaManifest Include="mylib-parent.pom" JavaArtifact="com.example.mylib-parent" JavaVersion="1.0.0" />
27+
</ItemGroup>
28+
```
29+
See the [Java Dependency Resolution documentation](../JavaDependencyVerification.md)
30+
for more details.
31+
32+
This build action was introduced in .NET 9.
33+
1734
## AndroidAsset
1835

1936
Supports [Android Assets](https://developer.android.com/guide/topics/resources/providing-resources#OriginalFiles),
@@ -84,6 +101,25 @@ Files with a Build action of `AndroidJavaLibrary` are Java
84101
Archives ( `.jar` files) that will be included in the final Android
85102
package.
86103

104+
## AndroidIgnoredJavaDependency
105+
106+
`<AndroidIgnoredJavaDependency>` is used in conjunction with [Java Dependency Resolution](../JavaDependencyVerification.md).
107+
108+
It is used to specify a Java dependency that should be ignored. This can be
109+
used if a dependency will be fulfilled in a way that Java dependency resolution
110+
cannot detect.
111+
112+
```xml
113+
<!-- Include format is {GroupId}:{ArtifactId} -->
114+
<ItemGroup>
115+
<AndroidIgnoredJavaDependency Include="com.google.errorprone:error_prone_annotations" Version="2.15.0" />
116+
</ItemGroup>
117+
```
118+
See the [Java Dependency Resolution documentation](../JavaDependencyVerification.md)
119+
for more details.
120+
121+
This build action was introduced in .NET 9.
122+
87123
## AndroidJavaSource
88124

89125
Files with a Build action of `AndroidJavaSource` are Java source code that

Documentation/guides/messages/README.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -183,6 +183,19 @@ Either change the value in the AndroidManifest.xml to match the $(SupportedOSPla
183183
+ XA4230: Error parsing XML: {exception}
184184
+ [XA4231](xa4231.md): The Android class parser value 'jar2xml' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.
185185
+ [XA4232](xa4232.md): The Android code generation target 'XamarinAndroid' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.
186+
+ [XA4234](xa4234.md): '<{item}>' item '{itemspec}' is missing required attribute '{name}'.
187+
+ [XA4235](xa4235.md): Maven artifact specification '{artifact}' is invalid. The correct format is 'group_id:artifact_id'.
188+
+ [XA4236](xa4236.md): Cannot download Maven artifact '{group}:{artifact}'. - {jar}: {exception} - {aar}: {exception}
189+
+ [XA4237](xa4237.md): Cannot download POM file for Maven artifact '{artifact}'. - {exception}
190+
+ [XA4239](xa4239.md): Unknown Maven repository: '{repository}'.
191+
+ [XA4241](xa4241.md): Java dependency '{artifact}' is not satisfied.
192+
+ [XA4242](xa4242.md): Java dependency '{artifact}' is not satisfied. Microsoft maintains the NuGet package '{nugetId}' that could fulfill this dependency.
193+
+ [XA4243](xa4243.md): Attribute '{name}' is required when using '{name}' for '{element}' item '{itemspec}'.
194+
+ [XA4244](xa4244.md): Attribute '{name}' cannot be empty for '{element}' item '{itemspec}'.
195+
+ [XA4245](xa4245.md): Specified POM file '{file}' does not exist.
196+
+ [XA4246](xa4246.md): Could not parse POM file '{file}'. - {exception}
197+
+ [XA4247](xa4247.md): Could not resolve POM file for artifact '{artifact}'.
198+
+ [XA4248](xa4248.md): Could not find NuGet package '{nugetId}' version '{version}' in lock file. Ensure NuGet Restore has run since this <PackageReference> was added.
186199
+ XA4300: Native library '{library}' will not be bundled because it has an unsupported ABI.
187200
+ [XA4301](xa4301.md): Apk already contains the item `xxx`.
188201
+ [XA4302](xa4302.md): Unhandled exception merging \`AndroidManifest.xml\`: {ex}

0 commit comments

Comments
 (0)