SkiaSharp/README.md

97 строки
3.6 KiB
Markdown

# SkiaSharp
[![Gitter.im](https://img.shields.io/badge/gitter.im-xamarin%2FXamarinComponents-E60256.svg)](https://gitter.im/xamarin/XamarinComponents) [![NuGet](https://img.shields.io/nuget/v/SkiaSharp.svg?maxAge=2592000)](https://www.nuget.org/packages/SkiaSharp) [![NuGet Pre Release](https://img.shields.io/nuget/vpre/SkiaSharp.svg?maxAge=2592000)](https://www.nuget.org/packages/SkiaSharp)
SkiaSharp is a cross-platform 2D graphics API for .NET platforms based on Google's
Skia Graphics Library (https://skia.org/). It provides a comprehensive 2D API that can
be used across mobile, server and desktop models to render images.
## What is Included
SkiaSharp provides a PCL and platform-specific bindings for:
- Mac (Console or using the Xamarin.Mac)
- Xamarin.Android
- Xamarin.iOS
- Xamarin.tvOS
- Xamarin.Mac
- Windows Desktop
- Windows UWP
You can also build this on your particular variant of Unix
to create your native libraries.
## Using SkiaSharp
Check our getting [started guide](https://developer.xamarin.com/guides/cross-platform/drawing/)
# Extensions for SkiaSharp
Windows/WPF users might find the [SkiaSharpWPFExtensions](https://github.com/impsnldavid/skiasharpwpfextensions) useful.
## Building SkiaSharp
First clone the repository:
$ git clone https://github.com/mono/SkiaSharp.git
Next, set up the submodules:
$ cd SkiaSharp
$ git submodule init && git submodule update
Then follow the platform-specific instructions below.
### Mac OS X
Run from Bash
$ ./bootstrapper.sh -t libs
This runs the build process by using the `libs` build target.
### Windows
You need Python 2.7 in `PATH` environment variable. Then you can build it:
> .\bootstrapper.ps1 -Target libs
This runs the build process by using the `libs` build target.
### Build Targets
There are several targets available, you can specify the target as the argument to the `-t` command line
option in the bootstrapper script.
- `Everything` - builds everything for the current platform
- `externals` - builds all the native libraries
- [win] `externals-windows` - builds the native libraries for Windows
- [win] `externals-uwp` - builds the native libraries for Windows UWP
- [mac] `externals-osx` - builds the native libraries for Mac OS X
- [mac] `externals-ios` - builds the native libraries for iOS
- [mac] `externals-tvos` - builds the native libraries for tvOS
- [mac] `externals-andoid` - builds the native libraries for Android
- `libs` - builds all the managed libraries
- [win] `libs-windows` - builds the managed libraries that can be built on Windows
- [mac] `libs-osx` - builds the managed libraries that can be built on Mac OS X
- `tests` - builds and runs the tests
- `samples` - builds the samples available for the current platform
- `docs` - updates the mdoc files
- `nuget` - packages the libraries into a NuGet
- `clean` - cleans everything
- `clean-externals` - cleans externals only
- `clean-managed` - cleans managed libraries/samples only
## Compare Code
Here are some links to show the differences in our code as compared to Google's.
What version are we on? [**m53**](https://github.com/google/skia/tree/chrome/m53)
Are we up-to-date with Google? [Compare](https://github.com/mono/skia/compare/xamarin-mobile-bindings...google:chrome/m53)
What have we added? [Compare](https://github.com/google/skia/compare/chrome/m53...mono:xamarin-mobile-bindings)
## Where is Windows Phone 8 / Store 8
We are working to add binaries for these platforms, stay tuned for a future release
(or check the pull requests and branches, where we are working on those)