Imports, exports y bibliotecas

Un import incorpora otro archivo o paquete al código para que pueda utilizar sus clases y funciones. Todo archivo de Dart comienza con ellos. 📥

Las bibliotecas integradas utilizan el prefijo dart:. Por ejemplo, dart:math proporciona sqrt y Random sin necesidad de instalar nada.

Para utilizar una dependencia de pub, impórtela con el prefijo package:, seguido del nombre del paquete y de la ruta del archivo dentro de este.

Para los archivos del propio proyecto, utilice una ruta relative entre comillas. Así mantiene vinculado el código relacionado sin un prefijo de paquete.

Si dos bibliotecas comparten un nombre, añada un prefijo con as. Después, llame a los miembros mediante ese prefijo para evitar conflictos.

Utilice show para importar únicamente nombres específicos de una biblioteca. Así mantiene limpio el espacio de nombres y deja clara su intención.

Lo contrario de show es hide. Importa todo excepto los nombres que enumere, lo que resulta ideal para evitar un conflicto concreto.

En Dart, cada archivo es una library de forma predeterminada. Los miembros públicos de nivel superior son visibles para quienes importan la biblioteca; no se requiere nada más.

Un nombre que comienza con un underscore es privado para su biblioteca. Quienes la importan no pueden verlo; así es como se ocultan los detalles de implementación.

La directiva export reenvía los nombres públicos de otra biblioteca a través de su archivo, de modo que los usuarios importan un único punto de entrada en lugar de muchos.

Un archivo barrel es simplemente una biblioteca llena de exportaciones. Proporciona al paquete una única superficie de API pública y ordenada que todos pueden importar.

Ha aprendido a importar código del SDK, de paquetes y local, a precisarlo con show y hide, y a exponer una API limpia mediante export. 🎉