跳到主要内容

迁移到 v3

安装​

通过运行以下命令,将所有 @motion-canvas 包更新到 3.x.x 版本:

npm install --save @motion-canvas/2d@3 @motion-canvas/core@3 @motion-canvas/ui@3 @motion-canvas/vite-plugin@3

名称变更​

此版本引入了多项名称变更,旨在使代码更具可读性,并减少与现有类型发生冲突的 可能性。请务必在代码库中替换以下名称:

旧名称新名称
ImageImg
TextTxt
Rect(类型,而非节点)BBox
Node.getCacheRectNode.getCacheBBox
Node.cacheRectNode.cacheBBox
Node.fullCacheRectNode.fullCacheBBox
CodeBlock.selectionOpacityCodeBlock.unselectedOpacity

项目配置​

现在,大多数项目设置通过编辑器进行配置,并存储在 meta 文件中。首次运行项目后, meta 文件将自动更新以包含这些新设置。

你可以将配置从项目文件迁移过来:

src/project.ts
import {makeProject} from '@motion-canvas/core';

import example from './scenes/example?scene';

export default makeProject({
scenes: [example],
background: '#141414',
audioOffset: 2,
});

转移到 meta 文件:

src/project.meta
{
"version": 1,
"shared": {
"background": "rgb(20,20,20)",
"range": [0, null],
"size": {
"x": 1920,
"y": 1080
},
"audioOffset": 2
},
"preview": {
"fps": 30,
"resolutionScale": 1
},
"rendering": {
"fps": 30,
"resolutionScale": 1,
"colorSpace": "srgb",
"fileType": "image/png",
"quality": 1
}
}

CodeBlock 回退​

由于技术问题,PR #401 已被回退。

  • CodeBlock 应再次使用完整路径导入:
    import {CodeBlock} from '@motion-canvas/2d/lib/components/CodeBlock';
  • 目前暂不支持 stockTheme 属性。

请持续关注,我们将努力寻找更好的解决方案。