React Native Coucon SDK：TurboModule 安全认证集成指南与 API 参考

react-native-coucon-sdk by boostbrothers/agent-skills

1 周安装量

GitHub

安装命令

npx skills add https://github.com/boostbrothers/agent-skills --skill react-native-coucon-sdk

React 移动应用安全

🇨🇳中文介绍

React Native Coucon SDK

@boostbrothers/react-native-coucon-sdk — 一个基于 TurboModule 的 SDK，用于在 React Native 中使用 Coucon SAS（安全认证服务）认证引擎。

何时应用

在以下情况下参考此技能：

实现 Coucon SAS 认证时
集成基于 TurboModule 的原生模块时
使用基于 NativeEventEmitter 事件的异步模式时

架构

    应用 (React Native)
      ↓ initialize() / run()
      ↓ addOnSASRunCompletedListener()
    CouconSdk (TurboModule)
      ↓ TurboModuleRegistry
    iOS/Android 原生 SAS 引擎
      ↓ 事件发射
    NativeEventEmitter (onSASRunCompleted)
      ↓ { index, outString }
    应用

⚠️ 关键：监听器注册顺序

务必先注册监听器，然后再调用 run()。

run() 会立即返回，但结果是通过 onSASRunCompleted 事件异步传递的。在没有监听器的情况下调用 run() 将无法接收结果。

API 参考

initialize()

初始化 SAS 引擎。在应用启动时调用一次。

import { CouconSdk } from '@boostbrothers/react-native-coucon-sdk';

await CouconSdk.initialize();

🇺🇸English

React Native Coucon SDK

@boostbrothers/react-native-coucon-sdk — Coucon SAS(Security Authentication Service) 인증 엔진을 React Native에서 사용하는 TurboModule 기반 SDK.

When to Apply

Reference this skill when:

Coucon SAS 인증을 구현할 때
TurboModule 기반 네이티브 모듈 연동 시
NativeEventEmitter 이벤트 기반 비동기 패턴 사용 시

Architecture

앱 (React Native)
  ↓ initialize() / run()
  ↓ addOnSASRunCompletedListener()
CouconSdk (TurboModule)
  ↓ TurboModuleRegistry
iOS/Android 네이티브 SAS 엔진
  ↓ 이벤트 방출
NativeEventEmitter (onSASRunCompleted)
  ↓ { index, outString }
앱

⚠️ CRITICAL: 리스너 등록 순서

반드시 리스너를 먼저 등록한 후 run()을 호출하세요.

run()은 즉시 반환되지만 결과는 onSASRunCompleted 이벤트로 비동기 전달됩니다. 리스너 없이 run()을 호출하면 결과를 받을 수 없습니다.

API Reference

initialize()

SAS 엔진을 초기화합니다. 앱 시작 시 한 번 호출.

import { CouconSdk } from '@boostbrothers/react-native-coucon-sdk';

await CouconSdk.initialize();

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

addOnSASRunCompletedListener(callback)

const subscription = CouconSdk.addOnSASRunCompletedListener(
  ({ index, outString }) => {
    console.log(`SAS 完成 - index: ${index}, result: ${outString}`);
  }
);

// 组件卸载时清理
return () => subscription.remove();

运行 SAS 引擎。结果通过事件异步传递。

// ⚠️ 务必在注册监听器后调用！
CouconSdk.run(0, 'input-string');

import { useEffect } from 'react';
import { CouconSdk } from '@boostbrothers/react-native-coucon-sdk';

function useCouconAuth() {
  useEffect(() => {
    // 1. 初始化
    CouconSdk.initialize();

    // 2. 注册监听器（先于 run！）
    const subscription = CouconSdk.addOnSASRunCompletedListener(
      ({ index, outString }) => {
        // 4. 接收结果
        handleAuthResult(index, outString);
      }
    );

    // 3. 执行
    CouconSdk.run(0, 'auth-input');

    return () => subscription.remove();
  }, []);
}

onSASRunCompleted 事件数据：

字段	类型	描述
index	number	传递给 run() 的索引值
outString	string	SAS 引擎处理结果字符串

监听器未收到事件：检查是否在调用 run() 之前注册了监听器。确保在异步初始化完成后调用 run()。

TurboModule 加载失败：检查 React Native New Architecture 设置。确保 android/gradle.properties 中设置了 newArchEnabled=true。

initialize() 失败：检查原生 SAS 引擎库是否正确链接到项目中。

重复接收事件：检查是否使用 subscription.remove() 清理了之前的监听器。在 useEffect 的清理函数中调用 remove()。

平台	支持
iOS	✅
Android	✅
Web	❌

addOnSASRunCompletedListener(callback)

SAS 실행 완료 이벤트 리스너를 등록합니다.

const subscription = CouconSdk.addOnSASRunCompletedListener(
  ({ index, outString }) => {
    console.log(`SAS 완료 - index: ${index}, result: ${outString}`);
  }
);

// 컴포넌트 언마운트 시 정리
return () => subscription.remove();

SAS 엔진을 실행합니다. 결과는 이벤트로 비동기 전달.

// ⚠️ 반드시 리스너 등록 후 호출!
CouconSdk.run(0, 'input-string');

Complete Usage Example

import { useEffect } from 'react';
import { CouconSdk } from '@boostbrothers/react-native-coucon-sdk';

function useCouconAuth() {
  useEffect(() => {
    // 1. 초기화
    CouconSdk.initialize();

    // 2. 리스너 등록 (run보다 먼저!)
    const subscription = CouconSdk.addOnSASRunCompletedListener(
      ({ index, outString }) => {
        // 4. 결과 수신
        handleAuthResult(index, outString);
      }
    );

    // 3. 실행
    CouconSdk.run(0, 'auth-input');

    return () => subscription.remove();
  }, []);
}

onSASRunCompleted 이벤트 데이터:

Field	Type	Description
index	number	run()에 전달한 인덱스 값
outString	string	SAS 엔진 처리 결과 문자열

리스너에 이벤트가 오지 않음 : run() 호출 전에 리스너를 등록했는지 확인. 비동기 초기화 완료 후 run() 호출.

TurboModule 로드 실패 : React Native New Architecture 설정 확인. android/gradle.properties에 newArchEnabled=true.

initialize() 실패 : 네이티브 SAS 엔진 라이브러리가 프로젝트에 올바르게 링크되었는지 확인.

이벤트 중복 수신 : subscription.remove()로 이전 리스너를 정리했는지 확인. useEffect cleanup에서 remove() 호출.

Platform	Support
iOS	✅
Android	✅
Web	❌

xdrop 文件传输脚本：Bun 环境下安全上传下载工具，支持加密分享

27,100 周安装

React Native Coucon SDK：TurboModule 安全认证集成指南与 API 参考

🇨🇳中文介绍

React Native Coucon SDK

何时应用

架构

⚠️ 关键：监听器注册顺序

API 参考

initialize()

🇺🇸English

React Native Coucon SDK

When to Apply

Architecture

⚠️ CRITICAL: 리스너 등록 순서

API Reference

initialize()

相关 Skills

addOnSASRunCompletedListener(callback)

run(index, input)

完整使用示例

事件结构

故障排除

平台支持

addOnSASRunCompletedListener(callback)

run(index, input)

Complete Usage Example

Event Structure

Troubleshooting

Platform Support

最新 Skills