android 界面提示框架WisdomProgressHUD,为金典而生

时间:2024-01-25 07:06:13

一:简述

今天给android开发者们,推荐一个金典的界面提示框架WisdomProgressHUD,使用简洁方便。

WisdomProgressHUD 是一个半透明的 HUD 指示器。 WisdomProgressHUD 是android 版SDK,由java编写,保证兼容性问题。

全局HUD单列对象,支持属性动态调整, 支持延时调用,无需开发关心释放问题,是一个强大的HUD库,使用简介,操作方便。

github 链接:https://github.com/tangjianfengVS/WisdomProgressHUD

 

二:WisdomProgressHUD 支持类型

        1:  Default  (只有文字没有图片,默认使用)

 
Default

        2:  Succee    (有文字,有图片,成功提示)

 
Succee

        3:  Error    (有文字,有图片,失败提示)

 
Error

        4:  Warning  (有文字,有图片,警告提示)

 
Warning

        5:  Loading  (有文字,有图片,加载中提示)("Loading" 和上面的类型不同,是耗时任务,不会自动消灭任务,需要手动调用 'dismiss',结束回调任务也不会实现)

 
Loading

三: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'方法中调用,非常推荐给大家使用!