代码无报错但悬浮Overlay按钮不可见的问题排查

我尝试开发一款类似Messenger头像的悬浮Overlay按钮（收到消息时显示），运行程序时无代码错误，能看到带有启动按钮的应用界面，但点击按钮后无任何可见内容。

问题根源 #

1. 启动按钮未绑定点击事件：当前代码在MainActivity的onCreate中自动启动服务，但布局里的启动按钮没有设置点击逻辑，导致用户点击按钮无反应。
2. 服务未注册：FloatingWidgetService未在AndroidManifest.xml中声明，系统无法找到并启动该服务。
3. 悬浮窗权限未动态申请：Android 6.0（API 23）及以上系统中，SYSTEM_ALERT_WINDOW权限需要用户手动授权，仅在Manifest中声明无法自动获取。

修复步骤及代码 #

1. 修正MainActivity.java（添加点击事件与权限申请）

package com.example.mywidget;

import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Build;
import android.os.Bundle;
import android.provider.Settings;
import android.view.View;
import android.widget.Button;

public class MainActivity extends Activity {
    private static final int REQUEST_OVERLAY_PERMISSION = 1001;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 绑定启动按钮的点击事件
        Button startButton = findViewById(R.id.start_button);
        startButton.setOnClickListener(v -> {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                // 检查悬浮窗权限
                if (!Settings.canDrawOverlays(this)) {
                    Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
                            Uri.parse("package:" + getPackageName()));
                    startActivityForResult(intent, REQUEST_OVERLAY_PERMISSION);
                } else {
                    startFloatingWidgetService();
                }
            } else {
                // 低版本直接启动服务
                startFloatingWidgetService();
            }
        });
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == REQUEST_OVERLAY_PERMISSION) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                if (Settings.canDrawOverlays(this)) {
                    startFloatingWidgetService();
                }
            }
        }
    }

    private void startFloatingWidgetService() {
        Intent intent = new Intent(this, FloatingWidgetService.class);
        startService(intent);
    }
}

2. 修正AndroidManifest.xml（注册服务）

在<application>标签内添加服务声明，完整代码如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

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

    <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:supportsRtl="true"
        android:theme="@style/Theme.Mywidget"
        tools:targetApi="31">
        <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=".FloatingWidgetService"
            android:exported="false"/>
    </application>

</manifest>

3. 其他代码保持不变

FloatingWidgetService.java、activity_main.xml、floating_widget_layout.xml无需修改。

效果验证 #

1. 运行应用后，点击"Start Floating Widget Service"按钮，若未授权悬浮窗权限，会跳转至系统设置页面引导授权；
2. 授权完成后返回应用，服务会启动，右下角会显示红色的悬浮按钮；
3. 点击悬浮按钮会触发showTextDialog()方法（可自行补充弹窗逻辑）。

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