Skip to content
/ XAndroidUtil Public

封装自己常用的一些Android的组件或工具

2 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

stars-one/XAndroidUtil

BranchesTags

Repository files navigation

Android工具库

封装自己常用的一些Android的组件或工具

目录

依赖

需要先引用JitPack仓库源

<dependency>
    <groupId>com.github.stars-one</groupId>
    <artifactId>xAndroidUtil</artifactId>
    <version>0.1</version>
</dependency>


implementation 'com.github.stars-one:xAndroidUtil:0.1'

全局配置工具类

使用此工具类可以不用关注配置项的保存或进入APP的初始化读取配置

1.新建常量池

class Constants {
    companion object {
        val SP_USER_NAME = "username"
    }
}

2.配置配置项

class GlobalData {
    companion object {
        //设置默认值
        val userName = GlobalDataConfig(Constants.SP_USER_NAME, "")
    }
}

3.使用

在需要用的地方使用下面取值

val value = GlobalData.userName.currentValue()

数值变更调用此方法:

val value = GlobalData.userName.setValue("myname")

新增监听回调功能,用法如下:

GlobalData.userName.addCallBack{
    //里面你的逻辑,如
    val valueResult = GlobalData.userName.currentValue
}

当配置的数据发生变更,都会执行一次回调

2.Remix图标

将Remix Icon图标封装在Android中,方便快速调用

基于Remix的3.2.0版本

在xml使用

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <site.starsone.xandroidutil.view.RemixIconTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:iconName="home-5-fill" />

</LinearLayout>

代码中使用:

val tvHome = findViewById<RemixIconTextView>(R.id.tvHome)
tvHome.iconName = "home-5-fill"

3.工具类方法

PS: 位于XAndroidMethod类中

  • openUrlByDefaultBrower 使用默认浏览器打开网址
  • openUrlByBrower 弹窗选择浏览器打开链接
  • showTipDialog 显示提示框(有个不再提示的选项)

4.主题样式

  • ripple_common_bg.xml 水波纹背景

5.SlantedTextView

一个倾斜的TextView,适用于标签效果,搬运HeZaiJin/SlantedTextView: Android slanted TextView.

预览效果

xml使用

<com.haozhang.lib.SlantedTextView
    android:layout_width="80dp"
    android:layout_height="80dp"
    android:gravity="center"
    app:slantedBackgroundColor="@color/secondary_text"
    app:slantedLength="40dp"
    app:slantedMode="left"
    app:slantedText="IOS"
    app:slantedTextColor="@color/primary"
    app:slantedTextSize="16sp"
    />

Java使用

SlantedTextView stv = (SlantedTextView) findViewById(R.id.test);

stv.setText("PHP")
        .setTextColor(Color.WHITE)
        .setSlantedBackgroundColor(Color.BLACK)
        .setTextSize(18)
        .setSlantedLength(50)
        .setMode(SlantedTextView.MODE_LEFT);

属性说明

SlantedMode模式可选项

6.日志查看功能

移植了getActivity / Logcat开源库的功能,稍微调整了下样式

通过下面的代码跳转到页面,可看到效果

startActivity(LogcatActivity::class.java)

7.扩展方法

  • Long.toDateString long类型转时间字符串
  • Long.toUnitString 字节转为对应的单位
  • Long.toUnitStringNew 字节转为对应的单位
  • Long.toUnitStringNewWithUnit 字节转为对应的单位,得到Pair类型结果的数值和单位分开
  • Long.fillZero 前置补0
  • Int.fillZero 前置补0
  • Date.toDateString date类型转时间字符串
  • Double.toFix double保留几位小数
  • String.parseJsonToList json字符串转List对象
  • String.parseJsonToObject json字符串转Object对象
  • File.getMimeType 获取文件的mimeType
  • StateListDrawable.getXStateDrawable 获取selector中某个状态的drawable
  • ColorStateList.getColorForState 获取selector中某个状态的color
  • ComponentActivity.startActivityForResult 打开新Activity并可以在回调中直接接收返回叔叔
  • TextView.showHighText TextView设置关键字高亮

8.XActivityUtil

  • joinQqGroup() 跳转qq的加入群的页面方法,需要传个qq群号
  • openFile() 打开文件

9.FloatingActionBtnMenu 悬浮按钮组菜单

用了第三方,感觉他们的api使用有些麻烦,自己抽空实现了一个简单的垂直排列的悬浮按钮

效果

使用

1.xml中添加组件

<site.starsone.xandroidutil.view.FloatingActionBtnMenu
    android:id="@+id/fabMenu"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:iconBgColor="@color/design_default_color_error"
    app:iconColor="@color/design_default_color_secondary"
/>
  • iconBgColor 主按钮的背景色
  • iconColor 主按钮的图标色

也可以通过方法setMainBtnStyle()修改

2.设置按钮组菜单项和点击监听器

有2个方法来快速构建子项

  • buildItemsByMenuData() 通过menu菜单资源
  • buildItemsByListData() 通过list数据

使用buildItemsByMenuData方法:

需要定义个mymenu.xml的菜单文件

val fabMenu = findViewById<FloatingActionBtnMenu>(R.id.fabMenu)
val list = listOf(
    FloatingActionBtnMenu.MenuItemData("", R.drawable.ic_baseline_adb_24),
    FloatingActionBtnMenu.MenuItemData(
        "sec", R.drawable.ic_baseline_adb_24,
        FloatingActionBtnMenu.MenuItemStyle()
    )
)

fabMenu.buildItemsByMenuData(R.menu.mymenu) {
    //按钮的点击监听器
    when (it) {
        R.id.menuFirst -> {
            ToastUtils.showShort("点击了first")
        }
        R.id.menuSec -> {
            ToastUtils.showShort("点击了sec")
        }
    }
}

使用buildItemsByListData方法:

val fabMenu = findViewById<FloatingActionBtnMenu>(R.id.fabMenu)
val list = listOf(
    FloatingActionBtnMenu.MenuItemData("", R.drawable.ic_baseline_adb_24),
    FloatingActionBtnMenu.MenuItemData(
        "sec", R.drawable.ic_baseline_adb_24,
        FloatingActionBtnMenu.MenuItemStyle()
    )
)
fabMenu.buildItemsByListData(list) {
    when (it) {
        0 -> ToastUtils.showShort("点击了first")
        1 -> ToastUtils.showShort("点击了sec")
    }
}

样式修改

样式数据实体类为MenuItemStyle,解释如下:

/**
 * @param textColor 左侧文本颜色
 * @param textBgColor 左侧文本背景色
 * @param iconColor 右侧图标颜色
 * @param iconBgColor 右侧图标背景色
 */
data class MenuItemStyle(
    @ColorInt val textColor: Int = ColorUtils.getColor(R.color.black),
    @ColorInt val textBgColor: Int = ColorUtils.getColor(R.color.white),
    @ColorInt val iconColor: Int = ColorUtils.getColor(R.color.white),
    @ColorInt val iconBgColor: Int = ColorUtils.getColor(R.color.purple_700)
)

使用buildItemsByMenuData()方法来构建的话,可以使用第二个参数,接收一个List来设置每个item的样式颜色,注意要和menu资源文件的item项数要保持一致!

而使用buildItemsByListData()方法来构建的话,FloatingActionBtnMenu.MenuItemData实体类里的第三个参数可附加样式

单独使用

考虑到自己APP的需求,有时候可能APP只会有个添加功能,就懒得改回使用FAB了,索性就让这个组件支持单个使用(即点击后不会弹出多个按钮了)

使用的话很简单,设置一下点击事件即可(不创建多个菜单子项就可以了),如下代码所示

val fabMenu = findViewById<FloatingActionBtnMenu>(R.id.fabMenu)
fabMenu.setMainBtnClickListener{
    //点击操作...
}

10.设置项组件

可自动保存设置项数值的组件,无需关注保存和读取逻辑

PS: showTip属性是后续新增的,3个都可以使用

1.SettingItemRadioGroup 单选按钮设置项

支持GlobalData的Int和String类型

<site.starsone.xandroidutil.view.SettingItemRadioGroup
    android:id="@+id/sirb"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:tip="提示说明"
    app:text="下载模式"/>
object MyGlobalData {
    val mode = GlobalDataConfig("mymode", 1)
}

val sItemRb = findViewById<SettingItemRadioGroup>(R.id.sirb)
sItemRb.setData(SettingItemRadioGroupDataInt(listOf(
    Pair(1,"模式1"),
    Pair(2,"模式2"),"下载模式","提示文本"
),MyGlobalData.mode))
  • setRbOrientation() 设置排列方向

2.SettingItemSwitch 开关设置项

<site.starsone.xandroidutil.view.SettingItemSwitch
    android:id="@+id/siSwtich"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:tip="提示说明"
    app:text="测试开关"/>
object MyGlobalData {
    val openFlag = GlobalDataConfig("openFlag", true)
}

val siSwtich = findViewById<SettingItemSwitch>(R.id.siSwtich)
siSwtich.setData(SettingItemSwitchData(MyGlobalData.openFlag))

3.SettingItemTextInt 数字输入设置项

点击整个item会弹出对话框,让用户输入数字

<site.starsone.xandroidutil.view.SettingItemTextInt
    android:id="@+id/siText"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:tip="提示说明222"
    app:text="测试开关223"
    app:showTip="false"
    />
object MyGlobalData {
    val mode = GlobalDataConfig("openFlag", 3)
}

val siText = findViewById<SettingItemTextInt>(R.id.siText)
siText.setData(SettingItemTextDataInt(MyGlobalData.mode,dialogTip = "输入数字,此选项重启才会生效",showTip = true))

11.BadgeObservableData 小红点封装类

与com.google.android.material.bottomnavigation.BottomNavigationView联用,方便更新小红点数据

//从底部导航栏得到小红点组件对象
val badgeDrawable = bottomNav.getOrCreateBadge(R.menu.menuAdd)
//将小红点组件对象转为我们的实体类
val badgeObservableData = badgeDrawable.toBadgeObservableData()

//更新小红点的数量,会自动更新数据,且包含了主线程切换操作
badgeObservableData.data = 20

toBadgeObservableData(zeroHide) 是一个扩展方法

提供了个zeroHide参数,如果为false的话,当小红点上的数值为0,则会有下面的效果(下载中那个菜单);为true的话,则是直接隐藏小红点的显示

12.侧滑菜单布局SuperSlidingPaneLayout

复制于jenly1314/SuperSlidingPaneLayout: SuperSlidingPaneLayout 是基于SlidingPaneLayout扩展修改，新增几种不同的侧滑效果。,更新为androidx版本

xml布局:

<?xml version="1.0" encoding="utf-8"?>
<site.starsone.xandroidutil.view.SuperSlidingPaneLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/sPanelLayout"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    app:mode="default_"
    app:compat_sliding="false"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <!--  注意顺序,一定是目录布局,然后再到内容  -->

    <!--  侧边栏目录布局  -->
    <include layout="@layout/main_drawer" android:layout_width="match_parent" android:layout_height="match_parent"/>

    <!-- 内容布局   -->
    <include layout="@layout/main_content" android:layout_width="match_parent" android:layout_height="match_parent"/>

</site.starsone.xandroidutil.view.SuperSlidingPaneLayout>

13.FlowLayout自定义布局

参考视频定制TagFlowLayout实现单选多选效果1_Android多种方式实现流式布局-慕课网写的一个自定义流式布局

使用的示例xml:

<?xml version="1.0" encoding="utf-8"?>
<com.example.myapplication.view.FlowLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/flowlayout"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:maxLines="10"
    android:maxRows="11"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".FlowLayoutTestActivity">

    <Button
        android:layout_width="wrap_content"
        android:layout_margin="4dp"
        android:layout_height="wrap_content"
        android:text="helo"/>

</com.example.myapplication.view.FlowLayout>

14.SelectImageView组件

需求来源: 项目中经常会有个根据点击从而对图片进行切换,比如勾选功能(之前的解决方法就是写个selector,然后更改imageview的isSelected属性来实现)

不过还是觉得每次要创建一个selector文件比较麻烦,于是想通过直接在xml中使用2个图片来优化流程,于是就有了此组件

组件里面已经包含了点击事件,使用的时候不需要再去设置,如果想要设置,也提供了个方法setOnClick

<!--    正常使用,点击切换图标的选中状态    -->
<site.starsone.xandroidutil.view.SelectImageView
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   app:selectImg="@drawable/ic_baseline_adb_24_gray"
   app:normalImg="@drawable/ic_baseline_adb_24_rose"
   />

<!--   选中才展示图标的效果 ,使用透明色  -->
<site.starsone.xandroidutil.view.SelectImageView
   android:layout_marginStart="16dp"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   app:selectImg="#00000000"
   app:normalImg="@drawable/ic_baseline_adb_24_rose"
   />

<!--       着色效果    -->
<site.starsone.xandroidutil.view.SelectImageView
   android:layout_marginStart="16dp"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   app:selectImgTint="#03bbf3"
   app:selectImg="@drawable/ic_baseline_adb_24_gray"
   app:normalImg="@drawable/ic_baseline_adb_24_rose"
   />

15.通用Recyclerview的item装饰ItemDecoration

ItemDecorationVertical

可实现垂直线性布局中间item的分割间距效果,效果图如下

val itemDero = ItemDecorationVertical(12)
mrecyclerview.addItemDecoration(itemDero)

ItemDecorationGrid

可实现网格布局item的分割间距效果,效果图如下

//每行3个
val itemDero = ItemDecorationGrid(3,12) {outRect, space, position ->  }
mrecyclerview.addItemDecoration(itemDero)

BlankItemDecoration

适用于线性布局的recyclerview,给每个item增加一个空白分割效果

16. NetWorkUtil网络工具类

  • ping(host:String) 向某个域名发起ping请求

About

封装自己常用的一些Android的组件或工具

Resources

Readme
Activity

Stars

2 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases 39

Release 0.9.34 Latest
Oct 31, 2024
+ 38 releases

Languages