@aibee/rn-nav-sdk

@aibee/rn-nav-sdk 是一个面向第三方接入的 React Native 导航 SDK。

它通过 NavWebview 组件为 WebView 中的 H5 页面注入导航相关的原生能力，支持在 iOS 和 Android 上承载导航页面加载与设备能力接入。

安装

SDK 依赖 react-native-webview，请一并安装：

pnpm add @aibee/rn-nav-sdk react-native-webview

使用 iOS 时还需要：

cd ios && pod install

NavWebview 参数

NavWebview 继承 react-native-webview 的 WebViewProps，原生属性（source、style、onLoadEnd、javaScriptEnabled 等）直接透传。SDK 参数如下：

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | source | WebViewProps['source'] | 是 | H5 页面地址。使用自动寻车流程时 URL 需带 from=1 参数 | | back | () => void | 是 | 路由返回方法，由宿主实现（SDK 不集成路由）。H5 通过 JSBridge AIBEENav.back() 触发 | | searchConfig | OnSearchNavigationConfig | 是 | 结构 { range, coordinates, parkingLotId? }：range 为室内范围多边形顶点，coordinates 为候选目标点，均为高德 GCJ-02 坐标 | | sdkConfig | Partial<SDKConfig> | 是 | { gaodeAndroidAppKey, gaodeIOSAppKey, gaodeRegion? }。App Key 从高德开放平台申请 gaodeRegion 取 'MAINLAND' \| 'HONG_KONG' | | h5PreloadRemainingTimeThreshold | number | 否 | 高德导航剩余时间 ≤ 该值（秒）时预加载室内 H5 ，默认 30 |

示例

import { NavWebview } from '@aibee/rn-nav-sdk';
import type { OnSearchNavigationConfig } from '@aibee/rn-nav-sdk';

const searchConfig: OnSearchNavigationConfig = {
  range: [
    { latitude: 40.076546, longitude: 116.245131 },
    { latitude: 40.076807, longitude: 116.245755 },
    { latitude: 40.075602, longitude: 116.245552 },
    { latitude: 40.075799, longitude: 116.2463 },
  ],
  coordinates: [{ latitude: 40.076152, longitude: 116.245494 }],
};

<NavWebview
  source={{ uri: 'https://your-h5-url?from=1' }}
  back={() => navigation.goBack()}
  searchConfig={searchConfig}
  sdkConfig={{
    gaodeAndroidAppKey: '<your-android-key>',
    gaodeIOSAppKey: '<your-ios-key>',
    gaodeRegion: 'MAINLAND',
  }}
/>

其余 props（事件回调、onLog 调试日志、loadingComponent 自定义 loading 等）均为可选，按需参阅 NavWebviewProps 类型定义（src/components/NavWebview.tsx）。

平台配置

iOS（必需）

在宿主应用 Info.plist 中添加：

<!-- 后台定位模式（缺失会触发断言崩溃） -->
<key>UIBackgroundModes</key>
<array>
    <string>location</string>
</array>

<!-- 定位权限描述 -->
<key>NSLocationWhenInUseUsageDescription</key>
<string>需要获取您的位置信息用于寻车导航和室内定位</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要获取您的位置信息用于后台导航和室内定位</string>

<!-- 蓝牙权限描述（iBeacon 室内定位） -->
<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要蓝牙权限用于扫描 iBeacon 进行室内定位</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>需要蓝牙权限用于扫描 iBeacon 进行室内定位</string>