Rfactor and translate English parts of the text (#25153)
This commit is contained in:
Maxim
Gregory Gubarev
@ -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 на этом экране:
|
||||
|
||||
|
||||
|
||||
@ -37,28 +38,29 @@ Kotlin работает с **JDK 1.6+,** поэтому убедитесь, чт
|
||||
|
||||
|
||||
|
||||
Теперь вы попадете в главный редактор, где вы увидите, что ваши файлы проектов организованы следующим образом.
|
||||
Теперь вы попадете в окно редактора, где слева вы увидите файлы вашего проекта.
|
||||
|
||||
|
||||
|
||||
Чтобы проверить правильность вашей установки, создайте новый файл Kotlin в папке **src** и назовите его **app** (или как-нибудь еще, как вам понравится):
|
||||
|
||||
Теперь, создайте новый файл Kotlin в папке **src** и назовите его **helloworld** (или придумайте что-нибудь, более вам подходящее).
|
||||
|
||||
|
||||
|
||||
После того, как вы создали файл, напечатайте код программы Hello World. Не волнуйтесь, если это не очень понятно сразу, это будет подробно рассмотрено позже в руководстве.
|
||||
После того, как вы создали файл, скопируйте в него следующую программу. Не волнуйтесь, если вы не понимаете, что она делает, мы рассмотрим ее подробно несколько позже.
|
||||
|
||||
```
|
||||
fun main (args: Array<String>) {
|
||||
println("Hello World!")
|
||||
}
|
||||
```
|
||||
|
||||
``` fun main (args: Array ) { println ("Hello World!") }```
|
||||
|
||||
|
||||
|
||||
Теперь вы можете ее запустить нажав пиктограмму Kotlin расположенную левее вставленной строчки кода.
|
||||
|
||||
Теперь вы можете запустить эту программу, нажав на иконку Kotlin слева (часть редактора с номерами строк):
|
||||
|
||||
|
||||
|
||||
Если все пройдет нормально, вы увидите сообщение "Hello World!" в окне запуска, как показано ниже:
|
||||
|
||||
Если все пойдет хорошо, то вы увидите сообщение "Hello World!" в окне **Run** расположенной внизу главного окна.
|
||||
|
||||
|
||||
|
||||
|
||||
@ -89,10 +91,7 @@ fun main (args: Array<String>) {
|
||||
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.
|
||||
```
|
||||
|
||||
fun main (args: Array ) { println ("Hello World!") }
|
||||
```
|
||||
``` fun main (args: Array ) { println ("Hello World!") } ```
|
||||
|
||||
|
||||
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!") }
|
||||
|
||||
|
||||
|
||||
* ## Using the standalone compiler on the terminal
|
||||
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.
|
||||
* ## Использование компилятора Kotlin из командной строки
|
||||
-----
|
||||
|
||||
### 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.
|
||||
|
||||
</br>
|
||||
|
||||
**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
|
||||
```
|
||||
|
||||
$ brew update $ brew install kotlin
|
||||
```
|
||||
**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>) {
|
||||
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`
|
||||
|
||||
Если все пойдет хорошо, вы должны увидеть **Hello World!** напечатан на экране терминала
|
||||
Если все пойдет хорошо, вы должны увидеть **Hello World!** на экране терминала
|
||||
```
|
||||
$ java -jar hello.jar
|
||||
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/) .
|
||||
|
||||
|
||||
Reference in New Issue
Block a user