Kotlin Language Documentation 1.3

• 语言: 英语
• 格式: .pdf
• 来源: s3.amazonaws.com

摘要

文档详细介绍了Kotlin 1.3版本的新特性和兼容性变化。主要内容包括coroutines的正式发布和稳定性改善、Kotlin/Native的增强、多平台项目模型的改进，以及新的功能如无参数main函数和注解类中的嵌套声明。此外，文档还描述了多项行为兼容性和源兼容性变化，包括构造函数参数评估顺序的变更和split方法跨平台行为的统一。

AI总结

《Kotlin Language Documentation 1.3》摘要：

### 新特性概览
1. **协程全稳态发布**：
- 1.3版本正式发布协程支持，语言和API完全稳定。
- 增加对挂起函数的可调用引用支持（callable references on suspend-functions），提升反射API中的协程支持。

2. **Kotlin/Native 改进**：
- 继续优化Kotlin/Native目标，提供更多功能和稳定性。

3. **多平台项目改进**：
- 重构了多平台项目模型，提升代码共享的灵活性和可维护性。
- 主要变化：
- 共同代码和平台特定代码现在放在同一模块的不同源根中，简化了项目配置。
- 提供预设的平台配置，简化依赖管理。
- 支持跨平台的源集共享。
- 支持发布多平台库。

### 兼容性变化
1. **行为兼容性**：
- **类初始化顺序变化**：1.3版本修改了构造函数参数评估顺序，可能影响类初始化行为。可以通过 `-Xnormalize-constructor-calls=disable` 恢复旧行为，但该标志将在下一主版本中移除（问题 KT-19532）。

2. **二进制兼容性**：
- 废弃了以下工件：
- `kotlin-runtime`：建议使用 `kotlin-stdlib`。
- `kotlin-stdlib-jre7/8`：建议使用 `kotlin-stdlib-jdk7/8`。
- `kotlin-jslib`：建议使用 `kotlin-stdlib-js`。
- 1.3版本移除了这些工件，之前版本仅抛出警告。

3. **字符串拆分行为统一**：
- 1.3统一了 `split` 方法在不同平台上的行为（问题 KT-21049）。

### 标准库增强
1. **新增实用方法**：
- `associateWith`、`ifEmpty`、`ifBlank` 等函数，简化常见操作。

2. **常用类型增强**：
- 数组尺寸相关常量：`SIZE_BYTES` 和 `SIZE_BITS`。
-aad

3. **其他改进**：
- 添加了对数值转换的更严格的检查，以防止整数溢出。
- 统一了正则表达式空匹配结果的处理。

### IDE 和工具支持
1. **代码风格支持**：
- 提供更好的代码风格推荐和自动化支持，简化代码规范化。

2. **内置支持**：
- `kotlinx.serialization` 库现在与Kotlin编译器一起分发，减少了版本兼容性的担忧。

3. **脚本和工具改进**：
- 支持运行可执行的Kotlin脚本文件（`.kts` 扩展名），直接在编辑器中评估。
- add

### 其他特性
1. **参数无需的主函数**：
- 支持无参数的 `main` 函数，简化程序入口。

2. **注解改进**：
- 支持在注解类中嵌套类、接口、对象和伴生对象。

3. **合约（Contracts）**：
- 引入实验性合约功能，支持更智能的类型推断和不为空检查。

4. **静态分析增强**：
- 提供更智能的警告和减少样板代码的功能，例如智能转换（smart casts）。
- 提供更有效的分开设置warnings as errors的选项。

### 注意事项
- 多平台项目和脚本功能目前仍为实验性功能，未来可能有breaking changes。
- 脚本API不提供兼容性保证。

如需了解更多细节，建议参考完整的《Kotlin Language Documentation 1.3》。