Merge pull request #49 from lakscastro/docs/FULL-DOCS

Add migration notes and missing plugin development guide

Author: lask

docs/Contributing/Setup environment/Debugging plugin.md

@@ -1 +1,25 @@
-> First you need follow the guide `Setup local environment` in order to read this guide
+> First you need follow the guide [`Setup local environment`](./Setup%20local%20environment.md) in order to read this guide
+
+Since this is an Android plugin, you'll need to use Android Studio in order to have a full intellisense and debugging features for Kotlin.
+
+You can also use Visual Studio Code for Dart and Android Studio for Kotlin.
+
+## Android Side
+
+> All android plugin is inside `/android` folder.
+
+There a few steps in order to start debugging this plugin:
+
+- Open the project inside Android Studio.
+- Right click on `/android` folder.
+- `Flutter` > `Open Android module in Android Studio` > `New Window`.
+
+Done, all completing features will be available.
+
+See [Flutter docs for details](https://docs.flutter.dev/development/tools/android-studio).
+
+## Dart Side
+
+There's no additional step. Just open the directory inside your preferable editor.
+
+Happy hacking.

docs/Migrate notes/From v0.2.0.md

@@ -0,0 +1,62 @@
+There's some breaking changes from `v0.2.x` then be careful when updating on `pubspec.yaml`
+
+`pubspec.yaml` dependecy manager file:
+
+```yaml
+dependencies:
+  shared_storage: v0.3.0
+```
+
+## SDK Constraint
+
+In `android\app\build.gradle` set `android.defaultConfig.minSdkVersion` to `19`:
+
+```gradle
+android {
+  ...
+  defaultConfig {
+    ...
+    minSdkVersion 19
+  }
+  ...
+}
+```
+
+## Plugin Import
+
+Although this import is still supported:
+
+```dart
+import 'package:shared_storage/shared_storage.dart' as shared_storage;
+```
+
+This should be renamed to any of them or all:
+
+```dart
+import 'package:shared_storage/saf.dart' as saf;
+import 'package:shared_storage/media_store.dart' as media_store;
+import 'package:shared_storage/environment.dart' as environment;
+```
+
+Choose which modules/imports one you want to include inside ee project.
+
+## Media Store `getMediaStoreContentDirectory`
+
+In `android\app\build.gradle` set `android.defaultConfig.minSdkVersion` to `19`:
+
+```gradle
+android {
+  ...
+  defaultConfig {
+    ...
+    minSdkVersion 19
+  }
+  ...
+}
+```
+
+The method `getMediaStoreContentDirectory` now returns the right class `Uri` instead of a `Directory`.
+
+Be sure to update all ocurrences.
+
+This `Uri` is used to represent a directory.