add note about sd-cards on kitkat

spacecowboy · Dec 30, 2017 · 5912ea1 · 5912ea1
1 parent 72333f8
commit 5912ea1
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -1,3 +1,11 @@
+## Note: avoid using as SD-card file picker on Kitkat+
+
+In Kitkat or above, use Android's built-in file-picker instead. Google has restricted the ability of external libraries like this from creating directories on external SD-cards in Kitkat and above which will manifest itself as a crash.
+
+If you need to support pre-Kitkat devices see https://github.com/spacecowboy/NoNonsense-FilePicker/issues/158#issuecomment-353896387 for the recommendation approach.
+
+This does not impact the library's utility for non-SD-card locations, nor does it impact you if you don't want to allow a user to create directories.
+
 # NoNonsense-FilePicker
 
 <p>