更新记录

1.0.0（2025-08-14） 下载此版本

1.0.0

平台兼容性

云端兼容性

uni-app(4.75)

uni-app x(4.75)

wen-uts-albc

wen-uts-albc 是一个基于 UTS（Uni TypeScript） 的 UniApp 插件，用于集成 阿里百川电商 SDK (AlibcSDK)，提供 登录、登出、顶部认证 等功能。

📦 功能特性

• ✅ 用户登录（login）
• ✅ 用户登出（logout）
• ✅ 淘宝顶部弹框授权（topAuth）

📥 安装步骤

1. 克隆插件

将本插件下载或克隆至 uni_modules 目录下：

git clone https://your-repo-url/uni_modules/wen-uts-albc

2. 禁用资源文件混淆

在 manifest.json 中禁用 res 资源文件混淆（否则安全图初始化会失败）：

"android": {
  "enableResourceOptimizations": false
}

🔗 关闭 res 混淆文档说明

🚀 快速上手（使用示例项目）

⚠️ 请使用真机运行，自定义基座打包，模拟器不支持

1. 下载示例项目，提交 云打包 ➜ 使用 自定义基座 ➜ 安装到手机
2. 若运行正常，再继续进行下列配置和集成

🧭 接入流程

1. 注册阿里百川账号

👉 阿里百川开放平台

2. 创建应用

3. 申请套件

4. 后台开通「百川电商 SDK」和「旗舰版」

5. 前往套件平台申请淘宝客基础页面包

👉 淘宝客基础页面包申请

6. 获取 SDK 管理地址

👉 SDK 管理页面

注意：申请通过后需上传安全图片（否则登录后需输账号密码）

7. 上传 APK 获取安全图（使用你自己的签名打包 APK）

• 选择 v6.1 版安全图片
• 选择 Android 系统
• 上传 APK 并下载生成的图片

8. 替换安全图

将生成的安全图（命名为 yw_1222_baichuan.jpg）替换到：

uni_modules/wen-uts-albc/utssdk/app-android/res/drawable/

9. 修改 appkey

在调用授权方法时传入你自己在阿里开放平台注册的 appkey

🛠️ 使用方法

初始化 SDK

import { initAlbc } from '@/uni_modules/wen-uts-albc';

initAlbc();

登录登出与授权示例

<template>
    <view class="content">
        <button @click="init">初始化</button>
        <button @click="login">登录</button>
        <button @click="logout">登出</button>
        <button @click="authorize">顶部授权</button>
    </view>
</template>

<script>
    import {
        initAlbc,
        loginAlbc,
        logoutAlbc,
        topAuthAlbc
    } from '@/uni_modules/wen-uts-albc';

    export default {
        methods: {
            async init() {
                const {
                    result,
                    fail
                } = await initAlbc();
                uni.showToast({
                    title: fail || result,
                    icon: 'none'
                });
            },
            async login() {
                const {
                    result,
                    fail
                } = await loginAlbc();
                uni.showToast({
                    title: fail || result,
                    icon: 'none'
                });
            },
            async logout() {
                const {
                    result,
                    fail
                } = await logoutAlbc();
                uni.showToast({
                    title: fail || result,
                    icon: 'none'
                });
            },
            async authorize() {
                const query = {
                    icon: " https://foruda.gitee.com/avatar/16772***124/10605975_du-jiwen_1660208658.png!avatar200",
                    name: "授权App名称",
                    appkey: "34487880"
                };
                const {
                    result,
                    fail
                } = await topAuthAlbc(query);
                if (fail) {
                    uni.showToast({
                        title: fail,
                        icon: 'none'
                    });
                } else {
                    uni.showToast({
                        title: result,
                        icon: 'none'
                    });
                }
            }
        }
    };
</script>

🔍 API 说明

顶部授权参数类型

export type topAuthAlbcOptions = {
  icon: string;   // 图标 URL
  name: string;   // App 名称
  appkey: string; // 淘宝联盟 AppKey
};

⚠️ 注意事项

• 🚫 不支持模拟器运行
• ✅ 需使用自定义基座（打包时使用你自己的签名证书）
• 🧩 支持平台：UniApp（Vue2/Vue3） + 安卓
• 📸 安全图片需使用 v6.1 版本
• 🔐 安全图必须与当前应用包名+证书一致
• 💥 SDK 初始化后，才能调用其他方法

📄 License

MIT License 详见 LICENSE

❤️ 捐赠支持

如果你觉得本项目对你有帮助，可以请我喝杯咖啡 ☕。你的支持是我持续更新的动力！

支付宝	微信

请使用对应的 App 扫码进行捐赠，感谢支持！