Juliet Levesque
6f69e97421
CancellationFlags will be used to prevent crashes during the shutdown of Nearby Connections from pending tasks taking too long during the shutdown period. By using CancellationFlags, we can prevent the retries occuring during the Shutdown by short-circuiting an in flight AttemptToConnect, and checking for Cancellation before retries. Because BluetoothClassic does not use futures, the short circuit only requires a check after ConnectToService, and returning an empty socket. PiperOrigin-RevId: 539755631
Nearby Connection
Nearby Connections is a high level protocol on top of Bluetooth/WiFi that acts as a medium-agnostic socket. Devices are able to advertise, scan, and connect with one another over any shared medium (eg. BT <-> BT). Once connected, the two devices share a list of all supported mediums and attempt to upgrade to the one with the highest bandwidth (eg. BT -> WiFi). The connection is encrypted, reliable, and fully duplex. BYTE, FILE, and STREAM payloads are all supported and will be chunked & transferred internally and recombined on the receiving device. See Nearby Connections Overview for more information.
Checkout the source tree
git clone https://github.com/google/nearby
cd nearby
git submodule update --init --recursive
Building Nearby, Unit Testing and Sample Apps
We support multiple platforms including Linux, iOS & Windows.
Building for Linux
NOTE: Linux has no mediums implemented.
Currently we support building from source using [bazel] (https://bazel.build). Other BUILD system such as cmake may be added later.
Prerequisites:
- Bazel
- clang with support for c++ 17+
- Openssl libcrypto.so (-lssl;-lcrypto).
To build the Nearby Connection Core library:
CC=clang CXX=clang++ bazel build -s --check_visibility=false //connections:core --spawn_strategy=standalone --verbose_failures
Building for macOS and iOS
NOTE: The only medium supported is Wi-Fi LAN.
Currently we support building with Swift Package Manager.
Prerequisites:
- Xcode. Available from Apple Store.
- Google Protobuf Compiler (protoc). If you have homebrew installed, you can do
brew install protobuf.
To build the Nearby Connection library:
swift build