一、前言
在 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
五、背景样式：res/drawable/bg_loading_dialog.xml
六、自定义主题：res/values/styles.xml
@android:color/transparent
@null
true
true
false七、使用方法
在需要显示加载框时调用：
// 显示菊花
SdkLoadingDialog.show(this, "正在处理支付...");
// 成功/失败/取消时关闭菊花
SdkLoadingDialog.hide();附件：菊花图标
