更新记录

1.0.0（2026-08-29）

• 首个版本：初始化、安装检测、打开小红书活动页、图文与视频笔记分享。

平台兼容性

uni-app(5.24)

uni-app x(5.24)

hans-xhs-share 小红书分享

封装小红书官方分享 SDK 的 uni-app x UTS 插件：初始化、安装检测、打开小红书活动页、图文（1~18 张）与视频笔记分享。

使用前提：在小红书开放平台申请 AppKey，并完成应用包名 / BundleID 备案。

平台兼容性

安装与配置

Android：无需手动配置，AAR 与 FileProvider 均已内置，直接打自定义基座即可。如需更换 SDK，请替换 utssdk/app-android/libs/xhssharesdk.aar，并使用不低于 1.1.4 的版本。

iOS：

1. 编辑 utssdk/app-ios/Info.plist，把 xhs填写你的AppKey 改为 xhs + 你的AppKey；
2. 应用工程配置 Universal Link（HTTPS 域名，以 / 结尾填到开放平台备案），HBuilderX manifest 打开 Associated Domains。

快速上手

UTS 支持类型检查，建议为会保存、复用或动态拼装的参数对象显式声明插件导出的类型。特别是 XhsShareOptions 的 type 字段声明为 'image' | 'video'，可避免先赋值给变量后被推断为普通 string。

import {
    initXhsShare,
    isXhsInstalled,
    openXhsUrl,
    shareToXhs,
    XhsShareSimpleResult,
    XhsShareFail,
    XhsShareInitOptions,
    XhsShareOptions,
    XhsOpenUrlOptions
} from '@/uni_modules/hans-xhs-share'

// 初始化（iOS 必须传 universalLink，以 "/" 结尾）
const initOptions : XhsShareInitOptions = {
    appKey: '你的AppKey',
    universalLink: 'https://your-domain.com/app/xhs/',
    enableLog: false,
    success: (res : XhsShareSimpleResult) => {},
    fail: (err : XhsShareFail) => {}
}
initXhsShare(initOptions)

// 安装检测（同步）
if (!isXhsInstalled()) {
    uni.showToast({ title: '请先安装小红书', icon: 'none' })
}

// 图文分享：最多 18 张，网络 URL 或本地路径均可
const imageOptions : XhsShareOptions = {
    type: 'image',
    imageUrls: ['/static/demo/a.jpg', '/static/demo/b.jpg'],
    title: '标题',
    summary: '正文'
}
shareToXhs(imageOptions)

// 单张便捷写法
const singleImageOptions : XhsShareOptions = {
    type: 'image',
    imageUrl: '/static/demo/a.jpg'
}
shareToXhs(singleImageOptions)

// 视频分享（封面可选）
const videoOptions : XhsShareOptions = {
    type: 'video',
    videoUrl: '/static/demo/v.mp4',
    coverUrl: '/static/demo/cover.jpg',
    title: '标题',
    summary: '正文'
}
shareToXhs(videoOptions)

// 在小红书内打开活动页
const openUrlOptions : XhsOpenUrlOptions = {
    url: 'https://www.xiaohongshu.com/explore'
}
openXhsUrl(openUrlOptions)

API

initXhsShare(options)

初始化，启动后调用一次即可；重复调用会覆盖配置。

shareToXhs(options)

openXhsUrl(options)

在小红书内打开活动页，url 仅支持 http/https。

其它

• isXhsInstalled(): boolean —— 同步检测是否安装小红书
• setXhsLogEnabled(enabled) / isXhsLogEnabled() —— 日志开关

所有接口均支持回调（类型已随插件导出）： success(res : XhsShareSimpleResult) —— 用户在小红书完成发布后触发； fail(err : XhsShareFail) —— 取消等失败场景触发； complete(res) —— 无论成败均触发。 err 为标准 UniError（errSubject: 'hans-xhs-share'），err.data 携带官方原始信息 { nativeCode, nativeMsg, platform }。

错误码

注意事项

• 本地路径支持 /static/... 自动转换；沙盒内文件请传绝对路径。
• iOS 经系统相册跨进程共享媒体，首次使用会弹相册权限，拒绝后返回 9010006。
• 工程 URL Scheme 超过 50 个时，xhs<AppKey> 必须排进前 50 位，否则无法回跳。
• 排障时先开日志（setXhsLogEnabled(true) 或 init 传 enableLog: true），控制台过滤 hans-xhs-share。

更新日志

见 changelog.md