更新记录

1.1.0（2026-07-08）

• 新增 iOS 原生 Facebook Login SDK 登录实现，使用 FBSDKCoreKit 与 FBSDKLoginKit。
• 新增 iOS Pod 依赖配置和 Info.plist 占位模板，宿主 App 需要替换 FacebookAppID、FacebookClientToken、FacebookDisplayName 和 fb{AppID} URL Scheme。
• 新增 iOS URL 回调 Hook，用于处理 Facebook SDK 授权完成后的 App 回跳。
• 更新平台支持标记，App-Android 与 App-iOS 均支持原生登录。

1.0.1（2026-07-08）

• 完善接入文档，明确需要准备 Facebook App ID、Facebook Client Token、Android 包名、Class Name、Key Hash、fb{AppID} 回调 Scheme 和 permissions。
• 补充原生登录完整流程说明：App 调用 Facebook SDK、获取 accessToken/userID、提交服务端校验并换取业务登录态。
• 补充 H5 OAuth 回调页模板说明，明确该页面只用于 HTTPS OAuth 中转场景，不替代 Facebook Android SDK 的 fb{AppID} 回调 Scheme。
• 调整 demo 说明，测试参数仅允许写在示例页面中；插件包内 AndroidManifest 保持 fb0000000000000000 占位值，上传插件前不要写入业务 App ID 或密钥。

1.0.0（2026-07-06）

• 新增 Android Facebook Login SDK 授权登录。
• 返回 accessToken 与 userID，便于宿主 App 提交到业务服务端校验。
• 新增 demo 页面、接入说明和登录流程文档。

平台兼容性

uni-app(4.76)

uni-app x(4.76)

facebook-login

facebook-login 是一个 uni-app x UTS 插件，用于在 Android / iOS App 中调用 Facebook Login SDK 获取授权结果。

平台支持

安装

将插件目录放入项目：

uni_modules/facebook-login

Android 必配项

1. 到 Meta for Developers 创建应用，开启 Facebook Login。
2. 在 Facebook 后台配置 Android 包名、Class Name、Key Hash。
3. 修改插件内 AndroidManifest 的回调 scheme：

<data android:scheme="fb你的FacebookAppID" />

例如 Facebook App ID 是 123456789012345，则 scheme 是 fb123456789012345。

Facebook 原生 SDK 登录不需要在 App 里配置 App Secret，也不要把 App Secret、服务端密钥写进插件或 demo。

iOS 必配项

1. 到 Meta for Developers 创建应用，开启 Facebook Login。
2. 在 Facebook 后台配置 iOS Bundle ID。
3. 修改插件内 iOS Info.plist 占位值：

uni_modules/facebook-login/utssdk/app-ios/Info.plist

需要替换：

iOS 也需要回调 Scheme 严格等于 fb{Facebook App ID}。如果 URL Scheme 配错，授权完成后不能正常回到 App。

接入前需要提供的参数

最容易出错的是回调 Scheme。它必须严格等于 fb{Facebook App ID}，例如 App ID 为 123456789012345 时填写 fb123456789012345。如果 scheme、包名或 Key Hash 不一致，授权页可能能打开，但结果不会正常回到 App。

原生登录流程

1. 宿主 App 在 Meta 后台配置平台信息：Android 配包名、Class Name、Key Hash；iOS 配 Bundle ID。
2. 宿主 App 配置 fb{Facebook App ID} 回调 Scheme：Android 修改插件 AndroidManifest；iOS 修改插件 Info.plist。
3. 页面调用 getFacebookLogin().login({ appId, clientToken, permissions })。
4. 插件初始化 Facebook SDK，并调用 Facebook Login SDK 打开授权页。
5. 用户授权成功后，Facebook SDK 通过 fb{AppID} scheme 把结果返回 App。
6. 插件返回 accessToken 和 userID。
7. 业务侧把 accessToken 提交到自己的服务端。
8. 服务端调用 Facebook Graph API 校验 token、获取用户信息，并换取业务系统自己的登录态。

客户端只负责拿 Facebook 授权结果，不建议在客户端直接完成业务登录信任闭环。

H5 OAuth 回调页

插件内带有从源 App 回调页移植并去品牌化后的模板：

static/h5/oauth-callback.html

demo 根目录也放了一份：

static/h5/oauth-callback.html

这个页面用于 HTTPS Redirect URI -> App Scheme 的场景，例如网页 OAuth 回调后再打开 App。它是可选模板，主要用于你额外做 Web OAuth 或需要 HTTPS 中转页的场景；普通 Android / iOS 原生 Facebook SDK 登录只需要配置 fb{AppID}。

部署前需要替换：

注意：H5 回调页不替代 Facebook 原生 SDK 的 fb{FacebookAppID} 回调 scheme。原生 Facebook Login SDK 仍必须按上文配置 fb{AppID}。

调用示例

import { getFacebookLogin, FacebookLoginSuccess, FacebookLoginFail } from '@/uni_modules/facebook-login'

getFacebookLogin().login({
  appId: '你的 Facebook App ID',
  clientToken: '你的 Facebook Client Token',
  permissions: ['public_profile', 'email'],
  success: (result: FacebookLoginSuccess) => {
    console.log('accessToken=' + result.accessToken)
    console.log('userID=' + result.userID)
    // 建议把 accessToken 提交给业务服务端校验并换取自己的登录态。
  },
  fail: (error: FacebookLoginFail) => {
    console.log(error.errCode.toString() + ':' + error.errMsg)
  },
  complete: null
})

API

getFacebookLogin().login(options)

getFacebookLogin().logout()

清理 Facebook SDK 当前登录态。

返回结果

type FacebookLoginSuccess = {
  accessToken: string,
  userID: string | null
}

错误码