Kotlin 中文文档

转载地址：http://www.tuicool.com/articles/faqyMzE

gitbook 墙内访问速度很糟糕 现在有了 墙内地址 啦 :)

国内服务器由 掘金 赞助

稀土掘金：挖掘最优质的互联网技术 / 联合编辑每日精选内容 / 移动端优质阅读体验

本书源码在github

pd下载 ePub下载

记得要点 star star star

发现有翻译的不好的或者错误欢迎到 github 提issue

号外 号外 Kotlin 1.0 正式发布

Android 世界的 Swift 终于发布1.0版本

Kotlin 是一个实用性很强的语言，专注于互通，安全，简洁，工具健全...

无缝支持 Java+Kotlin 项目，可以更少的使用样版代码，确保类型安全。

Kotlin 1.0 更新日志

还换了logo :)

Kotlin LOC (软件规模代码行) 如下图

近期我会重新读一遍 Kotlin 官方文档 并对现在的这份文档进行更新(又立 flag 了) -- 2016.2.16

• 准备开始

  • 基本语法
  • 习惯用语
  • 编码风格

• 基础

  • 基本类型
  • 包
  • 控制流
  • 返回与跳转

• 类和对象

  • 类和继承
  • 属性和字段
  • 接口
  • 可见性修饰词
  • 扩展
  • 数据对象
  • 泛型
  • 嵌套类
  • 枚举类
  • 对象表达式和声明
  • 代理模式
  • 代理属性

• 函数和lambda表达式

  • 函数
  • 高级函数和lambda表达式
  • 内联函数

• 其它

  • 多重申明
  • Ranges
  • 类型检查和自动转换
  • This表达式
  • 等式
  • 运算符重载
  • 空安全
  • 异常
  • 注解
  • 反射
  • 动态类型

• 参考

  • API
  • 语法

• 互用性

  • 与 java 交互

• 工具

  • Kotlin代码文档
  • 使用Maven
  • 使用Ant
  • 使用Griffon
  • 使用Gradle

• FAQ

  • 与java对比
  • 与Scala对比

如何在Android studio中使用KotLin

在根目录build.gradle里边添加相应的依赖就好
看示例：

	// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    ext.kotlin_version = '1.0.6'
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath "org.jetbrains.kotlin:kotlin-android-extensions:$kotlin_version"
    }
}

allprojects {
    repositories {
        jcenter()
    }

添加了版本号以及要使用的俩个依赖，如果需要还可以导入其他的依赖。

在app的目录（也就是你android代码目录）的build.gradle文件中添加简单的设置就好
看示例：

buildscript {
    repositories {
        jcenter()


    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0'
    }
}


def getDate() {
    return Calendar.getInstance().getTimeInMillis();
}


allprojects {
    repositories {
        jcenter()


    }
}
apply plugin:  'com.android.application'
apply plugin: 'kotlin-android'


dependencies {
    compile 'com.android.support:support-v4:23.1.1'
    compile 'com.android.support:appcompat-v7:23.1.1'
    compile 'com.android.support:design:23.1.1'
    compile 'com.android.support:preference-v7:23.1.1'
    compile 'org.apache.commons:commons-compress:1.10'
    compile 'commons-net:commons-net:3.3'
    compile 'com.github.zafarkhaja:java-semver:0.9.0'
    compile 'org.unbescape:unbescape:1.1.1.RELEASE'
    compile 'org.msgpack:msgpack:0.6.12'
    compile 'com.googlecode.juniversalchardet:juniversalchardet:1.0.3'
    compile 'org.tukaani:xz:1.5'
    compile 'ch.acra:acra:4.6.2'
    testCompile 'junit:junit:4.12'
    compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
}


android {
    compileSdkVersion 23
    buildToolsVersion '23.0.2'


    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }


    packagingOptions {
        exclude 'META-INF/LICENSE.txt'
        exclude 'META-INF/NOTICE.txt'
    }


    defaultConfig {
        minSdkVersion 9
        targetSdkVersion 22
        versionCode 4
        versionName "1.7.0-unstable"
        if(System.getenv("NIGHTLY_BUILD")) {
            versionName += "+" + System.getenv("NIGHTLY_BUILD_COMMIT").substring(0, 7)
        }
    }


    lintOptions {
        if (System.getenv("NIGHTLY_BUILD")) {
            checkReleaseBuilds false
        }
        abortOnError false
    }


    signingConfigs {
        release {
            if (System.getenv("KEYSTORE_FILE") != null) {
                storeFile = file(System.getenv("KEYSTORE_FILE"))
                storePassword = System.getenv("KEYSTORE_PWD")
                keyAlias = System.getenv("KEYSTORE_ALIAS")
                keyPassword = System.getenv("KEYSTORE_ALIAS_PWD")
            }
            return true
        }
    }


    buildTypes {
        debug {
            buildConfigField "java.util.Date", "BUILD_TIME", "new java.util.Date(" + getDate() + "L)"
            buildConfigField "String", "BUILD_NAME", "\"" + System.getenv("USER") + "\"";
            minifyEnabled false
            shrinkResources false
            debuggable true
            jniDebuggable true
            zipAlignEnabled true
            multiDexEnabled true
        }
        release {
            buildConfigField "java.util.Date", "BUILD_TIME", "new java.util.Date(" + getDate() + "L)"
            buildConfigField "String", "BUILD_NAME", "\"" + System.getenv("USER") + "\"";
            if (System.getenv("KEYSTORE_FILE") != null) {
                signingConfig signingConfigs.release
            }
            multiDexEnabled true
            return true
        }
    }
    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }
}
repositories {
    mavenCentral()
}

主要添加了有3个地方：
1、

	apply plugin: 'kotlin-android'

2、 

	compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"

3、

android{
	 ......
		sourceSets {
			main.java.srcDirs += 'src/main/kotlin'
		}
	}

这样就可以正常使用了。

如果出现
Execution failed for task ':app:clean'.
> Unable to delete file: C:\Users\User\KotlinGameEngine\app\build\intermediates\exploded-aar\com.android.support\appcompat-v7\23.0.1\jars\classes.jar
类似这样的问题，那么只要在app目录下的build.gradle文件中添加task：

	task clean(type: Exec) {
    ext.lockhunter = '\"C:\\LockHunter.exe\"'
    def buildDir = file(new File("build"))
    commandLine 'cmd', "$lockhunter", '/delete', '/silent', buildDir
}

如果出现Unresolved reference: kotlinx这样的问题，那么需要在app目录下的build.gradle文件中添加：
apply plugin: 'kotlin-android-extensions'
以及要确保classpath配置了classpath "org.jetbrains.kotlin:kotlin-android-extensions:$kotlin_version"