From 0b2a8eca1ebf67175bf7af13fd7a70aa5f5199d4 Mon Sep 17 00:00:00 2001 From: kidfromjupiter Date: Sun, 1 Feb 2026 06:01:44 +0000 Subject: [PATCH] improved readme --- sharing/linux/README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/sharing/linux/README.md b/sharing/linux/README.md index 9545e0a1..e5a501b8 100644 --- a/sharing/linux/README.md +++ b/sharing/linux/README.md @@ -2,6 +2,17 @@ This directory contains the Linux-specific implementation of Nearby Sharing and a sample application demonstrating its usage. +## ⚠️ Important Compatibility Notice + +**This is a simplified implementation for Linux-to-Linux transfers only.** + +- ✅ **Works**: Linux ↔ Linux device transfers +- ❌ **Does NOT work**: Linux ↔ Android/ChromeOS (authentication failure) + +**Reason**: The full Nearby Sharing protocol requires certificate-based authentication, introduction frame exchange, and protocol frame handling which are not implemented in this simplified version. + +**For Android/ChromeOS compatibility**, you need the full implementation in `sharing/nearby_sharing_service_impl.{h,cc}` which requires additional platform support. See [ANDROID_COMPATIBILITY.md](ANDROID_COMPATIBILITY.md) for details. + ## Overview Nearby Sharing is a feature that allows users to share files, text, and other content between nearby devices using Bluetooth Low Energy (BLE) and Wi-Fi Direct. This implementation provides a simplified Linux interface built on top of the Nearby Connections API.