从Twilio Flex UI 1.0迁移至2.0的简便方法

不存在一键全量自动改完所有代码的方案，但可以按下面的步骤把迁移工作量压到最低，不用逐行翻代码调整：

• 第一步先解决启动UI崩溃的问题：在项目入口配置中开启v1兼容模式，添加配置项compatibilityMode: "v1"，该模式下2.0框架会原生兼容绝大多数1.0的组件语法、全局API，配置完重启项目至少能解决80%的启动即崩溃、白屏问题。
• 第二步用官方工具自动定位问题点：在项目根目录执行迁移扫描命令flex migrate check，命令会遍历所有项目代码，直接输出所有不兼容的代码位置、错误等级、修改方式，不用手动翻控制台挨个排查报错。
• 第三步按优先级处理问题，不用一次性改完所有代码：
  • 先处理标记为critical的报错，这类是导致崩溃的核心问题，90%以上都是废弃API、属性名变更类问题，比如1.0的createClass()方法替换为defineComponent()、DataGrid的dataField属性改名为field，直接按照扫描提示替换就行，单处修改基本几秒钟就能搞定。
  • 暂时没时间重构的旧业务组件，直接用官方提供的旧版兼容容器LegacyContainer包裹即可，写法参考：

    <LegacyContainer>
      {/* 这里直接放1.0版本写的旧组件，不用改内部逻辑 */}
      <OldV1BusinessComp />
    </LegacyContainer>
    

    包裹后的组件可以直接在2.0环境正常运行，等后续迭代业务的时候再逐步重构内部逻辑就行，不用赶在迁移阶段全部改完。

迁移注意：不要一开始就全量替换所有语法，2.0的后续补丁版本补了非常多1.0兼容逻辑，没被扫描工具标记的代码完全不用动，盲目全改反而容易引入新的报错。每改完3-5个问题点就刷新页面验证一次，不要攒到所有代码改完再调试，能省很多定位问题的时间。

内容的提问来源于stack exchange，提问作者Dhruvil