协程

每个根都有一条会话线程,它有两个入口:

  • root.sessionScope:要挂并发的协程用它(SupervisorJob + sessionDispatcher,随 root.close() 取消,不会活得比树更久);
  • root.post { }:非挂起的回调用它。已经在会话线程上就内联执行,否则投过去;异常不吞。跨线程投递没有顺序保证,别拿它和帧循环排顺序。

底层原语是 DslRootUtils.sessionDispatcher(串行调度器,指向该根的主线程)与 isOnSessionThread。注意自己用 Minecraft.getInstance() 之类另造一个 dispatcher 指到同一线程是错的:框架的 isOnSessionThread、session 属性作用域都绑在会话调度器上,自己造的那个在框架看来是”别的线程”。

通过Context启动

部分回调包含CoroutineScope接收者。可以使用launch{},async{},withContext(){}等扩展函数。

默认在渲染线程执行。如果需要做耗时计算、IO读写,需要手动指定在Dispatchers.IO。

属性自带的作用域

local/stable/session/static属性也可以直接launch。这些作用域按属性边界释放:

  • local每个条目一个scope,条目在成功帧末未被读到就取消它自己的;
  • stable每个Screen一个共享scope,Screen关闭时取消;
  • session使用所属Root的sessionScope,Root关闭时取消;
  • static使用进程级scope,不随任何Root或Screen关闭。

local/stable/session 使用根的会话调度器,static 使用 Dispatchers.Default。进程作用域里的工作若要操作 UI,需要通过对应的 root.post 回到会话线程。

local/stable的scope是Screen Job的子级,session是Root Job的子级,而Screen Job又是Root Job的子级。所以关闭Screen或Root时,即使某个初始化块还没把属性发布出来,它启动的协程也会被取消。界面关闭后,保留的作用域对象不能再声明新属性或取协程scope。

local/stable的coroutineScope是各自声明的条目,随帧或屏释放;session/static的coroutineScope直接返回Root或进程持有的那个scope,不会为每个调用它的Screen在共享map里建立条目。所以多个Screen取同一Root/进程的scope拿到的是同一个对象,也不会增加共享槽。

作用域只保证生命周期,不会让共享属性里的任意可变对象自动线程安全。单个值的引用读写跨线程可见;复合读写仍需自行同步。static/session动画器内部的多字段状态由该动画器自己的锁保持一致,不引入全局锁。


This site uses Just the Docs, a documentation theme for Jekyll.