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).