@ 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 方法支持两种调用样式:
1. 基于对象的API(建议 - 新建)
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 创建 塞罗