/AndroidSupportComponents

Primary LanguageC#MIT LicenseMIT

Xamarin Component for Android Support Library

Xamarin creates and maintains Xamarin.Android bindings for the Google Android Support Libraries, including:

  • Design
  • Animated Vector Drawable
  • Vector Drawable
  • Custom Tabs
  • Recommendation
  • Support v4
  • Support v13
  • Support v7 AppCompat
  • Support v7 CardView
  • Support v7 GridLayout
  • Support v7 MediaRouter
  • Support v7 Palette
  • Support v7 Preference
  • Support v7 RecyclerView
  • Support v8 RenderScript
  • Support v14 Preference
  • Support v17 Leanback
  • Support v17 Preference Leanback

Building

Prerequisites

  • Mac OSX 10.11 or higher / Windows 10 or higher (experimental support only)
  • Xamarin.Android 6.0 or higher
  • Mono 4.3 or higher
  • Java JDK 1.7 or higher
  • Android SDK with API Levels 15, 16, 17, 18, 21, 23

Build Scripts

The build script for this project uses Cake. To run the build, you can use one of the bootstrapper files either for Mac or Windows:

Mac:

sh build.sh --target libs

Windows (experimental support only):

NOTE: Windows build support is still experimental. You may need to first build the externals target, then open the AndroidSupport.sln in Visual Studio, rebuild it, build the clean target, and then continue on normally building whichever targets you like. This will ensure the appropriate files are downloaded and cached in your user's AppData folder.

powershell .\build.ps1 -Target libs

The bootstrapper script will automatically download Cake.exe and all the required tools and files into the ./tools/ folder.

The following targets can be specified:

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

NOTE: The externals build task may take awhile to run as it downloads several large dependencies.

You may want to consider passing --verbosity diagnostic (or -Verbosity diagnostic on Windows) to the bootstrapper to enable more verbose output, including downloading progress.

Working in Visual Studio / Xamarin Studio

Before the .sln files will compile in Visual Studio or Xamarin Studio, the external dependencies need to be downloaded. This can be done by running the build.sh or build.ps1 with the target externals. After the externals are setup, the .sln files should compile in an IDE.

License

The license for this repository is specified in LICENSE.md

The externals build task downloads some external dependencies from Google which are licensed under and subject to the terms of Android Software Development Kit License Agreement

Contribution Guidelines

The Contribution Guidelines for this repository are listed in CONTRIBUTING.md

.NET Foundation

This project is part of the .NET Foundation