Visibilidad internal frente a public
Controle deliberadamente la superficie de su módulo
Visibilidad internal frente a public es una lección gratuita de Kotlin Multiplatform Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Kotlin Multiplatform Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Kotlin Multiplatform Academy incluye 4 lecciones en total.
La visibilidad controla el acceso
Los modificadores de visibilidad de Kotlin determinan quién puede llamar a su código. Así separa la puerta de entrada del módulo de sus estancias privadas.
public es el valor predeterminado
Si no escribe nada, una declaración es public. Esto significa que cualquiera, incluidas ambas aplicaciones, puede verla y llamarla desde fuera del módulo.
fun greet(name: String) = "Hi, " + nameinternal significa «solo para el módulo»
El modificador internal limita una declaración a su propio módulo. El código externo, como la aplicación de Android o iOS, simplemente no puede verla.
internal fun buildHeader(): String = "X-App: 1"private es el más restrictivo
Un miembro private solo es visible dentro de su archivo o clase. Utilícelo para pequeñas funciones auxiliares que nadie más deba tocar.
private fun clamp(x: Int) = x.coerceIn(0, 100)public es su contrato
Considere cada declaración public como una promesa para quienes llaman al código. Cuando las aplicaciones dependen de ella, cambiarla puede impedir que se compilen.
internal para la infraestructura
La conexión de red, los mapeadores y las funciones auxiliares son la infraestructura. Márquelos como internal para que respalden su API sin formar parte de ella.
Por defecto, mantenga el acceso cerrado
Comience todo como internal o private y abra únicamente lo que quienes llaman al código necesiten de verdad. Es mucho más seguro que abrirlo todo por costumbre.
Qué significa módulo aquí
En el caso de internal, un módulo es un conjunto de archivos que se compilan juntos, como su módulo compartido de Gradle. Las aplicaciones son módulos independientes.
Una superficie menor permite cambios más seguros
Ocultar la infraestructura reduce su superficie pública. Al exponer menos, puede reorganizar libremente los elementos internos sin preocupar a quienes llaman al código. 🔒
La visibilidad también se aplica a las propiedades
Los modificadores se aplican a las propiedades y las clases, no solo a las funciones. Una clase puede ser pública mientras sus campos permanecen privados en su interior.
class Cart {
private var items = 0
val count: Int get() = items
}internal en ambas aplicaciones
Como internal oculta los elementos al atravesar el límite del módulo, ni la aplicación de Android ni la de iOS los ve, lo que mantiene ordenada la API.
Comprobación rápida
Comprobemos cómo funciona internal.
Recapitulación
public es su contrato, internal oculta la infraestructura dentro del módulo y private bloquea las funciones auxiliares. Mantenga el acceso cerrado por defecto para obtener una API limpia. 🎉
Preguntas frecuentes
¿La lección «Visibilidad internal frente a public» es gratis?
Sí — el texto completo de «Visibilidad internal frente a public» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Kotlin Multiplatform Academy, actualiza a CoddyKit PRO. El curso de Kotlin Multiplatform Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Visibilidad internal frente a public»?
Controle deliberadamente la superficie de su módulo Practicas Kotlin Multiplatform Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Kotlin Multiplatform Academy?
No se requiere experiencia previa. Kotlin Multiplatform Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.
¿Cuánto tiempo toma la lección «Visibilidad internal frente a public»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Kotlin Multiplatform Academy?
Sí. Cada lección de Kotlin Multiplatform Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Diseñe una API pública pequeña
- Visibilidad internal frente a public
- Organice los paquetes dentro del módulo
- Documente la API para ambos equipos