Skip to content

Commit 8940f22

Browse files
Update README for version 10.1.2 changes
Updated version information from v10.1.1 to v10.1.2 in the README. Added new features and improvements for v10.1.2, including file size filtering and dialog customization.
1 parent b35edbd commit 8940f22

1 file changed

Lines changed: 32 additions & 18 deletions

File tree

Readme.md

Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ If this library helps you, please consider supporting my open-source work.
4949
## Table of Contents
5050

5151
- [Overview](#overview)
52-
- [What is new in v10.1.1](#what-is-new-in-v1011)
52+
- [What is new in v10.1.2](#what-is-new-in-v1012)
5353
- [Important Android storage reality](#important-android-storage-reality)
5454
- [Requirements](#requirements)
5555
- [Installation](#installation)
@@ -71,7 +71,7 @@ If this library helps you, please consider supporting my open-source work.
7171
- [Handling Android 14+ partial photo/video access](#handling-android-14-partial-photovideo-access)
7272
- [Play Store safe integration options](#play-store-safe-integration-options)
7373
- [Troubleshooting](#troubleshooting)
74-
- [Migration guide from v9.x to v10.1.1](#migration-guide-from-v9x-to-v1011)
74+
- [Migration guide from v9.x to v10.1.2](#migration-guide-from-v9x-to-v1012)
7575
- [Security and privacy recommendations](#security-and-privacy-recommendations)
7676
- [FAQ](#faq)
7777
- [Contributing](#contributing)
@@ -105,9 +105,21 @@ dialog.setDialogSelectionListener(files -> {
105105
106106
---
107107

108-
## What is new in v10.1.1
108+
## What is new in v10.1.2
109109

110-
Version `10.1.1` focuses on modern Android support, stability, clearer storage behavior, and better dialog customization.
110+
Version `10.1.2` focuses on modern Android support, stability, clearer storage behavior, dialog customization, and advanced file filtering.
111+
112+
### New in v10.1.2
113+
114+
- Added file size filtering support using `min_file_size` and `max_file_size`.
115+
- Added support for selecting files below a specific size.
116+
- Added support for selecting files above a specific size.
117+
- Added support for selecting files between a minimum and maximum size range.
118+
- Added support for combining file size filtering with extension filtering.
119+
- Added examples for selecting video files below a specific file size.
120+
- Added examples for selecting PDF files below a specific file size.
121+
- Added examples for selecting large files such as videos between 100 MB and 2 GB.
122+
- Added README documentation explaining that file size filtering works with all file types, not only videos.
111123

112124
### New in v10.1.1
113125

@@ -124,6 +136,7 @@ Version `10.1.1` focuses on modern Android support, stability, clearer storage b
124136
- Improved Android 13+ permission guidance.
125137
- Added Android 14+ partial media access documentation.
126138
- Safer extension filtering.
139+
- Safer file size filtering.
127140
- Safer checkbox handling.
128141
- Safer selected item handling.
129142
- More predictable selected path ordering.
@@ -139,6 +152,7 @@ Version `10.1.1` focuses on modern Android support, stability, clearer storage b
139152
- Handles invalid offset/root configuration safely.
140153
- Handles empty folders safely.
141154
- Handles extension formats like `pdf`, `.pdf`, and `*`.
155+
- Handles file size limits using `long` values to support large file sizes.
142156

143157
---
144158

@@ -299,15 +313,15 @@ Add the FilePicker dependency inside the `dependencies` block.
299313

300314
```gradle
301315
dependencies {
302-
implementation "io.github.tutorialsandroid:filepicker:10.1.1"
316+
implementation "io.github.tutorialsandroid:filepicker:10.1.2"
303317
}
304318
```
305319

306320
### Kotlin DSL - app/build.gradle.kts
307321

308322
```kotlin
309323
dependencies {
310-
implementation("io.github.tutorialsandroid:filepicker:10.1.1")
324+
implementation("io.github.tutorialsandroid:filepicker:10.1.2")
311325
}
312326
```
313327

@@ -465,15 +479,15 @@ Add the dependency inside the `dependencies` block.
465479

466480
```gradle
467481
dependencies {
468-
implementation "com.github.TutorialsAndroid:FilePicker:v10.1.1"
482+
implementation "com.github.TutorialsAndroid:FilePicker:v10.1.2"
469483
}
470484
```
471485

472486
### Kotlin DSL - app/build.gradle.kts
473487

474488
```kotlin
475489
dependencies {
476-
implementation("com.github.TutorialsAndroid:FilePicker:v10.1.1")
490+
implementation("com.github.TutorialsAndroid:FilePicker:v10.1.2")
477491
}
478492
```
479493

@@ -512,13 +526,13 @@ android {
512526
For production apps, Maven Central is recommended:
513527

514528
```gradle
515-
implementation "io.github.tutorialsandroid:filepicker:10.1.1"
529+
implementation "io.github.tutorialsandroid:filepicker:10.1.2"
516530
```
517531

518532
Use JitPack only if you specifically want to fetch the library directly from GitHub:
519533

520534
```gradle
521-
implementation "com.github.TutorialsAndroid:FilePicker:v10.1.1"
535+
implementation "com.github.TutorialsAndroid:FilePicker:v10.1.2"
522536
```
523537

524538
---
@@ -564,15 +578,15 @@ Only use the old `allprojects` method if your project is very old and does not h
564578

565579
```gradle
566580
dependencies {
567-
implementation "io.github.tutorialsandroid:filepicker:10.1.1"
581+
implementation "io.github.tutorialsandroid:filepicker:10.1.2"
568582
}
569583
```
570584

571585
### JitPack
572586

573587
```gradle
574588
dependencies {
575-
implementation "com.github.TutorialsAndroid:FilePicker:v10.1.1"
589+
implementation "com.github.TutorialsAndroid:FilePicker:v10.1.2"
576590
}
577591
```
578592

@@ -914,7 +928,7 @@ FilePickerDialog dialog = new FilePickerDialog(
914928

915929
This section answers a common GitHub issue/question: **"Change Width and Height"**.
916930

917-
From `v10.1.1`, `FilePickerDialog` supports programmatic dialog sizing. This is useful for:
931+
`FilePickerDialog` supports programmatic dialog sizing. This is useful for:
918932

919933
- Ultra-wide screens
920934
- Landscape mode
@@ -1812,7 +1826,7 @@ If your APK is used internally, enterprise-side-loaded, or outside Google Play,
18121826

18131827
### Dialog looks too small on tablets, landscape, or ultra-wide screens
18141828

1815-
Use the v10.1.1 dialog sizing API before showing the picker:
1829+
Use the dialog sizing API before showing the picker:
18161830

18171831
```java
18181832
dialog.setDialogSizeByPercent(0.85f, 0.75f);
@@ -1894,12 +1908,12 @@ Possible causes:
18941908

18951909
---
18961910

1897-
## Migration guide from v9.x to v10.1.1
1911+
## Migration guide from v9.x to v10.1.2
18981912

18991913
### 1. Update dependency
19001914

19011915
```gradle
1902-
implementation "io.github.tutorialsandroid:filepicker:10.1.1"
1916+
implementation "io.github.tutorialsandroid:filepicker:10.1.2"
19031917
```
19041918

19051919
### 2. Replace old permission code
@@ -1951,7 +1965,7 @@ Only use `MANAGE_EXTERNAL_STORAGE` when the answer is policy-safe.
19511965

19521966
### 5. Update dialog size usage if needed
19531967

1954-
If your old app looked too narrow on landscape, tablet, foldable, or ultra-wide screens, use the v10.1.1 sizing API:
1968+
If your old app looked too narrow on landscape, tablet, foldable, or ultra-wide screens, use the v10.1.2 sizing API:
19551969

19561970
```java
19571971
dialog.setDialogSizeByPercent(0.85f, 0.75f);
@@ -2043,7 +2057,7 @@ No.
20432057

20442058
### Can I change dialog width and height?
20452059

2046-
Yes. From v10.1.1, use:
2060+
Yes. From v10.1.2, use:
20472061

20482062
```java
20492063
dialog.setDialogSizeByPercent(0.85f, 0.75f);

0 commit comments

Comments
 (0)