xamarin-android-tools is a repo to easily share code between the xamarin-android repo and the Xamarin.Android commercial tooling, such as IDE extensions, without requiring that the IDE extensions submodule the entire xamarin-android repo, which is gigantic.
xamarin-android-tools requires Mono 4.8 or later and
make all target accepts the following optional
$(CONFIGURATION): The configuration to build. Possible values include
Release. The default value is
$(V): Controls build verbosity. When set to a non-zero value, The build is built with
To build xamarin-android-tools:
msbuild /restore Xamarin.Android.Tools.sln
Alternatively, first prepare the project:
This will perform
nuget restore and any other pre-build tasks
that need to be performed.
To run the unit tests:
dotnet test tests/Xamarin.Android.Tools.AndroidSdk-Tests/Xamarin.Android.Tools.AndroidSdk-Tests.csproj -l "console;verbosity=detailed"
There are two configurations,
Release, controlled by the
$(Configuration) MSBuild property or the
$(CONFIGURATION) make variable.
bin\$(Configuration) directory, e.g.
redistributable artifacts. The
bin\TestDebug, contains unit tests and related files.
bin\$(Configuration): redistributable build artifacts.
bin\Test$(Configuration): Unit tests and related files.
Package versioning follows Semantic Versioning 2.0.0.
The major version in the
nuget.version file should be updated when a breaking change is introduced.
The minor version should be updated when new functionality is added.
The patch version will be automatically determined by the number of commits since the last version change.
This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.
Xamarin.Android.Tools.AndroidSdk nupkg files are produced for every build which occurrs on Azure Devops.
To download one of these packages, navigate to the build you are interested in and click on the
Alternatively, "unofficial" releases are currently hosted on the Xamarin.Android feed.
Add the feed to your project's
NuGet.config to reference these packages:
<configuration> <packageSources> <add key="Xamarin.Android" value="https://pkgs.dev.azure.com/xamarin/public/_packaging/Xamarin.Android/nuget/v3/index.json" /> </packageSources> </configuration>
An Azure Pipelines Release can be manually triggered to push a new version to this feed.
To discuss this project, and participate in the design, we use the email@example.com mailing list.
We use Mono's Coding Guidelines.
We use GitHub to track issues.