mqtt_client 5.5.3

  • README.md
  • CHANGELOG.md
  • Installing
  • Versions
  • 93

mqtt_client #

Build Status

A server side MQTT client for Dart.

The client is an MQTT v3(3.1 and 3.1.1) implementation supporting subscription/publishing at all QOS levels, keep alive and synchronous connection. The client is designed to take as much MQTT protocol work off the user as possible, connection protocol is handled automatically as are the message exchanges needed to support the different QOS levels and the keep alive mechanism. This allows the user to concentrate on publishing/subscribing and not the details of MQTT itself.

Examples of usage can be found in the examples directory. An example is also provided showing how to use the client to connect to the mqtt-bridge of Google's IoT-Core suite. This demonstrates how to use secure connections and switch MQTT protocols. The test directory also contains standalone runnable scripts demonstrating subscription, publishing and topic filtering.

The client supports both normal and secure TCP connections and server side secure(wss) and non-secure(ws) websocket connections.

The client has been used successfully with the MQTT brokers from several of the major cloud providers IOT/MQTT platforms, including :-

  • Google IOT Core
  • Amazon AWS
  • Microsoft Azure
  • IBM

It has also been used with a range of both publicly available brokers such as Mosquitto and proprietary ones. An example using the adafruit MQTT broker for flutter can be found here.

The code is a port from the C# nMQTT client library to Dart.

#5.5.3 Issues 85 and 87

#5.5.2 Fix for dart 2.2 usage

#5.5.1 Issue 81

5.5.0 #

Issues 69, 74 and 79

5.4.0 #

Issues 67 and 68

5.3.0 #

Issues 61, 62 and 63

5.2.0 #

Issues 59 + 60

5.1.0 #

Issues 54, 55 and 56

5.0.0 #

Roll up release for issues 48, 49, 50, 52 and 53, warning - breaking API change for connection state and security context in secure mode hence the major version bump.

4.0.0 #

Issue 45, better connection fail reporting, update linter, note breaking API change for turning logging on/off

3.3.6 #

Formatting

3.3.5 #

Issue 40, disconnected clients

3.3.4 #

Formatting

3.3.3 #

Issue 26, example code for flutter

3.3.2 #

Issue 38 QOS1 + 2 protocol handling bugs, Issue 34 Flutter buffers

3.3.1 #

Issue 38 QOS1 + 2 protocol handling bugs

3.3.0 #

Issue 37 onSubscribed and OnUnsubscribed callbacks

3.2.1 #

Issues 32 bug fix

3.2.0 #

Issues 32 and 35

3.1.0 #

Issues 27 and 29, pull request 30

3.0.0 #

Update to Dart 2, major version bump only to create a clean break from Dart 1

2.0.0 #

Issue 23, all subscriptions are now on one client level observable, not on seperate ones per subscription, this change is NOT backwards compatible

1.9.1 #

Issue 22, don't disconnect if we have no connection established

1.9.0 #

Issue 19, multitopic subscriptions + other more minor updates, API changed on this version.

1.8.0 #

Pull request 14, Making library more compliant to work with VerneMQ - explicit setting of will qos.

1.7.2 #

Issue 10, add library prefix for observable

1.7.1 #

Issue 10, update Observable version to 'any'

1.7.0 #

Add the payload builder utility.

1.6.1 #

Update Observable version

1.6.0 #

Remove eventable and its dependency on mirrors, replace with event_bus, issue 10

1.5.0 #

Fixes for issue 8, pub suggestions fixed.

1.4.0 #

Fixes for issues 5 and 6

1.3.0 #

Fixes for issues 3 and 4

1.2.0 #

Add secure sockets, server side only Add ability to select the MQTT protocol between 3.1 and 3.1.1 A few code and test tidy ups Tested to work with iot-core MQTT bridge

1.1.0 #

Add websockets as an alternative network connection server side only

1.0.1 #

Fix unit tests on Travis

1.0.0 #

Initial release

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  mqtt_client: ^5.5.3

2. Install it

You can install packages from the command line:

with pub:


$ pub get

with Flutter:


$ flutter pub get

Alternatively, your editor might support pub get or flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:mqtt_client/mqtt_client.dart';
  
Version Uploaded Documentation Archive
5.5.3 Apr 25, 2019 Go to the documentation of mqtt_client 5.5.3 Download mqtt_client 5.5.3 archive
5.5.2 Feb 27, 2019 Go to the documentation of mqtt_client 5.5.2 Download mqtt_client 5.5.2 archive
5.5.1 Feb 27, 2019 Go to the documentation of mqtt_client 5.5.1 Download mqtt_client 5.5.1 archive
5.5.0 Feb 19, 2019 Go to the documentation of mqtt_client 5.5.0 Download mqtt_client 5.5.0 archive
5.4.0 Jan 25, 2019 Go to the documentation of mqtt_client 5.4.0 Download mqtt_client 5.4.0 archive
5.3.0 Jan 9, 2019 Go to the documentation of mqtt_client 5.3.0 Download mqtt_client 5.3.0 archive
5.2.0 Dec 20, 2018 Go to the documentation of mqtt_client 5.2.0 Download mqtt_client 5.2.0 archive
5.1.0 Dec 2, 2018 Go to the documentation of mqtt_client 5.1.0 Download mqtt_client 5.1.0 archive
5.0.0 Nov 26, 2018 Go to the documentation of mqtt_client 5.0.0 Download mqtt_client 5.0.0 archive
4.0.0 Nov 18, 2018 Go to the documentation of mqtt_client 4.0.0 Download mqtt_client 4.0.0 archive

All 36 versions...

Popularity:
Describes how popular the package is relative to other packages. [more]
90
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
90
Overall:
Weighted score of the above. [more]
93
Learn more about scoring.

We analyzed this package on Jun 14, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.3.1
  • pana: 0.12.17

Platforms

Detected platforms: Flutter, other

Primary library: package:mqtt_client/mqtt_client.dart with components: io.

Maintenance suggestions

Maintain an example. (-10 points)

Create a short demo in the example/ directory to show how to use this package.

Common filename patterns include main.dart, example.dart, and mqtt_client.dart. Packages with multiple examples should provide example/README.md.

For more information see the pub package layout conventions.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.0.0-dev <3.0.0
crypto ^2.0.6 2.0.6
event_bus ^1.0.1 1.1.0
meta ^1.0.4 1.1.7
path ^1.6.2 1.6.2
typed_data ^1.1.6 1.1.6
Transitive dependencies
charcode 1.1.2
collection 1.14.11
convert 2.1.1
Dev dependencies
coverage ^0.12.3
dart_dev ^2.0.1
dart_style ^1.1.3
mockito ^3.0.0
test ^1.3.0