Scenic Framework v0.11 升级指南与技术解析

陶淑菲

于 2025-06-26 09:07:42 发布

阅读量316

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00874/article/details/148915536

Scenic Framework v0.11 升级指南与技术解析

scenic Core Scenic library 项目地址: https://gitcode.com/gh_mirrors/scen/scenic

前言

Scenic Framework 是一个面向嵌入式设备和物联网场景的UI框架，其最新版本v0.11带来了重大架构革新。本文将深入解析这些变化，并提供详细的升级指南，帮助开发者顺利完成版本迁移。

核心架构变更概述

v0.11版本对Scenic进行了全面重构，主要改进包括：

全新的资源管道系统：废弃了原有的Scenic.Cache，引入了更易用的静态资源管道
场景状态管理重构：采用类似Phoenix Channel和Plug Conn的状态管理模型
驱动引擎重写：标准化了渲染流程，使驱动开发更简单
新增脚本引擎：用于生成可发送给驱动的绘制脚本
输入事件处理优化：需要显式请求输入事件

详细升级步骤

1. 依赖项更新

修改mix.exs文件中的依赖项：

{:scenic, "~> 0.11.0"},
{:scenic_driver_local, "~> 0.11.0"}

执行清理命令确保更新生效：

mix deps.clean --all
mix deps.unlock

2. 视口配置调整

视口配置从Map改为Keyword列表：

# 旧配置
%{
  name: :main_viewport,
  size: {1200, 600},
  default_scene: {MyProject.RootScene, nil},
  drivers: [
    %{
      module: Scenic.Driver.Glfw,
      name: :glfw,
      opts: [resizeable: false, title: @title]
    }
  ]
}

# 新配置
[
  name: :main_viewport,
  size: {1200, 600},
  default_scene: {MyProject.RootScene, nil},
  drivers: [
    [
      module: Scenic.Driver.Local,
      name: :local
    ]
  ]
]

3. 场景状态管理重构

v0.11采用了类似Phoenix的状态管理模式：

defmodule MyScene do
  use Scenic.Scene
  
  @impl Scenic.Scene
  def init(scene, _params, _opts) do
    graph = Scenic.Graph.build(font: :roboto)
      |> text("Hello World", id: :text)
    
    scene =
      scene
      |> assign(graph: graph, counter: 0)
      |> push_graph(graph)
    
    {:ok, scene}
  end
end

4. 图形推送机制

push_graph/2函数回归并成为标准做法：

def handle_cast(:update, scene) do
  new_graph = Scenic.Graph.modify(scene.assigns.graph, :text, &text(&1, "Updated"))
  
  scene =
    scene
    |> assign(graph: new_graph)
    |> push_graph(new_graph)
  
  {:noreply, scene}
end

新特性详解

1. 静态资源管道

新的资源管理系统更接近Phoenix的静态资源处理方式：

在项目根目录创建assets文件夹
配置资源模块：

config :scenic, :assets, module: MyApp.Assets

定义资源模块：

defmodule MyApp.Assets do
  use Scenic.Assets.Static,
    otp_app: :my_app,
    alias: [
      logo: "images/logo.png"
    ]
end

在场景中使用：

Graph.build()
  |> rect({100, 50}, fill: {:image, "images/background.jpg"})
  |> rect({50, 50}, fill: {:image, :logo})  # 使用别名

2. 流式资源处理

动态图像处理API升级为Scenic.Assets.Stream：

# 生产者端
def handle_info({:camera_frame, texture}, state) do
  :ok = Scenic.Assets.Stream.put("camera_0", texture)
  {:noreply, state}
end

# 消费者端
Graph.build()
  |> rect({640, 480}, fill: {:stream, "camera_0"})

重要变更说明

驱动变更：
- :scenic_driver_local成为标准渲染器
- 废弃:scenic_driver_glfw和:scenic_drives_nerves_rpi
样式变更：
- :text_height替换为:line_height
- 移除:clear_color样式，改为在视口配置中设置主题
输入处理：
- 需要显式请求输入事件：Scene.request_input/2或Scene.capture_input/2
- 输入消息格式变更
组件验证：
- verify/1重命名为validate/1