ws_native

The Rust transport for ws: TLS, WebSocket framing and JSON parsing run on native threads (tokio, tungstenite, rustls, simd-json), and messages reach Dart in batches without copies.

import 'package:ws_native/ws_native.dart';

void main() {
  if (!WsNative.install()) {
    // Pure Dart is used; say why (unsupported target, build skipped...).
    debugPrint('ws_native: ${WsNative.unavailableReason}');
  }
  runApp(const App());
}

The libraries for Android, iOS, macOS, Linux and Windows ship inside this package. A build hook adds the one for the target to your app, so building needs no Rust toolchain and no network. Works with Flutter and with dart build cli, dart run and dart test.

Executables built with dart compile exe cannot depend on packages with build hooks. Use dart run ws:install and package:ws/native.dart instead (see the ws README).

Opt out, or build from source, per app:

hooks:
  user_defines:
    ws_native:
      source: none # none | build | prebuilt
      # library: path/to/libws_native.so  # use this file instead

App Store privacy manifest

The iOS library imports fstat (from the Rust standard library), one of Apple's "required reason" APIs (file timestamps). Flutter wraps the library in a generated framework that cannot carry its own PrivacyInfo.xcprivacy, so declare it in the app's manifest:

<key>NSPrivacyAccessedAPITypes</key>
<array>
  <dict>
    <key>NSPrivacyAccessedAPIType</key>
    <string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
    <key>NSPrivacyAccessedAPITypeReasons</key>
    <array>
      <string>C617.1</string>
    </array>
  </dict>
</array>

C617.1: metadata of files inside the app container. The library itself reads no files on iOS (certificates come from Security.framework).

Licences

The libraries are built from Rust crates under permissive licences (MIT, Apache-2.0, ISC, BSD-3-Clause, Zlib, Unicode-3.0, CDLA-Permissive-2.0). Their notices are part of this package's LICENSE, so Flutter's showLicensePage lists them with no work on your side.

Libraries

ws_native
Native (Rust) transport for package:ws, with the library bundled by a build hook (Flutter, dart build cli, dart run, dart test).