Resolve #108 Need dispose method for clearing resources

Author: jumperchen

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.9.11
+
+**New Feature:**
+
+* [#108](https://github.com/rikulo/socket.io-client-dart/issues/108) Need dispose method for clearing resources
+
 ## 0.9.10+2
 
 * Fix dart analyzer warning for formatting issues.

README.md

@@ -152,6 +152,9 @@ void main() {
 }
 ```
 
+### Memory leak issues in iOS when closing socket.
+* Refer to https://github.com/rikulo/socket.io-client-dart/issues/108 issue.
+Please use `socket.dispose()` instead of `socket.close()` or `socket.disconnect()` to solve the memory leak issue on iOS.
 
 ## Notes to Contributors
 

lib/src/socket.dart

@@ -407,6 +407,16 @@ class Socket extends EventEmitter {
     return this;
   }
 
+  /// Disposes the socket manually which will destroy, close, disconnect the socket connection
+  /// and clear all the event listeners. Unlike [close] or [disconnect] which won't clear
+  /// all the event listeners
+  ///
+  /// @since 0.9.11
+  void dispose() {
+    disconnect();
+    clearListeners();
+  }
+
   ///
   /// Sets the compress flag.
   ///

pubspec.yaml

@@ -1,6 +1,6 @@
 name: socket_io_client
 description: Dartlang port of socket.io-client for web, flutter, dartvm to use
-version: 0.9.10+2
+version: 0.9.11
 homepage: https://www.zkoss.org
 repository: https://github.com/rikulo/socket.io-client-dart
 issue_tracker: https://github.com/rikulo/socket.io-client-dart/issues