更新记录

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 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。

调用示例

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
}

错误码