/Common

通用类库:Kotlin 扩展、Kotlin-Dsl(animation、layout、代码构造Drawable)、动态权限申请、缓存(内存、磁盘、内存+磁盘)。

Primary LanguageKotlinApache License 2.0Apache-2.0

Common

通用类库:Kotlin 扩展、Kotlin-DSL(animation、layout、代码构造Drawable)、动态权限申请、缓存(内存、磁盘、内存+磁盘)。

How to include it in your project:

Step 1. Add the JitPack repository to your build file

allprojects {
    repositories {
        google()
        mavenCentral()
        maven("https://jitpack.io")
    }
}

Step 2. Add the dependency

dependencies {
    implementation("com.github.FPhoenixCorneaE:Common:$latest")
}

**Step 3.**Add the dependencies you need

dependencies {
    // lifecycle
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:$lifecycle_version")
    implementation("androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version")
    // coroutines
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version")
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutines_version")
    // navigation
    implementation("androidx.navigation:navigation-common-ktx:$navigation_version")
    implementation("androidx.navigation:navigation-fragment-ktx:$navigation_version")
    implementation("androidx.navigation:navigation-runtime-ktx:$navigation_version")
    implementation("androidx.navigation:navigation-ui-ktx:$navigation_version")
    // Gson
    implementation("com.google.code.gson:gson:2.8.9")
    // eventbus
    implementation("org.greenrobot:eventbus:3.3.1")
    // coil
    implementation("io.coil-kt:coil:$coil_version")
    implementation("io.coil-kt:coil-gif:$coil_version")
    implementation("io.coil-kt:coil-svg:$coil_version")
    implementation("io.coil-kt:coil-video:$coil_version")
    // coil-transformations
    implementation("com.github.Commit451.coil-transformations:transformations:$coil_transformations_version")
    implementation("com.github.Commit451.coil-transformations:transformations-gpu:$coil_transformations_version")
    implementation("com.github.Commit451.coil-transformations:transformations-face-detection:$coil_transformations_version")
}

How to use:

2.若是有自定义 Startup Initializer,需要依赖CommonInitializer

override fun dependencies(): MutableList<Class<out Initializer<*>>> {
    return mutableListOf(CommonInitializer::class.java)
}

4.代码构造Drawable

GradientDrawable:

gradientDrawable(this) {
    shape(Shape.RECTANGLE)
    solidColor(Color.GRAY)
//            solidColor {
//                item {
//                    color(Color.RED)
//                    state(StatePressed)
//                }
//                item {
//                    color(Color.BLUE)
//                    minusState(StatePressed)
//                }
//            }
    corner {
//                radius(20f)
        radii(
            topLeftRadius = 5f,
            topRightRadius = 10f,
            bottomLeftRadius = 15f,
            bottomRightRadius = 20f
        )
    }
    stroke {
        width(3f)
        dashWidth(8f)
        dashGap(3f)
        color {
            item {
                color(Color.BLUE)
                state(StatePressed)
            }
            item {
                color(Color.RED)
                minusState(StatePressed)
            }
        }
    }
    padding {
        setPadding(left = 8f, top = 8f, right = 8f, bottom = 8f)
    }
    size(width = 100, height = 20)
//            gradient {
//                gradientCenter(0.5f, 0.5f)
//                useLevel(false)
//                gradientType(GradientType.LINEAR_GRADIENT)
//                orientation(GradientDrawable.Orientation.LEFT_RIGHT)
//                gradientRadius(10f)
//                gradientColors(intArrayOf(Color.TRANSPARENT, Color.BLACK))
//            }
}

StateListDrawable:

stateListDrawable {
    item {
        drawable(ColorDrawable(Color.GRAY))
        minusState(StatePressed)
    }
    item {
        drawable(ColorDrawable(Color.GREEN))
        state(StatePressed)
    }
}

5.自定义日志打印(v2.0.5加入)

默认使用android.util.Log打印,若要使用自定义日志打印或者第三方打印库,可实现接口com.fphoenixcorneae.common.log.Printer,然后在自定义ApplicationattachBaseContext(base: Context?)方法中初始化,并调用AndroidLog.setPrinter(printer: Printer)

示例:

package com.fphoenixcorneae.common.demo

import com.fphoenixcorneae.common.log.Printer
import com.orhanobut.logger.Logger

/**
 * @desc:CustomPrinter
 * @date:2022/5/3 11:41
 */
class CustomPrinter : Printer {
    override fun v(tag: String?, message: String, vararg args: Any?) {
        Logger.t(tag).v(message, args)
    }

    override fun d(tag: String?, message: String, vararg args: Any?) {
        Logger.t(tag).d(message, args)
    }

    override fun i(tag: String?, message: String, vararg args: Any?) {
        Logger.t(tag).i(message, args)
    }

    override fun w(tag: String?, message: String, vararg args: Any?) {
        Logger.t(tag).w(message, args)
    }

    override fun e(tag: String?, message: String, vararg args: Any?) {
        Logger.t(tag).e(message, args)
    }

    override fun wtf(tag: String?, message: String, vararg args: Any?) {
        Logger.t(tag).wtf(message, args)
    }

    override fun json(tag: String?, message: String?) {
        Logger.t(tag).json(message)
    }

    override fun xml(tag: String?, message: String?) {
        Logger.t(tag).xml(message)
    }
}
override fun attachBaseContext(base: Context?) {
    super.attachBaseContext(base)
    // 初始化日志打印配置
    initLoggerConfig()
    AndroidLog.setPrinter(CustomPrinter())
}

6.内存缓存MemoryCache、磁盘缓存DiskCache、双重缓存DoubleCache

  • MemoryCacheManager:内存缓存管理

    • 设置自定义的默认内存缓存(可选):

      setDefaultMemoryCache(memoryCache: MemoryCache),默认有一个defaultMemoryCache

    • 将值放入内存缓存:

      put(key: String, value: Any?)

    • 将值从内存缓存中取出:

      get(key: String, defaultValue: T?)

    • 获取内存缓存计数:

      getCacheCount()

    • 根据key将值从内存缓存中移除:

      remove(key: String)

    • 清除所有内存缓存:

      clear()

  • DiskCacheManager:磁盘缓存管理

    • 设置自定义的默认磁盘缓存(可选):

      setDefaultDiskCache(diskCache: DiskCache),默认有一个defaultDiskCache

    • 将值放入磁盘缓存:

      put(key: String, value: Any?)

    • 将值从磁盘缓存中取出:

      get(key: String, defaultValue: T?)getParcelable(key: String, creator: Parcelable.Creator<T>) /getParcelable(key: String, parceler: Parceler<T>)

    • 获取磁盘缓存大小(字节数):

      getCacheSize()

    • 获取磁盘缓存计数:

      getCacheCount()

    • 根据key将值从磁盘缓存中移除:

      remove(key: String)

    • 清除所有磁盘缓存:

      clear()

  • DoubleCacheManager:双重(内存+磁盘)缓存管理

    • 设置自定义的默认双重缓存(可选):

      setDefaultDoubleCache(doubleCache: DoubleCache),默认有一个defaultDoubleCache

    • 将值放入双重缓存:

      put(key: String, value: Any?)

    • 将值从双重缓存中取出:

      get(key: String, defaultValue: T?)getParcelable(key: String, creator: Parcelable.Creator<T>) /getParcelable(key: String, parceler: Parceler<T>)

    • 获取磁盘缓存大小(字节数):

      getCacheDiskSize()

    • 获取磁盘缓存计数:

      getCacheDiskCount()

    • 获取内存缓存计数:

      getCacheMemoryCount()

    • 根据key将值从双重缓存中移除:

      remove(key: String)

    • 清除所有双重缓存:

      clear()