更新记录

1.0.3（2026-11-13）

• 初始化增加 features，可关掉登录、分享或手动事件。关掉后再调返回 95112
• iOS 初始化补了 initializeSDK。事件结果增加 attStatus
• Info.plist 增加 Facebook 的 SKAdNetwork ID

平台兼容性

uni-app(4.27)

uni-app x(4.27)

fz-facebook

1.0.3

登录、分享、App Events。仅 App。不展示广告。广告 ID 和自动事件默认关。

Android com.facebook.android:facebook-login:18.3.0。iOS FBSDKCoreKit / FBSDKLoginKit / FBSDKShareKit 18.0.3。

拷到 uni_modules 后打自定义基座。改 App ID、scheme 或原生代码要重打。不要写 App Secret。

环境

配置

页面里的 App ID 要和下面两处相同。还是 YOUR_APP_ID 时初始化失败。

utssdk/app-android/res/values/strings.xml

utssdk/app-ios/Info.plist

Android 包名 com.example.fzunitestapp，主 Activity io.dcloud.PandoraEntry。Bundle ID、包名、Key Hash 填到 Meta 后台。

keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore -storepass android | openssl sha1 -binary | openssl base64

自定义基座换了签名，用那把证书再算一次。

用法

import {
  initFacebook,
  loginFacebook,
  logFacebookEvent,
  logFacebookPurchase,
  shareFacebook,
  setFacebookAdvertiserTracking
} from '@/uni_modules/fz-facebook'

await initFacebook({
  appId: '123456789012345',
  clientToken: '客户端 token',
  displayName: 'fz-uni-test-app',
  features: { login: true, share: false, appEvents: true },
  autoLogAppEvents: false,
  advertiserIdCollection: false
})

const session = await loginFacebook({ permissions: 'public_profile,email' })

await logFacebookEvent({
  name: 'fb_mobile_complete_registration',
  valueToSum: null,
  paramsJson: '{"fb_registration_method":"facebook"}'
})

await logFacebookPurchase({
  amount: '9.99',
  currency: 'USD',
  paramsJson: '{"fb_content_id":"sku_demo"}'
})

await shareFacebook({
  contentType: 'link',
  url: 'https://developers.facebook.com',
  quote: '',
  hashtag: '',
  imagePath: null,
  mode: 'automatic'
})

await setFacebookAdvertiserTracking(true)

示例页 pages/facebook/facebook。各方法的参数在 utssdk/index.d.ts。

标准事件：fb_mobile_complete_registration、fb_mobile_content_view、fb_mobile_add_to_cart、fb_mobile_add_to_wishlist、fb_mobile_initiated_checkout、fb_mobile_search。购买用 logFacebookPurchase。

错误码

失败 reject，errSubject 为 fz-facebook。

自定义基座 + 真机。登录能回到 App，说明 scheme、包名、Key Hash 是对的。事件到 Events Manager 里看。