Lit 3.0 预发布版公告

Lit 团队很高兴地宣布 Lit 3.0 的首个预发布版！

Lit 3.0 是自两年前推出统一的 Lit 项目和 Lit 2.0 以来的第一个主版本。我们非常重视社区的稳定性和向后兼容性，因此我们专注于通过核心库的次版本和新的 labs 包来添加新功能，而不做任何破坏性变更。

但现在是时候做一些破坏性变更了，这些变更将提高核心 Lit 项目的开发速度和测试稳定性。

Lit 3.0 没有添加新功能，因为根据语义化版本规范，新功能通常不是破坏性变更，可以在次版本中添加。Lit 3.0 版本是进行一些破坏性变更的机会，以清理一些技术债务，为我们计划在 3.x 发布系列中推出的新功能铺平道路。

Lit 3.0 的变更主要集中在浏览器支持、移除已弃用的 API 以及包的发布方式上。如果你在使用 Lit 2.x 时没有弃用警告，这应该是一次无缝升级！

以下是 Lit 3.0 变更的最大事项：

• 不再支持 IE11。
• Lit 的 npm 模块现在以 ES2021 格式发布。
• 在 Lit 1.x 发布期间已弃用的 API 已被移除。
• SSR hydration 支持模块已移至 @lit-labs/ssr-client 包。

Lit v2 到 v3 升级指南 的预览版已在网站上提供。

详细的变更日志可在 GitHub 上找到。

我们很乐意请你帮忙测试新版本，以确保最终版本的顺利升级过程。我们特别关注确保新语言版本与你的工具链兼容。我们预计一些用户可能需要将工具升级到最新版本。

你可以通过更新 package.json 文件来试用预发布版，将其包含以下内容：

  "lit": "^3.0.0-pre.0"
  "lit-html": "^3.0.0-pre.0"
  "lit-element": "^4.0.0-pre.0"
  "@lit/reactive-element": "^2.0.0-pre.0"

你也可以使用 pre npm tag，例如 npm i lit@pre。

所有其他包，如 labs 包，也有依赖于预发布核心库的预发布版本。如果你依赖这些包，也需要更新它们。如果你更大胆，可以使用 npm overrides 来为依赖项也选择预发布版本。这应该对大多数依赖项都有效。

即使依赖项使用 Lit 2.x，好消息是 Lit 2.x 和 Lit 3.x 是可互操作的，因为：

1. Web Components 固有的互操作性：使用不同库构建的组件可以一起工作，包括使用不同版本的 Lit 构建的组件。
2. 我们将模板和指令等核心功能的互操作性作为 Lit 2 的优先事项。你可以跨 Lit 版本共享模板、指令、装饰器等。

我们正在为 lit.tips 准备 3.0 的新文档。虽然这些文档与 2.x 基本相同，但我们正在澄清浏览器和工具链支持，并希望让你能够轻松选择适合你所使用版本的正确文档集，以便为 3.x 特定的未来变更做好准备。在 3.0 发布时，我们将归档 2.x 文档（但它们仍将在文档版本下拉菜单中可用，1.x 也是如此）。在 3.0 预发布阶段，2.x 将仍然是默认版本，你可以在文档选项卡旁边的下拉菜单中选择 v3。

我们希望你喜欢 Lit 3.0！如果你有问题或反馈，请在 GitHub issues 或我们的 Lit and Friends Discord 上告诉我们。

谢谢！

-Lit 团队