efa8c413d6
So if we have a case like: 26.0.0-alpha1, it would create an ItemID like `supportv4-26.0.0-alpha1` which is not allowed. Instead we’ll replace the verison’s - with _ to create `supportv4-26.0.0_alpha1` |
||
---|---|---|
.github | ||
animated-vector-drawable | ||
component | ||
constraint-layout | ||
constraint-layout-solver | ||
customtabs | ||
design | ||
dynamic-animation | ||
exifinterface | ||
icons | ||
instantvideo | ||
percent | ||
recommendation | ||
support-annotations | ||
support-compat | ||
support-core-ui | ||
support-core-utils | ||
support-fragment | ||
support-media-compat | ||
support-tv-provider | ||
tests | ||
transition | ||
util | ||
v4 | ||
v7-appcompat | ||
v7-cardview | ||
v7-gridlayout | ||
v7-mediarouter | ||
v7-palette | ||
v7-preference | ||
v7-recyclerview | ||
v8-renderscript | ||
v13 | ||
v14-preference | ||
v17-leanback | ||
v17-preference-leanback | ||
vector-drawable | ||
wearable | ||
.gitignore | ||
AndroidSupport.TypeForwarders.sln | ||
AndroidSupport.sln | ||
LICENSE.md | ||
Metadata.generated.xml | ||
README.md | ||
THIRD-PARTY-NOTICES | ||
build.cake | ||
build.ps1 | ||
build.sh | ||
cake.packages.config | ||
template.targets |
README.md
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 onexternals
)externals
downloads the external dependenciessamples
builds all of the samples (depends onlibs
)nuget
builds the nuget packages (depends onlibs
)component
builds the xamarin components (depends onsamples
andnuget
)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