A Dart client for the NATS messaging system. Design to use with Dart and flutter.
All examples can be found in example folder.
For android you need to add to android/app/src/profile/AndroidManifest file lines:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />For activiy in backgroud:
<!-- Allows run app in background -->
<uses-permission android:name="android.permission.REQUEST_COMPANION_RUN_IN_BACKGROUND"/>
<!-- Allows app use data in background -->
<uses-permission android:name="android.permission.REQUEST_COMPANION_USE_DATA_IN_BACKGROUND"/>For iOS you don't need any specific permissions for NATS client.
But for background activity you need to add to file ios/Runner/Info.plist lines:
<key>UIBackgroundModes</key>
<array>
<string>audio</string>
<string>external-accessory</string>
<string>fetch</string>
<string>processing</string>
<string>remote-notification</string>
</array>For running unit-tests use dart test in project root folder.
NOTE. For testing you need run NATS in docker. Instruction
The following is a list of features currently supported and planned by this client:
- - Publish
- - Subscribe, unsubscribe
- - NUID, Inbox
- - Reconnect to single server when connection lost and resume subscription
- - Unsubscribe after N message
- - Request, Respond
- - Respond, Request example
- - Queue subscribe
- - caches, flush, drain
- - Request timeout
- - structured data
- - Connection option (cluster, timeout,ping interval, max ping, echo,... )
- - Random automatic reconnection, disable reconnect, number of attempts, pausing
- - Connect to cluster,randomize, Automatic reconnect upon connection failure base server info
- - Events/status disconnect handler, reconnect handler
- - Buffering message during reconnect atempts
- - All authentication models, including NATS 2.0 JWT and seed keys
- - TLS support