XamarinComponents/README.md

Open Source Components

These are a collection of open source components (including bindings and plugins) created by Xamarin and others in the community.

Status

Please note that this repository of bindings for third-party mobile libraries is considered unsupported and unmaintained. We have moved many of the most popular and essential bindings to other repositories.

Existing bindings published from this repository will not receive fixes or updates to newer versions.

For details of bindings officially supported by Microsoft, see the Support page.

Building

Prerequisites

Before building the libraries and samples in this repository, you will need to install .NET Core and the Cake .NET Core Tool:

dotnet tool install -g cake.tool

When building on macOS, you may also need to install CocoaPods:

# Homebrew
brew install cocoapods

# Ruby Gems
gem install cocoapods

Compiling

You can either build all the libraries and samples in the repository from the root:

dotnet cake --name=<name-from-manifest>

Or, you can build each component separately:

cd <path-to-component>
dotnet cake

The name of each component can be found in the manifest.yaml. For example, to build the ARCore component, you can either start the build from the root:

dotnet cake --name=ARCore --target=nuget

Or, you can navigate to the folder and run it from there:

cd Android/ARCore
dotnet cake --target=nuget

The following targets can be specified using the --target=<target-name>:

• libs builds the class library bindings (depends on externals)
• externals downloads and builds the external dependencies
• samples builds all of the samples (depends on libs)
• nuget builds the nuget packages (depends on libs)
• clean cleans up everything

Working in Visual Studio

Before the .sln files will compile in the IDEs, the external dependencies need to be downloaded. This can be done by running the externals target:

dotnet cake --target=externals

After the externals are downloaded and built, the .sln files should compile in your IDE.

---

Support & Getting Help

The following libraries are supported.

To get help, visit the .NET area of Microsoft Q&A.

---