As mudan\u00e7as na biblioteca padr\u00e3o na vers\u00e3o 1.4-M3 incluem:<\/p>\n Voc\u00ea pode encontrar a lista completa de mudan\u00e7as no log de altera\u00e7\u00f5es<\/a>. Como sempre, somos muito gratos aos nossos colaboradores externos<\/a>.<\/p>\n Apreciaremos bastante se voc\u00ea puder experimentar a pr\u00e9-visualiza\u00e7\u00e3o<\/a> e compartilhar suas impress\u00f5es<\/a>.<\/p>\n <\/p>\n A partir do Java 9, voc\u00ea pode modularizar sua aplica\u00e7\u00e3o gra\u00e7as ao projeto Jigsaw. A ferramenta jlink<\/strong><\/a> permite que voc\u00ea gere uma imagem Java runtime contendo apenas os m\u00f3dulos da plataforma que s\u00e3o necess\u00e1rios para sua aplica\u00e7\u00e3o. Antes j\u00e1 era poss\u00edvel usar o O Kotlin 1.4 acrescenta as informa\u00e7\u00f5es sobre m\u00f3dulos de O Kotlin 1.4 suporta convers\u00f5es SAM para classes Kotlin<\/a>. Voc\u00ea pode marcar uma interface que tenha um \u00fanico m\u00e9todo abstrato como uma Voc\u00ea pode usar um construtor SAM que recebe um lambda como par\u00e2metro para criar uma inst\u00e2ncia. O c\u00f3digo resultante \u00e9 muito mais simples:<\/p>\n <img class="alignnone size-full wp-image-55452" src="https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2020\/07\/fun_interface-1.png<\/a>" onmouseover="this.src=’https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2020\/07\/fun_interface.gif<\/a>‘;" Para manter a consist\u00eancia com a API existente, tamb\u00e9m acrescentamos Embora Kotlin n\u00e3o tenha exce\u00e7\u00f5es checadas<\/a>, ele usa a anota\u00e7\u00e3o code>@Throws<\/code<\/a><\/a> para garantir a interoperabilidade com linguagens que as possuem, tais como Java e Swift. Antes, havia anota\u00e7\u00f5es separadas com este nome para a JVM ( Na vers\u00e3o 1.4-M1 anunciamos mudan\u00e7as no tratamento de exce\u00e7\u00f5es na interop Objective-C\/Swift<\/a>: agora Muitos de voc\u00eas conhecem estas fun\u00e7\u00f5es de extens\u00e3o pr\u00e1ticas para tipos de container \u2013 Tais regras podem levar a resultados inesperados, por exemplo:<\/p>\n Adicionalmente, tal comportamento \u00e9 inconsistente com a forma como essas mesmas fun\u00e7\u00f5es operam em listas, porque elas usam igualdade de ordem total<\/em>:<\/p>\n Na vers\u00e3o 1.4-M3 come\u00e7amos o ciclo de depreca\u00e7\u00e3o para as fun\u00e7\u00f5es de extens\u00e3o No Kotlin 1.3.40 acrescentamos uma pr\u00e1tica fun\u00e7\u00e3o Note que, at\u00e9 o momento, o Observe que o Kotlin 1.4 n\u00e3o tem compatibilidade retroativa com a vers\u00e3o 1.3 em alguns casos especiais. Todos esses casos foram cuidadosamente revisados pelo comit\u00ea da linguagem e ser\u00e3o listados no "guia de compatibilidade" (semelhante a este<\/a>). Por enquanto, voc\u00ea pode encontrar esta lista no YouTrack<\/a>.<\/p>\n \n Observe que as garantias de compatibilidade retroativa n\u00e3o abrangem vers\u00f5es de pr\u00e9-lan\u00e7amento. Os recursos e a API poder\u00e3o mudar em lan\u00e7amentos subsequentes. Quando chegarmos a uma RC final, todos os bin\u00e1rios produzidos pelas vers\u00f5es de pr\u00e9-lan\u00e7amento ser\u00e3o proibidos pelo compilador, e voc\u00ea precisar\u00e1 recompilar tudo o que foi compilado pelo 1.4\u2011Mx.\n<\/p><\/blockquote>\n Como sempre, voc\u00ea pode experimentar o Kotlin online<\/strong> em play.kotl.in<\/a>.<\/p>\n No IntelliJ IDEA<\/strong> e Android Studio<\/strong> voc\u00ea pode atualizar o Kotlin Plugin para a vers\u00e3o 1.4-M3. Veja como fazer isso<\/a>.<\/p>\n Se quiser trabalhar em projetos existentes que foram criados antes de instalar a vers\u00e3o de pr\u00e9via, ser\u00e1 necess\u00e1rio configurar sua compila\u00e7\u00e3o para a vers\u00e3o de pr\u00e9via no Gradle ou Maven<\/a>.<\/p>\n Voc\u00ea pode baixar o compilador de linha de comando<\/strong> da p\u00e1gina do lan\u00e7amento no GitHub<\/a>.<\/p>\n Voc\u00ea pode usar as seguintes vers\u00f5es das bibliotecas<\/strong> publicadas junto com este lan\u00e7amento:<\/p>\n Os detalhes do lan\u00e7amento e a lista de bibliotecas compat\u00edveis tamb\u00e9m est\u00e3o dispon\u00edveis aqui<\/a>.<\/p>\n Somos gratos por todos os relatos de bugs que voc\u00ea enviou para nosso rastreador de issues<\/a> e faremos o melhor poss\u00edvel para corrigir todos os issues mais importantes antes do lan\u00e7amento final.<\/p>\n Voc\u00ea tamb\u00e9m est\u00e1 convidado a participar do canal #eap<\/a><\/em> no nosso Kotlin Slack<\/a> (obtenha um convite aqui<\/a>). Neste canal voc\u00ea pode fazer perguntas, participar de discuss\u00f5es e receber notifica\u00e7\u00f5es dos novos builds de pr\u00e9-visualiza\u00e7\u00e3o.<\/p>\n M\u00e3os \u00e0 obra com o Kotlin!<\/p>\n Gostar\u00edamos de agradecer a todos os nossos contribuintes externos cujos pull requests foram inclu\u00eddos neste lan\u00e7amento:<\/p>\n![\"\"](\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2020\/07\/Blog_Banners_m3_1500h751.png\")
<\/a><\/p>\n\n
module-info<\/code><\/a><\/li>\n@Throws<\/code><\/a> na biblioteca comum<\/li>\nArtefatos da biblioteca padr\u00e3o agora incluem descritores module-info<\/h2>\n
jlink<\/code> com artefatos da biblioteca padr\u00e3o Kotlin, mas era preciso usar artefatos separados \u2013 apenas os que tinham o classificador "modular" \u2013 e todo o processo de configura\u00e7\u00e3o n\u00e3o era simples. A impossibilidade de incluir descritores de m\u00f3dulos nos artefatos principais foi causada por problemas nas ferramentas para Android, que j\u00e1 foram corrigidos.<\/p>\nmodule-info.java<\/code> aos artefatos default da biblioteca padr\u00e3o, para que voc\u00ea possa us\u00e1-los com o jlink<\/code> com facilidade. No Android, certifique-se de estar usando o plugin Android Gradle vers\u00e3o 3.2 ou superior, que \u00e9 capaz de processar corretamente jars contendo module-info.<\/p>\nSuporte a fun interface na biblioteca padr\u00e3o<\/h2>\n
fun interface<\/code> e depois passar um lambda como argumento quando essa interface for esperada como par\u00e2metro. Na biblioteca padr\u00e3o, as seguintes interfaces s\u00e3o agora declaradas como fun interface<\/code>:<\/p>\n\n
Comparator<\/code><\/li>\nReadOnlyProperty<\/code><\/li>\nPropertyDelegateProvider<\/code> (foi introduzida em 1.4-M2<\/a>)<\/li>\n<\/ul>\n
\nonmouseout="this.src=’https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2020\/07\/fun_interface-1.png<\/a>‘;" alt="" \/><\/p>\nOpera\u00e7\u00f5es de cole\u00e7\u00f5es<\/h2>\n
\n
sumOf<\/code> recebe uma fun\u00e7\u00e3o seletora e retorna uma soma de seus valores sobre todos os elementos de uma cole\u00e7\u00e3o. \u00c9 muito parecida com as fun\u00e7\u00f5es sumBy<\/code> e sumByDouble<\/code> que j\u00e1 existem. A principal diferen\u00e7a \u00e9 que a nova fun\u00e7\u00e3o sumOf<\/code> recebe seletores com v\u00e1rios tipos de retorno, permitindo que voc\u00ea lide com somas de diferentes tipos da mesma forma. Ou seja, sumOf produz somas dos tipos Int<\/code>, Long<\/code>, Double<\/code>, UInt<\/code>, ULong<\/code>. Na JVM tamb\u00e9m est\u00e3o dispon\u00edveis os tipos BigInteger<\/code> e BigDecimal<\/code>.\n\r\ndata class OrderItem(val name: String, val price: Double, val count: Int)\r\n\r\nfun main() {\r\n\/\/sampleStart\r\n val order = listOf<OrderItem>(\r\n OrderItem("Cake", price = 10.0, count = 1),\r\n\tOrderItem("Coffee", price = 2.5, count = 3),\r\n OrderItem("Tea", price = 1.5, count = 2))\r\n \r\n val total = order.sumOf { it.price * it.count} \/\/ Double\r\n val count = order.sumOf { it.count } \/\/ Int\r\n\/\/sampleEnd\r\n println("Voc\u00ea solicitou $count itens que custam $total no total")\r\n}\r\n<\/pre>\n<\/li>\nmin<\/code> e max<\/code> foram renomeadas para minOrNull<\/code> e maxOrNull<\/code>. Desde sua introdu\u00e7\u00e3o na vers\u00e3o 1.0, as fun\u00e7\u00f5es min<\/code> e max<\/code> t\u00eam retornado null<\/code> em cole\u00e7\u00f5es vazias. Isto contradiz a conven\u00e7\u00e3o de nomenclatura usada em toda a API de cole\u00e7\u00f5es do Kotlin: fun\u00e7\u00f5es sem o sufixo *OrNull<\/code> lan\u00e7am uma exce\u00e7\u00e3o se a cole\u00e7\u00e3o receptora estiver vazia. Se voc\u00ea ainda quiser receber um null<\/code>, voc\u00ea deve usar a vers\u00e3o *OrNull<\/code> da fun\u00e7\u00e3o, por exemplo, firstOrNull<\/code>.
\nPortanto, decidimos gradualmente alterar o comportamento de min<\/code> e max<\/code>. Na vers\u00e3o 1.4-M3, estamos acrescentando minOrNull<\/code> e maxOrNull<\/code> como sin\u00f4nimos de min<\/code> e max<\/code> e iniciando o ciclo de depreca\u00e7\u00e3o para min<\/code> e max<\/code> para que elas sejam reintroduzidas com tipos de retorno que n\u00e3o sejam null.\n<\/li>\nminOf<\/code> e maxOf<\/code> que retornam o valor m\u00ednimo ou m\u00e1ximo da fun\u00e7\u00e3o seletora fornecida sobre os itens da cole\u00e7\u00e3o. Estas fun\u00e7\u00f5es resolvem a situa\u00e7\u00e3o na qual era necess\u00e1rio escrever map { selector }.max()!!<\/code> ou maxBy { selector }!!.selector<\/code> (ou min<\/code> e minBy<\/code>).<\/p>\n\r\ndata class OrderItem(val name: String, val price: Double, val count: Int)\r\n\r\nfun main() {\r\n\/\/sampleStart\r\n val order = listOf<OrderItem>(\r\n OrderItem("Cake", price = 10.0, count = 1),\r\n OrderItem("Coffee", price = 2.5, count = 3),\r\n OrderItem("Tea", price = 1.5, count = 2))\r\n \r\n val highestPrice = order.maxOf { it.price }\r\n\/\/sampleEnd \r\n println("O item mais caro do pedido custa $highestPrice")\r\n}\r\n<\/pre>\nminOfWith<\/code> e maxOfWith<\/code>, que recebem um Comparator<\/code> como argumento.
\nTodas essas novas fun\u00e7\u00f5es seguem a conven\u00e7\u00e3o non-null que descrevemos acima: elas lan\u00e7am exce\u00e7\u00f5es em cole\u00e7\u00f5es vazias e possuem vers\u00f5es *OrNull<\/code> que retornam null<\/code> neste caso.\n<\/li>\nflatMap<\/code> e flatMapTo<\/code> permitem que voc\u00ea use transforma\u00e7\u00f5es com tipos de retorno que n\u00e3o combinam com o tipo do receptor, ou seja:<\/p>\n\n
Sequence<\/code> em Iterable<\/code>, Array<\/code> e Map<\/code><\/li>\nIterable<\/code> em Sequence<\/code><\/li>\n<\/ul>\n\r\nfun main() {\r\n\/\/sampleStart\r\n val list = listOf("kot", "lin")\r\n val lettersList = list.flatMap { it.asSequence() }\r\n val lettersSeq = list.asSequence().flatMap { it.toList() }\r\n\/\/sampleEnd \r\n println(lettersList)\r\n println(lettersSeq.toList())\r\n}\r\n<\/pre>\n<\/li>\nflatMapIndexed<\/code> foi acrescentada como uma contrapartida para flatMap<\/code>. Como voc\u00ea talvez j\u00e1 saiba, Indexed<\/code> no nome de uma fun\u00e7\u00e3o que processa cole\u00e7\u00f5es significa que a opera\u00e7\u00e3o aplicada recebe o \u00edndice do elemento como par\u00e2metro.<\/p>\n\r\nfun main() {\r\n\/\/sampleStart\r\n val list = listOf("hello", "kot", "lin", "world")\r\n val kotlin = list.flatMapIndexed { index, item ->\r\n if (index in 1..2) item.toList() else emptyList() \r\n }\r\n\/\/sampleEnd\r\n println(kotlin)\r\n}\r\n<\/pre>\n<\/li>\n<\/ul>\nAnota\u00e7\u00e3o @Throws comum<\/h2>\n
kotlin.jvm.Throws<\/code>) e Native (kotlin.native.Throws<\/code>). A partir da vers\u00e3o 1.4-M3, a anota\u00e7\u00e3o code>@Throws<\/code<\/a> est\u00e1 dispon\u00edvel como parte da biblioteca comum diretamente no pacote kotlin<\/code> (kotlin.Throws<\/code>), o que permite que voc\u00ea a utilize no c\u00f3digo comum.<\/p>\n@Throws em fun\u00e7\u00f5es suspensas no Swift e Objective-C<\/h3>\n
NSError<\/code> \u00e9 lan\u00e7ada apenas para exce\u00e7\u00f5es que s\u00e3o inst\u00e2ncias de classes especificadas como par\u00e2metros de uma anota\u00e7\u00e3o code>@Throws<\/code<\/a> (ou suas subclasses). Na vers\u00e3o 1.4-M2 introduzimos suporte b\u00e1sico para as fun\u00e7\u00f5es de suspens\u00e3o do Kotlin no Swift e Objective-C<\/a>. Na vers\u00e3o 1.4-M3 h\u00e1 pequenas mudan\u00e7as no comportamento das fun\u00e7\u00f5es de suspens\u00e3o anotadas com code>@Throws<\/code<\/a>:<\/p>\n\n
suspend fun<\/code> anotada com @Throws<\/code>, voc\u00ea precisa especificar CancellationException::class<\/code> como par\u00e2metro da anota\u00e7\u00e3o @Throws<\/code>. Caso contr\u00e1rio, voc\u00ea ter\u00e1 um erro de compila\u00e7\u00e3o.<\/li>\n@Throws<\/code> em uma suspend fun<\/code>, ela ir\u00e1 usar implicitamente @Throws(CancellationException::class)<\/code> quando for chamada pelo Swift.<\/li>\n<\/ul>\nIgualdade em arrays de ponto-flutuante<\/h2>\n
contains<\/code>, indexOf<\/code> e lastIndexOf<\/code>. Algum tempo atr\u00e1s, descobrimos que seu comportamento em arrays de ponto-flutuante (FloatArray<\/code> e DoubleArray<\/code>) pode ser controverso e pode parecer incorreto.
\nPara ser mais espec\u00edfico, eles usam o padr\u00e3o IEEE 754<\/a> para aritm\u00e9tica de ponto-flutuante. Este padr\u00e3o define as seguintes regras de igualdade para casos especiais:<\/p>\n\n
NaN<\/code> n\u00e3o \u00e9 igual a<\/strong> NaN<\/code><\/li>\n-0.0<\/code> \u00e9 igual a<\/strong> 0.0<\/code><\/li>\n<\/ul>\n\r\nfun main() {\r\n\/\/sampleStart\r\n val darray = doubleArrayOf(Double.NaN, 0.0)\r\n println (darray.contains(darray[0])) \/\/ false!\r\n\/\/sampleEnd\r\n}\r\n<\/pre>\n\r\nfun main() {\r\n\/\/sampleStart\r\n val listOfDouble: List<Double> = listOf(0.0, Double.NaN)\r\n val listFromArray: List<Double> = doubleArrayOf(0.0, Double.NaN).asList()\r\n\r\n println(listOfDouble.contains(Double.NaN)) \/\/ true\r\n println(listFromArray.contains(Double.NaN)) \/\/ false em vers\u00f5es anteriores\r\n\/\/sampleEnd\r\n}\r\n<\/pre>\ncontains<\/code>, indexOf<\/code> e lastIndexOf<\/code> de FloatArray<\/code> e DoubleArray<\/code>. Ao tentar utiliz\u00e1-las, voc\u00ea receber\u00e1 avisos com instru\u00e7\u00f5es para substituir os usos dessas fun\u00e7\u00f5es.
\nEm lan\u00e7amentos futuros aumentaremos o n\u00edvel de depreca\u00e7\u00e3o para ERROR<\/code> e removeremos essas fun\u00e7\u00f5es da API p\u00fablica.<\/p>\nConvers\u00e3o de KType para Java Type<\/h2>\n
typeOf<\/code><\/a> \u00e0 biblioteca padr\u00e3o. Esta fun\u00e7\u00e3o retorna uma representa\u00e7\u00e3o em tempo de execu\u00e7\u00e3o do tipo reificado T<\/code> como inst\u00e2ncia de KType<\/code><\/a>. Por\u00e9m, em muitos casos de uso pr\u00e1ticos, voc\u00ea precisa trabalhar com objetos java.lang.reflect.Type<\/code><\/a> da API Java reflection em vez de usar KType<\/code>. J\u00e1 era poss\u00edvel realizar a convers\u00e3o necess\u00e1ria, mas para isto era necess\u00e1rio usar a depend\u00eancia kotlin-reflect<\/code> inteira. Agora atualizamos a biblioteca padr\u00e3o com uma forma de converter um KType<\/code> em um Type<\/code> Java \u2013 uma propriedade de extens\u00e3o KType.javaType<\/code> que retorna um Type<\/code> Java:<\/p>\n\r\nimport kotlin.reflect.javaType\r\nimport kotlin.reflect.typeOf\r\n\r\n@OptIn(ExperimentalStdlibApi::class)\r\ninline fun <reified T> accessReifiedTypeArg() {\r\n val kType = typeOf<T>()\r\n println("Kotlin type: $kType")\r\n println("Java type: ${kType.javaType}")\r\n}\r\n\r\n@OptIn(ExperimentalStdlibApi::class)\r\nfun main() {\r\n accessReifiedTypeArg<String>()\r\n \/\/ Kotlin type: kotlin.String\r\n \/\/ Java type: class java.lang.String\r\n \r\n accessReifiedTypeArg<List<String>>()\r\n \/\/ Kotlin type: kotlin.collections.List<kotlin.String>\r\n \/\/ Java type: java.util.List<java.lang.String>\r\n}\r\n<\/pre>\nType<\/code> Java obtido n\u00e3o se comporta da forma correta em alguns casos especiais (como em par\u00e2metros de tipo anotados ou vari\u00e2ncia no local da declara\u00e7\u00e3o), portanto KType.javaType<\/code> continua experimental. Voc\u00ea pode encontrar mais detalhes sobre os casos n\u00e3o suportados neste issue<\/a>.<\/p>\nCompatibilidade<\/h2>\n
Notas de pr\u00e9-lan\u00e7amento<\/h3>\n
Como experimentar os \u00faltimos recursos<\/h2>\n
\n
Compartilhe suas impress\u00f5es<\/h2>\n
Contribui\u00e7\u00f5es externas<\/h2>\n
\n
![https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2020\/07\/fun_interface-1.png<\/a>" onmouseover="this.src=’](\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2020\/07\/fun_interface-1.png\"){kind=link}
![https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2020\/07\/fun_interface.gif<\/a>‘;"\nonmouseout="this.src=’](\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2020\/07\/fun_interface.gif\"){kind=link}