@getcello/cello-react-native

中文文档
0.17.0发布于 2026/11/12MITTypeScriptESM + CJS零依赖近 30 天下载 5.3万

反应原生包装以桥接iOS和Android SDK

中文使用文档
文档目录33 节
  1. 🏠 网站
  2. 📚 开发者 Docs
  3. 安装
  4. 机器人
  5. 监督办
  6. 博览
  7. 方法
  8. 导入
  9. import Cello from '@getcello/cello-react-native';
  10. Cello.initialize()
  11. API 样式
  12. 初始化选项
  13. 产品用户详情
  14. 回返
  15. Cello.showFab()
  16. Cello.hideFab()
  17. Cello.openWidget()
  18. Cello.hideWidget()
  19. Cello.shutdown()
  20. Cello.getActiveUcc()
  21. 回返
  22. Cello.getCampaignConfig()
  23. 回返
  24. Cello.updateToken(token)
  25. 选项
  26. 回返
  27. Cello.changeLanguage(language)
  28. 选项
  29. 使用量
  30. 解决问题
  31. 作者
  32. 显示您的支持
  33. 许可证

@ getcello/ cello- react- native

反应原生包装器来连接我们的iOS和Android SDK

🏠 网站

📚 开发者 Docs



安装

npm install @getcello/cello-react-native

或者说

yarn add @getcello/cello-react-native

机器人

如果您正在使用 React Industrial v. 0. 60 或以上,则库会自动链接而无需采取任何步骤.

Android: 自动链接到 React Industrial v0.59 及以下

react-native link @getcello/cello-react-native

Android: 手动链接到 React Industrial v0.59 及以下

  • 在代码下添加到 android/settings.gradle
include ':cello-react-native'
project(':cello-react-native').projectDir = new File(rootProject.projectDir, '../node_modules/@getcello/cello-react-native/android')
  • 然后编辑 android/app/build.gradle内部 dependencies 在最下方添加
implementation project(':cello-react-native')

Android: 设置

  • 在行后添加到 android/app/src/main/java/com/YOUR_APP/app/MainApplication.java 内部 onCreate 方法,替换 productId 财务报告和审定财务报表 token 可见于您的 设置页面。 。 。 .
import com.celloreactnative.CelloReactNativeModule; //  <-- Add this line

// ...

@Override
public void onCreate() {
  super.onCreate();
  SoLoader.init(this, /* native exopackage */ false);

  // ...

  CelloReactNativeModule.initialize("productId", "token"); // <-- Add this line

  // ...
}
  • 打开 android/build.gradle 更改 minSdkVersion 改为 21国, (中文(简体) ), compileSdkVersion 至少改为 页:1 财务报告和审定财务报表 targetSdkVersion 至少改为 页:1
buildscript {
    // ...
    ext {
        buildToolsVersion = "29.0.2"
        minSdkVersion = 21 // <-- Here
        compileSdkVersion = 34 // <-- Here
        targetSdkVersion = 34 // <-- Here
    }
    // ...
}
  • 单位 android/build.gradle 确保 com.android.tools.build:gradle 版本大于 8.1.1
dependencies {
    classpath("com.android.tools.build:gradle:8.1.1")
    // ...
}

Android: 权限

你需要包括 互联网 权限在 android/app/src/main/AndroidManifest.xml数字 :

<uses-permission android:name="android.permission.INTERNET" />

监督办

IOS的 Cello 需要一个 最低iOS版本15.

cd ios
pod install
cd ..

如果您正在使用 React Industrial v. 0. 60 或以上,则库会自动链接而无需采取任何步骤.

IOS SDK (英语:CelloSDK.xcframework这个包裹里面的船, 所以没有什么可补充的 Podfile。不要添加 CelloSDK 通过 Podfile 或 Swift 软件包管理器 : 应用程序可以得到两个框架副本 。 与一个 pod 'CelloSDK' 线条, pod install 停止为 target has frameworks with conflicting names: cellosdk.xcframework; 删除该行.

iOS: 设置

  • 打开 ios/AppDelegate.m 然后增加以下代码:

  • 在文件上方添加以下内容:

#import "AppDelegate.h"
#import <React/RCTBridge.h>
#import <React/RCTBundleURLProvider.h>
#import <React/RCTRootView.h>
// ...
#import <CelloReactNative.h> // <-- Add This
  • 内部 didFinishLaunchingWithOptions 在此之前 return YES 添加, 请记住替换 productId 财务报告和审定财务报表 token 可见于您的 凯洛门户数字 :
  // ...
  self.window.rootViewController = rootViewController;

  [CelloReactNative initialize:for@"productId" with:@"token"]; // <-- Add this (Remember to replace strings with your product id and token)

  return YES;
  }

博览

如果您正在使用 Expo, 您可以使用内置插件 .

在安装此软件包后, 添加 配置插件 页:1 plugins 您的数组 app.json 或者说 app.config.js数字 :

{
  "expo": {
    "plugins": ["@getcello/cello-react-native"]
  }
}

该插件提供了设置环境的道具. 每次更换道具或插件,都需要重建(并 prebuild(原始内容存档于2018-10-10). ). 本地应用. 如果没有添加额外的属性,则使用默认值.

  • env (单位:千美元)字符串:设定为您想要的环境,例如: prod, (中文(简体) ), sandbox. 可选。 默认为 prod。 。 。 .
{
  "expo": {
    "plugins": [
      [
        "@getcello/cello-react-native",
        {
          "env": "sandbox"
        }
      ]
    ]
  }
}

接下来,重建您的应用程序,如 "添加风俗本土代码" 向导.


方法

导入

import Cello from '@getcello/cello-react-native';


Cello.initialize()

初始化您产品中的 Cello 推荐组件

API 样式

这个 initialize 方法支持两种调用样式:

import Cello from '@getcello/cello-react-native';

const config = await Cello.initialize({
  productId: 'your-product-id',
  token: 'your-token',
  productUserDetails: {
    firstName: 'John',
    lastName: 'Doe',
    fullName: 'John Doe',
    email: '[email protected]',
  },
});

2. 基于争论的API(Legacy - 仍然支持)

const config = await Cello.initialize('your-product-id', 'your-token');

初始化选项

财产类型需求说明
产品标识字符串对Cello门户网站上的你产品ID
符号字符串对用户认证符
产品用户详情产品用户详情没有用户细节对象(见下文)

产品用户详情

有用户信息的可选对象 :

财产类型说明
第一个Name字符串用户名
最后一个Name字符串用户姓
完整Name字符串用户的全名
电子邮件字符串用户的电子邮件地址

回返

Promise<configuration>


Cello.showFab()

显示启动推荐组件的浮动动作按钮或书签


Cello.hideFab()

隐藏启动推荐组件的浮动动作按钮或书签


Cello.openWidget()

打开移交组件


Cello.hideWidget()

关闭移交部分


Cello.shutdown()

关闭移交部分


Cello.getActiveUcc()

获取当前登录用户的 ucc 和邀请链接的方法 .

回返

{ ucc, link }


Cello.getCampaignConfig()

获得你产品竞选配置的方法.

回返

Promise<campaignConfig | null>

返回具有以下属性的运动配置对象 :

  • primaryCurrency (字符串):主货币代码
  • revenuePercentage (数目):作为奖励支付的指定新收入的百分比
  • rewardCap (数目):每个转介机构可获得的最高奖励
  • newSignupBonus (数目):为鼓励更多分享的报名提供额外奖励
  • newPurchaseBonus (数目):额外奖励购买,鼓励更多分享
  • newUserDiscountMonth (数目):新用户获得折扣的时间长短
  • newUserDiscountPercentage (数目):新用户得到的折扣

回返 null 如果 SDK 没有初始化,或者没有竞选配置.


Cello.updateToken(token)

更新标志并进行验证.

选项

类型类型需求
符号字符串对

回返

Promise<configuration>


Cello.changeLanguage(language)

一种在不重新初始化的情况下在运行时更改移案部分语言的方法.

选项

类型类型需求
语言字符串对

使用量

检查示例应用程序


解决问题

  • 这个工程使用AndroidX依赖性,但“android.useAndroidX”属性没有启用 .

    • 启用 jetifier,将这两行添加到您的 gradle.properties 文件 :
      android.useAndroidX=true
      android.enableJetifier=true
      
  • 当Android应用持续停止(E/AndroidRuntime:FATAL EXCEPTION: mqt native modules)时

    • 将这些行添加到 dependencies 内 ./android/app/build.gradle数字 :
      implementation 'androidx.appcompat:appcompat:1.6.1'
      
  • 当使用 Jest 的测试未提及“ 无法读取未定义的属性 ” 时

    • 做一个 jest.mock 用于库的函数 :
      // jest/setup.ts
      jest.mock('@getcello/cello-react-native', () => jest.fn());
      

作者

👤 塞罗( Cello )https://www.cello.so/ (中文(简体) )(中文(简体) )

显示您的支持

如果这个计划能帮助你的话,就给你一个!

许可证

这个项目是 麻省理工学院 有执照.


由QQ 创建 塞罗

版本与发布记录

@getcello/cello-react-native 共发布 52 个版本,首次发布于 2024/04/27;过去 12 个月发布了 11 个版本。

版本发布日期距今
0.17.0latest2026/11/124 天前
0.17.0-rc.0rc2026/11/124 天前
0.16.02026/10/061 个月前
0.15.12026/09/301 个月前
0.15.02026/09/092 个月前
0.15.0-rc.02026/09/092 个月前

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

@getcello/cello-react-native 是什么?

反应原生包装以桥接iOS和Android SDK

如何安装 @getcello/cello-react-native?

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

@getcello/cello-react-native 支持 TypeScript 吗?

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

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

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

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

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

@getcello/cello-react-native 可以商用吗?

@getcello/cello-react-native 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

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

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

@getcello/cello-react-native 还在维护吗?

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