更新记录

1.0.4（2026-05-12）

• 插件显示名称调整为 Apple 苹果授权登录，提升 Apple 相关搜索命中。
• 关键词补充 Apple授权登录，并保留苹果登录、苹果授权登录等中文关键词。

1.0.3（2026-05-12）

• 移除 iOS Apple 原始错误日志中的运行包 Bundle ID 诊断，避免在插件用户日志中暴露宿主应用包名。
• 文档中的具体 Bundle ID 示例改为通用占位示例。

1.0.2（2026-05-12）

• 修复 iOS 授权成功后可能因 UTS bridge 转换嵌套可选数据导致闪退的问题。
• iOS 原生成功回调改为只传递基础类型，姓名字段在 UTS 层组装。

平台兼容性

uni-app(4.76)

uni-app x(4.76)

zhuanz-apple-login

iOS 原生 Sign in with Apple 授权登录 UTS 插件，适用于 uni-app 和 uni-app x 的 App iOS 端。

功能

兼容性版本

接入前准备

1. 登录 Apple Developer，进入 Certificates, Identifiers & Profiles。
2. 选择当前应用的 App ID，启用 Sign in with Apple。
3. 重新生成并下载 Provisioning Profile。
4. 在 HBuilderX 中使用新的描述文件制作自定义基座或正式包。
5. 使用真机测试，标准基座无法完成 Apple 原生授权登录能力验证。

必须使用自定义基座或正式包运行。标准调试基座不会使用你的 Bundle ID、证书和描述文件，无法验证苹果授权登录。

插件已内置 utssdk/app-ios/UTS.entitlements：

<key>com.apple.developer.applesignin</key>
<array>
  <string>Default</string>
</array>

该配置需要自定义基座或正式包才会随原生工程生效，默认 uni-app x 调试基座不会使用你的 Bundle ID、证书和描述文件。

如果运行时报：

com.apple.AuthenticationServices.AuthorizationError error 1000

请按当前安装包的实际 Bundle ID 检查，例如 com.example.app：

1. Apple Developer 后台必须存在 App ID com.example.app。
2. 该 App ID 的 Sign in with Apple capability 必须已启用。
3. 启用后必须重新生成并下载匹配 com.example.app 的 Provisioning Profile。
4. HBuilderX 云打包、自定义基座或正式包必须选择新的描述文件，不能继续使用旧描述文件或标准调试基座。
5. 重新安装新包后再测试，旧包的签名 entitlement 不会自动变化。

iOS 签名 entitlement 需要通过 Apple Developer 后台和描述文件确认；当前 HBuilderX 5.07 的 UTS Swift 编译环境不支持直接调用 SecTaskCopyValueForEntitlement 做运行时读取。

使用示例

import { getZAppleLogin } from '@/uni_modules/zhuanz-apple-login'

const apple = getZAppleLogin()

apple.signIn({
  state: 'YOUR_RANDOM_STATE',
  success: (res) => {
    console.log(res.user)
    console.log(res.identityToken)
    console.log(res.authorizationCode)
  },
  fail: (err) => {
    console.log(err.errCode, err.errMsg)
  },
  complete: null
})

建议仅在 iOS 端引入和调用：

// #ifdef APP-IOS
import { getZAppleLogin } from '@/uni_modules/zhuanz-apple-login'
// #endif

Demo 调用说明

示例工程入口位于 pages/index/index.uvue，核心调用流程如下：

import * as appleLogin from '@/uni_modules/zhuanz-apple-login'

let appleSDK : appleLogin.ZAppleLogin | null = null

onLoad((_options : OnLoadOptions) => {
  appleSDK = appleLogin.getZAppleLogin()
})

function loginWithApple() : void {
  const sdk = appleSDK ?? appleLogin.getZAppleLogin()
  appleSDK = sdk

  sdk.signIn({
    state: 'zhuanz-apple-login-demo',
    success: (result : appleLogin.ZAppleLoginSuccess) => {
      console.log('[zhuanz-apple-login][demo] Apple login success')
      console.log('[zhuanz-apple-login][demo] user:', result.user)
      console.log('[zhuanz-apple-login][demo] authorizationCodeLength:', result.authorizationCode.length)
      console.log('[zhuanz-apple-login][demo] identityTokenLength:', result.identityToken.length)

      uni.showToast({
        title: '登录成功',
        icon: 'success'
      })
    },
    fail: (error : appleLogin.ZAppleLoginFail) => {
      if (error.errCode == 107) {
        return
      }

      uni.showToast({
        title: error.errMsg != null && error.errMsg != '' ? error.errMsg : 'Apple 登录失败',
        icon: 'none'
      })
    },
    complete: null
  } as appleLogin.ZAppleLoginOptions)
}

Demo 页面点击“使用 Apple 登录”后会调用 loginWithApple()。登录成功后，页面会展示 user、state、授权范围、authorizationCodeLength、identityTokenLength、email、realUserStatus、fullName 等信息。出于安全考虑，Demo 控制台只打印 identityToken 和 authorizationCode 的长度，不直接打印完整凭证。

API

getZAppleLogin()

返回 Apple 登录实例。

signIn(options)

返回字段

错误码

Apple 原始错误

当插件错误码为 999 时，可查看 cause.code 中的 Apple 原始错误码。

错误处理示例：

fail: (error) => {
  if (error.errCode == 107) {
    return
  }

  const cause = error.cause as any
  const appleCode = cause != null && cause.code != null ? parseInt(cause.code.toString()) : 0
  if (error.errCode == 999 && appleCode == 1001) {
    return
  }

  uni.showToast({
    title: error.errMsg || 'Apple 登录失败',
    icon: 'none'
  })
}

注意事项

• 若原始错误为 com.apple.AuthenticationServices.AuthorizationError error 1000，优先检查 Apple Developer 是否启用 Sign in with Apple、描述文件是否重新生成、当前是否使用自定义基座或正式包运行。
• Apple 只在首次授权时返回邮箱和姓名，后续登录通常不会再次返回。
• 如需重新获取邮箱和姓名，需要用户在系统设置中取消该 App 的 Apple ID 授权后重新登录。
• identityToken 和 authorizationCode 应提交服务端校验，客户端不要直接信任登录结果。
• 服务端校验 identityToken 时应检查签名、过期时间、issuer、aud 和 nonce/state 等业务约束。
• Android 如需 Apple 登录，应使用网页 OAuth 与服务端回调方案，不属于此 iOS 原生插件能力。