一:简述
今天给android开发者们,推荐一个金典的界面提示框架WisdomProgressHUD,使用简洁方便。
WisdomProgressHUD 是一个半透明的 HUD 指示器。 WisdomProgressHUD 是android 版SDK,由java编写,保证兼容性问题。
全局HUD单列对象,支持属性动态调整, 支持延时调用,无需开发关心释放问题,是一个强大的HUD库,使用简介,操作方便。
github 链接:https://github.com/tangjianfengVS/WisdomProgressHUD
二:WisdomProgressHUD 支持类型
1: Default (只有文字没有图片,默认使用)
2: Succee (有文字,有图片,成功提示)
3: Error (有文字,有图片,失败提示)
4: Warning (有文字,有图片,警告提示)
5: Loading (有文字,有图片,加载中提示)("Loading" 和上面的类型不同,是耗时任务,不会自动消灭任务,需要手动调用 'dismiss',结束回调任务也不会实现)
三:WisdomProgressHUD 属性设置
1: static float HUDTextSize = 13
说明: 提示时候的文字字体pd大小,设置最小值13号pd
2: static float HUDShowTime = 2500
说明: 提示时候的界面显示时间,设置最小值1秒
3: task end handler task. (任务结束回调)
public interface FinishHandler { void finish(); }
......后面有待扩展
四:WisdomProgressHUD 使用分类
1: 在 "OnCreate" 中的调用:
说明: 为了解决 android 机制不允许在 "OnCreate" 方法中向屏幕中添加UI问题,所以 "OnCreate"需要用到HUD,请调用 "startOnCreate" 方法。
2: 普通使用:
说明: 不在 "OnCreate" 中使用 "start" 方法。
3: 延迟使用:
说明:在当前时间延迟使用功能,调用 "after" 方法。
五:WisdomProgressHUD 具体API,参数
/** ---- 1: start show -----
* showState: task type, defoult value 'Default'. (任务类型)
* context : 'Context' value.
* text: show textView title value. (文字) */
public static void start(int showState, Context context, String text){ }
/** ----2: start show with 'WisdomProgressHUD.FinishHandler'-----
* showState: task type, defoult value 'Default'. (任务类型)
* context : 'Context' value.
* text: show textView title value. (文字)
* finishHandler: task end handler task. (任务结束回调) */
public static void start(int showState, Context context, String text, WisdomProgressHUD.FinishHandler finishHandler){ }
/** ---- 3: start show OnCreate -----
* Use the API when a prompt needs to be loaded in 'OnCreate'.(在 ‘OnCreate’ 中需要加载提示时使用API)
* showState: task type, defoult value 'Default'. (任务类型)
* context : 'Context'.
* text: show textView title value. (文字)
* ViewGroup: The 'Context' rootLayout. (Context的底层布局) */
public static void startOnCreate(int showState, Context context, String text, ViewGroup rootView){ }
/** ---- 4:start show OnCreate with 'WisdomProgressHUD.FinishHandler' -----
* Use the API when a prompt needs to be loaded in 'OnCreate'.(在 ‘OnCreate’ 中需要加载提示时使用API)
* showState: task type, defoult value 'Default'. (任务类型)
* context : 'Context'.
* text: show textView title value. (文字)
* ViewGroup: The 'Context' rootLayout. (Context的底层布局)
* finishHandler: task end handler task. (任务结束回调) */
public static void startOnCreate(int showState, Context context, String text, ViewGroup rootView, WisdomProgressHUD.FinishHandler finishHandler){ }
/** ----- 5: after task -----
* delay: after task time value. */
public static void after(final int showState, final Context context, final String text, long delay){ }
/** ----- 6: after task -----
* delay: after task time value. */
public static void after(final int showState, final Context context, final String text, final long delay, final WisdomProgressHUD.FinishHandler finishHandler){ }
/** 7: dismiss(手动释放)*/
public static void dismiss() { }
六:WisdomScreenUtils: 提供屏幕尺寸转换处理功能
/** 根据手机的分辨率从 dp 的单位 转成为 px(像素) */
public static int dip2px(Context context, float dpValue) { return (int) }
/** 根据手机的分辨率从 px(像素) 的单位 转成为 dp */
public static int px2dip(Context context, float pxValue) { return (int) }
/** 获取屏幕密度 */
public static float getScreenDensity(Context context) { return float }
/** 获取屏幕宽度(像素) */
public static int getScreenWidthPixels(Context context) { return int }
/** 获取屏幕宽度(dp) */
public static float getScreenWidthDp(Context context) { return float }
/** 获取屏幕高度(像素) */
public static int getScreenHeightPixels(Context context) { return int }
/** 获取屏幕高度(dp) */
public static float getScreenHeightDp(Context context) { return float }
/** 获取状态栏高度 */
public static int getStatusHeight(Context context) { return int }
/** 保存屏幕截图到本地
* @param activity
* @param strFileName 文件全路径:例如 "/sdcard/screen_shot_20160424.jpg" */
public static void savScreenShot(Activity activity, String strFileName) { }
/** 截图
* 也可以调用shell命令去截图 screencap -p test.png
* @param activity 截取activity 所在的页面的截图,即使退到后台也是截取这个activity */
private static Bitmap takeShot(Activity activity) { return Bitmap }
七: Android Studio SDK 集成:
1: build.gradle 配置 'https://jitpack.io' :
allprojects {
repositories { maven { url 'https://jitpack.io' } }
}
2: build.gradle 配置 'com.github.tangjianfengVS:WisdomProgressHUD:0.0.1' :
dependencies {
implementation 'com.github.tangjianfengVS:WisdomProgressHUD:0.0.1'
}
八:结语:
WisdomProgressHUD Android SDK,界面设计漂亮,并且是一款金典的HUD,并且支持屏蔽任务期间的用户交互。
WisdomProgressHUD Android SDK,开发中使用方便,性能高效,自动管理生命周期,兼容'Oncreate'方法中调用,非常推荐给大家使用!