Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update README.md #1004

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update README.md #1004

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
19 changes: 16 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@ Open Source Components for Xamarin are a collection of open source components (i
- [Data Caching & Databases](#data-caching--databases)
- [Create a Plugin for Xamarin](#create-a-plugin-for-xamarin)

>NOTE: If you are using the Fabric SDK via Xamarin Components to monitor crashes in your app, you must migrate off of Fabric by **November 15th 2020**. See [Migrating off of the Fabric SDK](#migrating-off-of-the-fabric-sdk-for-crash-reporting) for more information and guidance for alternatives.

## Building

### Prerequisites
Expand Down Expand Up @@ -93,17 +95,28 @@ Xamarin Supported Open Source components are a collection of Xamarin built bindi
| Name | Description | Source |
|---------------------------------------|----------------------------------------------------------------------------------|------------------------------------------------------------------|
| Android Support Libraries | Bindings for Google's Android Support Libraries | [GitHub](https://github.com/xamarin/AndroidSupportComponents) |
| Google Play Services Client Libraries | Bindings for Google's Play Services Client Libraries | [GitHub](https://github.com/xamarin/GooglePlayServicesComponents)|
| Google API's for iOS | Bindings for Google's API's for iOS Libraries | [GitHub](https://github.com/xamarin/GoogleAPIsForiOSComponents) |
| Google Play Services Client Libraries* | Bindings for Google's Play Services Client Libraries | [GitHub](https://github.com/xamarin/GooglePlayServicesComponents)|
| Google API's for iOS* | Bindings for Google's API's for iOS Libraries | [GitHub](https://github.com/xamarin/GoogleAPIsForiOSComponents) |
| Facebook SDK's | Bindings for Facebook's iOS & Android SDK's | [GitHub](https://github.com/xamarin/FacebookComponents) |
| Xamarin.Auth | Cross-platform API for authenticating users and storing their accounts. | [GitHub](https://github.com/xamarin/Xamarin.Auth) |

\* Xamarin will not be supporting the Firebase Crashlytics SDK. See [Migrating off of the Fabric SDK](#migrating-off-of-the-fabric-sdk-for-crash-reporting) for more information and guidance if you are using Fabric to report crashes in your app.

### Xamarin.Essentials

Xamarin.Essentials gives developers essential cross-platform APIs for their mobile applications. Xamarin.Essentials exposes over 60 native APIs in a single cross-platform package for developers to consume in their iOS, Android, UWP, or Xamarin.Forms application. Browse through the [documentation](https://docs.microsoft.com/xamarin/essentials) on how to get started today.

The repository for Xamarin.Essentials can be found at https://github.com/xamarin/Essentials. If you have any suggestions or feature requests, or if you find any issues, please open a new issue.

---

### Migrating off of the Fabric SDK for Crash Reporting

As of November 15 2020, Google [will not support the Fabric SDK for crash reporting](https://firebase.googleblog.com/2020/06/crashlytics-sdk-now-available.html) as they move customers to the Firebase Crashlytics SDK. The Xamarin team will **not** be updating Xamarin Components to bind to the Firebase Crashlytics SDK. We have outlined 2 courses of action you can take to update your app to continue getting crash reports in other ways. If you are currently using the Fabric SDK and do not update your app, you will stop receiving crash reports on 11/15/2020.

#### Option 1: Use Visual Studio App Center
App Center Crashes is a great tool to monitor crashes in your application using Visual Studio App Center's [Diagnostics SDK](https://docs.microsoft.com/appcenter/diagnostics/). All App Center Crashes and Analytics features are [free to use](https://docs.microsoft.com/appcenter/general/pricing). Follow the instructions [here](https://docs.microsoft.com/appcenter/sdk/crashes/xamarin) to collect crash reports in your app.

#### Option 2: Create Slim Bindings
We are working on documentation and a blog post to guide you through creating Slim Bindings of the Firebase Crashlytics SDK. Check back here for more information.

---