Google Git
Sign in
chromium / external / github.com / google / nearby-connections / 8e048f7be0f2c3b41f6aa7047252cfa54ff85272
commit8e048f7be0f2c3b41f6aa7047252cfa54ff85272[log] [tgz]
authoredwinwu <edwinwu@google.com>Wed May 25 13:35:23 2022
committerCopybara-Service <copybara-worker@google.com>Wed May 25 13:36:55 2022
treee1154f45474222114fe72954b49aee0474dcd1d5
parentcb8fef78755d95c0df6db3949127bc37fd6e65d9 [diff]
[BLE Refactor] Uses Uuid class for those used in Uuid string-form in /medium layer.

PiperOrigin-RevId: 450910238
32 files changed
tree: e1154f45474222114fe72954b49aee0474dcd1d5
  1. .github/
  2. compiled_proto/
  3. connections/
  4. docs/
  5. embedded/
  6. internal/
  7. presence/
  8. proto/
  9. third_party/
  10. .bazelrc
  11. .gitignore
  12. .gitmodules
  13. CONTRIBUTING.md
  14. LICENSE
  15. Package.resolved
  16. Package.swift
  17. README.md
  18. WORKSPACE
README.md

Nearby C++ Library

The repository contains the Nearby project C++ library source code. This is not an officially supported Google product.

About the Nearby Project

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

Currently we support building from source using [bazel] (https://bazel.build). Other BUILD system such as cmake may be added later.

Prerequisites:

  1. Bazel
  2. clang with support for c++ 17+
  3. 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

Currently we support building with Swift Package Manager.

Prerequisites:

  1. Xcode. Available from Apple Store.
  2. Google Protobuf Compiler (protoc). If you have homebrew installed, you can do brew install protobuf.

To build the Nearby Connection library:

swift build

We also provide a iOS [sample app using the Nearby Connections library] (https://github.com/google/nearby/blob/master/internal/platform/implementation/ios/Example/NearbyConnectionsExample/README.md).

Limitation

The only Medium supported is Wifi LAN.

Last Updated: April 7, 2022