1
2Android StorageProvider Sample
3===================================
4
5This sample shows how to implement a simple documents provider using the storage access
6framework available in Android 4.4.
7
8Introduction
9------------
10
11This sample uses the [StorageAccessFramework][1] introduced in Android 4.4 to implement a [DocumentsProvider][2].
12
13See [Writing A Custom Document Provider guide][3] for all the details on how to do this.
14
15
16[1]: https://developer.android.com/guide/topics/providers/document-provider.html
17[2]: https://developer.android.com/reference/android/provider/DocumentsProvider.html
18[3]: https://developer.android.com/guide/topics/providers/document-provider.html#custom
19
20Pre-requisites
21--------------
22
23- Android SDK 28
24- Android Build Tools v28.0.3
25- Android Support Repository
26
27Screenshots
28-------------
29
30<img src="screenshots/1-logged-out.png" height="400" alt="Screenshot"/> <img src="screenshots/2-logged-in.png" height="400" alt="Screenshot"/>
31
32Getting Started
33---------------
34
35This sample uses the Gradle build system. To build this project, use the
36"gradlew build" command or use "Import Project" in Android Studio.
37
38Support
39-------
40
41- Google+ Community: https://plus.google.com/communities/105153134372062985968
42- Stack Overflow: http://stackoverflow.com/questions/tagged/android
43
44If you've found an error in this sample, please file an issue:
45https://github.com/googlesamples/android-StorageProvider
46
47Patches are encouraged, and may be submitted by forking this project and
48submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details.
49
50License
51-------
52
53Copyright 2019 The Android Open Source Project, Inc.
54
55Licensed to the Apache Software Foundation (ASF) under one or more contributor
56license agreements.  See the NOTICE file distributed with this work for
57additional information regarding copyright ownership.  The ASF licenses this
58file to you under the Apache License, Version 2.0 (the "License"); you may not
59use this file except in compliance with the License.  You may obtain a copy of
60the License at
61
62http://www.apache.org/licenses/LICENSE-2.0
63
64Unless required by applicable law or agreed to in writing, software
65distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
66WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
67License for the specific language governing permissions and limitations under
68the License.
69