ad22d9dea6
* Initial work for WebAuthenticator API * Fix page loaded in sample * Fix weird generated item * Fix error message * Fix filename, too many .'s * Remove unnecessary comment * Tweak AppleSignIn API * Cancel any previous waiting tasks * Use WebAuthenticationBroker on UWP * Make code more readable * iOS10+ is only supported so remove check * Move last fallback into TVOS * Remove unnecessary duplicate attribute * Change exception type. * Better error message * Make AppleSignIn accessible from shared code * Added sample aspnet project for auth * Apple Signin for iOS only for now * Make auth sample use sample server * Added some tests * Make some methods private that shouldn't be public * Add docs * Increase device test timeout * Add human interaction traits to some new tests * Update devicetests cake Updated to newer addins Stop using cake bootstrappers * Run device tests with cake dotnet core * Bump xunit device runner * Tests go back to netcore 2 * Bump xunit device runner in rest of devicetest projs * Build that android app first! * Cleanup web auth - Change result type name - Clean up result type properties - Remove IsSupported from apple public api - Throw not supported in public apple api on < iOS 13 * Update sample to check for iOS 13 independently * Update docs * Make code a bit more readable. * More readable code changes * Fix test * Add some detection of callback activity This adds some code to ensure the developer has subclassed `WebAuthenticatorCallbackActivity` and registered an appropriate intentfilter for it based on the `callbackUrl` being used. Co-authored-by: James Montemagno <james.montemagno@gmail.com> |
||
|---|---|---|
| .github | ||
| Assets | ||
| DeviceTests | ||
| Samples | ||
| Tests | ||
| Xamarin.Essentials | ||
| docs | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .openpublishing.build.ps1 | ||
| .openpublishing.publish.config.json | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| Directory.Build.props | ||
| LICENSE | ||
| LICENSE-CODE | ||
| PRODUCT-FEEDBACK.md | ||
| README.md | ||
| SUBMITTING-ISSUES.md | ||
| ThirdPartyNotices | ||
| Xamarin.Essentials.ruleset | ||
| Xamarin.Essentials.sln | ||
| appcenter-post-clone.sh | ||
| azure-pipelines.yml | ||
| build.ps1 | ||
| generate-docs.cmd | ||
| nuget.config | ||
| nugetreadme.txt | ||
| stylecop.json | ||
README.md
Xamarin.Essentials
Xamarin.Essentials gives developers essential cross-platform APIs for their mobile applications.
iOS, Android, and UWP offer unique operating system and platform APIs that developers have access to, all in C# leveraging Xamarin. It is great that developers have 100% API access in C# with Xamarin, but these APIs are different per platform. This means developers have to learn three different APIs to access platform-specific features. With Xamarin.Essentials, developers have a single cross-platform API that works with any iOS, Android, or UWP application that can be accessed from shared code no matter how the user interface is created.
Build Status
| Build Server | Type | Platform | Status |
|---|---|---|---|
| VSTS | Build | Windows | |
| App Center | Sample App | Android | |
| App Center | Sample App | iOS |
Sample App
Try out Xamarin.Essentials on your device!
- Android Sample App via App Center.
Installation
Xamarin.Essentials is available via NuGet & is included in every template:
- NuGet Official Releases:
Please read our Getting Started with Xamarin.Essentials guide for full setup instructions.
Documentation
Browse our full documentation for Xamarin.Essentials, including feature guides, on how to use each feature.
Supported Platforms
Platform support & feature support can be found on our documentation
Contributing
Please read through our Contribution Guide. We are not accepting new PRs for full features, however any issue that is marked as up for grabs are open for community contributions. We encourage creating new issues for bugs found during usage that the team will triage. Additionally, we are open for code refactoring suggestions in PRs.
Building Xamarin.Essentials
Xamarin.Essentials is built with the new SDK-style projects with multi-targeting enabled. This means that all code for iOS, Android, and UWP exist inside of the Xamarin.Essentials project.
Visual Studio
A minimum version of Visual Studio 2019 16.3 or Visual Studio for Mac 2019 8.3 are required to build and compile Xamarin.Essentials.
Workloads need:
- Xamarin
- .NET Core
- UWP
You will need the following SDKs
- Android 10.0, 9.0, 8.1, 8.0, 7.1, 7.0, & 6.0 SDK Installed
- UWP 10.0.16299 SDK Installed
FAQ
Here are some frequently asked questions about Xamarin.Essentials, but be sure to read our full FAQ on our Wiki.
License
Please see the License.