实验阶段的协同程序

协同程序的设计还处于实验阶段,意味着可能会在以后的版本中改变一些特性。当编译协同程序时,默认会有一个警告:协同程序出于实验阶段。为了移除这个警告,你需要指定opt-in flag。

因为实验性质的原因,协同相关的API被放置在标准库中的kotlin.coroutines.experimental包中。当设计结束了之后,实验状态就会提升,最终的API将会被移动到kotlin.coroutines,然后实验包将会继续保留以解决兼容问题。

重要提示:我们建议库作者按照相同的约定:添加experimental前缀(比如com.example.experimental)到你的基于协同API的包下,以便保留二进制兼容。当最终API发布时,紧跟以下条款:

  • 复制相应的API到com.example(去掉experimental前缀)
  • 保留实验阶段的包以解决后向兼容

这将会最小化代码迁移产生的影响。

results matching ""

    No results matching ""