Packages and imports

A source file may start with a package declaration:

package org.example fun printMessage() { /*...*/ } class Message { /*...*/ } // ... 

All the contents, such as classes and functions, of the source file are included in this package. So, in the example above, the full name of printMessage() is org.example.printMessage, and the full name of Message is org.example.Message.

If the package is not specified, the contents of such a file belong to the default package with no name.

Default imports

A number of packages are imported into every Kotlin file by default:

Additional packages are imported depending on the target platform:

Imports

Apart from the default imports, each file may contain its own import directives.

You can import either a single name:

import org.example.Message // Message is now accessible without qualification 

or all the accessible contents of a scope: package, class, object, and so on:

import org.example.* // everything in 'org.example' becomes accessible 

If there is a name clash, you can disambiguate by using as keyword to locally rename the clashing entity:

import org.example.Message // Message is accessible import org.test.Message as testMessage // testMessage stands for 'org.test.Message' 

The import keyword is not restricted to importing classes; you can also use it to import other declarations:

Visibility of top-level declarations

If a top-level declaration is marked private, it is private to the file it's declared in (see Visibility modifiers).

Last modified: 01 June 2021

© 2010–2021 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/packages.html