@didomi/react-native

中文文档
2.39.0发布于 2026/11/10BSD-3TypeScriptESM + CJS构建来源已验证近 30 天下载 6.3万

Didomi 反应原生 SDK

中文使用文档
文档目录7 节
  1. 安装
  2. 使用量
  3. 配置本地文件
  4. 文档
  5. 示例应用程序
  6. 建议改进
  7. 许可证

Didomi 反应原生

Didomi是一个领先的"同意管理平台",它允许公司根据GDPR,CCPA,以及其他数据隐私条例收集,存储并带动用户同意. 这个插件使得React Introduct开发者能够进入合规状态并优化其在本地移动应用上的同意率和货币化.

这个寄存器包含了Didomi React Industrial插件的源代码和样本应用. 这个插件使React Industrial开发者可以轻松地在Android和iOS应用上使用Didomi的"同意管理平台".

安装

使用 yarn add @didomi/react-native 或者说 npm i @didomi/react-native

然后为 iOS 安装所需的 socket cd ios && pod install

由于 Didomi 需要 iOS 的 Swift 运行时间, 您可能需要在 Xcode 项目中添加一个空的 Swift 文件( 以创建导出头) .

使用量

import { Didomi, DidomiEventType } from '@didomi/react-native';
import { useEffect } from 'react';

// ...
function App() {
  useEffect(() => {
    // Initialize and setup UI
    // The initialize function need to be called only once and as early as possible to give time for the SDK initialization
    Didomi.initialize('YOUR_API_KEY', undefined, undefined, undefined, false, undefined, 'YOUR_NOTICE_ID');

    // The setupUI displays the popup and is only available once the SDK sent the onReady events
    Didomi.setupUI();
  }, [])
  return (
    <SafeAreaView style={{ flex: 1 }}>
      // ...
    </SafeAreaView>
  );
}

//...

// Retrieve data
const purposes = await Didomi.getEnabledPurposes();
const status = await Didomi.getUserStatusForVendor('vendorId');

//...

// Register an event listener
Didomi.addEventListener(DidomiEventType.SHOW_NOTICE, () => {
  console.log('Show notice');
});

//...

关于现有方法和活动的完整概述,请审查 在线文档。 。 。 .

配置本地文件

以防您需要使用本地配置 。 这个 didomi_config.json 必须添加到本地iOS和Android项目中.

在iOS上,拖放文件到Xcode文件.

在Android上,复制到 src/main/assets 文件夹.

文档

关于安装和使用插件的完整指示,请读取我们的文档:

开发者指南

API 参考

示例应用程序

资料来源包含两个应用程序: /test (主要为UI测试设计的应用程序)和 /sample (更人类友好的应用).

它们可以使用:

# test or sample Application
cd sample
cd ios && pod install
cd ..
npx react-native run-ios
# or npx react-native run-android

建议改进

文件错误、 特性请求或建议其他改进, 请使用 Github 的发行跟踪器。 。 。 .

许可证

修改的 BSD 许可证 (BSD-3)

版本与发布记录

@didomi/react-native 共发布 75 个版本,首次发布于 2021/06/25;过去 12 个月发布了 26 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.39.0latest2026/11/101 天前
2.38.12026/10/2913 天前
2.38.02026/10/2616 天前
2.37.12026/10/2121 天前
2.37.02026/10/1230 天前
2.36.02026/09/281 个月前

关于 @didomi/react-native 的常见问题

@didomi/react-native 是什么?

Didomi 反应原生 SDK

如何安装 @didomi/react-native?

在项目目录运行 npm install @didomi/react-native,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(*)、react-native(>=0.77.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@didomi/react-native 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@didomi/react-native 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@didomi/react-native 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@didomi/react-native 可以商用吗?

@didomi/react-native 使用 BSD-3 许可。声明的许可为 BSD-3,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@didomi/react-native 的下载量有多少?

根据 npm 官方下载统计,@didomi/react-native 在 2026/10/12 – 2026/11/10 这 30 天内被下载 62,698 次,日均约 2,090 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@didomi/react-native 还在维护吗?

最新版本 2.39.0 发布于 2026/11/10(1 天前);至今共发布 75 个版本,其中过去 12 个月发布了 26 个;首次发布于 2021/06/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。