实战：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(); // 先清理旧实例，避免多次 showLayoutInflater 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"><ProgressBarandroid:id="@+id/progressBar"android:layout_width="40dp"android:layout_height="40dp"android:indeterminate="true"android:indeterminateTint="@android:color/white" /><TextViewandroid: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();
附件：菊花图标
