iOS.md

iOS

Some functions are diabled by default:

• switchWifi()
• switchBluetooth()
• switchLocation()
• switchAirplane()
• isBluetoothEnabled()
• addBluetoothListener()

When you call these functions, you'll just get some warning log.

You can enable it by add a preprocessor macros.

Private API

There are some functions which start with switch:

• switchWifi()
• switchBluetooth()
• switchLocation()
• switchAirplane()

I implement them by using non-public APIs, which is not permitted on the App Store, see this issue.

These functions are disabled by default. You must not call them If your app need submit to App Store. As an alternative, you can show a tip to tell the user how to change the system setting.

Only when you'll distribute the app outside App Store, you can enable them by add a preprocessor macros PRIVATE_API.

WARNING: If you enable it and submit app to App Store, you'll definitely get a rejection from apple. In the worst case, your account will be ban!

You should add PRIVATE_API in both Debug and Release

Bluetooth

There are some bluetooth-function:

• isBluetoothEnabled()
• addBluetoothListener()

You can enable them in a few steps:

First, add preprocessor macros BLUETOOTH, either

1. Manually, or
2. Using post_install hook in Podfile (for React-Native >=0.60 with autolinking)

Manually adding a preprocessor macro:

You should add BLUETOOTH in both Debug and Release

Automatically adding a preprocessor macro via Podfile

Add post_install hook in Podfile:

  post_install do |installer|
    flipper_post_install(installer)

    ## ADD THE FOLLOWING:

    # Enables bluetooth functionality of react-native-system-setting
    installer.pods_project.targets.each do |target|
      if target.name == "RCTSystemSetting"
        target.build_configurations.each do |config|
          config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= ['$(inherited)']
          if !config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'].include? 'BLUETOOTH'
            puts 'Adding BLUETOOTH in GCC_PREPROCESSOR_DEFINITIONS of Pod RCTSystemSetting...'
            config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] << 'BLUETOOTH'
          end
        end
      end
    end
  end

Then open Info.plist as source code.

Finally, add NSBluetoothPeripheralUsageDescription in Info.plist, see Info.plist - example

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  
  ...
  
  <key>NSBluetoothPeripheralUsageDescription</key>
  <string>Explain the reasons for accessing...</string>
  
</dict>
</plist>

You can change the string as you need