更新记录

1.2.0（2026-11-12）

实现 iOS 端授权登录：注册 BiliOAuth SDK、接管 URL Scheme / Universal Link 回跳并处理 delegate 回调；补充 iOS 原生配置与接入说明。

1.0.0（2025-11-07）

1.0.0（2025-11-08）

提交

平台兼容性

uni-app(3.8.11)

uni-app x(3.8.11)

xb-bilibiliOauth

哔哩哔哩授权登录

发起登录

<script>
    import {
        startBiliAuth
    } from "@/uni_modules/xb-bilibiliOauth";

    export default {
        data() {
            return {}
        },
        methods: {
            login() {
                startBiliAuth({
                    clientId: "",
                    packageName: "",
                    // iOS 可选：配置了 Universal Link 时才传，不传则走 URL Scheme 回跳
                    // universalLink: "https://your.domain.com",
                    success: (code, msg) => {
                        console.log('success', code, msg);
                    },
                    fail: (msg) => {
                        console.log('fail', msg);
                    },
                });
            },
        }
    }
</script>

参数说明：

iOS 接入配置

BiliOAuth.framework 已随插件提供，无需额外引入。在 manifest.json → app-plus → distribute → ios 中：

1. urltypes：把 bili{clientId} 放在第一位（{clientId} 换成开放平台申请的 client_id），已有的其它 scheme 用逗号排在后面。
2. urlschemewhitelist：加入 bilibili.oauth,bilibili，已有值用逗号追加。
3. Universal Link（可选）：capabilities.entitlements 的 com.apple.developer.associated-domains 加 applinks:{域名}，并在该域名部署 apple-app-site-association；调用时传 universalLink。不配就走 URL Scheme 回跳。

配置后重新制作自定义基座 / 云打包（需 HBuilderX 3.97+）。用户未返回 App 时不会触发回调，加载态请在业务侧处理。

开发文档

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