更新记录

1.0.0（2026-09-08）

支持 三端小红书分享笔记功能

平台兼容性

uni-app(5.0)

uni-app x(5.0)

tt-xhs-share

📷 小红书分享 UTS 插件，为 uni-app x & uni-app 提供小红书图文、视频分享能力。

标签：小红书分享、分享SDK、Android、iOS、HarmonyOS

📖 目录

• SDK 版本信息
• 环境配置
• 快速开始
• 基础使用
• 平台差异
• 错误处理
• 常见问题

SDK 版本信息

环境配置

前置条件

1. 在小红书开放平台申请 appKey
2. 设备已安装小红书客户端
3. 使用自定义基座或正式包测试

iOS 平台配置

register 需要传入：

• appKey
• universalLink

插件内已配置：

• utssdk/app-ios/Info.plist
• URL Scheme 占位：YOUR_XHS_APP_KEY
• LSApplicationQueriesSchemes：xhsdiscover

宿主 iOS 工程需要：

• 将 YOUR_XHS_APP_KEY 替换为真实 appKey
• 配置 Associated Domains

HarmonyOS 平台配置

插件内已配置：

• utssdk/app-harmony/config.json
• 依赖：@xiaohongshu/open_sdk@1.0.4

Harmony 端接口映射：

• type: "image" -> note
• type: "video" -> video

Android 平台配置

Android 侧已内置原生依赖，通常只需保证 appKey 正确。

快速开始

import { getTTXhsShare } from '@/uni_modules/tt-xhs-share'

const xhs = getTTXhsShare()

xhs.register({
  appKey: '你的 appKey',
  universalLink: 'https://your-domain.com/xhs/'
})

图文分享

xhs.share({
  type: 'image',
  title: '标题',
  content: '正文',
  images: ['https://example.com/1.jpg']
})

视频分享

xhs.share({
  type: 'video',
  title: '标题',
  content: '正文',
  video: 'https://example.com/demo.mp4',
  cover: 'https://example.com/cover.jpg'
})

基础使用

isInstall

判断小红书客户端是否安装。

register

share

平台差异

错误处理

常见问题

1. iOS 为什么还要配 universalLink？

小红书 iOS SDK 需要它完成回跳和分享链路。

2. 为什么分享前必须先 register？

插件统一了三端接口，未初始化时不会进入原生分享流程。

3. 本地文件能直接传吗？

可以，插件会按平台自动转换。

4. 为什么打包失败？

优先检查：

• appKey 是否正确
• iOS 的 universalLink 是否配置
• Harmony 的 @xiaohongshu/open_sdk 是否已引入