10 个对于Android开发者有用的Kotlin扩展函数

使用扩展函数来提高安卓开发体验

什么是扩展功能？

Kotlin 中的扩展函数允许您向现有类添加新功能，而无需继承它或修改类本身。这是从类定义外部扩展类功能的便捷方式。

Log

您可以any object使用此扩展功能轻松地在 logcat 中编写。您不必担心将任何对象转换为字符串。可以用默认标签写，也可以通过自定义标签在logcat中区分。

import android.util.Log

fun Any?.printToLog(tag: String = "DEBUG_LOG") {
    Log.d(tag, toString())
}

用法

val text = "This is text"
 text.printToLog() 

val user = User( 
    name = "John" , 
    id = 1
 ) 
user.printToLog() // 使用默认日志标签
user.printToLog(tag = "USER_INFO" ) / / 带有自定义日志标签

View#visiable，invisible，gone

在 Android 中，我们总是需要处理视图。因此，很明显，我们必须使用视图可见性来显示或隐藏特定的文本视图、图像视图和任何其他视图。因此，此功能有助于可见性处理。您可以直接将gone()、visible()或invisible()函数应用于单个操作。

但是，如果您必须处理特定条件下的可见性，则可以使用goneIf、visibleIf或invisibleIf函数。此函数使用中缀表示法的概念来增加代码的可读性。

import android.view.View

fun View.gone() = run { visibility = View.GONE }

fun View.visible() = run { visibility = View.VISIBLE }

fun View.invisible() = run { visibility = View.INVISIBLE }

infix fun View.visibleIf(condition: Boolean) =
    run { visibility = if (condition) View.VISIBLE else View.GONE }

infix fun View.goneIf(condition: Boolean) =
    run { visibility = if (condition) View.GONE else View.VISIBLE }
    
infix fun View.invisibleIf(condition: Boolean) =
    run { visibility = if (condition) View.INVISIBLE else View.VISIBLE }

用法

view.gone() 
view.visible() 
view.invisible() 

// dataFound、loading、condition 应该是有效的布尔表达式
view goneIf dataFound 
view visibleIf loading 
view invisibleIf condition

Toast

Toast，向用户显示消息或发出警告是一件简单的事情。为此，您必须使用 Toast 类的 makeText 函数并传递上下文和其他内容以及使用 show 函数来显示。

因此，此扩展功能允许您简单地传递一条消息，然后您的 toast 就会显示出来。此函数是在 Activity 和 Fragment 范围内创建的。因此，您必须在该范围内使用它。您还可以仅使用字符串 ID 来使用字符串资源文件中的文本。

import android.app.Activity
import android.widget.Toast
import androidx.annotation.StringRes
import androidx.fragment.app.Fragment

fun Fragment.toast(message: String) {
    Toast.makeText(requireContext(), message, Toast.LENGTH_LONG).show()
}

fun Fragment.toast(@StringRes message: Int) {
    Toast.makeText(requireContext(), message, Toast.LENGTH_LONG).show()
}

fun Activity.toast(message: String) {
    Toast.makeText(this, message, Toast.LENGTH_LONG).show()
}

fun Activity.toast(@StringRes message: Int) {
    Toast.makeText(this, message, Toast.LENGTH_LONG).show()
}

用法

toast( "这是Toast消息" ) 
toast(R.string.toast_message)

snackbar

此功能可帮助您在视图顶部显示一个 snackbar 以进行简单的消息显示，并且您还可以根据需要更改持续时间。您必须在视图或根视图上使用此功能。

import android.view.View
import androidx.annotation.StringRes
import com.google.android.material.snackbar.Snackbar

fun View.snackbar(message: String, duration: Int = Snackbar.LENGTH_LONG) {
    Snackbar.make(this, message, duration).show()
}

fun View.snackbar(@StringRes message: Int, duration: Int = Snackbar.LENGTH_LONG) {
    Snackbar.make(this, message, duration).show()
}

用法

rootView.snackbar( "This is snackbar message" ) 
rootView.snackbar(R.string.snackbar_message) 

// 自定义持续时间长度
rootView.snackbar( "This is snackbar message" , duration = Snackbar.LENGTH_SHORT)

hidekeyboard

如果您正在处理用户操作，或者如果您想在任何特定情况下以编程方式隐藏键盘，那么隐藏键盘可能会让人头疼，那么此功能将很有用。您必须简单地调用hideKeyboard()活动或片段范围。

import android.app.Activity
import android.view.View
import android.view.inputmethod.InputMethodManager
import androidx.fragment.app.Fragment

fun Activity.hideKeyboard() {
    val imm: InputMethodManager =
        getSystemService(Activity.INPUT_METHOD_SERVICE) as InputMethodManager
    val view = currentFocus ?: View(this)
    imm.hideSoftInputFromWindow(view.windowToken, InputMethodManager.HIDE_NOT_ALWAYS)
}

fun Fragment.hideKeyboard() {
    activity?.apply {
        val imm: InputMethodManager =
            getSystemService(Activity.INPUT_METHOD_SERVICE) as InputMethodManager
        val view = currentFocus ?: View(this)
        imm.hideSoftInputFromWindow(view.windowToken, InputMethodManager.HIDE_NOT_ALWAYS)
    }
}

用法

hideKeyboard()

dp 和 px 转换

有时，您必须从代码文件中动态修改视图，而不是从 XML 中对其进行修复。例如，您可能必须为特定场景更改视图宽度和高度，或者您必须修改边距或填充。因此，在那种情况下，您必须将像素传递给这些函数。但是您希望根据与密度无关的像素 (dp) 标准有更多的了解。

因此，此属性可帮助您进行px to dp和dp to px转换。您可以简单地使用 px 属性将 dp 转换为 px，并使用 dp 属性将 px 转换为 dp。

import android.content.res.Resources

// Convert px to dp
val Int.dp: Int
    get() = (this / Resources.getSystem().displayMetrics.density).toInt()

//Convert dp to px
val Int.px: Int
    get() = (this * Resources.getSystem().displayMetrics.density).toInt()

用法

params.setMargins( 16.px , 16.px , 16.px , 16.px )

数字及字母检查

此属性允许您检查字符串。当您只想验证数字、字母或字符串文本中的字母数字时，这会很有用。检查示例以获得更多理解。它基于正则表达式。

val String.isDigitOnly: Boolean
    get() = matches(Regex("^\\d*\$"))

val String.isAlphabeticOnly: Boolean
    get() = matches(Regex("^[a-zA-Z]*\$"))

val String.isAlphanumericOnly: Boolean
    get() = matches(Regex("^[a-zA-Z\\d]*\$"))

用法

val isValidNumber = "1234" .isDigitOnly // return true
val isValid = "1234abc" .isDigitOnly // return false
val isOnlyAlphabetic = "abcABC" .isAlphabeticOnly // return true
val isOnlyAlphabetic2 = "abcABC123" .isAlphabeticOnly // return false
val isOnlyAlphanumeric = "abcABC123" .isAlphanumericOnly // return true
val isOnlyAlphanumeric2 = "abcABC@123." .isAlphanumericOnly // return false

isNull

isNull 将应用于任何属性。每当您要检查任何对象的 null 相等性时，都会使用此属性。此属性将增加代码的可读性。您可以使用obj.isNull而不是obj == null。

val Any?.isNull get() = this == null

用法

if (obj.isNull) {
    // Run if object is null
} else {
    // Run if object is not null
}

ifNull

如果你想在特定对象为空时运行一些代码怎么办？在这种情况下，通常，您必须使用具有 null 相等性的 if 条件。但是，除此之外，您还可以使用此功能。当该特定对象为空时，它将运行该块。这个概念就像其他作用域函数一样。

fun Any?.ifNull(block: () -> Unit) = run {
    if (this == null) {
        block()
    }
}

用法

obj.ifNull { 
    // Write code
}

日期格式

在 Android 中处理日期时，我们必须对服务器日期和用户可读日期进行一些自定义。为此，我们通常使用辅助函数进行转换。

但是，在这里，我们可以直接在字符串到字符串到日期的转换中应用这个函数，我们可以在日期上使用这个函数来进行日期到字符串的转换。在这里，我已经通过了默认格式。但你可以改变它。您可以根据您的要求传递自定义格式。

import java.text.SimpleDateFormat
import java.util.*

fun String.toDate(format: String = "yyyy-MM-dd HH:mm:ss"): Date? {
    val dateFormatter = SimpleDateFormat(format, Locale.getDefault())
    return dateFormatter.parse(this)
}

fun Date.toStringFormat(format: String = "yyyy-MM-dd HH:mm:ss"): String {
    val dateFormatter = SimpleDateFormat(format, Locale.getDefault())
    return dateFormatter.format(this)
}

用法

val currentDate = Date().toStringFormat()
val currentDate2 = Date().toStringFormat(format = "dd-MM-yyyy")
val date = "2023-01-01".toDate(format = "yyyy-MM-dd")

结论

我希望所提供的扩展函数对简化和优化您的代码很有用。随意修改它们以满足您的个人需求并将它们包含在您的项目中。