实战：Android 自定义菊花加载框（带超时自动消失）

一、前言

在 Android 项目开发中，经常需要用到 加载中菊花（类似 iOS 的 HUD 效果），例如支付请求、接口调用等场景。

二、实现效果

如果只是简单写个 ProgressDialog，可控性不强，也不够美观。

下面我分享一个封装好的 菊花加载框工具类 —— SdkLoadingDialog，支持：

✅ 自定义布局（菊花 + 提示文字）
✅ 半透明黑色圆角背景（类似 iOS HUD）
✅ 超时保护（默认 15 秒后自动消失，避免菊花转不停）
✅ 全局静态调用，简单易用

三、核心工具类：SdkLoadingDialog.java

package com.example.sdk.config;

import android.app.Dialog;
import android.content.Context;
import android.os.Handler;
import android.os.Looper;
import android.view.LayoutInflater;
import android.view.View;
import android.widget.TextView;

import com.example.sdk.R;

public class SdkLoadingDialog extends Dialog {

    private static SdkLoadingDialog instance;
    private static Handler handler = new Handler(Looper.getMainLooper());
    private static Runnable timeoutRunnable;

    private SdkLoadingDialog(Context context, int themeResId) {
        super(context, themeResId);
    }

    /**
     * 显示菊花
     * @param context Activity
     * @param message 提示信息
     */
    public static void show(Context context, String message) {
        hide(); // 先清理旧实例，避免多次 show

        LayoutInflater inflater = LayoutInflater.from(context);
        View view = inflater.inflate(R.layout.dialog_loading, null);

        TextView msgText = view.findViewById(R.id.tipTextView);
        if (message != null && message.length() > 0) {
            msgText.setText(message);
            msgText.setVisibility(View.VISIBLE);
        } else {
            msgText.setVisibility(View.GONE);
        }

        instance = new SdkLoadingDialog(context, R.style.MyDialogStyle);
        instance.setCancelable(false); // 禁止返回键取消
        instance.setContentView(view);
        instance.show();

        // 超时保护：15 秒后强制关闭
        timeoutRunnable = SdkLoadingDialog::hide;
        handler.postDelayed(timeoutRunnable, 15000);
    }

    /**
     * 隐藏菊花
     */
    public static void hide() {
        if (instance != null && instance.isShowing()) {
            Context ctx = instance.getContext();
            if (ctx != null) {
                instance.dismiss();
            }
        }
        instance = null;

        if (handler != null && timeoutRunnable != null) {
            handler.removeCallbacks(timeoutRunnable);
            timeoutRunnable = null;
        }
    }
}

四、自定义布局：res/layout/dialog_loading.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="120dp"
    android:layout_height="120dp"
    android:gravity="center"
    android:orientation="vertical"
    android:background="@drawable/bg_loading_dialog">

    <ProgressBar
        android:id="@+id/progressBar"
        android:layout_width="40dp"
        android:layout_height="40dp"
        android:indeterminate="true"
        android:indeterminateTint="@android:color/white" />

    <TextView
        android:id="@+id/tipTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="12dp"
        android:text="加载中..."
        android:textColor="@android:color/white"
        android:textSize="14sp" />
</LinearLayout>

五、背景样式：res/drawable/bg_loading_dialog.xml

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="#CC000000"/> <!-- 半透明黑色 -->
    <corners android:radius="12dp"/>   <!-- 圆角 -->
</shape>

六、自定义主题：res/values/styles.xml

<style name="MyDialogStyle" parent="Theme.AppCompat.Light.Dialog">
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowFrame">@null</item>
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowIsFloating">true</item>
    <item name="android:backgroundDimEnabled">false</item>
</style>

七、使用方法

在需要显示加载框时调用：

// 显示菊花
SdkLoadingDialog.show(this, "正在处理支付...");

// 成功/失败/取消时关闭菊花
SdkLoadingDialog.hide();

附件：菊花图标