跳转到正文

Android 端 Apple 登录

GitHub

在 Android 上实现 Apple 登录比较 hacky。Apple 没有官方支持 Sign in with Apple 在 Android 上,所以这个方案略显 hacky。

Android 目前使用 Chrome 标签页显示 OAuth2 网站。这种方式有以下挑战:

  • 配置困难
  • 需要后端

了解 Android 端的工作流程。

章节标题为“理解 Android 上的流程”

让我用一张图来说明 Android 上的流程:

既然你已经了解了挑战和流程,那就开始配置吧。

  1. 登录 Apple 开发者门户.

  2. 点击 Identifiers.

    Apple Developer Portal 的 Identifiers 部分

    您应该看到如下界面:

    Apple Developer Portal Identifiers 界面
    1. 确保该字段显示为 App IDs
    2. 请确认您能找到您的 App ID。
  3. 请确保 Sign in with Apple 你的应用已启用该 capability

    1. 点击你的应用 从列表中选择你的应用
    2. 确保 Sign in with Apple capability 已启用 Sign in with Apple capability enabled 复选框
    3. 如果未启用,请启用它。
  4. 返回全部 All Identifiers

    所有标识符导航按钮
  5. 点击 App Ids 并前往 Services IDs

    导航到 Services IDs 部分
  6. 创建新的标识符

    1. 点击加号按钮

      添加新 Service ID 按钮
    2. 选择 Servcice IDs 并点击 Continue

      选择 Services IDs 选项
    3. 输入描述和标识符并点击 Continuie.

      输入 Service ID 详情
    4. 请确认详细信息并点击 Register

      确认 Service ID 注册
    5. 点击新创建的 Service

      选择新创建的 Service ID
    6. 启用 Sign in with Apple 选项

      为 Service ID 启用 Sign in with Apple
    7. 配置 Sign In with Apple

      配置 Sign in with Apple 按钮
    8. 确保 Primary App ID 已设置为上一步配置的 App ID

      设置 Primary App ID 下拉框
    9. 添加用于托管后端的域名。

      设置域名与回调 URL 字段
    10. 确认信息并点击 Done

      正在确认域名与回调 URL 配置
    11. 点击 Continue

      服务配置的“继续”按钮
    12. 点击 Save

      服务配置的“保存”按钮

正在创建密钥

“创建密钥”章节
  1. 返回全部 All Identifiers

    所有标识符导航按钮
  2. 点击 Keys

    Apple Developer Portal 中的 Keys 部分
  3. 点击加号图标

    添加新密钥按钮
  4. 为您的密钥命名

    输入密钥名称
  5. 选择 Sign in with Apple 并点击 Configure

    为该密钥启用并配置 Sign in with Apple
  6. 选择主 App ID,然后按 Save

    为该密钥选择主 App ID
  7. 点击 Continue

    继续配置密钥
  8. 点击 Register

    注册以创建密钥
  9. 复制密钥 ID 并下载密钥。

    密钥 ID 和下载按钮界面
  10. 找到下载的密钥,并将其保存在后端文件夹中。

    已下载的密钥文件

为了使用 Login with Apple 在 Android 上,你需要获取 Team ID。它将用于后端。

  1. 前往 此网站 并向下滚动

  2. 找到 Team ID

    开发者账号中的 Team ID 位置

正如你在图中看到的,后端会执行一个名为 Redirect back to the app的步骤。这需要手动修改你的应用。

  1. 修改 AndroidManifest.xml
    1. 打开该文件,我将使用 AndroidStudio

      Android Studio 中的 AndroidManifest.xml 文件
    2. 找到 MainActivity 并添加以下 Intent filter

      在 MainActivity 中添加 Intent filter code
      <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="capgo-demo-app" android:host="path" />
      </intent-filter>
  2. 修改 MainActivity
    1. 请打开 MainActivity

      Android Studio 中的 MainActivity.java 文件
    2. 添加以下 code:

      添加到 MainActivity 以处理深度链接的 Code
      @Override
      protected void onNewIntent(Intent intent) {
      String action = intent.getAction();
      Uri data = intent.getData();
      if (Intent.ACTION_VIEW.equals(action) && data != null) {
      PluginHandle pluginHandle = getBridge().getPlugin("SocialLogin");
      if (pluginHandle == null) {
      Log.i("Apple Login Intent", "SocialLogin login handle is null");
      return;
      }
      Plugin plugin = pluginHandle.getInstance();
      if (!(plugin instanceof SocialLoginPlugin)) {
      Log.i("Apple Login Intent", "SocialLogin plugin instance is not SocialLoginPlugin");
      return;
      }
      ((SocialLoginPlugin) plugin).handleAppleLoginIntent(intent);
      return;
      }
      super.onNewIntent(intent);
      }

Android 需要后端,但配置后端也会影响 iOS。提供了一个示例后端 这里

此示例提供以下内容:

  • 一个简单的 JSON 数据库
  • 一种从 Apple 服务器请求 JWT 的方式
  • 简单的 JWT 验证

鉴于我在本教程中讲的所有内容,以下是 env 部分的样子:

  • ANDROID_SERVICE_ID = 服务 ID
  • IOS_SERVICE_ID = App ID
env: {
PRIVATE_KEY_FILE: "AuthKey_U93M8LBQK3.p8",
KEY_ID: "U93M8LBQK3",
TEAM_ID: "UVTJ336J2D",
ANDROID_SERVICE_ID: "ee.forgr.io.ionic.starter.service2",
IOS_SERVICE_ID: "me.wcaleniewolny.test.ionic.vue",
PORT: 3000,
REDIRECT_URI: "https://xyz.wcaleniewolny.me/login/callback",
BASE_REDIRECT_URL: "capgo-demo-app://path"
}

……的用法 login 函数的使用方式保持不变,与 iOS 一致。详情请参阅该章节。 但是, initialize 方法会稍有变化。

await SocialLogin.initialize({
apple: {
clientId: 'ee.forgr.io.ionic.starter.service2',
redirectUrl: 'https://appleloginvps.wcaleniewolny.me/login/callback'
}
})
  1. 如果你还没有 App ID,请点击加号按钮

    添加新标识符的加号按钮
  2. 选择 App IDs 然后点击继续

    选择 App IDs 类型
  3. 点击类型 App 并点击 Continue

    选择 App 类型
  4. 输入描述和 App ID

    填写 App 描述和 Bundle ID
  5. 启用 Sign with Apple 功能

    启用 Sign in with Apple 功能
  6. 点击 Continue

    App 注册的“继续”按钮
  7. 确认信息并点击 Register

    正在确认 App 注册信息

如果你正在使用 Android 端 Apple 登录 用来规划身份验证和账户流程,并将它与 使用 @capgo/capacitor-social-login 关于使用 @capgo/capacitor-social-login 的原生能力, @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节, @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节, @capgo/capacitor-native-biometric 以及 @capgo/capacitor-native-biometric 中的实现细节, 双因素认证 有关双重身份验证的实现细节。