react-native-beidou 1.0.4 → 1.0.6

package/Compass.ios.tsx

@@ -0,0 +1,15 @@
+import React from 'react';
+import { requireNativeComponent, ViewStyle } from 'react-native';
+
+type CompassProps = {
+    style?: ViewStyle;
+    onHeadingChange?: (event: { nativeEvent: { radians: number; degrees: number } }) => void;
+};
+
+const CompassNativeView = requireNativeComponent<CompassProps>('CompassView');
+
+const Compass: React.FC<CompassProps> = (props) => {
+    return <CompassNativeView {...props} />;
+};
+
+export default Compass;

package/Compass.tsx

@@ -0,0 +1,6 @@
+// Compass.tsx
+import { Platform } from 'react-native';
+import CompassIOS from './Compass.ios';
+import CompassAndroid from './Compass.android';
+
+export default Platform.OS === 'ios' ? CompassIOS : CompassAndroid;

package/README.md

@@ -1,154 +1,78 @@
-# RN 项目
+# React Native 北斗蓝牙 SDK（react-native-beidou）
 
-开发分支: h5-dev
+## 安装
 
-环境搭建：https://reactnative.cn/docs/environment-setup
-
-react 中文网：https://www.php.cn/doc/react/index.html 学习函数组件、类组件可以先不学
-
-es6 教程：https://www.runoob.com/w3cnote
-
-useMock：https://www.usemock.com/login >>>>>>>>>在【useMock 协作项目】
-
-UI 库: https://rn.mobile.ant.design/docs/react/introduce-cn 版本：`5.2.3`
-
-开发工具： vscode, 插件：eslint(自动格式化)、react-native-snippets(代码提示)
-
-.vscode 可以扩展自定义模板，现有创建组件模板 rnc 指令
-
-`node: v18.17.1`  
-`yarn: 1.22.22`
-
-新建页面、组件规范： pages、components、assets 以页面维度划分
-
-# 安卓 gif 与 webp 支持
+```bash
+yarn add react-native-beidou  
+```
 
-项目的 android 目录输入
-cd android
-.\gradlew app:dependencies --configuration releaseRuntimeClasspath
+### iOS
 
-# 常用脚本
+在 `ios/Podfile` 中确保加入：
 
-```
-   "mock": "nodemon ./mock/mock.js",
-    "android": "gulp dev-android",
-    "ios": "gulp dev-ios",
-    "start": "gulp dev-start",
-    "test": "jest",
-    "build": "gulp default",
-    "upload": "gulp upload",
-    "build:dll-custom": "gulp build-custom",
-    "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
-    "bundle:analysis": "react-native-bundle-visualizer"
+```ruby
+pod 'react-native-beidou', :path => '../node_modules/react-native-beidou'
 ```
 
-例如
+执行：
 
-```
-开发启动命令
-yarn android --pageName=页面名称
-页面名称：src/pages下的页面入口文件名（不带后缀）
-
-
-使用metro配置自定义拆包：
-业务包（页面级别）可以直接使用页面名字，如Demo。打包配置走metro.main.config.js；
-非业务包（包括node_modules里的第三方插件、utils自定义公共方法）需要在custom.config.js里配置。打包配置走metro.common.config.js
-输出：bundle/(ios|android)-${pageName}
-splitCache: 打包信息缓存，目前之缓存非业务包信息，带_origin为路径信息缓存，不带的是打包id缓存
-yarn build:dll-custom --pageName=dll
-yarn build:dll-custom --pageName=utils
-yarn build:dll-custom --pageName=Demo
-
-添加参数：
---pageName=<页面名称>  指定要打包的页面名称（必填）
---ios                只打iOS包，不打Android包
---android            只打Android包，不打iOS包
---sourceMap          生成sourcemap文件，用于错误堆栈符号化
-
-示例：
-yarn build:dll-custom --pageName=Demo1 --ios --sourceMap
+```bash
+cd ios && pod install
 ```
 
-# js 能力相关的
+注意：
+- 本库通过 `vendored_frameworks` 引入 `BeidouBluetooth.framework`，无需额外拷贝。
+- 最低平台版本需满足 iOS 15.6（来自 `react-native-beidou.podspec`）。
 
-1.如果依赖 js 能力的数据，可以用 async await
+### Android
 
-2.不依赖的话，用.then 的方式或者不需要接收的方式，防止阻塞后面代码执行
+采用 RN Autolinking，无需手动修改。若出现无法自动链接，可检查本库提供的 `react-native.config.js`：
 
+```js
+packageImportPath: "import com.cmcc_rn_module.BeiDouBluetoothPackage;",
+packageInstance: "new com.cmcc_rn_module.BeiDouBluetoothPackage()"
 ```
-// js能力调用方法
-    try {
-      const data = await callNativeMethod({
-        businessName: 'userStatus',
-        debug: false,
-        ...剩余参数(不要传success和error),
-      });
-      // succes回调
-      console.log('%c Line:141 🍰 data', 'color:#7f2b82', data);
-    } catch (error) {
-      // error回调
-      console.log('%c Line:148 🍰 error', 'color:#b03734', error);
-    }
-
-// 参考商城写法
-// useInfo 更新调用接口
-  useEffect(() => {
-    !!userInfo && getData();
-  }, [userInfo]);
-
-  useEffect(() => {
-    // 强登isForceLogin
-    loginInfo({isForceLogin: false}).then((res: any) => {
-      setUserInfo(res);
-    });
-  }, []);
-```
-
-# 开发在线调试
-
-1.yarn build
-
-2.yarn upload 上传 jsbundle 到服务器
 
-3.客户端设置页输入 jsbundle 地址，开启调试模式
+库内已包含 `android/libs/bluetooth-sdk.aar`，通常无需额外配置。
 
-# 本地 mock
+---
 
-启动命令 `yarn mock`
+## 权限与配置
 
-根据 data 里的 json 文件名自动创建路由，修改文件自动启动服务
+### Android 权限（必配）
 
-例如
+在宿主应用 `android/app/src/main/AndroidManifest.xml` 中添加（按系统版本动态申请）：
 
-users.json => http://localhost:3000/api/users
+```xml
+<!-- Android 12+ -->
+<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
+<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
 
-# 注意事项
+<!-- Android 6.0+ 扫描需要位置权限 -->
+<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
 
-1. 定时器相关的，都要有清除逻辑，不然会报内存泄漏, 接收的地方都用 ref
-2. 页面如果要用不涉及更新的全局变量，不要写在组件外面，都用 ref
-3. `react-native-swiper`组件废弃，新页面采用`react-native-reanimated-carousel`
+<!-- WiFi 名称读取（可选） -->
+<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
 
-# 符号化错误堆栈（Symbolication）
-
-当React Native应用崩溃时，错误堆栈通常包含混淆后的代码位置，使调试变得困难。使用symbolicate命令可以将这些位置转换为源代码中的实际位置。
+<!-- 建议配置，声明低功耗蓝牙能力 -->
+<uses-feature android:name="android.hardware.bluetooth_le" android:required="false" />
+```
 
-使用方法： 文件路径相对于工程根目录
+混淆（如启用 ProGuard/R8）建议保留：
 
-```
-yarn symbolicate --sourcemap=<sourcemap文件路径> --stack=<错误堆栈文件路径>
+```proguard
+-keep class com.beidou.bluetooth.** { *; }
+-keep class com.cmcc_rn_module.** { *; }
 ```
 
-参数说明：
-- `--sourcemap`：指定sourcemap文件的路径，例如：`CT00010.jsbundle.map`。该文件是在打包时生成的，包含源代码和打包后代码的映射关系。
-- `--stack`：指定包含错误堆栈信息的文本文件路径，例如：`error.txt`。该文件包含应用崩溃时的错误堆栈信息。
+### iOS 权限（Info.plist）
 
-注意事项：
-- 打包时需要添加`--sourceMap`参数才会生成sourcemap文件，例如：`yarn build --sourceMap`或`yarn build:dll-custom --pageName=Demo --sourceMap`
-- 符号化过程使用`metro-symbolicate`工具，会自动将混淆后的代码位置映射回源代码位置
+根据实际需要添加：
 
-示例：
+```xml
+<key>NSBluetoothAlwaysUsageDescription</key>
+<string>需要使用蓝牙与北斗终端通信</string>
+<key>NSLocationWhenInUseUsageDescription</key>
+<string>用于蓝牙扫描或获取WiFi信息</string>
 ```
-yarn symbolicate --sourcemap=CT00010.jsbundle.map --stack=error.txt
-```
-
-执行后，将输出符号化后的错误堆栈信息，帮助开发者快速定位问题所在位置。

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -1,2 +1,2 @@
-#Tue Sep 16 15:41:38 CST 2025
-gradle.version=8.9
+#Fri Oct 24 11:21:51 CST 2025
+gradle.version=8.10

package/android/src/main/java/com/cmcc_rn_module/BeiDouBluetoothModule.java

@@ -143,7 +143,7 @@ public class BeiDouBluetoothModule extends ReactContextBaseJavaModule {
 
     // 开始扫描蓝牙设备
     @ReactMethod
-    public void startScanForService() {
+    public void startScanForService(Callback callback) {
         BluetoothSDK instance = BluetoothSDK.getInstance(reactContext);
         Log.d("BluetoothSDK", "MyModule-> 开始扫描");
         instance.startScan();

package/index.ts

@@ -80,7 +80,7 @@ export interface MessageInfo {
 interface BeiDouBluetoothModuleType {
   // 原有蓝牙相关方法
   getAllConversations(): Promise<string>; // 更新为Promise版本
-  startScanForService(): void;
+  startScanForService(callback: (res: number) => void): void;
   stopScanning(): void;
   getDiscoveredDevices(): Promise<string>; // JSON string of BlueDeviceInfoEntity[]
   connectToDeviceFromCloudDeviceNO(deviceNO: string, a: number): Promise<'ok' | 'fail'>;
@@ -89,7 +89,7 @@ interface BeiDouBluetoothModuleType {
   shouldShowBlueToothPermissionRationale(params: string, callback: (status: BluetoothPermissionRationaleStatus) => void): void;
   initializeBluetooth(callback: (status: BluetoothStatus) => void): void;
   generateRandom16BytesString(): string;
-  writeData(randomString: string, deviceNo: string, command: number, attrType: number, encrypt: boolean, callback: (result: number) => void): void;
+  writeData(randomString: string, deviceNo: string, command: number, attrType: number, callback: (result: number) => void): void;
 
   // 新增的iOS兼容方法
   writeInfo(base64Payload: string | null, deviceNO: string, command: number, opCode: number, attrType: number, encrypted: boolean): Promise<WriteInfoResponse>;
@@ -355,8 +355,8 @@ export const setBeiDouBLEKey = async (bleKey: string): Promise<boolean> => {
 export const BeiDouModule = {
   // 蓝牙相关
   bluetooth: {
-    startScan: () => BeiDouBluetoothModule.startScanForService(),
-    startScanIOS: (callback: (result: number) => void) => BeiDouBluetoothModule.startScanForService(callback),
+    // startScan: () => BeiDouBluetoothModule.startScanForService(),
+    startScan: (callback: (result: number) => void) => BeiDouBluetoothModule.startScanForService(callback),
     stopScan: () => BeiDouBluetoothModule.stopScanning(),
     getDevices: getDiscoveredDevicesArray,
     connect: (deviceNo: string) => BeiDouBluetoothModule.connectToDeviceFromCloudDeviceNO(deviceNo, 0),

package/ios/BeiDouBluetoothModule.m

@@ -152,7 +152,7 @@ RCT_EXPORT_METHOD(writeData:(NSString *)base64String
                                         deviceId:deviceNO
                                          command:commandValue
                                           opcode:0
-                                        attrType:attrType
+                                        attrType:0
                                        encrypted:isEncrypted
                                         callback:^(NSInteger result) {
     if (result == 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-beidou",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "A React Native module for BeiDou Bluetooth communication.",
   "main": "index.ts",
   "types": "index.ts",
@@ -10,6 +10,8 @@
     "ios",
     "index.ts",
     "Compass.android.tsx",
+    "Compass.ios.tsx",
+    "Compass.tsx",
     "react-native.config.js",
     "BeiDouAIDLTestPage.tsx",
     "TestPage.ts"