Giters

stars-one / XAndroidUtil

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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 弹窗选择浏览器打开链接

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.fillZero 前置补0
  • Int.fillZero 前置补0
  • Date.toDateString date类型转时间字符串
  • Double.toFix double保留几位小数
  • String.parseJsonToList json字符串转List对象
  • String.parseJsonToObject json字符串转Object对象
  • File.getMimeType 获取文件的mimeType

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.设置项组件

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

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))

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的话,则是直接隐藏小红点的显示

About

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

Languages

Language:Java 54.2%Language:Kotlin 45.8%