# @coinflowlabs/react-native-fraud 中文文档

规范地址：https://npmcn.com/package/%40coinflowlabs/react-native-fraud/

版本：0\.1\.2
npm 元数据更新时间：2026-11-09T21:47:30.556Z
中文译文更新时间：2026-11-10T10:27:24.370Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40coinflowlabs/react-native-fraud
原文对照：https://npmcn.com/package/%40coinflowlabs/react-native-fraud/?lang=original
项目主页：https://github.com/coinflow-labs-us/coinflow-react-native-fraud#readme
源码仓库：https://github.com/coinflow-labs-us/coinflow-react-native-fraud

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：39 kB，24 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react \>=16，react-native \>=0\.66\.0
- 首次发布：2026-10-14T15:31:46.329Z
- 最新版本发布：2026-10-26T18:57:04.179Z
- 近 30 天下载量：66938（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

React Introduct的Coinflow欺诈保护——一个不透明的头,由Coinflow的原生iOS和Android欺诈SDKs支持.

## 安装

```sh
npm install @coinflowlabs/react-native-fraud
```

也可以使用：`pnpm add @coinflowlabs/react-native-fraud`、`yarn add @coinflowlabs/react-native-fraud`、`bun add @coinflowlabs/react-native-fraud`

## README

# @coinflowlabs/ react-native-frainition - 欺诈

为React Industrial提供联合流量欺诈保护. 在Coinflow的原生iOS和Android欺诈之上的一通小桥 SDKs会返回一个单不透明的头来附加到Coinflow API的呼叫上.

## 安装

```bash
npm install @coinflowlabs/react-native-fraud
```

## 使用量

将您的应用根包成保护靴:

```tsx
import {CoinflowProtectionProvider} from '@coinflowlabs/react-native-fraud';

export default function App() {
  return (
    <CoinflowProtectionProvider merchantId={merchantId} env="prod"> {/* 'prod' | 'sandbox' */}
      <RootNavigator />
    </CoinflowProtectionProvider>
  );
}
```

负责时间, 附加单不透明标题 :

```tsx
import {useCoinflowFraudHeaders} from '@coinflowlabs/react-native-fraud';

const getFraudHeaders = useCoinflowFraudHeaders();
const res = await fetch(chargeUrl, {headers: {...(await getFraudHeaders()), ...auth}});
// => {'x-device-id': '<opaque value>'}
```

或绝对通过 `CoinflowFraud.initialize({merchantId, env})` 财务报告和审定财务报表 `CoinflowFraud.getPurchaseHeaders()`。 。 。 .

变化 `merchantId` 或者说 `env` 打开 `CoinflowProtectionProvider` 用新配置重新初始化 . 当您必须拨打 API 时, 请切换配置 `CoinflowFraud.initialize({merchantId, env, force: true})`。带有不同配置的非强制呼叫 被忽略.

也没打过电话 当本地模块没有链接时( Expo Go, web), `getPurchaseHeaders()` 返回时 `{}`。 。 。 .

### 本地设置

软件包自动链接一个将本地 SDKs 包裹的本地模块: `CoinflowFraud` iOS上显示 `cash.coinflow:coinflow-fraud` 安卓号.

-   **展览 :** 添加 `"@coinflowlabs/react-native-fraud"` 改为 `plugins` 在您的应用程序配置。 插件 进行这些修改:
    -   它指向你的Podfile 在iOS SDK, 它不在可可Pods的后车厢.
    -   它将会话提供商的舱载到iOS 15.1, 因为他们声明14. 0, 而目前是14 Xcode拒绝.
    -   在Android上,它将信号SDKs的"马文回放"添加到你的应用程序上 `android/build.gradle`。 。 。 . `npx expo run:android` 需要这一点,因为它与 `--configure-on-demand`。 。 。 .
-   **裸体反应原生( iOS) :** 将此行添加到您的 Podfile 目标 :
    
    ```ruby
    pod 'CoinflowFraud', :git => 'https://github.com/coinflow-labs-us/coinflow-swift-fraud.git', :tag => 'v0.2.1'
    ```
    
    然后在您的顶部添加这个 `post_install do |installer|` 块 :
    
    ```ruby
    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |build_config|
        next unless build_config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'].to_f < 15.1
        build_config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.1'
      end
    end
    ```
    
    iOS构建需要Xcode 26或更后.
-   **机器人:** 通常没有配置, 因为模块添加了信号 SDKs 的 Maven repos 自己来 将存储器集中到 `settings.gradle` 结束 `dependencyResolutionManagement { repositoriesMode … }` 这是例外。 与 `FAIL_ON_PROJECT_REPOS` 建造失败,并且 `PREFER_SETTINGS` 复数被忽略 。 这些 应用程序添加 Coinflow 的 `cash.coinflow.fraud.repositories` 设置插件到已有的 `pluginManagement` 财务报告和审定财务报表 `plugins` 块 `android/settings.gradle`它添加了设置中的重置器, ,然后模块宣布没有自己的寄存器,所以两种模式都正在构建。 插件在马文上 中央,这样 `pluginManagement` 必须列出 `mavenCentral()`数字 :
    
    ```groovy
    pluginManagement {
      repositories {
        gradlePluginPortal()
        mavenCentral()
      }
    }
    
    plugins {
      id("cash.coinflow.fraud.repositories") version "0.1.1"
    }
    ```
    

## 示例应用程序

`example/` 是将根包入 `CoinflowProtectionProvider` 并附上 `x-device-id` 请求头。 它从npm安装此软件包.

```bash
cd example
cp example.env .env
npm install
npx expo run:ios   # or: npx expo run:android
```

## 版式

-   `src/` 是JS API,一个失败打开的包装器 围绕本地模块.
-   `ios/` 是斯威夫特桥到 `CoinflowFraud` 舱 (`lib/swift-fraud`) (中文(简体) ).
-   `android/` 是科特林桥 `cash.coinflow:coinflow-fraud` (单位:千美元)`lib/android-fraud`) (中文(简体) ).
-   `app.plugin.js` 是 Expo 配置插件。 在Coinflow单列跑道内,测试台通过 `{"localSdkRoot": "../../.."}`通过它,iOS从 `lib/swift-fraud` 和 Android 数据 解决 SDK 从 `mavenLocal()`因此,第一次运行 `./gradlew publishToMavenLocal` 内 `lib/android-fraud`。 。 。 .

## 常见问题

### @coinflowlabs/react-native-fraud 是什么？

React Introduct的Coinflow欺诈保护——一个不透明的头,由Coinflow的原生iOS和Android欺诈SDKs支持\.

### 如何安装 @coinflowlabs/react-native-fraud？

在项目目录运行 npm install @coinflowlabs/react-native-fraud，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=16）、react-native（\>=0\.66\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @coinflowlabs/react-native-fraud 支持 TypeScript 吗？

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

### @coinflowlabs/react-native-fraud 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @coinflowlabs/react-native-fraud 可以商用吗？

@coinflowlabs/react-native-fraud 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @coinflowlabs/react-native-fraud 的下载量有多少？

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

### @coinflowlabs/react-native-fraud 还在维护吗？

最新版本 0\.1\.2 发布于 2026/10/27（14 天前）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。