Rfactor and translate English parts of the text (#25153)

This commit is contained in:
Maxim
2018-12-06 19:54:10 +03:00
committed by Gregory Gubarev
parent ca45baca82
commit c073e72b0a

View File

@ -5,12 +5,12 @@ localeTitle: Котлин
**Что такое Котлин?** **Что такое Котлин?**
[Kotlin](https://kotlinlang.org/) - это статически типизированный язык программирования, разработанный компанией [Jetbrains](https://www.jetbrains.com) , компанией за некоторыми из самых популярных в мире IDE, таких как IntelliJ и Pycharm. [Kotlin](https://kotlinlang.org/) - это язык программирования, разработанный компанией [Jetbrains](https://www.jetbrains.com) , известной своими IDE IntelliJ, Pycharm и др.
Он служит заменой Java, при этом полностью с ней совместим и работает поверх JVM. Компилируется в JavaScript, а также на другие платформы через инфраструктуру LLVM. Он находится в разработке около 6 лет, и он достиг 1,0 всего год назад. Он служит заменой Java и работает на JVM. Он находится в разработке около 6 лет, и достиг версии 1.0 всего год назад.
Kotlin настолько понравился разработчикам, что Google анонсировала его как основной язык разработки приложений под Android [Google I / O 2017](https://blog.jetbrains.com/kotlin/2017/05/kotlin-on-android-now-official/) .
Сообщество разработчиков охватило Kotlin настолько, что Google объявила о первоклассной поддержке языка для Android разработки во время [Google I / O 2017](https://blog.jetbrains.com/kotlin/2017/05/kotlin-on-android-now-official/) .
## Версия ## Версия
@ -18,18 +18,19 @@ localeTitle: Котлин
## Установка ## Установка
Прежде чем приступать к установке компилятора для Kotlin, вам необходимо убедиться, что вы настроили **JDK (Java Development Kit),** в вашей системе.
Если на вашем компьютере не установлен JDK, перейдите в **раздел «Установка»** [ссылка, чтобы узнать,](https://guide.freecodecamp.org/java) как его настроить. Прежде чем приступать к установке Kotlin, необходимо убедиться, что вы настроили **JDK (Java Development Kit)**.
Kotlin работает с **JDK 1.6+,** поэтому убедитесь, что вы установили правильную версию. Когда вы закончите настройку JDK, выполните следующие действия. Если на вашем компьютере не установлен JDK, перейдите в раздел [по этой ссылке](https://guide.freecodecamp.org/java), чтобы узнать, как его установить и настроить. Kotlin работает с **JDK 1.6+**, поэтому убедитесь, что вы установили нужную версию.
* ## IntelliJ IDEA
Самый быстрый способ заставить Kotlin работать на вашем компьютере - использовать его вместе с **IntelliJ IDEA** . Это рекомендуемая среда разработки для Kotlin из-за поддержки инструментов, предоставляемой JetBrains. Вы можете загрузить [Community Edition](http://www.jetbrains.com/idea/download/index.html) IntelliJ с [сайта JetBrains](https://www.jetbrains.com).
После установки IntelliJ вы можете начать свой первый проект на Kotlin без каких-либо дополнительных настроек. **IntelliJ IDEA** - самый быстрый способ заставить Kotlin работать на вашей машине. Это рекомендуемая среда разработки для Kotlin благодаря большому количеству инструментов, предоставляемых Jetbrains. Вы можете бесплатно скачать его [Community Edition](http://www.jetbrains.com/idea/download/index.html) IntelliJ с сайта [JetBrains](https://www.jetbrains.com) .
После установки IntelliJ можно создать свой первый Kotlin-проект дополнительных настроек для этого не требуется.
В меню **Файл** выберете **новый проект**. В открывшемся окне выберете слева пунк **Java**. Отметьте пункт **Kotlin (Java)** как показано на скриншоте ниже, и нажмите кнопку **Далее**.
Создайте **Новый проект** и убедитесь, что вы выбрали Java-модуль. Установите флажок Kotlin на этом экране:
![новый экран проекта](https://kotlinlang.org/assets/images/tutorials/getting-started/new_project_step1.png) ![новый экран проекта](https://kotlinlang.org/assets/images/tutorials/getting-started/new_project_step1.png)
@ -37,28 +38,29 @@ Kotlin работает с **JDK 1.6+,** поэтому убедитесь, чт
![название проекта](https://kotlinlang.org/assets/images/tutorials/getting-started/project_name.png) ![название проекта](https://kotlinlang.org/assets/images/tutorials/getting-started/project_name.png)
Теперь вы попадете в главный редактор, где вы увидите, что ваши файлы проектов организованы следующим образом. Теперь вы попадете в окно редактора, где слева вы увидите файлы вашего проекта.
![структура проекта](https://kotlinlang.org/assets/images/tutorials/getting-started/folders.png) ![структура проекта](https://kotlinlang.org/assets/images/tutorials/getting-started/folders.png)
Чтобы проверить правильность вашей установки, создайте новый файл Kotlin в папке **src** и назовите его **app** (или как-нибудь еще, как вам понравится):
Теперь, создайте новый файл Kotlin в папке **src** и назовите его **helloworld** (или придумайте что-нибудь, более вам подходящее).
![структура проекта](https://kotlinlang.org/assets/images/tutorials/getting-started/new_file.png) ![структура проекта](https://kotlinlang.org/assets/images/tutorials/getting-started/new_file.png)
После того, как вы создали файл, напечатайте код программы Hello World. Не волнуйтесь, если это не очень понятно сразу, это будет подробно рассмотрено позже в руководстве. После того, как вы создали файл, скопируйте в него следующую программу. Не волнуйтесь, если вы не понимаете, что она делает, мы рассмотрим ее подробно несколько позже.
``` ``` fun main (args: Array ) { println ("Hello World!") }```
fun main (args: Array<String>) {
println("Hello World!") ![окно программы](https://kotlinlang.org/assets/images/tutorials/getting-started/hello_world.png)
}
``` Теперь вы можете ее запустить нажав пиктограмму Kotlin расположенную левее вставленной строчки кода.
![project structure ](https://kotlinlang.org/assets/images/tutorials/getting-started/hello_world.png)
Теперь вы можете запустить эту программу, нажав на иконку Kotlin слева (часть редактора с номерами строк):
![hello world](https://kotlinlang.org/assets/images/tutorials/getting-started/run_default.png) ![hello world](https://kotlinlang.org/assets/images/tutorials/getting-started/run_default.png)
Если все пройдет нормально, вы увидите сообщение "Hello World!" в окне запуска, как показано ниже:
Если все пойдет хорошо, то вы увидите сообщение "Hello World!" в окне **Run** расположенной внизу главного окна.
![run window](https://kotlinlang.org/assets/images/tutorials/getting-started/run_window.png) ![run window](https://kotlinlang.org/assets/images/tutorials/getting-started/run_window.png)
@ -89,10 +91,7 @@ fun main (args: Array<String>) {
Go ahead and create a new Kotlin file in the **src** folder Go ahead and create a new Kotlin file in the **src** folder
Once that is done go ahead and type out the following code. Don't worry if it does not make sense right now, it will be covered later in the guide. Once that is done go ahead and type out the following code. Don't worry if it does not make sense right now, it will be covered later in the guide.
``` ``` fun main (args: Array ) { println ("Hello World!") } ```
fun main (args: Array ) { println ("Hello World!") }
```
![eclipse hello world ](https://kotlinlang.org/assets/images/tutorials/getting-started-eclipse/hello-world.png) ![eclipse hello world ](https://kotlinlang.org/assets/images/tutorials/getting-started-eclipse/hello-world.png)
Now that you are done typing out the Hello World code, go ahead and run it. To run the file, right click anywhere inside the editor and click on ***Run As -> Kotlin Application*** Now that you are done typing out the Hello World code, go ahead and run it. To run the file, right click anywhere inside the editor and click on ***Run As -> Kotlin Application***
@ -104,39 +103,37 @@ fun main (args: Array ) { println ("Hello World!") }
![eclipse run app](https://kotlinlang.org/assets/images/tutorials/getting-started-eclipse/output.png) ![eclipse run app](https://kotlinlang.org/assets/images/tutorials/getting-started-eclipse/output.png)
* ## Using the standalone compiler on the terminal * ## Использование компилятора Kotlin из командной строки
If you are someone who prefers doing things in a more manual way and do not want to tie yourself down to an editor/IDE you might wanna use the Kotlin compiler. -----
### Downloading the compiler Если вы предпочитаете обходится без IDE и делать все вручную, вы пожете использовать отдельный компилятор Kotlin.
With every release of Kotlin, Jetbrains ship a standalone compiler which can be downloaded from the <a href='https://github.com/JetBrains/kotlin/releases/tag/v1.1.51'>GitHub releases</a>. Version 1.1.51 happens to be the latest at the time of this writing. ### Загрузка компилятора
С каждым релизом Kotlin, Jetbrains поставляет компилятор, который можно скачать [с сайта GitHub](https://github.com/JetBrains/kotlin/releases). Версия 1.1.51 была самой свежей на момент написания данного текста.
**Установка вручную**
После того как, вы скачали архив с компилятором, его нужно распаковать и запустить стандартную процедуру установки. Добавьте директорию **bin** к системной переменной PATH на необязательном шаге установки. Она (директория) содержит набор скриптов необходимых компилятору, чтобы компилировать и запускать программы Kotlin под Windows, Linux или macOS.
</br> **Установка при помощи Homebrew (MacOS)**
**Manual Installation** Вы можете установить компилятор Kotlin на macOS при помощи [Homebrew](http://brew.sh) - менеджера пакетов macOS. Запустите терминал и выполните следующие команды:
Once you have downloaded the compiler you need to unzip it and proceed with the standard installation using the installation wizard. Adding the **bin** directory to the system path is an optional step. It contains the scripts that are necessary to compile and run Kotlin on Windows, Linux and macOS. ```
$ brew update
</br> $ brew install kotlin
**Installation via Homebrew**
You can install the compiler on macOS using <a href='http://brew.sh/'>Homebrew </a>which is a package manager for macOS. Launch the Terminal app and issue the following commands
``` ```
$ brew update $ brew install kotlin
```
**Installation via SDKMAN!** **Installation via SDKMAN!**
Another simple way of installing the Kotlin compiler on macOS, Linux, Cygwin, FreeBSD and Solaris is by using <a href='http://sdkman.io/'>SDKMAN!</a>. Launch the terminal and issue the following commands Другой простой способ усатновить компилятор Kotlin на macOS, Linux, Cygwin, FreeBSD или Solaris - это использовать [SDKMAN!](http://sdkman.io/). Выполните в терминале следующую команду, для скачивания SDKMAN! :
```
$ curl -s https://get.sdkman.io | bash\`\`\` ``` $ curl -s https://get.sdkman.io | bash ```
Следуйте инструкциям на экране и после SDKMAN! это проблема с установкой следующей команды внутри терминала После этого запустите с его помощью установку Kotlin:
`$ sdk install kotlin`
**Установка в Линуксе** **Установка в Линуксе**
@ -146,33 +143,35 @@ kotlin компилятор есть также практически во вс
Как и все предыдущие параметры установки, было бы неплохо протестировать запуск установки. Как и все предыдущие параметры установки, было бы неплохо протестировать запуск установки.
Откройте текстовый редактор по вашему выбору и напишите базовую программу Kotlin, приведенную ниже.
**Протестируем установку**
Теперь необходимо убедиться, что компилятор установился и настроен корректно. Откройте текстовый редактор и напишите простую программу Kotlin:
``` ```
fun main(args: Array<String>) { fun main(args: Array<String>) {
println("Hello, World!") println("Hello, World!")
} }
``` ```
Сохраните этот файл с расширением **.kt** . Теперь вы готовы скомпилировать его и посмотреть результаты. Для этого выполните следующую команду Сохраните этот файл с расширением **.kt** . Теперь все готово, чтобы ее скомпилировать и посмотреть результ. Для этого выполните следующую команду:
`$ kotlinc hello.kt -include-runtime -d hello.jar` ``` $ kotlinc hello.kt -include-runtime -d hello.jar ```
параметр `-d` сообщает компилятору, что вы хотите вызывать. Параметр `-include-runtime` делает полученный .jar-файл самодостаточным и выполнимым, включая библиотеку времени исполнения Kotlin. параметр `-d` сообщает компилятору, файл с каким именем, и какого формата вы хотите получить. Параметр `-include-runtime` делает полученный .jar-файл самодостаточным и выполнимым, включая библиотеку времени исполнения Kotlin.
Если ошибок компиляции не было, запустите приложение, используя следующую команду Если ошибок компиляции не было, можно запустить приложение, используя следующую команду:
`$ java -jar hello.jar` `$ java -jar hello.jar`
Если все пойдет хорошо, вы должны увидеть **Hello World!** напечатан на экране терминала Если все пойдет хорошо, вы должны увидеть **Hello World!** на экране терминала
``` ```
$ java -jar hello.jar $ java -jar hello.jar
Hello, World! Hello, World!
``` ```
Поздравляем, вы успешно создали компилятор Kotlin и среду разработки в вашей системе. В этом руководстве мы рассмотрим все тонкости и интересные части Kotlin, но вы можете получить головной убор, если хотите, перейдя на сайт [Try Kotlin](https://try.kotlinlang.org/) и пройдя там упражнения. Поздравляем, вы успешно установили компилятор Kotlin и среду разработки в вашей системе. На сайте [Try Kotlin](https://try.kotlinlang.org/) можной практиковаться в выполнении различных заданий на Kotlin.
## Документация ## Документация
Одна из самых больших вещей в Kotlin - это всеобъемлющая и хорошо структурированная документация. Даже если вы новичок в программировании, вы найдете себя дома с документами. Они делают довольно изумительную работу, чтобы все это было хорошо структурировано. Вы можете проверить официальную документацию по [этой ссылке](https://kotlinlang.org/docs/reference/) . У Kotlin подробная и хорошо структурированная документация. Даже если вы новичок в программировании, вам будет удобно. Jetbrains делают довольно много работы, чтобы все было хорошо структурировано. Посмотреть официальную документацию можно по [этой ссылке](https://kotlinlang.org/docs/reference/) .