更新记录

1.0.0（2026-09-03）

支持 Android 和 iOS 平台的 Naver ID 授权登录、退出登录及 Token 管理功能

平台兼容性

uni-app(5.24)

uni-app x(5.24)

tt-naver-open

Naver ID 登录 UTS 插件，支持 uni-app x Android 和 iOS App。

平台要求

• Android：minSdk 21，使用 Maven Central 的 com.navercorp.nid:oauth:5.12.0。
• iOS：deployment target 15.0，插件内置官方 NidThirdPartyLogin.xcframework 和 NidCore.xcframework。
• Harmony：仅提供不支持实现，会通过 fail 回调返回错误码 401。
• Web、小程序和其他平台：不提供实现。

使用

import { getTTNaverSDK } from '@/uni_modules/tt-naver-open'

const naver = getTTNaverSDK()
naver.initialize({
  clientId: 'YOUR_CLIENT_ID', clientSecret: 'YOUR_CLIENT_SECRET', appName: 'Your App',
  serviceUrlScheme: 'YOUR_NAVER_SERVICE_URL_SCHEME',
  success: null, fail: null, complete: null
})
naver.login({
  success: (res) => console.log(res.accessToken), fail: (err) => console.error(err.errCode, err.errMsg), complete: null
})

Android 使用 Naver 官方 oauth SDK 5.12.0，iOS 使用官方 Swift SDK 的 XCFramework。serviceUrlScheme 仅 iOS 必填，必须与 Naver Developer Center 中登记的 URL Scheme 一致。请将 Info.plist 中的 YOUR_NAVER_SERVICE_URL_SCHEME 替换为实际值；如果宿主应用已有 CFBundleURLTypes，请合并对应 Scheme，避免覆盖现有配置。

示例页 pages/index/index.uvue 可验证初始化、登录和退出登录流程。示例中的 Client ID、Client Secret 和 URL Scheme 仅为输入占位符，不能直接用于登录。

API

getTTNaverSDK() 返回以下方法：

• initialize({ clientId, clientSecret, appName, serviceUrlScheme, success, fail, complete })
• login({ success, fail, complete })
• logout({ success, fail, complete })
• clearToken()、isLoggedIn()、getAccessToken()

登录成功结果包含 accessToken、refreshToken、accessTokenExpiresAt（毫秒时间戳）和 tokenType。未初始化、重复登录、取消/失败等情况通过 fail 回调返回 IUniError，常用错误码为 103、302、401、999。

initialize 应在调用 login 前执行。iOS 回调依赖宿主应用的 URL Scheme，插件已通过 TTNaverSDKHookProxy 转发授权回调。

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS