O Kotlin 1.5.0-RC j\u00e1 est\u00e1 dispon\u00edvel com todos os recursos planejados para a vers\u00e3o 1.5.0: confira todo o escopo da pr\u00f3xima vers\u00e3o! Novos recursos de linguagem, atualiza\u00e7\u00f5es do stdlib, uma biblioteca de teste melhorada e muitas outras altera\u00e7\u00f5es est\u00e3o recebendo os toques finais. As \u00fanicas outras altera\u00e7\u00f5es antes do lan\u00e7amento ser\u00e3o corre\u00e7\u00f5es de bugs.<\/p>\n<\/p>\n
Experimente as modernas APIs do Kotlin nos seus projetos do mundo real com a vers\u00e3o 1.5.0-RC e nos ajude a deixar essa vers\u00e3o de lan\u00e7amento melhor ainda! Informe quaisquer problemas que voc\u00ea encontrar no nosso rastreador de issues YouTrack<\/a>.<\/p>\n Instalar a vers\u00e3o 1.5.0-RC<\/a><\/p>\n Neste artigo, n\u00f3s vamos apresentar o que mudou no Kotlin padr\u00e3o e nas bibliotecas de teste com a vers\u00e3o 1.5.0-RC:<\/p>\n Voc\u00ea encontra todos os detalhes abaixo!<\/p>\n <\/a><\/p>\n A biblioteca padr\u00e3o inclui a API de inteiros sem sinal que \u00e9 \u00fatil para lidar com opera\u00e7\u00f5es de inteiros n\u00e3o negativos. Ele inclui:<\/p>\n Tipos inteiros sem sinal fazem parte da vers\u00e3o Beta desde o Kotlin 1.3<\/a>. Agora estamos classificando tipos e opera\u00e7\u00f5es com inteiros sem sinal como est\u00e1veis, permitindo que estejam dispon\u00edveis sem a necessidade de confirma\u00e7\u00e3o e seguros para uso em projetos do mundo real.<\/p>\n As novas APIs est\u00e1veis s\u00e3o:<\/p>\n Arrays de inteiros sem sinal permanecem em Beta. Assim como varargs<\/a> de inteiros sem sinal que s\u00e3o implementados com arrays. Se voc\u00ea quiser us\u00e1-los no seu c\u00f3digo, voc\u00ea pode confirm\u00e1-los com a anota\u00e7\u00e3o Saiba mais sobre inteiros sem sinal no Kotlin<\/a>.<\/p>\n <\/a><\/p>\n O Kotlin agora fornece uma maneira de usar a moderna API Java IO n\u00e3o bloqueante<\/a> num estilo idiom\u00e1tico Kotlin pronto para uso, atrav\u00e9s de fun\u00e7\u00f5es de extens\u00e3o para Eis aqui um pequeno exemplo:<\/p>\n Essas extens\u00f5es foram inclu\u00eddas como um recurso experimental no Kotlin 1.4.20<\/a> e agora est\u00e3o dispon\u00edveis sem a necessidade de confirma\u00e7\u00e3o. D\u00ea uma olhada no pacote As extens\u00f5es existentes para a API File permanecem dispon\u00edveis, portanto voc\u00ea \u00e9 livre para escolher a API de sua prefer\u00eancia.<\/p>\n <\/a><\/p>\n Muitos de voc\u00eas devem estar familiarizados com as fun\u00e7\u00f5es stdlib para alterar a capitaliza\u00e7\u00e3o de strings e caracteres: Agora existe uma nova API independente de localiza\u00e7\u00e3o para alterar o formato mai\u00fasculo\/min\u00fasculo de strings e caracteres: as extens\u00f5es As novas fun\u00e7\u00f5es funcionam de forma igual, independentemente das configura\u00e7\u00f5es de localiza\u00e7\u00e3o da plataforma. Basta chamar as fun\u00e7\u00f5es e deixar o resto para o stdlib.<\/p>\n As novas fun\u00e7\u00f5es funcionam de forma igual, independentemente das configura\u00e7\u00f5es de localiza\u00e7\u00e3o da plataforma. Basta chamar as fun\u00e7\u00f5es e deixar o resto para o stdlib.<\/p>\n Na JVM, voc\u00ea pode realizar altera\u00e7\u00f5es entre mai\u00fasculas e min\u00fasculas levando em conta os par\u00e2metros de localiza\u00e7\u00e3o ao chamar as novas fun\u00e7\u00f5es passando a localiza\u00e7\u00e3o atual como argumento:<\/p>\n As novas fun\u00e7\u00f5es dever\u00e3o substituir completamente as antigas, que estamos agora marcando como deprecadas.<\/p>\n A opera\u00e7\u00e3o que retorna o c\u00f3digo UTF-16 de um caractere – a fun\u00e7\u00e3o Al\u00e9m disso, n\u00e3o havia uma fun\u00e7\u00e3o comum que retornasse o valor num\u00e9rico Para solucionar essas quest\u00f5es, agora existe um conjunto de novas fun\u00e7\u00f5es para convers\u00e3o entre caracteres e seus c\u00f3digos inteiros e valores num\u00e9ricos:<\/p>\n Essas fun\u00e7\u00f5es t\u00eam nomes claros e deixam o c\u00f3digo mais leg\u00edvel:<\/p>\n As novas fun\u00e7\u00f5es est\u00e3o dispon\u00edveis desde o Kotlin 1.4.30<\/a>, no modo de pr\u00e9-visualiza\u00e7\u00e3o, mas agora s\u00e3o fun\u00e7\u00f5es est\u00e1veis. As antigas fun\u00e7\u00f5es para convers\u00e3o de caractere para n\u00famero ( Continuamos a estender a parte multiplataforma da biblioteca padr\u00e3o para que todos os seus recursos fa\u00e7am parte do c\u00f3digo comum do projeto multiplataforma.<\/p>\n Agora, disponibilizamos v\u00e1rias fun\u00e7\u00f5es A propriedade A fun\u00e7\u00e3o Embora esse comportamento pare\u00e7a natural, ele pode ocultar situa\u00e7\u00f5es potencialmente incorretas. O que quer que voc\u00ea converta com esta fun\u00e7\u00e3o, voc\u00ea obter\u00e1 um booleano mesmo se a string tiver algum valor inesperado.<\/p>\n Novas vers\u00f5es estritas que diferenciam mai\u00fasculas de min\u00fasculas de String?.toBoolean()<\/a> foram criadas para ajudar a evitar esses erros:<\/p>\n <\/a><\/p>\n A API experimental Duration and Time Measurement<\/a> faz parte da stdlib desde a vers\u00e3o 1.3.50. Ela oferece uma API para a medi\u00e7\u00e3o precisa de intervalos de tempo.<\/p>\n Uma das principais classes desta API \u00e9 Tamb\u00e9m introduzimos novas propriedades para recuperar uma dura\u00e7\u00e3o como um valor Outra mudan\u00e7a \u00e9 um conjunto de novas fun\u00e7\u00f5es de f\u00e1brica para criar inst\u00e2ncias de Dadas essas mudan\u00e7as importantes, toda a API Duration and Time Measurement permanece experimental na vers\u00e3o 1.5.0 e requer confirma\u00e7\u00e3o atrav\u00e9s da anota\u00e7\u00e3o Por favor, experimente a nova vers\u00e3o e compartilhe seus coment\u00e1rios no nosso rastreador de issues, YouTrack<\/a>.<\/p>\n <\/a><\/p>\n No Kotlin, o operador de divis\u00e3o ( Anteriormente, a divis\u00e3o arredondada para baixo necessitava de uma fun\u00e7\u00e3o personalizada como:<\/p>\n Na vers\u00e3o 1.5.0-RC, apresentamos a fun\u00e7\u00e3o Na vers\u00e3o 1.5.0, introduzimos a nova fun\u00e7\u00e3o Ela difere da fun\u00e7\u00e3o <\/a><\/p>\n A API de cole\u00e7\u00f5es Kotlin cobre uma variedade de opera\u00e7\u00f5es populares em cole\u00e7\u00f5es com fun\u00e7\u00f5es integradas. Para os casos que n\u00e3o s\u00e3o comuns, voc\u00ea geralmente combina chamadas dessas fun\u00e7\u00f5es. Isto funciona, mas nem sempre fica muito elegante e pode causar sobrecarga.<\/p>\n Por exemplo, para obter o primeiro resultado n\u00e3o nulo de uma fun\u00e7\u00e3o de seletor nos elementos da cole\u00e7\u00e3o, voc\u00ea chamaria Eis aqui um exemplo de como ele pode ser usado para encurtar seu c\u00f3digo.<\/p>\n Suponha que voc\u00ea tenha uma classe com uma propriedade anul\u00e1vel e precise do seu primeiro valor n\u00e3o nulo dentro de uma lista de inst\u00e2ncias de classe.<\/p>\n You can implement this by iterating the collection and checking if a property is not null:<\/p>\n Outra maneira \u00e9 usar as fun\u00e7\u00f5es que j\u00e1 existem E \u00e9 assim que fica com a nova fun\u00e7\u00e3o:<\/p>\n <\/a><\/p>\n Faz v\u00e1rios lan\u00e7amentos que n\u00e3o inclu\u00edmos atualiza\u00e7\u00f5es importantes na biblioteca de testes do Kotlin Estamos continuando nosso desenvolvimento do processo de configura\u00e7\u00e3o para projetos multiplataforma. Na vers\u00e3o 1.5.0, tornamos mais f\u00e1cil configurar uma depend\u00eancia do Agora, a depend\u00eancia Depois de especificar a depend\u00eancia \u00c9 assim que fica no Groovy DSL:<\/p>\n E no Kotlin DSL fica assim:<\/p>\n Voc\u00ea tamb\u00e9m pode mudar para o JUnit 5 ou TestNG simplesmente chamando uma fun\u00e7\u00e3o na tarefa de teste: O mesmo funciona em projetos JVM puros quando voc\u00ea adiciona a depend\u00eancia Para a vers\u00e3o 1.5.0, preparamos uma s\u00e9rie de novas fun\u00e7\u00f5es de asser\u00e7\u00e3o, juntamente com melhorias nas existentes.<\/p>\n Primeiro, vamos dar uma olhada nas novas fun\u00e7\u00f5es:<\/p>\n Aqui est\u00e1 um breve exemplo que mostra o uso dessas fun\u00e7\u00f5es:<\/p>\n Em rela\u00e7\u00e3o \u00e0s fun\u00e7\u00f5es de asser\u00e7\u00e3o existentes, agora \u00e9 poss\u00edvel chamar suspending functions<\/a> dentro do lambda, que s\u00e3o passadas para \n
Tipos inteiros sem sinal est\u00e1veis<\/h2>\n
\n
UInt<\/code>, ULong<\/code>, UByte<\/code>, UShort<\/code> e fun\u00e7\u00f5es relacionadas, como convers\u00f5es.<\/li>\nUIntArray<\/code>, UIntRange<\/code> e containers similares para outros tipos.<\/li>\n<\/ul>\n\n
\nfun main() {\n\/\/sampleStart\n val zero = 0U \/\/ Define unsigned numbers with literal suffixes\n val ten = 10.toUInt() \/\/ or by converting non-negative signed numbers\n \/\/val minusOne: UInt = -1U \/\/ Error: unary minus is not defined\n val range: UIntRange = zero..ten \/\/ Separate types for ranges and progressions\n\n for (i in range) print(i)\n println()\n println("UInt covers the range from ${UInt.MIN_VALUE} to ${UInt.MAX_VALUE}") \/\/ UInt covers the range from 0 to 4294967295\n\/\/sampleEnd\n}\n<\/pre>\n@ExperimentalUnsignedTypes<\/code>.<\/p>\nExtens\u00f5es para a API java.nio.file.Path<\/h2>\n
java.nio.file.Path<\/code><\/a>.<\/p>\n\nimport kotlin.io.path.*\nimport java.nio.file.Path\n\nfun main() {\n \/\/ construct path with the div (\/) operator\n val baseDir = Path("\/base")\n val subDir = baseDir \/ "subdirectory"\n\n \/\/ list files in a directory\n val kotlinFiles = Path("\/home\/user").listDirectoryEntries("*.kt")\n \/\/ count lines in all kotlin files\n val totalLines = kotlinFiles.sumOf { file -> file.useLines { lines -> lines.count() } }\n}\n<\/pre>\nkotlin.io.path<\/code><\/a> para obter a lista de fun\u00e7\u00f5es que voc\u00ea pode usar.<\/p>\nAPI independente de par\u00e2metros de localiza\u00e7\u00e3o para caixa-alta e caixa-baixa<\/h2>\n
toUpperCase()<\/code>, toLowerCase()<\/code>, toTitleCase()<\/code>. Elas geralmente funcionam bem, mas podem causar dor de cabe\u00e7a quando for necess\u00e1rio lidar com par\u00e2metros de localiza\u00e7\u00e3o em plataforma diferentes: s\u00e3o todas sens\u00edveis \u00e0 localiza\u00e7\u00e3o, o que significa que o resultado poder\u00e1 variar de acordo com a plataforma de localiza\u00e7\u00e3o onde o c\u00f3digo \u00e9 executado. Por exemplo, o que voc\u00ea acha que \u00e9 retornado pela chamada \u201dKotlin\u201d.toUpperCase()<\/code>? \u201cKOTLIN<\/code>\u201d, \u00e9 claro, voc\u00ea diria. Mas em turco, a letra mai\u00fascula correspondente a i<\/code> \u00e9 \u0130<\/code>, portanto o resultado \u00e9 diferente: KOTL\u0130N<\/code>.<\/p>\nuppercase()<\/code>, lowercase()<\/code>, titlecase()<\/code> e suas vers\u00f5es correspondentes *Char()<\/code>. Voc\u00ea talvez j\u00e1 tenha experimentado a pr\u00e9via desses recursos na vers\u00e3o 1.4.30<\/a>.<\/p>\n\nfun main() {\n\/\/sampleStart\n \/\/ replace the old API\n println("Kotlin".toUpperCase()) \/\/ KOTLIN or KOTL\u0130N or?..\n\n \/\/ with the new API\n println("Kotlin".uppercase()) \/\/ Always KOTLIN\n\/\/sampleEnd\n}\n<\/pre>\n\n"Kotlin".uppercase(Locale.getDefault()) \/\/ Locale-sensitive uppercasing\n<\/pre>\n
Convers\u00f5es leg\u00edveis de caractere para c\u00f3digo e de caractere para d\u00edgito<\/h2>\n
toInt()<\/code> – era uma armadilha comum porque ela parece muito com String.toInt()<\/code> usada em strings de um d\u00edgito, que produz um Int<\/code> apresentado por este d\u00edgito.<\/p>\n\n"4".toInt() \/\/ returns 4\n'4'.toInt() \/\/ returns 52\n<\/pre>\n
4<\/code> para Char<\/code> '4'<\/code>.<\/p>\n\n
Char(code)<\/code> e Char.code<\/code> convertem entre um char e seu c\u00f3digo.<\/li>\nChar.digitToInt(radix: Int)<\/code> e sua vers\u00e3o *OrNull<\/code> criam um inteiro a partir de um d\u00edgito na base especificada.<\/li>\nInt.digitToChar(radix: Int)<\/code> cria um caractere de um d\u00edgito que representa um inteiro na base especificada.<\/li>\n<\/ul>\n\nfun main() {\n\/\/sampleStart\n val capsK = Char(75) \/\/ \u2018K\u2019\n val one = '1'.digitToInt(10) \/\/ 1\n val digitC = 12.digitToChar(16) \/\/ hexadecimal digit \u2018C\u2019\n\n println("${capsK}otlin ${one}.5.0-R${digitC}") \/\/ \u201cKotlin 1.5.0-RC\u201d\n println(capsK.code) \/\/ 75\n\/\/sampleEnd\n}\n<\/pre>\nChar.toInt()<\/code> e fun\u00e7\u00f5es similares para outros tipos num\u00e9ricos) e convers\u00e3o de n\u00famero para caractere (Long.toChar()<\/code> e similares, exceto Int.toChar()<\/code>) agora est\u00e3o deprecadas.<\/p>\nAPI de caracteres multiplataforma estendida<\/h2>\n
Char<\/code> em todas as plataformas e em c\u00f3digo comum. Estas fun\u00e7\u00f5es s\u00e3o:<\/p>\n\n
Char.isDigit()<\/code>, Char.isLetter()<\/code>, Char.isLetterOrDigit()<\/code> que verificam se um caractere \u00e9 uma letra ou um d\u00edgito.<\/li>\nChar.isLowerCase()<\/code>, Char.isUpperCase()<\/code>, Char.isTitleCase()<\/code> que verificam o formato mai\u00fasculo\/min\u00fasculo de um caractere.<\/li>\nChar.isDefined()<\/code> que verifica se um caractere tem uma categoria geral Unicode<\/a> diferente de Cn<\/code> (undefined<\/em>).<\/li>\nChar.isISOControl()<\/code> que verifica se um caractere \u00e9 um caractere de controle ISO<\/a>, que possui c\u00f3digo nos intervalos\\u0000<\/code>..\\u001F<\/code> ou \\u007F<\/code>..\\u009F<\/code>.<\/li>\n<\/ul>\nChar.category<\/code> e seu tipo de retorno de classe enum CharCategory<\/code>, que indica a categoria geral de um caractere de acordo com o Unicode, agora est\u00e3o dispon\u00edveis nos projetos multiplataforma.<\/p>\n\nfun main() {\n\/\/sampleStart\n val array = "Kotlin 1.5.0-RC".toCharArray()\n val (letterOrDigit, punctuation) = array.partition { it.isLetterOrDigit() }\n val (upperCase, notUpperCase ) = array.partition { it.isUpperCase() }\n\n println("$letterOrDigit, $punctuation") \/\/ [K, o, t, l, i, n, 1, 5, 0, R, C], [ , ., ., -]\n println("$upperCase, $notUpperCase") \/\/ [K, R, C], [o, t, l, i, n, , 1, ., 5, ., 0, -]\n\n if (array[0].isDefined()) println(array[0].category)\n\/\/sampleEnd\n}\n<\/pre>\nVers\u00f5es estritas de String?.toBoolean()<\/h2>\n
String?.toBoolean()<\/code> do Kotlin \u00e9 amplamente usada para criar valores booleanos a partir de strings. Seu funcionamento \u00e9 bastante simples: seu valor \u00e9 true<\/code> para a string “true”, independente se estiver em letras mai\u00fasculas ou min\u00fasculas, e false<\/code> para todas as outras strings, inclusive null<\/code>.<\/p>\n\n
String.toBooleanStrict()<\/code> lan\u00e7a uma exce\u00e7\u00e3o para todas as entradas, exceto as literais “true” e “false”.<\/li>\nString.toBooleanStrictOrNull()<\/code> retorna null para todas as entradas, exceto literais “true” e “false”.<\/li>\n<\/ul>\n\nfun main() {\n\/\/sampleStart\n println("true".toBooleanStrict()) \/\/ True\n \/\/ println("1".toBooleanStrict()) \/\/ Exception\n println("1".toBooleanStrictOrNull()) \/\/ null\n println("True".toBooleanStrictOrNull()) \/\/ null: the function is case-sensitive\n\/\/sampleEnd\n}\n<\/pre>\nMudan\u00e7as na API Duration<\/h2>\n
Duration<\/code><\/a>. Ela representa a quantidade de tempo entre dois instantes de tempo. Na vers\u00e3o 1.5.0, Duration<\/code> ganha mudan\u00e7as significativas tanto na API quanto na representa\u00e7\u00e3o interna.<\/p>\nDuration<\/code> agora usa um valor Long<\/code> para a representa\u00e7\u00e3o interna, em vez de Double<\/code>. O intervalo de valores Long<\/code> permite representar mais de cem anos com precis\u00e3o de nanossegundos ou cem milh\u00f5es de anos com precis\u00e3o de milissegundos. No entanto, as dura\u00e7\u00f5es de fra\u00e7\u00f5es de nanosegundos suportadas anteriormente n\u00e3o est\u00e3o mais dispon\u00edveis.<\/p>\nLong<\/code>. Elas est\u00e3o dispon\u00edveis para diversas unidades de tempo:Duration.inWholeMinutes<\/code>, Duration.inWholeSeconds<\/code> e outras. Essas fun\u00e7\u00f5es vieram substituir as propriedades baseadas em Double<\/code>, como Duration.inMinutes<\/code>.<\/p>\nDuration<\/code> a partir de valores inteiros. Elas s\u00e3o definidas diretamente no tipo Duration<\/code> e substituem as antigas propriedades de extens\u00e3o de tipos num\u00e9ricos como Int.seconds<\/code>.<\/p>\n\nimport kotlin.time.ExperimentalTime\nimport kotlin.time.Duration\n\n@ExperimentalTime\nfun main() {\n val duration = Duration.milliseconds(120000)\n println("There are ${duration.inWholeSeconds} seconds in ${duration.inWholeMinutes} minutes")\n}\n<\/pre>\n@ExperimentalTime<\/code>.<\/p>\nOpera\u00e7\u00f5es matem\u00e1ticas: divis\u00e3o arredondada para baixo (fun\u00e7\u00e3o piso) e o operador mod<\/h2>\n
\/<\/code>) em inteiros <\/a> representa a divis\u00e3o truncada<\/em>, que despreza a parte fracion\u00e1ria do resultado. Na aritm\u00e9tica modular, h\u00e1 tamb\u00e9m uma alternativa: a divis\u00e3o arredondada para baixo<\/em> (fun\u00e7\u00e3o piso) que converte o resultado para o menor valor inteiro, produzindo um resultado diferente em n\u00fameros negativos.<\/p>\n\nfun floorDivision(i: Int, j: Int): Int {\n var result = i \/ j\n if (i != 0 && result <= 0) result--\n return result\n}\n<\/pre>\nfloorDiv()<\/code> que realiza a divis\u00e3o arredondada para baixo em inteiros.<\/p>\n\nfun main() {\n\/\/sampleStart\n println("Truncated division -5\/3: ${-5 \/ 3}")\n println("Floored division -5\/3: ${(-5).floorDiv(3)}")\n\/\/sampleEnd\n}\n<\/pre>\nmod()<\/code>. Ela agora funciona exatamente como o nome sugere: retorna o m\u00f3dulo<\/em>, que \u00e9 o resto da divis\u00e3o arredondada para baixo.<\/p>\nrem()<\/code>, do Kotlin (ou operador %<\/code>). O m\u00f3dulo \u00e9 a diferen\u00e7a entre a<\/code> e a.floorDiv(b) * b<\/code>. O m\u00f3dulo diferente de zero sempre ter\u00e1 o mesmo sinal que b<\/code> enquanto que a % b<\/code> pode ter um sinal diferente. Isto pode ser \u00fatil, por exemplo, para implementar listas c\u00edclicas:<\/p>\n\nfun main() {\n\/\/sampleStart\n fun getNextIndexCyclic(current: Int, size: Int ) = (current + 1).mod(size)\n fun getPreviousIndexCyclic(current: Int, size: Int ) = (current - 1).mod(size)\n \/\/ unlike %, mod() produces the expected non-negative value even if (current - 1) is less than 0\n\n val size = 5\n for (i in 0..(size * 2)) print(getNextIndexCyclic(i, size))\n println()\n for (i in 0..(size * 2)) print(getPreviousIndexCyclic(i, size))\n\/\/sampleEnd\n}\n<\/pre>\nCole\u00e7\u00f5es: firstNotNullOf() e firstNotNullOfOrNull()<\/h2>\n
mapNotNull()<\/code> e first()<\/code>. Na vers\u00e3o 1.5.0, voc\u00ea pode fazer isso com uma \u00fanica chamada da nova fun\u00e7\u00e3o firstNotNullOf()<\/code>. Junto com firstNotNullOf()<\/code>, estamos acrescentando sua contraparte *orNull()<\/code> que produz null se n\u00e3o houver nenhum valor a retornar.<\/p>\n\nclass Item(val name: String?)\n<\/pre>\n
\n\/\/ Option 1: manual implementation\nfor (element in collection) {\n val itemName = element.name\n if (itemName != null) return itemName\n}\nreturn null\n<\/pre>\nmapNotNull()<\/code> e firstOrNull()<\/code>. Observe que mapNotNull()<\/code> constr\u00f3i uma cole\u00e7\u00e3o intermedi\u00e1ria, que requer mem\u00f3ria adicional, especialmente em cole\u00e7\u00f5es grandes. Ent\u00e3o a transforma\u00e7\u00e3o em sequ\u00eancia pode tamb\u00e9m ser necess\u00e1ria aqui.<\/p>\n\n\/\/ Option 2: old stdlib functions\nreturn collection\n \/\/ .asSequence() \/\/ Avoid creating intermediate list for big collections\n .mapNotNull { it.name }\n .firstOrNull()\n<\/pre>\n\n\/\/ Option 3: new firstNotNullOfOrNull()\nreturn collection.firstNotNullOfOrNull { it.name }\n<\/pre>\nMudan\u00e7as na biblioteca de testes<\/h2>\n
kotlin-test<\/code>, mas agora estamos entregando algumas mudan\u00e7as h\u00e1 muito esperadas. Com a vers\u00e3o 1.5.0-RC, voc\u00ea pode experimentar uma s\u00e9rie de novos recursos:<\/p>\n\n
kotlin-test<\/code> em projetos multiplataforma.<\/li>\nDepend\u00eancia kotlin-test em projetos multiplataforma<\/h3>\n
kotlin-test<\/code> para todos os conjuntos de fontes.<\/p>\nkotlin-test<\/code> no conjunto de fontes de teste comum \u00e9 a \u00fanica que voc\u00ea precisa adicionar. O plug-in Gradle ir\u00e1 inferir a depend\u00eancia de plataforma correspondente para outros conjuntos de fontes:<\/p>\n\n
kotlin-test-junit<\/code> para conjuntos de fontes JVM. Voc\u00ea tamb\u00e9m pode mudar para kotlin-test-junit-5<\/code> ou kotlin-test-testng<\/code> se voc\u00ea ativ\u00e1-los explicitamente (continue lendo para saber como).<\/li>\nkotlin-test-js<\/code> para conjuntos de fontes Kotlin\/JS.<\/li>\nkotlin-test-common<\/code> e kotlin-test-annotations-common<\/code> para conjuntos de fontes comuns.<\/li>\nkotlin-test<\/code>.<\/li>\n<\/ul>\nEscolha autom\u00e1tica de um framework de testes para conjuntos de fontes Kotlin\/JVM<\/h3>\n
kotlin-test<\/code> no conjunto de fontes de teste comum, conforme descrito acima, os conjuntos de fontes da JVM recebem automaticamente a depend\u00eancia do JUnit 4. \u00c9 isso! Voc\u00ea pode escrever e executar os testes imediatamente!<\/p>\n\nkotlin {\n sourceSets {\n commonTest {\n dependencies {\n \/\/ This brings the dependency\n \/\/ on JUnit 4 transitively\n implementation kotlin('test')\n }\n }\n }\n}\n<\/pre>\n<\/p>\n\nkotlin {\n sourceSets {\n val commonTest by getting {\n dependencies {\n \/\/ This brings the dependency\n \/\/ on JUnit 4 transitively\n implementation(kotlin("test"))\n }\n }\n }\n}\n<\/pre>\nuseJUnitPlatform()<\/code><\/a> ou useTestNG()<\/code><\/a>.<\/p>\n\nkotlin {\n jvm {\n testRuns["test"].executionTask.configure {\n \/\/ enable TestNG support\n useTestNG()\n \/\/ or\n \/\/ enable JUnit Platform (a.k.a. JUnit 5) support\n useJUnitPlatform()\n }\n }\n}\n<\/pre>\nkotlin-test<\/code>.<\/p>\nAtualiza\u00e7\u00f5es nas fun\u00e7\u00f5es de asser\u00e7\u00e3o<\/h3>\n
\n
assertIs<T>()<\/code> e assertIsNot<T>()<\/code> verificam o tipo do valor.<\/li>\nassertContentEquals()<\/code> compara o conte\u00fado do cont\u00eainer para vetores, sequ\u00eancias e qualquer Iterable<\/code>. Mais precisamente, ele verifica se expected<\/code> e actual<\/code> cont\u00eam os mesmos elementos na mesma ordem.<\/li>\nassertEquals()<\/code> e assertNotEquals()<\/code> para Double<\/code> e Float<\/code> t\u00eam novas sobrecargas com um terceiro par\u00e2metro: precis\u00e3o.<\/li>\nassertContains()<\/code> verifica a presen\u00e7a de um item em qualquer objeto com o operador contains()<\/code> definido: array, lista, intervalo, etc.<\/li>\n<\/ul>\n\n@Test\nfun test() {\n val expectedArray = arrayOf(1, 2, 3)\n val actualArray = Array(3) { it + 1 }\n\n val first: Any = actualArray[0]\n assertIs<Int>(first)\n \/\/ first is smart-cast to Int now\n println("${first + 1}")\n\n assertContentEquals(expectedArray, actualArray)\n assertContains(expectedArray, 2)\n\n val x = sin(PI)\n\n \/\/ precision parameter\n val tolerance = 0.000001\n\n assertEquals(0.0, x, tolerance)\n}\n<\/pre>\n