react-native-beidou 1.0.3 → 1.0.5

package/BeiDouAIDLTestPage.tsx

@@ -39,10 +39,10 @@ const BeiDouAIDLTestPage: React.FC = () => {
   const [ephemerisType, setEphemerisType] = useState('GPS');
   const [ephemerisVersion, setEphemerisVersion] = useState('1.0.0');
   const [decryptMsg, setDecryptMsg] = useState('1,2,3,4,5');
-  
+
   // 服务配置参数
-  const [packageName, setPackageName] = useState('com.satnav.beidouservice');
-  const [actionName, setActionName] = useState('com.satnav.beidouservice.IBeidouMsgAidlInterface');
+  const [packageName, setPackageName] = useState('com.test.aidlsetvicetest');
+  const [actionName, setActionName] = useState('com.samsung.beidoupackage.BeidouMsgAidlService');
 
   const addTestResult = (method: string, success: boolean, result?: any, error?: string) => {
     const newResult: TestResult = {
@@ -67,7 +67,7 @@ const BeiDouAIDLTestPage: React.FC = () => {
         Alert.alert('错误', '请输入有效的包名和Action名');
         return;
       }
-      
+
       const result = await BeiDouModule.beidou.bindService(packageName.trim(), actionName.trim());
       setIsServiceBound(result);
       addTestResult('bindService', result, { packageName: packageName.trim(), actionName: actionName.trim(), result });
@@ -306,14 +306,14 @@ const BeiDouAIDLTestPage: React.FC = () => {
         {/* 服务配置区域 */}
         <View style={styles.inputSection}>
           <Text style={styles.sectionTitle}>服务配置</Text>
-          
+
           <View style={styles.inputGroup}>
             <Text style={styles.inputLabel}>包名 (Package Name):</Text>
             <TextInput
               style={styles.textInput}
               value={packageName}
               onChangeText={setPackageName}
-              placeholder="com.satnav.beidouservice"
+              placeholder="com.test.aidlsetvicetest"
             />
           </View>
 
@@ -323,7 +323,7 @@ const BeiDouAIDLTestPage: React.FC = () => {
               style={styles.textInput}
               value={actionName}
               onChangeText={setActionName}
-              placeholder="com.satnav.beidouservice.IBeidouMsgAidlInterface"
+              placeholder="com.samsung.beidoupackage.BeidouMsgAidlService"
             />
           </View>
         </View>

package/Compass.android.tsx

@@ -0,0 +1,20 @@
+import React from 'react';
+import {requireNativeComponent, NativeEventEmitter, NativeModules, ViewStyle} from 'react-native';
+const CompassManager = NativeModules.CompassManager;
+const CompassView = requireNativeComponent('CompassView');
+
+const CompassAndroid = ({ style, onHeadingChange }:{
+  style: ViewStyle;
+  onHeadingChange: (r:string)=>void
+}) => {
+  const eventEmitter = new NativeEventEmitter(CompassManager);
+
+  React.useEffect(() => {
+    const subscription = eventEmitter.addListener('onCompassUpdate', onHeadingChange);
+    return () => subscription.remove();
+  }, [onHeadingChange]);
+
+  return <CompassView style={style} />;
+};
+
+export default CompassAndroid;

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 @@
-#Fri Aug 15 17:28:01 CST 2025
+#Tue Sep 16 15:41:38 CST 2025
 gradle.version=8.9

package/android/.idea/AndroidProjectSystem.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AndroidProjectSystem">
+    <option name="providerId" value="com.android.tools.idea.GradleProjectSystem" />
+  </component>
+</project>

package/android/.idea/gradle.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="GradleMigrationSettings" migrationVersion="1" />
+  <component name="GradleSettings">
+    <option name="linkedExternalProjectsSettings">
+      <GradleProjectSettings>
+        <option name="testRunner" value="CHOOSE_PER_TEST" />
+        <option name="externalProjectPath" value="$PROJECT_DIR$" />
+        <option name="gradleJvm" value="#GRADLE_LOCAL_JAVA_HOME" />
+      </GradleProjectSettings>
+    </option>
+  </component>
+</project>

package/android/.idea/migrations.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectMigrations">
+    <option name="MigrateToGradleLocalJavaHome">
+      <set>
+        <option value="$PROJECT_DIR$" />
+      </set>
+    </option>
+  </component>
+</project>

package/android/.idea/misc.xml

@@ -0,0 +1,9 @@
+<project version="4">
+  <component name="ExternalStorageConfigurationManager" enabled="true" />
+  <component name="ProjectRootManager">
+    <output url="file://$PROJECT_DIR$/build/classes" />
+  </component>
+  <component name="ProjectType">
+    <option name="id" value="Android" />
+  </component>
+</project>

package/android/.idea/runConfigurations.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="RunConfigurationProducerService">
+    <option name="ignoredProducers">
+      <set>
+        <option value="com.intellij.execution.junit.AbstractAllInDirectoryConfigurationProducer" />
+        <option value="com.intellij.execution.junit.AllInPackageConfigurationProducer" />
+        <option value="com.intellij.execution.junit.PatternConfigurationProducer" />
+        <option value="com.intellij.execution.junit.TestInClassConfigurationProducer" />
+        <option value="com.intellij.execution.junit.UniqueIdConfigurationProducer" />
+        <option value="com.intellij.execution.junit.testDiscovery.JUnitTestDiscoveryConfigurationProducer" />
+        <option value="org.jetbrains.kotlin.idea.junit.KotlinJUnitRunConfigurationProducer" />
+        <option value="org.jetbrains.kotlin.idea.junit.KotlinPatternConfigurationProducer" />
+      </set>
+    </option>
+  </component>
+</project>

package/android/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+  </component>
+</project>

package/android/build.gradle

@@ -37,6 +37,9 @@ android {
         sourceCompatibility JavaVersion.VERSION_1_8
         targetCompatibility JavaVersion.VERSION_1_8
     }
+    buildFeatures {
+        aidl = true
+    }
 }
 
 repositories {

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.cmcc_rn_module">
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <!-- Android 10+ 建議聲明後台定位，如不需要可去除 -->
+    <!-- <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> -->
+</manifest>