Xamarin.Auth 技术文档

1. 安装指南

Xamarin.Auth 的安装过程依赖于平台，以下为MacOSX和Windows平台的安装命令。

对于 MacOSX 平台：

sh ./build.sh --target=clean && sh ./build.sh --target=libs && sh ./build.sh --target=nuget

对于 Windows 平台：

# Windows 平台的安装命令未在文档中给出，请参考相应的开发文档或社区支持。

2. 项目的使用说明

Xamarin.Auth 是一个跨平台库，用于帮助开发者通过标准的认证机制（如 OAuth 1.0 和 2.0）对用户进行认证并存储用户凭据。该库也便于添加对非标准认证方案的支持。

在使用前，您需要通过OAuth服务提供商（如Google、Facebook）完成服务器端设置。接着，在客户端初始化 Authenticator 对象，设置相关的 OAuth 数据。

3. 项目API使用文档

Xamarin.Auth 提供了以下两种构造函数，分别用于 OAuth2 Implicit Grant flow 和 OAuth2 Authorization Code Grant flow 的初始化：

• OAuth2 Implicit Grant flow

  参数包括：clientId、scope、authorizeUrl、redirectUrl

• OAuth2 Authorization Code Grant flow

  参数包括：clientId、clientSecret、scope、authorizeUrl、redirectUrl、accessTokenUrl

下面是一个使用 OAuth2 Implicit Grant flow 认证 Facebook 的示例：

using Xamarin.Auth;
// ...
OAuth2Authenticator auth = new OAuth2Authenticator
    (
        clientId: "App ID from https://developers.facebook.com/apps",
        scope: "",
        authorizeUrl: new Uri ("https://m.facebook.com/dialog/oauth/"),
        redirectUrl: new Uri ("http://www.facebook.com/connect/login_success.html"),
        // 是否使用新的 Native UI API
        // true = Android Custom Tabs 和/或 iOS Safari View Controller
        // false = 使用嵌入式浏览器（Android WebView, iOS UIWebView）
        // 默认 = false（不使用新的 Native UI）
        isUsingNativeUI: false
    );

4. 项目安装方式

项目可以通过以下方式安装：

• 通过 NuGet 包管理器安装。在 NuGet 包管理器中搜索 Xamarin.Auth 并安装。
• 通过 GitHub 仓库克隆项目代码到本地，然后按照上面的构建命令进行构建。

请注意，Xamarin.Auth 已经支持了多个平台，包括 Xamarin.Android、Xamarin.iOS、Windows Phone Silverlight 8、Windows Store 8.1 WinRT、Windows Phone 8.1 WinRT 以及 Universal Windows Platform (UWP)。一旦您学会了在某个平台上使用它，迁移到其他平台将会非常简单。

以上就是关于 Xamarin.Auth 的技术文档，希望对您使用该库有所帮助。如果您有任何问题或需要进一步的帮助，请参考文档中提供的社区支持渠道。