更新记录

1.0.0（2026-11-02）

• 新增 iOS 原生 Sign in with Apple 授权、凭证状态查询、撤销通知订阅及精确释放。
• 新增 state 匹配、nonce 透传、并发保护、单次终态与取消/超时处理，区分本地等待和系统窗口生命周期。
• 新增 uni-app Vue2/Vue3 与 uni-app x 分类标签示例、脱敏诊断、完整报告和固定快照分段复制。
• 新增原生 entitlement、源码构建身份、双项目同步与分层验证脚本；本候选源码仍需 Apple 编译及 iPhone 业务验收。
• 修复 iOS 对非空原生错误码字符串强制解包导致的编译错误。
• 修复 iOS 诊断日期、日志长度、请求编号和可空原生状态的类型转换。
• 修复 iOS 回执解析对类型信封布尔解码的依赖，改用基础字段读取并校验请求、成功标志与错误码的一致性；新原生包仍需真机复验。
• 修复诊断脱敏对 credentialState、nativeState 等非敏感状态字段的误匹配。

平台兼容性

uni-app(5.33)

uni-app x(5.33)

lizhao-apple-login 苹果授权登录与凭证状态

介绍

为 uni-app（Vue2/Vue3）和 uni-app x 提供 iOS 原生 Sign in with Apple 授权、凭证状态与撤销通知的 UTS 插件。当前交付为候选源码，本轮 iOS 回执解析修正后仍需匹配新源码的 Apple 编译、签名与 iPhone 回归，平台声明中的 - 表示待验证。

功能特色

适合哪些场景

插件不负责账号数据库、会话签发、账户注销或部署后端。

下载与导入

从基础到进阶：按业务模块使用

接入准备

目前按源码导入，将完整 uni_modules/lizhao-apple-login/ 放入工程，不拆出内部文件。没有已发布市场链接。

从插件根导入：

import { signInWithApple, getAppleLoginCapabilitiesSync } from '@/uni_modules/lizhao-apple-login'

将对应示例去掉扩展名后注册到项目 pages.json。两种示例均保留真实插件调用、操作日志、完整报告和复制回退，页面语法与滚动容器按宿主分别维护。

接入前完成以下配置：

1. 使用当前应用真实 Bundle ID，在 Apple Developer 后台为 App ID 启用 Sign in with Apple，更新匹配的描述文件。
2. 保留 uni_modules/lizhao-apple-login/utssdk/app-ios/config.json 和 uni_modules/lizhao-apple-login/utssdk/app-ios/UTS.entitlements；构建时合并 Apple entitlement，不能代替后台配置。
3. 使用匹配本次源码、Bundle ID、签名和描述文件的 iOS 自定义基座或正式包。标准基座不能验证客户应用的签名能力；WGT 不能更新已编译的原生插件。
4. 原生目标 iOS 13+，实际运行下限还取宿主/编译器的更高要求。本轮资源验证使用 HBuilderX 5.34 工具链，其他版本需重新核对。

示例标签与测试范围

示例通过“授权登录”和“凭证与能力”标签分类：前者测试授权、资料选项和取消等待；后者测试能力检查、凭证查询、撤销监听与释放及诊断开关。页面底部始终保留日志、完整报告、分段及手动复制入口。凭证查询需要先取得真实 Apple 用户标识。

模块一：取得授权凭据

以下 JavaScript 可用于 uni-app 页面 methods 中。没有服务端挑战时可先测原生授权；生产接入应从后端取得并绑定一次性的 nonce/state，再传入 options。不要使用固定演示字符串充当生产随机挑战。

import { signInWithApple, getAppleLoginCapabilitiesSync } from '@/uni_modules/lizhao-apple-login'

export default {
  data() { return { requestId: '', status: '待授权' } },
  methods: {
    login() {
      const capability = getAppleLoginCapabilitiesSync()
      if (!capability.supported) { this.status = capability.limitation; return }
      this.requestId = signInWithApple({
        scopes: ['email', 'fullName'],
        timeoutMs: 120000,
        success: (result) => {
          this.status = 'Apple授权完成，请交服务端验证'
          // 在业务HTTPS接口中提交result.identityToken、authorizationCode及本次挑战。
          // 此处不打印、持久化或复制凭据；实际请求由业务自己的后端地址决定。
        },
        fail: (error) => { this.status = error.errCode + '：' + error.errMsg },
        complete: () => { this.requestId = '' }
      })
    }
  }
}

完整可操作页面见 uni_modules/lizhao-apple-login/example/uniapp/index.vue；它在内存保留 user 用于查询，不把凭据写入日志。

模块二：uni-app x 强类型调用

import { signInWithApple, AppleLoginOptions, AppleLoginSuccess, AppleLoginFail, AppleLoginComplete } from '@/uni_modules/lizhao-apple-login'

const options: AppleLoginOptions = {
  scopes: [],
  success: (result: AppleLoginSuccess): void => {
    uni.showToast({ title: 'Apple授权完成，待服务端验证', icon: 'none' })
    // 业务从此回调提交真实凭据；fullName/email为null时保留已有业务资料。
  },
  fail: (error: AppleLoginFail): void => {
    uni.showToast({ title: error.errCode.toString() + '：' + error.errMsg, icon: 'none' })
  },
  complete: (result: AppleLoginComplete): void => {
    // complete不含凭据，可按requestId结束对应页面忙碌态。
  }
}
const requestId = signInWithApple(options)

在页面事件中执行上述代码；完整状态、输入、释放与报告示例见 uni_modules/lizhao-apple-login/example/uniappx/index.uvue。请始终从根导入类型和函数。

模块三：查询、撤销通知与页面释放

以下 JavaScript 接收真实成功结果保存的 user，不使用虚构用户标识发起查询：

import { getAppleCredentialState, onAppleCredentialRevoked, offAppleCredentialRevoked, cancelAppleLogin } from '@/uni_modules/lizhao-apple-login'

export default {
  data() { return { appleUser: '', loginRequest: '', revokedSubscription: '', status: '' } },
  methods: {
    checkCredential() {
      if (!this.appleUser) { this.status = '请先授权或加载业务保存的Apple用户标识'; return }
      getAppleCredentialState({
        user: this.appleUser,
        success: (result) => { this.status = result.state },
        fail: (error) => { this.status = error.errCode + '：' + error.errMsg }
      })
    },
    observeRevocation() {
      if (this.revokedSubscription) return
      this.revokedSubscription = onAppleCredentialRevoked(() => { this.checkCredential() })
    }
  },
  onUnload() {
    if (this.loginRequest) cancelAppleLogin(this.loginRequest)
    if (this.revokedSubscription) offAppleCredentialRevoked(this.revokedSubscription)
  }
}

撤销通知不提供 user，插件将 event.user 返回 null；业务根据自己持有的标识查询，不能把通知伪装成指定用户已注销。transferred 需要服务端配合处理应用转移。状态查询 fail 与 revoked/notFound 不同，失败时不要删除账号。

API 用途速查

授权参数

查询、取消和监听参数

结果与事件

• AppleLoginSuccess：errSubject、errCode=0、errMsg、requestId、user、identityToken、authorizationCode、state、authorizedScopes、email、fullName、realUserStatus。授权码与JWT必须交服务端；用户标识不是会话凭证。
• email、fullName 可能为 null。fullName 包含可空 givenName、familyName、middleName、namePrefix、nameSuffix、nickname。Apple不保证每次返回个人资料，不覆盖业务已保存资料。
• realUserStatus 为系统原值：0不支持、1未知、2较可能真实；不能单独作为业务鉴权或风控结论。
• AppleCredentialStateResult：requestId、user、state、nativeState，以及标准错误摘要。state 为 authorized、revoked、notFound、transferred 或 unknown，保留未来原生值。
• AppleLoginCancelResult：requestId、cancelled（本地等待是否结束）、systemCancelRequested（是否请求系统取消）、nativePending（系统终态仍未确认）、errMsg。systemCancelRequested不代表已关闭系统窗口。
• AppleCredentialRevokedEvent：eventId、occurredAt、user=null，来源为系统通知。订阅应在离开页面时释放，避免频繁重复注册。
• AppleLoginCapabilities：platform、supported、systemVersion、supportsSystemCancel、nativeBusy、entitlement、nativeBuildId、limitation。entitlement=unknown时需核对真实签名，不能靠本地配置文件推断。
• AppleLoginDiagnostics：pluginId、pluginVersion、buildId、generatedAt、entries、droppedEntries、nativeSnapshot。记录有界，容量覆盖有计数；不含业务凭据正文。

错误码说明

errSubject 固定为 lizhao-apple-login。AppleLoginFail 还保留 requestId、nativeDomain、nativeCode、nativeCause（已脱敏；不可采集时 unknown）。同一错误码在所有入口语义一致。

Apple原生1000可能有多种原因，不能一律判定缺entitlement；先核Bundle ID、后台capability、描述文件、安装包签名及真实系统原因。用户取消与本地取消分别保留。

注意事项

平台与验收状态

目标能力仅 iOS 原生；兼容设计覆盖 uni-app Vue2/Vue3 与 uni-app x。Android、Harmony、Web 和所有小程序没有 Apple 登录实现，导入后返回明确不支持。其他平台的Google/华为账号不是苹果账号授权。

源码、静态检查、资源导出、Apple SwiftCompile/链接、匹配自定义基座与iPhone业务必须分别验证。当前候选源码的实际验证记录随开发更新；平台待验标记不代表已通过真机。

签名、服务端与生命周期

• 新增或修改原生Swift、UTS原生生成物、系统Framework或entitlement后需要重新iOS原生联编或制作自定义基座。资源/WGT不能补进原生代码。
• iOS16+才有ASAuthorizationController.cancel；iOS13–15本地取消后不能承诺关闭系统UI。旧控制器没有真实终态时继续保持busy。
• success/fail与complete按请求最多触发一次，客户回调异常隔离；异常正文可能含凭据，不自动采集。页面卸载时释放自己的请求及监听，并防止自己异步查询回调更新已卸载页面。
• 原生最多并行32个凭证查询，超出同样返回9361003；不自动创建无界查询。订阅按ID精确移除，避免反复重复注册。
• nonce原样传入；业务若约定SHA-256摘要，需要服务端与客户端明确一致。只在客户端解码JWT不等于验签。Client Secret、p8私钥和refresh token不得放客户端。
• 业务退出、系统账号退出、Apple授权撤销、服务端账户删除不同。Apple令牌撤销由服务端调用 /auth/revoke；插件不提供伪注销方法。
• 姓名/邮箱可能仅首次出现，业务应通过自己的安全管道保存；Apple隐藏邮件地址需按官方私有邮件转发要求配置发信域。

诊断与隐私

日志只在本地内存保留，默认不上传。原生在缓存前不写凭据，页面/helper在缓存和展示前脱敏；错误保留真实码和采集边界。不要在业务success中自行打印整结果。

两份完整示例底部均有一键复制日志、完整报告、固定快照分段与全文手动选择。报告包含插件/源码标记、运行时环境、调用与回调轨迹、错误和丢弃计数。HX/编译器构建信息、基座或运行时不可取得的字段明确写 unknown，不用排查电脑版本冒充客户包版本。生成完整报告后再逐段复制，后续日志不修改既有快照；失败不推进分段，不清原日志。

不请求定位、相机、通讯录、跟踪等无关权限，不使用第三方SDK。实际Apple授权通过系统服务联网；签名能力配置不是普通弹窗权限。客户自身后端的数据收集应在业务隐私政策说明。

官方接入依据：配置Sign in with Apple、服务端验证、撤销与账户删除。

作者系列 UTS 插件

以下链接以项目已核实的已发布清单为准；本候选插件不提前加入已上架列表。