react-native-coucon-sdk by boostbrothers/agent-skills
npx skills add https://github.com/boostbrothers/agent-skills --skill react-native-coucon-sdk@boostbrothers/react-native-coucon-sdk — 一个基于 TurboModule 的 SDK,用于在 React Native 中使用 Coucon SAS(安全认证服务)认证引擎。
在以下情况下参考此技能:
应用 (React Native)
↓ initialize() / run()
↓ addOnSASRunCompletedListener()
CouconSdk (TurboModule)
↓ TurboModuleRegistry
iOS/Android 原生 SAS 引擎
↓ 事件发射
NativeEventEmitter (onSASRunCompleted)
↓ { index, outString }
应用
务必先注册监听器,然后再调用 run()。
run()会立即返回,但结果是通过onSASRunCompleted事件异步传递的。在没有监听器的情况下调用 run() 将无法接收结果。
初始化 SAS 引擎。在应用启动时调用一次。
import { CouconSdk } from '@boostbrothers/react-native-coucon-sdk';
await CouconSdk.initialize();
@boostbrothers/react-native-coucon-sdk — Coucon SAS(Security Authentication Service) 인증 엔진을 React Native에서 사용하는 TurboModule 기반 SDK.
Reference this skill when:
앱 (React Native)
↓ initialize() / run()
↓ addOnSASRunCompletedListener()
CouconSdk (TurboModule)
↓ TurboModuleRegistry
iOS/Android 네이티브 SAS 엔진
↓ 이벤트 방출
NativeEventEmitter (onSASRunCompleted)
↓ { index, outString }
앱
반드시 리스너를 먼저 등록한 후 run()을 호출하세요.
run()은 즉시 반환되지만 결과는onSASRunCompleted이벤트로 비동기 전달됩니다. 리스너 없이 run()을 호출하면 결과를 받을 수 없습니다.
SAS 엔진을 초기화합니다. 앱 시작 시 한 번 호출.
import { CouconSdk } from '@boostbrothers/react-native-coucon-sdk';
await CouconSdk.initialize();
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
注册 SAS 运行完成事件监听器。
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 | ❌ |
每周安装量
1
仓库
首次出现
今天
安全审计
安装于
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
SAS 실행 완료 이벤트 리스너를 등록합니다.
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 이벤트 데이터:
| 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 | ❌ |
Weekly Installs
1
Repository
First Seen
Today
Security Audits
Installed on
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
xdrop 文件传输脚本:Bun 环境下安全上传下载工具,支持加密分享
27,100 周安装