Есть ли официальный путеводитель по Kotlin?

Я просто занимаюсь программированием Kotlin, и всякий раз, когда я изучаю новый язык, я стараюсь с самого начала пробовать рекомендуемый путь (руководство по стилю Sun Java, PEP8 для Python и т.д.). Есть что-то подобное для Котлина? Кажется, я не могу найти что-либо в Интернете, которое так или иначе говорит.

Ответы

Ответ 1

На сегодняшний день (2 ноября 2017 года) также существует официальное руководство по дизайну Kotlin для Android, поддерживаемое Google.

Ответ 2

Да, есть руководство по кодированию, которое можно найти здесь.

Кроме того, здесь выдержка из официального руководства.

Если у вас есть сомнения по умолчанию для кодов Java, таких как:

Использование camelCase для имен (и избегать подчеркивания в именах)

Типы начинаются с верхнего регистра

Методы и свойства начинаются с нижнего регистра

Использовать 4-сегментный отступ

public функции должны иметь такую документацию, что она появляется в Kotlin Doc

Ответ 3

TL;DR:

Для быстрого запуска: Условные обозначения JetBrains * обновлены в январе /2018 году.
Для команды или производственного кода: Стандарты кодирования Google Android.
Инструменты статического анализа: Detekt, Ktlint, Официальный Android Lint.

Я знаю, что прошло некоторое время с тех пор, как вы задали этот вопрос, я отправлюсь на будущие ссылки.

Если вы только начинаете и не чувствуете себя очень подавленным в самом начале, я буду рекомендовать конвенции Code JetBrains:

https://kotlinlang.org/docs/reference/coding-conventions.html Это очень легко, и вы можете внести свой вклад в список.

Если вы ищете что-то более конкретное, чтобы обсудить с вашей командой, чтобы получить что-то для производства, я рекомендую Android-Kotlin One от Google: https://android.github.io/kotlin-guides/style.html

И чтобы ответить на ваш вопрос в комментариях об инструменте типа checkstyle, который чрезвычайно полезен для команды, теперь вы можете получить некоторую поддержку от инструментов статического анализа, и пока Google обновляет Lint для Kotlin, я нашел эти интересные проекты:

И как вы можете прочитать в этом обсуждении IntelliJ теперь поддерживает проверку стиля кода Kotlin: https://discuss.kotlinlang.org/t/recommended-code-style-tool/3012/9

Обновление Jan/2018: Начиная с Kotlin 1.2.20 или новее Jetbrains обновил официальный codestyle, и они поддерживают стиль в IDE: перейдите в Настройки | Редактор | Стиль кода | Kotlin, нажмите ссылку "Установить из..." в верхнем правом углу и выберите "Предопределенный стиль/Руководство по стилю Kotlin" в меню