From 7ef59e9e2fc5689eae3878efbabf4b5f6b2dd195 Mon Sep 17 00:00:00 2001
From: Matt Creaser <mattwcc@amazon.com>
Date: Fri, 26 Jul 2024 16:59:04 -0300
Subject: [PATCH] Update The TransferUtility docs with new requirements for API
 34

---
 .../sdk/storage/android/getting-started.mdx       |  8 +++++++-
 .../sdk/storage/android/transfer-utility.mdx      | 15 +++++++++++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/src/fragments/sdk/storage/android/getting-started.mdx b/src/fragments/sdk/storage/android/getting-started.mdx
index 6d9b8d5336e..1cebc6a7e4f 100644
--- a/src/fragments/sdk/storage/android/getting-started.mdx
+++ b/src/fragments/sdk/storage/android/getting-started.mdx
@@ -81,7 +81,13 @@ Use the following steps to connect add file storage backend services to your app
 
    ```xml
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
-   <service android:name="com.amazonaws.mobileconnectors.s3.transferutility.TransferService" android:enabled="true" />
+   <!-- For apps targeting API Level 28 and above: -->
+   <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+   <!-- For apps targeting API Level 34 and above: -->
+   <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC"/>
+
+
+   <service android:name="com.amazonaws.mobileconnectors.s3.transferutility.TransferService" android:foregroundServiceType="dataSync" />
    ```
 
 3. **For Android Q (API 29)**: API 29 enforces scoped storage access for Android apps. To gain access to legacy external storage, enable the following application property inside `AndroidManifest.xml`:
diff --git a/src/fragments/sdk/storage/android/transfer-utility.mdx b/src/fragments/sdk/storage/android/transfer-utility.mdx
index af1449cda4b..eeb6a2ae9eb 100644
--- a/src/fragments/sdk/storage/android/transfer-utility.mdx
+++ b/src/fragments/sdk/storage/android/transfer-utility.mdx
@@ -372,6 +372,21 @@ tsIntent.putExtra(TransferService.INTENT_KEY_REMOVE_NOTIFICATION, <remove-notifi
 getApplicationContext().startForegroundService(tsIntent);
 ```
 
+## Supporting TransferService on Upside Down Cake and above
+
+Starting in Android Upside Down Cake (API Level 34), foreground services must supply a service type. Starting with version `2.76.1`, if `TransferService` is moved into the foreground it will specify the type `FOREGROUND_SERVICE_TYPE_DATA_SYNC`. The application must declare some additional permissions and details in `AndroidManifest.xml`.
+
+```xml
+<!-- Request permissions for foreground data sync service -->
+<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+<uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC"/>
+
+<!-- Update the service tag to specify the service type -->
+<service
+    android:name="com.amazonaws.mobileconnectors.s3.transferutility.TransferService"
+    android:foregroundServiceType="dataSync" />
+```
+
 ## Supporting Unicode characters in key-names
 
 **Upload/download objects**