0Pricing
Angular Academy · 课时

构建本地化构建版本

为每种区域设置生成应用构建版本

构建本地化构建版本 是 CoddyKit 上的免费 Angular Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Angular Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。

每个区域设置构建一次

Angular 的 i18n 在编译时处理：它会为每个区域设置生成一个单独且经过完整优化的构建包，并将翻译直接嵌入其中。用户只需下载自己的语言版本，不会产生运行时翻译开销。

配置本地化构建

在 angular.json 中声明区域设置后，在构建选项中设置 localize: true，即可一次生成所有区域设置的版本。

"build": {
  "options": {
    "localize": true,
    "outputPath": "dist/app"
  }
}

构建所有区域设置

运行生产构建；CLI 会为每个区域设置生成一个文件夹，每个文件夹都包含完整的应用。

ng build --localize
# dist/app/en/  dist/app/fr/  dist/app/es/

构建单个区域设置

为了更快地迭代，您可以传入某个区域设置的代码，只构建该区域设置的版本。

ng build --localize=fr

为每个区域设置设置基本路径

每个区域设置的构建版本都可以使用独立的 baseHref，从而通过类似 /fr/ 的子路径提供服务。请在 angular.json 中为每个区域设置进行配置。

"locales": {
  "fr": {
    "translation": "src/locale/messages.fr.xlf",
    "baseHref": "/fr/"
  }
}

在开发环境中提供特定区域设置

ng serve 一次只提供一个区域设置的版本。请传入要使用的配置或区域设置，以便在开发过程中预览翻译。

ng serve --configuration=fr

将用户路由到其区域设置

由于每个区域设置都是单独的可部署文件夹，通常会使用服务器或 CDN，根据用户的 Accept-Language 标头或语言切换器，将用户重定向到正确的子路径。

使用运行时 $localize 支持自定义设置

高级设置可以在启动前使用 @angular/localize 中的 loadTranslations() 在运行时加载翻译。这样会从每个区域设置各自构建，转变为单个构建包加上获取的翻译映射。

import { loadTranslations } from '@angular/localize';
loadTranslations(frTranslations);
// then bootstrapApplication(App)

Polyfill 要求

使用 $localize 需要 @angular/localize polyfill。请使用 CLI 添加一次；它会注册带标签模板翻译所需的全局对象。

ng add @angular/localize

保持较小的包体积

由于翻译在构建时完成，法语包中只包含法语文本，不包含其他语言，也不会将翻译引擎发送到浏览器。这就是编译时国际化能够让应用保持精简的原因。

部署输出内容

请部署整个 dist/app 目录；每个区域设置子目录都是一个独立应用。请配置主机，使 /fr/ 提供法语构建版本，并让默认区域设置从根路径或其专用路径提供内容。

快速检查

Angular 如何发布翻译？

回顾

将 localize: true，然后运行 ng build --localize，即可为每个区域设置生成一个文件夹，每个文件夹都是完整的应用。为每个区域设置使用对应的 baseHref（例如 /fr/），在开发时使用 --configuration 提供单个区域设置，添加 @angular/localize polyfill，并可选择在运行时加载翻译以满足自定义配置需求。

常见问题解答

「构建本地化构建版本」课时是免费的吗？

是的 — 「构建本地化构建版本」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Angular Academy 课程的其余内容，请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。

「构建本地化构建版本」这节课中我会学到什么？

为每种区域设置生成应用构建版本 你通过在浏览器中直接运行的动手代码来练习 Angular Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Angular Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「构建本地化构建版本」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Angular Academy 课中编写并运行代码吗？

能。每节 Angular Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 标记待翻译文本
  2. 提取并翻译消息
  3. 复数与选择（ICU）
  4. 构建本地化构建版本
← 返回 Angular Academy