DrawableToolbox 使用教程

1、项目介绍

DrawableToolbox 是一个完备的 Drawable 工具箱，旨在通过代码构建种类丰富的 Drawable，告别重复冗杂的 drawable XML 文件。该项目提供了丰富的 API，使得开发者能够轻松创建复杂的 Drawable，从而提高开发效率和代码的可维护性。

2、项目快速启动

添加依赖

首先，在您的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.github.duanhong169:drawabletoolbox:${latestVersion}'
}

请将 ${latestVersion} 替换为最新的版本号。

创建 Drawable

以下是一个简单的示例，展示如何使用 DrawableToolbox 创建一个带有圆角和渐变背景的 Drawable：

val drawable = DrawableBuilder()
    .rectangle()
    .rounded()
    .gradient()
    .linearGradient()
    .angle(90)
    .startColor(ContextCompat.getColor(context, R.color.colorPrimary))
    .endColor(ContextCompat.getColor(context, R.color.colorPrimaryDark))
    .build()

yourView.background = drawable

3、应用案例和最佳实践

案例一：自定义按钮背景

使用 DrawableToolbox 可以轻松创建具有不同状态（按下、选中）的按钮背景：

val normalState = DrawableBuilder()
    .rectangle()
    .rounded()
    .solidColor(ContextCompat.getColor(context, R.color.colorPrimary))
    .build()

val pressedState = DrawableBuilder()
    .rectangle()
    .rounded()
    .solidColor(ContextCompat.getColor(context, R.color.colorPrimaryDark))
    .build()

val stateListDrawable = StateListDrawableBuilder()
    .normal(normalState)
    .pressed(pressedState)
    .build()

yourButton.background = stateListDrawable

案例二：复杂渐变背景

创建一个具有复杂渐变效果的背景：

val drawable = DrawableBuilder()
    .rectangle()
    .rounded()
    .gradient()
    .radialGradient()
    .centerColor(ContextCompat.getColor(context, R.color.colorPrimary))
    .edgeColor(ContextCompat.getColor(context, R.color.colorPrimaryDark))
    .build()

yourView.background = drawable

4、典型生态项目

DrawableToolbox 可以与其他流行的 Android 库和工具结合使用，例如：

• Glide：用于加载和显示图片，结合 DrawableToolbox 可以创建复杂的图片背景。
• Retrofit：用于网络请求，结合 DrawableToolbox 可以创建加载中的 Drawable 效果。
• DataBinding：用于数据绑定，结合 DrawableToolbox 可以动态改变视图的背景。

通过这些组合，可以进一步提升应用的用户体验和视觉效果。