配置- 插件/ 反应- 本地化- ble- 插件

自动配置的配置插件 react-native-ble-plx 当本地代码生成时( w)npx expo prebuild) (中文(简体) ). 上游 PR。 。 。 .

博览会安装

已测试反对世博会SDK 49

此软件包不能用于“ Expo Go” 应用程序, 因为 它需要自定义本地代码。 。 。 . 首先用纱线、 npm 或 npx expo install。 。 。 .

npx expo install react-native-ble-plx @config-plugins/react-native-ble-plx

安装此 npm 软件包后, 添加 配置插件 页:1 plugins 您的数组 app.json 或者说 app.config.js数字 :

{
  "expo": {
    "plugins": ["@config-plugins/react-native-ble-plx"]
  }
}

接下来,重建您的应用程序,如 "添加风俗本土代码" 向导.

API 密码

该插件为额外的定制提供了道具. 每次更换道具或插件,都需要重建(并 prebuild(原始内容存档于2018-10-10). ). 本地应用. 如果没有添加额外的属性,则使用默认值.

• isBackgroundEnabled (单位:千美元)布尔: 在Android上启用背景BLE支持. 添加数 <uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/> 页:1 AndroidManifest.xml默认 false。 。 。 .
• neverForLocation (单位:千美元)布尔: 只有当您能够强烈断言您的应用程序从不从蓝牙扫描结果中获得物理位置时,才设定为真实. 更古老的Android设备仍需要定位许可. 注意,一些BLE信标是从扫描结果中过滤出来的. Android SDK 31+ (英语). 默认 false。 。 。 . 警告:这个参数是实验性的,BLE可能行不通. 保证在释放到生产前进行测试.
• modes (单位:千美元)字符串 []: 添加iOS UIBackgroundModes 页:1 Info.plist选项如下: peripheral,以及 central。默认为未定义.
• bluetoothAlwaysPermission (单位:千美元)字符串 qq 错误: 设置iOS NSBluetoothAlwaysUsageDescription 权限消息到 Info.plist设置 false 将跳过添加权限。 默认为 Allow $(PRODUCT_NAME) to connect to bluetooth devices。 。 。 .

Expo SDK 48支持iOS 13+,这意味着 NSBluetoothPeripheralUsageDescription 完全贬值。 已经不在了 @config-plugins/[email protected] 更伟大.

示例

{
  "expo": {
    "plugins": [
      [
        "@config-plugins/react-native-ble-plx",
        {
          "isBackgroundEnabled": true,
          "modes": ["peripheral", "central"],
          "bluetoothAlwaysPermission": "Allow $(PRODUCT_NAME) to connect to bluetooth devices"
        }
      ]
    ]
  }
}