Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/android/TOC.yml
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,8 @@
href: messages/apt0000.md
- name: APT0001
href: messages/apt0001.md
- name: APT2000
href: messages/apt2000.md
- name: APT2264
href: messages/apt2264.md
- name: APT2265
Expand Down Expand Up @@ -274,6 +276,12 @@
href: messages/xa1037.md
- name: XA1038
href: messages/xa1038.md
- name: XA1039
href: messages/xa1039.md
- name: XA1040
href: messages/xa1040.md
- name: XA1041
href: messages/xa1041.md
- name: "XA2xxx: Linker"
items:
- name: "XA2xxx: Linker"
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: AndroidMavenLibrary Build Action .NET for Android
description: AndroidMavenLibrary Build Action .NET for Android
ms.author: jopobst
ms.author: jopepper
ms.date: 05/11/2024
---
# AndroidMavenLibrary
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Distributing bindings libraries
description: Once a Java library has been bound, it may be desirable to distribute it internally or via NuGet for consumption.
ms.author: jopobst
ms.author: jopepper
ms.date: 05/08/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Java Dependency Verification in .NET for Android
description: Java Dependency Verification in .NET for Android
ms.author: jopobst
ms.author: jopepper
ms.date: 05/11/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Resolving Java Dependencies in .NET for Android
description: Resolving Java Dependencies in .NET for Android
ms.author: jopobst
ms.author: jopepper
ms.date: 05/11/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Binding a Java Library
description: Bind an existing Java library to use it from a .NET for Android application.
ms.author: jopobst
ms.author: jopepper
ms.date: 05/07/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Binding a Java Library from Maven
description: <AndroidMavenLibrary> allows a Maven artifact to be specified which will automatically be downloaded and added to a .NET for Android binding project. This can be useful to simplify maintenance of .NET for Android bindings for artifacts hosted in Maven.
ms.author: jopobst
ms.author: jopepper
ms.date: 05/11/2024
---

Expand Down
2 changes: 1 addition & 1 deletion docs/android/binding-libs/binding-java-libs/index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Overview
description: "The Android community has many Java libraries that you may want to use in your app; this guide explains how to incorporate Java libraries into your .NET for Android application by creating a Bindings Library."
ms.author: jopobst
ms.author: jopepper
ms.date: 05/08/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Creating enumerations"
description: There are cases where Java Android libraries use integer constants to represent states that are passed to properties or methods of the libraries. For widely distributed bindings, it may useful to bind these integer constants to enums in C# to provide a nicer API for consumers.
ms.author: jopobst
ms.author: jopepper
ms.date: 05/08/2024
---

Expand Down
2 changes: 1 addition & 1 deletion docs/android/binding-libs/customizing-bindings/index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Customizing Bindings"
description: "You can customize a .NET for Android binding by editing the metadata that controls the binding process. These manual modifications are often necessary for resolving build errors and for shaping the resulting API so that it is more consistent with C#/.NET. These guides explain the structure of this metadata and how to modify the metadata."
ms.author: jopobst
ms.author: jopepper
ms.date: 05/06/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Java Bindings Metadata"
description: "C# code in .NET for Android calls Java libraries through bindings, which are a mechanism that abstracts the low-level details that are specified in Java Native Interface (JNI). .NET for Android provides a tool that generates these bindings. This tooling lets the developer control how a binding is created by using metadata, which allows procedures such as modifying namespaces and renaming members. This document discusses how metadata works, summarizes the attributes that metadata supports, and explains how to resolve binding problems by modifying this metadata."
ms.author: jopobst
ms.author: jopepper
ms.date: 05/09/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Customizing Namespaces"
description: "Renaming Java package names to better fit C# namespaces conventions is a very common use of binding metadata. In order to make this task easier, customizations can be made in the MSBuild project file instead of writing metadata."
ms.author: jopobst
ms.author: jopepper
ms.date: 05/06/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Troubleshooting Bindings"
description: "This article summarizes serveral common errors that may occur when generating bindings, along with possible causes and suggested ways to resolve them."
ms.author: jopobst
ms.author: jopepper
ms.date: 05/09/2024
---

Expand Down
2 changes: 1 addition & 1 deletion docs/android/binding-libs/msbuild-reference/build-items.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Binding Projects MSBuild Items
description: This guide documents the various MSBuild items available for bindings projects.
ms.author: jopobst
ms.author: jopepper
ms.date: 05/08/2024
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Binding Projects MSBuild Properties
description: This guide documents the various MSBuild properties available for bindings projects.
ms.author: jopobst
ms.author: jopepper
ms.date: 05/08/2024
---

Expand Down
22 changes: 18 additions & 4 deletions docs/android/building-apps/build-items.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ The following MSBuild metadata are required:
- `%(JavaArtifact)`: The group and artifact id of the Java library matching the specifed POM
file in the form `{GroupId}:{ArtifactId}`.
- `%(JavaVersion)`: The version of the Java library matching the specified POM file.

See the [Java Dependency Resolution documentation](../features/maven/java-dependency-verification.md)
for more details.

Expand Down Expand Up @@ -279,9 +279,9 @@ installing app bundles.

## AndroidMavenLibrary

`<AndroidMavenLibrary>` allows a Maven artifact to be specified which will
automatically be downloaded and added to a .NET for Android binding project.
This can be useful to simplify maintenance of .NET for Android bindings for artifacts
`<AndroidMavenLibrary>` allows a Maven artifact to be specified which will
automatically be downloaded and added to a .NET for Android binding project.
This can be useful to simplify maintenance of .NET for Android bindings for artifacts
hosted in Maven.

```xml
Expand Down Expand Up @@ -336,6 +336,20 @@ used to specify the ABI that the library targets. Thus, if you add
</ItemGroup>
```

## AndroidNativeLibraryNoJniPreload

Every native library included in this item group will be exempt from the
JNI library preload mechanism. By default, all such libraries will be loaded
by the runtime early during application startup in order to assure their
proper initialization. However, in some cases it might not be the desired
behavior and this item group allows exclusion of libraries from this process
on an individual basis.

Some framework libraries which must be loaded at application startup will not
be affected if included in this item group.

See also [`$(AndroidIgnoreAllJniPreload)`](build-properties.md#androidignorealljnipreload)

## AndroidPackagingOptionsExclude

A set of file glob compatible items which will allow for items to be
Expand Down
Loading
Loading