Unity升级至Android API 34时关于android.permission.FOREGROUND_SERVICE_DATA_SYNC权限的排查、移除与声明问题

Hey there! Let's break down how to tackle this FOREGROUND_SERVICE_DATA_SYNC permission issue step by step— I’ve dealt with similar headaches when targeting newer Android APIs in Unity, so I’ve got some practical tips for you.

一、先搞清楚这个权限是哪来的 #

Before you decide to remove or declare it, you need to find out why it’s showing up in your project. Here are the most common places to check:

1. Unity自带的Player Settings配置 #

Open your Unity editor, go to Edit > Project Settings > Player > Android > Publishing Settings. Look through the Permissions list— sometimes enabling certain features (like background data sync options) will automatically add this permission. Also, check if the Custom Main Manifest option is checked; if yes, navigate to your custom AndroidManifest.xml file and search directly for the permission string: android.permission.FOREGROUND_SERVICE_DATA_SYNC.

2. 第三方插件/包是重灾区 #

Most of the time, this permission gets added by third-party plugins— especially those related to cloud sync, offline data processing, push notifications, or background services. Try these steps:

• Open your project’s Packages/manifest.json to list all installed packages, then cross-check each package’s documentation to see if it requires this foreground service permission.
• Use Unity’s Package Manager (Window > Package Manager) to inspect installed packages, and look for any Android-specific configuration they might include.
• Do a full project search (use your IDE’s search function or Unity’s built-in search) for all AndroidManifest.xml files (including those inside plugin folders) and look for the permission declaration.

3. 自定义Android代码 #

If you’ve added any custom Android plugins (Java/Kotlin code) to your project, check those files. Look for:

• Any <uses-permission> tags declaring this permission.
• Any Service classes that use android:foregroundType="dataSync" in their manifest declaration— this automatically requires the FOREGROUND_SERVICE_DATA_SYNC permission.

二、如果确认没用到，怎么移除它 #

If you’re sure your app doesn’t use data sync foreground services, here’s how to get rid of the permission:

1. 取消Unity自动添加的权限 #

Go back to the Publishing Settings > Permissions tab in Unity’s Player Settings, and uncheck any option that might be adding this permission. If you can’t find a direct toggle, move to the next step.

2. 用Manifest合并规则强制移除 #

If the permission is being merged in from a plugin or Unity’s default manifest, add this line to your custom AndroidManifest.xml (make sure you have the tools namespace declared first):

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"> <!-- 确保这行存在 -->

    <!-- 强制移除权限 -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" tools:node="remove" />

</manifest>

This tells the Android build system to strip out this permission during the manifest merge process, even if other manifests try to add it.

3. 清理第三方插件（可选） #

If you track down the specific plugin adding the permission, you can either:

• Switch to a version of the plugin that doesn’t require this permission (check the plugin’s release notes).
• Edit the plugin’s AndroidManifest.xml directly to remove the permission— though note that updating the plugin later will overwrite this change, so the tools:node="remove" method is more reliable.

三、如果确实在使用，怎么正确声明并制作合规视频 #

If you do use this permission for foreground data sync services, you need to properly declare it in Google Play Console and create a valid demonstration video.

1. 准确填写Google Play Console声明 #

• Log into Google Play Console, navigate to your app, then go to App content > Permissions and declarations > Permissions.
• Find FOREGROUND_SERVICE_DATA_SYNC and select "I use this permission".
• In the description field, be specific about your use case— avoid vague language. For example: "Our app runs a foreground service to sync users' offline activity logs to our cloud server, ensuring data is not lost even if the app is minimized."

2. 制作符合要求的演示视频 #

Google needs to see exactly how you use the permission in your app. Here’s what your video should include:

• Start by opening your app normally.
• Trigger the action that starts the data sync foreground service (e.g., tap a "Sync Data" button, or show the automatic sync trigger if it’s initiated in the background).
• Clearly show the foreground service notification (Android 13+ will display a persistent notification for foreground services— make sure this is visible in the video).
• Demonstrate the ongoing sync process (e.g., a progress bar, a "Sync in progress" message, or a confirmation when sync completes).
• Keep the video concise (30 seconds to 1 minute is ideal) and focused solely on the permission’s use case— no extra fluff or unrelated app features.

Make sure the video is clear, well-lit, and shows the entire flow from start to finish. Google will review this to verify your permission use is legitimate.

备注：内容来源于stack exchange，提问作者sinan ali şeker