update docs

Author: yjfnypeu

README.md

@@ -31,14 +31,66 @@ EasyAndroid.init(application)
 
 - [EasyDimension](./docs/EasyDimension.md)
 > 用于灵活的进行设备尺寸单位转换
+
+用法示例
+```
+// 转换10dp到px
+EasyDimension.withDIP(10).toPX()
+// 转换30sp到MM
+EasyDimension.withSP(30).toMM()
+```
 - [EasyFormatter](./docs/EasyFormatter.md)
 > 用于对任意类型数据，进行格式化输出。便于展示查看
+
+用法示例：
+```
+val any:Any = create()// 创建待格式化数据
+val result:String = EasyFormatter.DEFAULT.format(any)// 使用formatter实例进行格式化
+val result2:String = any.easyFormat()// 或者使用扩展函数。直接格式化
+```
+
 - [EasyLog](./docs/EasyLog.md)
 > 用于简单的进行日志打印输出，支持格式化输出、自定义打印格式。
+
+用法示例：
+```
+val any:Any = create()// 创建待打印数据
+EasyLog.DEFAULT.d(any)// 使用默认log实例进行数据打印. 以Log.d()的方式进行输出
+any.easyLogE()// 使用扩展函数直接进行数据打印，以Log.e()的方式进行输出
+```
 - [EasyToast](./docs/EasyToast.md)
 > 用于进行Toast提示，可很简单的指定输出样式。
+
+用法示例：
+```
+val message:String = create()// 创建待提示数据
+EasyToast.DEFAULT.show(message)// 使用系统样式进行输出
+EasyToast.create(layoutID:Int, tvID:Int, duration:Int).show(message)// 使用自定义样式进行输出
+```
 - [EasyReflect](./docs/EasyReflect.md)
 > 对常规的反射操作进行封装。达到更便于使用反射的效果
+
+用法示例：
+```
+// 以类名Test为例
+class Test(val name:String) {
+    fun wrap(name:String):String = "包裹后的数据$name"
+}
+
+// 创建Reflect实例：
+var reflect = EasyReflect.create(Test())
+
+// 为name字段赋值：
+reflect.setField("name", "EasyReflect")
+// 读取name字段的值："EasyReflect"
+val value = reflect.getValue("name")
+
+// 调用方法wrap方法，并传入参数value
+reflect.call("wrap", value)
+// 调用wrap方法，并获取返回值: "包裹后的数据EasyReflect"
+val result = reflect.callWithReturn("wrap", value).get<String>()
+```
+
 - [APIs](./docs/APIs.md)
 > 提供的一些其他零散的类库APIs
 

app/build.gradle

@@ -36,6 +36,6 @@ dependencies {
     if (useLocal) {
         implementation project(':utils')
     } else {
-        implementation 'com.github.yjfnypeu:EasyAndroid:1.0.0'
+        implementation 'com.github.yjfnypeu:EasyAndroid:1.0.1'
     }
 }

docs/EasyDimension.md

@@ -13,9 +13,12 @@ EasyDimension用于快速的在系统提供的各种尺寸间(PX, DIP, SP, IN, P
 1. 传入待转换尺寸
 
 ```kotlin
-// value为原始数值。unit为数值单位。
-// unit单位使用系统提供的尺寸单位，如TypedValue.COMPLEX_UNIT_PX, TypedValue.COMPLEX_UNIT_DIP
-dimension = EasyDimension.create(value, unit)
+dimension = EasyDimension.withPX(value:Float)//原始尺寸单位PX
+dimension = EasyDimension.withDIP(value:Float)//原始尺寸单位PX
+dimension = EasyDimension.withSP(value:Float)//原始尺寸单位SP
+dimension = EasyDimension.withPT(value:Float)//原始尺寸单位PT
+dimension = EasyDimension.withIN(value:Float)//原始尺寸单位IN
+dimension = EasyDimension.withMM(value:Float)//原始尺寸单位MM
 ```
 
 2. 输出转换后的不同尺寸的数值
@@ -33,5 +36,5 @@ dimension.toMM()
 
 将30dp转换为px
 ```kotlin
-val pxResult = EasyDimension.create(30, TypedValue.COMPLEX_UNIT_DIP).toPX()
+val pxResult = EasyDimension.withDIP(30).toPX()
 ```

utils/src/main/java/com/haoge/easyandroid/Extensions.kt

@@ -2,8 +2,11 @@ package com.haoge.easyandroid
 
 import android.app.Dialog
 import com.haoge.easyandroid.easy.EasyFormatter
+import com.haoge.easyandroid.easy.EasyLog
 import com.haoge.easyandroid.safe.SafeDialogHandle
 
 fun Dialog?.safeShow() = SafeDialogHandle.safeShowDialog(this)
 fun Dialog?.safeDismiss() = SafeDialogHandle.safeDismissDialog(this)
-fun Any?.easyFormat():String = EasyFormatter.DEFAULT.format(this)
+fun Any?.easyFormat():String = EasyFormatter.DEFAULT.format(this)
+fun Any?.easyLogD() = EasyLog.DEFAULT.d(this)
+fun Any?.easyLogE() = EasyLog.DEFAULT.e(this)

utils/src/main/java/com/haoge/easyandroid/easy/EasyDimension.kt

@@ -23,9 +23,28 @@ class EasyDimension private constructor(private val pixel:Float, private val met
     fun toMM() = pixel / metrics.xdpi / (1.0f / 25.4f)
 
     companion object {
+        @JvmStatic
         fun create(value:Float, unit:Int): EasyDimension {
             val metrics = SingleCache.getApplicationContext().resources.displayMetrics
             return EasyDimension(TypedValue.applyDimension(unit, value, metrics), metrics!!)
         }
+
+        @JvmStatic
+        fun withPX(value:Float) = create(value, TypedValue.COMPLEX_UNIT_PX)
+
+        @JvmStatic
+        fun withDIP(value:Float) = create(value, TypedValue.COMPLEX_UNIT_DIP)
+
+        @JvmStatic
+        fun withSP(value:Float) = create(value, TypedValue.COMPLEX_UNIT_SP)
+
+        @JvmStatic
+        fun withPT(value:Float) = create(value, TypedValue.COMPLEX_UNIT_PT)
+
+        @JvmStatic
+        fun withIN(value:Float) = create(value, TypedValue.COMPLEX_UNIT_IN)
+
+        @JvmStatic
+        fun withMM(value:Float) = create(value, TypedValue.COMPLEX_UNIT_MM)
     }
 }