You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Sep 16, 2023. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+18-12Lines changed: 18 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,28 +31,33 @@ This package is currently only supported on Android devices.
31
31
## Required Permissions on Android
32
32
33
33
In order to read and write outside the app-specific directories, additional
34
-
permissions will be required. These must be enabled on the `AndroidManifest.xml`
35
-
of your app located on `android/app/src/main`. More recent releases of `Android`
36
-
are managing storage permissions on the [file's purpose](https://developer.android.com/training/data-storage#permissions) and therefore have no effect applied.
34
+
permissions must be granted. These must be enabled on the `AndroidManifest.xml`
Enabling the required permissions will be done using the `BackupStorage`'s
45
+
`requestPermissions()` method, which utilizes the `permission_handler` package.
45
46
46
-
In order to access already existing backup files (the currently running app won't be able to access them directly), these permissions must first be granted.
47
-
This will be done using the `BackupStorage`'s `requestPermissions()` method,
48
-
which uses the `permission_handler` package.
47
+
More recent releases of `Android`
48
+
are managing storage permissions on the [file's purpose](https://developer.android.com/training/data-storage#permissions) and have some restrictions. In order to access already existing backup files created using previous installations
49
+
on Android 10 and higher, the `MANAGE_EXTERNAL_STORAGE` permissions must be granted.
50
+
The current installation won't be able to access them directly due to the altered
51
+
file privileges. This must be specified on the `BackupStorage`'s `useManageExternalStoragePermission`
52
+
flag. This practice is discouraged. Use the `BackupStorage`'s `pickBackupFile()`
53
+
methods to allow picking a specific file without the need of additional permissions.
49
54
50
-
## Backup location
55
+
## Backup Location
51
56
52
57
Backups are stored on the device's Media directories by default. But custom file
53
58
paths are supported. The Media directories will include the Documents folder
54
59
(default) on `/storage/emulated/0/Documents/` or the Download folder on
55
-
`/storage/emulated/0/Download/`.
60
+
`/storage/emulated/0/Download/`.
56
61
57
62
We recommend to use the Documents folder
58
63
as backup location if possible for better security.
@@ -79,10 +84,11 @@ experiment with the app.
79
84
80
85
## Dependencies
81
86
82
-
Leitmotif uses the following Dart dependencies in order to implement certain
87
+
LitBackupService uses the following Dart dependencies in order to implement certain
83
88
features and functionality:
84
89
85
90
-[permission_handler](https://pub.dev/packages/permission_handler) - [License](https://github.com/Baseflow/flutter-permission-handler/blob/master/LICENSE) (Used to request storage access permissions)
91
+
-[file_picker](https://pub.dev/packages/file_picker) - [License](https://github.com/miguelpruivo/flutter_file_picker/blob/master/LICENSE) (Used to allow platform-specific file picking)
86
92
87
93
## Credits
88
94
@@ -93,8 +99,8 @@ LitBackupService is made possible thanks to the Flutter Project.
93
99
Everything else in this repository including the source code is distributed under the
94
100
**BSD 3-Clause** license as specified in the `LICENSE` file.
0 commit comments