Add Storage Access Framework demos (#191)

* Add Storage Access Framework sample

* Upgrade to compileSdk 36

Add Jetpack photopicker library

Author: yrezgui

README.md

@@ -21,7 +21,7 @@ Browse the samples inside each topic samples folder:
 - [User-interface](https://github.com/android/platform-samples/tree/main/samples/user-interface)
 - More to come...
 
-We regularly add new samples to this repository. You can find a list of all the available samples [here](https://github.com/android/platform-samples/tree/main/samples).
+We are constantly adding new samples to this repository. You can find a list of all the available samples [here](https://github.com/android/platform-samples/tree/main/samples).
 
 ## How to run
 

app/src/main/java/com/example/platform/app/SampleDemo.kt

@@ -64,6 +64,7 @@ import com.example.platform.shared.MinSdkBox
 import com.example.platform.storage.mediastore.MediaStoreQuerySample
 import com.example.platform.storage.mediastore.SelectedPhotosAccessSample
 import com.example.platform.storage.photopicker.PhotoPickerSample
+import com.example.platform.storage.storageaccessframework.GetContentSample
 import com.example.platform.ui.appwidgets.AppWidgets
 import com.example.platform.ui.constraintlayout.AdvancedArrangementFragment
 import com.example.platform.ui.constraintlayout.AdvancedChainsFragment
@@ -580,6 +581,14 @@ val SAMPLE_DEMOS by lazy {
             apiSurface = StorageApiSurface,
             content = { MediaStoreQuerySample() },
         ),
+        ComposableSampleDemo(
+            id = "storageaccessframework-getcontent",
+            name = "Storage Access Framework - GET_CONTENT",
+            description = "Open a document using the Storage Access Framework",
+            documentation = "https://developer.android.com/training/data-storage/shared/documents-files#open-file",
+            apiSurface = StorageApiSurface,
+            content = { GetContentSample() },
+        ),
         ComposableSampleDemo(
             id = "selected-photos-access",
             name = "Selected Photos Access",

gradle/libs.versions.toml

@@ -30,6 +30,7 @@ material = "1.12.0"
 coil = "2.4.0"
 navigationCompose = "2.8.7"
 coroutines = "1.7.3"
+photopickerCompose = "1.0.0-alpha01"
 play-services-location = "21.1.0"
 
 accompanist = "0.32.0"
@@ -67,6 +68,7 @@ playServicesMlkitBarcodeScanning = "18.3.1"
 androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
 androidx-fragment-compose = { module = "androidx.fragment:fragment-compose", version.ref = "fragmentCompose" }
 androidx-navigation-compose = { module = "androidx.navigation:navigation-compose", version.ref = "navigationCompose" }
+androidx-photopicker-compose = { module = "androidx.photopicker:photopicker-compose", version.ref = "photopickerCompose" }
 junit = { group = "junit", name = "junit", version.ref = "junit" }
 androidx-junit = { group = "androidx.test.ext", name = "junit", version.ref = "junitVersion" }
 androidx-espresso-core = { group = "androidx.test.espresso", name = "espresso-core", version.ref = "espressoCore" }

samples/accessibility/build.gradle.kts

@@ -42,6 +42,7 @@ android {
 dependencies {
     implementation(platform(libs.androidx.compose.bom))
     implementation(libs.androidx.ui)
+    implementation(libs.androidx.ui.tooling)
     implementation(libs.androidx.ui.tooling.preview)
     implementation(libs.androidx.material3)
     implementation(libs.androidx.fragment)

samples/privacy/transparency/src/main/java/com/example/platform/privacy/transparency/DataAccess.kt

@@ -47,13 +47,10 @@ import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.platform.LocalLifecycleOwner
 import androidx.compose.ui.unit.dp
 import androidx.core.app.AppOpsManagerCompat
-//import androidx.core.content.getSystemService
 import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.LifecycleEventObserver
 import androidx.lifecycle.LifecycleOwner
-//import com.example.platform.base.PermissionBox
 import com.example.platform.shared.PermissionBox
-//import com.google.android.catalog.framework.annotations.Sample
 import com.google.android.gms.location.LocationServices
 import com.google.android.gms.location.Priority
 import com.google.android.gms.tasks.CancellationTokenSource
@@ -62,13 +59,6 @@ import kotlinx.coroutines.launch
 import kotlinx.coroutines.tasks.await
 
 @SuppressLint("MissingPermission")
-//@Sample(
-//    name = "Data Access",
-//    description = "Demonstrates how to implement data access auditing for your app to identify " +
-//            "unexpected data access, even from third-party SDKs and libraries.",
-//    documentation = "https://developer.android.com/guide/topics/data/audit-access",
-//)
-
 @RequiresApi(Build.VERSION_CODES.R)
 @Composable
 fun DataAccessSample() {

samples/privacy/transparency/src/main/java/com/example/platform/privacy/transparency/ScreenshotDetection.kt

@@ -39,10 +39,6 @@ import androidx.fragment.app.Fragment
 import java.text.DateFormat
 import java.util.Date
 
-//@Sample(
-//    name = "Screenshot Detection",
-//    description = "This sample shows how to detect that the user capture the screen in Android 14 onwards",
-//)
 @RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
 class ScreenshotDetectionSample : Fragment() {
 

samples/storage/build.gradle.kts

@@ -43,8 +43,10 @@ dependencies {
     implementation(platform(libs.androidx.compose.bom))
     implementation(libs.androidx.ui)
     implementation(libs.androidx.ui.graphics)
+    implementation(libs.androidx.ui.tooling)
     implementation(libs.androidx.ui.tooling.preview)
     implementation(libs.androidx.material3)
+    implementation(libs.androidx.photopicker.compose)
 
     implementation(project(":shared"))
 

samples/storage/src/main/java/com/example/platform/storage/StorageSampleActivity.kt

@@ -45,17 +45,10 @@ import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.text.style.TextOverflow
 import androidx.compose.ui.unit.dp
 import coil.compose.AsyncImage
-//import com.example.platform.base.PermissionBox
 import com.example.platform.shared.PermissionBox
-//import com.google.android.catalog.framework.annotations.Sample
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
 
-//@Sample(
-//    name = "MediaStore - Query",
-//    description = "Query files indexed by MediaStore",
-//    documentation = "https://developer.android.com/training/data-storage/shared/media#media_store",
-//)
 @SuppressLint("MissingPermission")
 @Composable
 fun MediaStoreQuerySample() {

samples/storage/src/main/java/com/example/platform/storage/mediastore/MediaStoreQuery.kt

@@ -48,12 +48,6 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
-//@Sample(
-//    name = "Selected Photos Access",
-//    description = "Check and request storage permissions",
-//    documentation = "https://developer.android.com/about/versions/14/changes/partial-photo-video-access",
-//)
-//@RequiresPermission(anyOf = [READ_MEDIA_IMAGES, READ_MEDIA_VIDEO, READ_EXTERNAL_STORAGE])
 @Composable
 fun SelectedPhotosAccessSample() {
     val context = LocalContext.current