# UniApp阿里百川安卓淘宝授权

**Repository Path**: wenouo/Albc_Wen_Auth

## Basic Information

- **Project Name**: UniApp阿里百川安卓淘宝授权
- **Description**: UniApp阿里百川安卓淘宝授权
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-30
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 阿里百川, uni-app

## README

# wen-uts-albc

`wen-uts-albc` 是一个基于 [UTS](https://doc.dcloud.net.cn/uni-app-x/plugin/uts-plugin.html) 的 UniApp 插件，用于集成 **阿里百川电商 SDK (AlibcSDK)**，提供 **登录、登出、顶部认证** 等功能。

---

## 📦 功能特性

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

---

## 📥 安装步骤

### 1. 克隆插件

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

```bash
git clone https://gitee.com/du-jiwen/Albc_Wen_Auth.git
```

### 2. 禁用资源文件混淆

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

```json
"android": {
  "enableResourceOptimizations": false
}
```

🔗 [关闭 res 混淆文档说明](https://uniapp.dcloud.net.cn/collocation/manifest-app.html#enableresourceoptimizations)

---

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

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

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

---

## 🧭 接入流程

### 1. 注册阿里百川账号

👉 [阿里百川开放平台](https://console.baichuan.taobao.com/applications.htm)

### 2. 创建应用

![创建应用](./static/1.png)

### 3. 申请套件

![申请套件](./static/2.png)

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

![开通套件](./static/3.png)

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

👉 [淘宝客基础页面包申请](https://suite.baichuan.taobao.com/suite2.htm#/apply)
![页面包](./static/4.png)

### 6. 获取 SDK 管理地址

👉 [SDK 管理页面](https://suite.baichuan.taobao.com/suite2.htm#/sdk)

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

![安全图上传](./static/5.png)

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

* 选择 `v6.1` 版安全图片
* 选择 Android 系统
* 上传 APK 并下载生成的图片
  ![获取安全图](./static/6.png)

### 8. 替换安全图

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

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

### 9. 修改 appkey

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

---

## 🛠️ 使用方法

### 初始化 SDK

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

initAlbc();
```

### 登录登出与授权示例

```vue
<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/1677214859156121124/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 说明

| 方法名             | 描述            |
| --------------- | ------------- |
| `initAlbc()`    | 初始化 Alibc SDK |
| `loginAlbc()`   | 登录淘宝账号        |
| `logoutAlbc()`  | 退出登录          |
| `topAuthAlbc()` | 顶部弹窗授权        |

### 顶部授权参数类型

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

---

## ⚠️ 注意事项

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

---


## 📄 License

MIT License
详见 [LICENSE](./LICENSE)