为何我的应用变体未显示在文件权限设置页面？

核心原因 #

你遇到的问题本质是两个点：

1. MANAGE_EXTERNAL_STORAGE权限的系统展示逻辑：Android系统的「文件权限」列表页面，只会展示系统判定为“核心功能需要访问全外部存储”的应用。调试构建（debug变体）默认带有android:debuggable="true"标记，部分系统版本会将这类应用过滤出列表，而主应用的构建变体不会被过滤。
2. 跳转逻辑的问题：如果你的代码是打开通用的「所有文件访问权限」列表页面（而非当前应用的权限详情页），测试变体就可能因为系统过滤而不显示。

另外你提到的package name和applicationId的混淆：Android系统识别应用权限是基于applicationId（即你说的Bundle ID），而非代码的package命名空间。测试变体的applicationId是com.mycompany.app.test，和主应用是完全独立的两个应用，这不是问题根源，只是系统对调试应用的特殊处理导致它没出现在列表里。

解决方法 #

1. 修改跳转逻辑，直接打开测试变体的权限详情页 #

不要打开通用的权限列表，而是直接跳转到当前应用的所有文件访问权限设置页，这样不管系统是否将应用列入列表，都能直接进入设置界面。代码示例：

Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
Uri uri = Uri.fromParts("package", getApplicationContext().getPackageName(), null);
intent.setData(uri);
startActivity(intent);

这段代码会直接定位到当前应用（测试变体）的权限设置页，用户可以在这里找到并开启MANAGE_EXTERNAL_STORAGE权限。

2. 确保测试变体的权限声明正确 #

检查测试变体的AndroidManifest.xml中是否正确声明了权限，并且适配了不同SDK版本：

<!-- 适配Android 11+ -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />
<!-- 适配Android 10及以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="29" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="29" />

如果用了Gradle的构建变体管理，确保测试变体没有移除该权限。比如可以用manifest占位符在release变体中自动移除权限：
在build.gradle中配置：

android {
    buildTypes {
        debug {
            manifestPlaceholders.addManageStoragePermission = true
        }
        release {
            manifestPlaceholders.addManageStoragePermission = false
        }
    }
}

然后在Manifest中使用占位符控制权限：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30"
    tools:remove="${addManageStoragePermission ? '' : 'android:name'}" />

3. 临时关闭测试变体的debuggable标记（可选） #

如果上述方法无效，可以尝试在测试变体的Gradle配置中关闭debuggable：

android {
    buildTypes {
        debug {
            debuggable false
        }
    }
}

但这样会失去调试功能，仅建议作为临时验证手段，不推荐长期使用。

内容的提问来源于stack exchange，提问作者Bungles