Android快速设置Tile无法显示问题排查（含服务类与清单代码）

我按照教程完成了Android快速设置Tile的开发，但在三星、Pixel、Vivo等多款设备的自定义Tile添加列表里都找不到这个Tile。下面是我的QuickTileService服务类代码和AndroidManifest配置，麻烦帮忙排查问题：

服务类代码 #

package quick_settings_tile;

import android.service.quicksettings.Tile;
import android.service.quicksettings.TileService;
import android.util.Log;
import android.widget.Toast;

public class QuickTileService extends TileService {
    // Called when the user adds your tile.
    @Override
    public void onTileAdded() {
        super.onTileAdded();

        try {
            // Existing onClick code
            Tile tile = getQsTile();
            tile.setState(Tile.STATE_ACTIVE);
            tile.updateTile();
            Log.d("QuickTileService", "Tile added");
        } catch (Exception e) {
            Log.e("QuickTileService", "Crash: " + e.getMessage());
        }

    }

    // Called when your app can update your tile.
    @Override
    public void onStartListening() {
        super.onStartListening();
        try {
            Tile tile = getQsTile();
            tile.setState(Tile.STATE_ACTIVE);
            tile.updateTile();
            Log.d("QuickTileService", "Tile listening");
        } catch (Exception e) {
            Log.e("QuickTileService", "Crash: " + e.getMessage());
        }
    }


    // Called when the user taps on your tile in an active or inactive state.
    @Override
    public void onClick() {
        super.onClick();

        try {
            // Existing onClick code
            Tile tile = getQsTile();
            Log.d("QuickTileService", "Clicked Label: " + tile.getLabel());
            Toast.makeText(this, "Hello, we are almost there!!!!!!!!!!!!", Toast.LENGTH_SHORT).show();
            getQsTile().updateTile();
        } catch (Exception e) {
            Log.e("QuickTileService", "Crash: " + e.getMessage());
        }
    }

    // Called when the user removes your tile.
    @Override
    public void onTileRemoved() {
        super.onTileRemoved();

        try {
            // Existing onClick code
            Log.d("QuickTileService", "Service removed");
        } catch (Exception e) {
            Log.e("QuickTileService", "Crash: " + e.getMessage());
        }
    }

    @Override
    public void onCreate() {
        super.onCreate();

        try {
            // Existing onClick code
            Log.d("QuickTileService", "Service created");
        } catch (Exception e) {
            Log.e("QuickTileService", "Crash: " + e.getMessage());
        }
    }

}

AndroidManifest配置 #

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.CAMERA" />

    <uses-feature android:name="android.hardware.camera" />

    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.Wire"
        tools:targetApi="31">

        <activity
            android:name="receipts.ReceiptActivity"
            android:exported="false" />

        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <service
            android:name="quick_settings_tile.QuickTileService"
            android:label="Pay bill"
            android:icon="@drawable/white_qr_code_scanner"
            android:exported="true"
            android:permission="android.permission.BIND_QUICK_SETTINGS">

            <meta-data android:name="android.service.quicksettings.ACTIVE_TILE"
                android:value="true" />

            <intent-filter>
                <action android:name="android.service.quicksettings.action.QS_TILE" />
            </intent-filter>

        </service>

    </application>

</manifest>

我已尝试了网上教程中的所有方法，但测试时仍无法看到快速设置Tile。

排查方向及修复方案 #

• API版本兼容性
  确保minSdkVersion不低于24（Android 7.0），Quick Settings Tile从该版本开始支持；同时明确设置targetSdkVersion为24+（如33），部分厂商对未明确版本的应用会过滤Tile。

• 移除无效Meta-Data
  删除android.service.quicksettings.ACTIVE_TILE这个元数据，该属性仅用于系统内置Tile，第三方应用添加后会导致系统识别异常。

• 图标资源验证
  检查@drawable/white_qr_code_scanner是否存在且符合规范：

  • 提供多分辨率适配资源（24x24dp基准）
  • 避免使用全透明或风格冲突的图标，可临时替换为@mipmap/ic_launcher测试
  • 部分厂商要求图标必须为不透明的纯色风格

• Manifest配置优化

  • 将android:label改为引用字符串资源（如@string/tile_label），硬编码字符串在部分厂商系统中可能不被识别
  • 确认服务类的包名quick_settings_tile.QuickTileService与实际类路径完全一致，大小写、路径错误会导致系统找不到服务

• 应用初始化验证
  部分厂商要求应用必须至少启动一次（打开MainActivity），才会在Quick Settings列表中显示Tile，先启动应用再去添加列表查看。

• 厂商系统特殊限制

  • 国产厂商（如Vivo、OPPO）可能存在白名单机制，需在应用信息中检查是否有“快捷设置”相关权限需要开启
  • 三星设备可尝试清除系统UI缓存：设置 -> 应用 -> 显示系统应用 -> 系统UI -> 存储 -> 清除缓存

内容的提问来源于stack exchange，提问作者Jim The Creator