Modo API explícito de Kotlin | medio

En Kotlin 1.4, una nueva característica del compilador llamada modo API explícito se introdujo, especialmente para desarrolladores de bibliotecas.

Ofertas del compilador de Kotlin modo API explícito para autores de bibliotecas. En este modo, el compilador realiza comprobaciones adicionales que ayudan a que la API de la biblioteca sea más clara y coherente. Agrega los siguientes requisitos para las declaraciones expuestas a la API pública de la biblioteca:

– Se requieren modificadores de visibilidad para las declaraciones si la visibilidad predeterminada las expone a la API pública. Esto ayuda a garantizar que ninguna reclamación se exponga involuntariamente a la API pública.

– Se requieren solicitudes explícitas específicas de tipo para las propiedades y funciones expuestas a la API pública. Esto garantiza que los usuarios de la API conozcan los tipos de miembros de la API que utilizan.

Dependiendo de la configuración, el compilador puede lanzar un archivoerror o warning . Para facilitar la lectura y reducir el código detallado, pocas declaraciones se excluyen de las comprobaciones anteriores, a saber

  • constructores primarios
  • propiedades de las clases de datos
  • captadores y establecedores de propiedades
  • override métodos
  • Ser explícito sobre los modificadores de visibilidad evita la exposición accidental de API internas.
  • Con tipos de devolución explícitos con evita cambios accidentales en el tipo de devolución que pueden causar un cambio sustancial para los usuarios de la biblioteca.

Ejemplo

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *