😯 👩‍🔬 🥩 Meilleures pratiques Kotlin 🍤 🐦 🌡️

Kotlin, créé il y a à peine 5 ans, est considéré comme le langage de programmation prioritaire pour Android depuis 2019. Et pourtant, ce langage est assez jeune et continue d'évoluer, il est donc parfois difficile de savoir comment écrire au mieux le code. Nous avons souvent des discussions dans notre équipe sur le thème du code pur Kotlin, et sur leur base, nous avons compilé nos meilleures pratiques. Nous aimerions partager ces recommandations et nous attendons avec impatience vos questions.

Eh bien, commençons! Tout d'abord, il y a beaucoup de sucre syntaxique dans Kotlin, et s'il est surutilisé, il devient difficile de lire un tel code. Les quelques points suivants peuvent être attribués à la lutte entre brièveté et lisibilité .

N'écrivez pas une déclaration de classe sur une seule ligne

– . .

class ChannelViewModel(
       val conversationId: String,
       getChannelUseCase: GetChannelUseCase,
) : ViewModel() {

, :

, ( Android Studio / Shift+Command+Up/Down)
.

return

data class MyClass(val number: Int, val flag: Boolean)

fun create(numberParam: Int?, flag: Boolean?): MyClass? {
   return MyClass(numberParam ?: return null, flag == true)
}

return, , . , numberParam null, return MyClass(...) return null. if, :

fun create(numberParam: Int?, flag: Boolean?): MyClass? {
   if (numberParam == null) {
       return null
   }
   return MyClass(numberParam, flag == true)
}

it

, it , - :

values?.filterNot { selectedValues?.contains(it) == true }
   ?.let {
       selectedValues?.addAll(it)
       result[key]?.values = selectedValues?.filter { it.isChecked }
   }

let:

values?.filterNot { allSelectedValues?.contains(it) == true }
   ?.let { newValues ->
       allSelectedValues?.addAll(newValues)
       result[key]?.values = allSelectedValues?.filter { it.isChecked }
   }

it – . -null, . :

val newValues = values.filterNot { selectedValues.contains(it) }
selectedValues.addAll(newValues)
result[key]?.values = selectedValues.filter { it.isChecked }

?. -null


private var animatedView: FrameLayout? = null
...
animatedView?.animate()?.alpha(1f)?.setDuration(500)?.interpolator = AccelerateInterpolator()

null , animatedView null. if (animatedView != null) . , animatedView null. lateinit , null:

private lateinit var animatedView: FrameLayout
...
animatedView.animate().alpha(1f).setDuration(500).interpolator = AccelerateInterpolator()

Java Kotlin, “ ”. . Java - if when, (let, apply, also, with, run), , Utils extension .

!!

!! , NullPointerException, !! “”.

!! :

-null ( lateinit animatedView)
let ?.let { … }
- ?:
, , , null, checkNotNull requireNotNull. : IllegalStateException IllegalArgumentException .

, !! Java Kotlin, @NonNull Java-.

when if

val price = if (priceData.isWeightPrice) {
   priceData.minDiscountPrice.toInt()
} else if (priceData.discountPrice != 0.0) {
   priceData.discountPrice.toInt()
} else {
   priceData.price.toInt()
}

when:

val price = when {
   priceData.isWeightPrice -> priceData.minDiscountPrice.toInt()
   priceData.discountPrice != 0.0 -> priceData.discountPrice.toInt()
   else -> priceData.price.toInt()
}

when , , .

when , . , when .

Util

- , extension. .

, . , , .

, Util Kotlin ( : Java , Kotlin – ). - , (package) . (extension , , ; , - ). , , , .

, ( “ ”). , .

(trailing commas)

1.4. ( ) : diff .

Single Abstract Method interface (Fun interface)

Kotlin 1.4.0. , fun :

this.actionClickListener = object : BubbleView.ClickListener {
   override fun onBubbleViewClick() {
           ...
       }
   }

 this.actionClickListener = BubbleView.ClickListener {
      ...
  }

fun:

fun interface ClickListener {
   fun onBubbleViewClick()
}

, Java, Kotlin , SAM- . :

(T) -> R;
, SAM-;
, .

Kotlin , , , . , , , . , / .

val itemIdsSet: Set<String> = ...
val currentItemIds: Set<String> = ...
for(itemId in itemIdsSet) {
   if(!currentItemIds.contains(itemId)) {
       repository.exclude(itemId)
   }
}

val itemIdsSet: Set<String> = ...
val currentItemIds: Set<String> = ...
for (itemId in itemIdsSet subtract currentItemIds) {
   repository.exclude(itemId)
}

API , exclude , :

repository.exclude(itemIdsSet subtract currentItemIds)

code style

, “”. :

(, _ enum )
companion object ( ) ..

, . , best practices.

, Kotlin- :

https://developer.android.com/kotlin/style-guide https://proandroiddev.com/an-opinionated-guide-on-how-to-make-your-kotlin-code-fun-to-read-and-joy-to-work-with-caa3a4036f9e

https://developer.android.com/kotlin/coroutines/coroutines-best-practices

Meilleures pratiques Kotlin