افزودن package مربوط به localize

برای استفاده از قابلیت‌های localization در Angular، از [Angular CLI][CliMain] استفاده کنید تا package مربوط به @angular/localize را به پروژه خود اضافه کنید.

برای افزودن package مربوط به @angular/localize، از دستور زیر استفاده کنید تا فایل‌های package.json و TypeScript configuration در پروژه شما update شوند.

shell

# #docregion add-localize
ng add @angular/localize
# #enddocregion add-localize

# #docregion extract-i18n-default
ng extract-i18n
# #enddocregion extract-i18n-default

# #docregion extract-i18n-output-path
ng extract-i18n --output-path src/locale
# #enddocregion extract-i18n-output-path

# #docregion extract-i18n-formats
ng extract-i18n --format=xlf
ng extract-i18n --format=xlf2
ng extract-i18n --format=xmb
ng extract-i18n --format=json
ng extract-i18n --format=arb
# #enddocregion extract-i18n-formats

# #docregion extract-i18n-out-file
ng extract-i18n --out-file source.xlf
# #enddocregion extract-i18n-out-file

# #docregion build-localize
ng build --localize
# #enddocregion build-localize

# #docregion serve-french
ng serve --configuration=fr
# #enddocregion serve-french

# #docregion build-production-french
ng build --configuration=production,fr
# #enddocregion build-production-french

این کار types: ["@angular/localize"] را در فایل‌های TypeScript configuration اضافه می‌کند. همچنین خط /// <reference types="@angular/localize" /> را در بالای فایل main.ts اضافه می‌کند که reference به type definition است.

اگر @angular/localize نصب نشده باشد و تلاش کنید یک نسخه localized از پروژه خود build کنید $برای مثال، هنگام استفاده از attributeهای i18n در templateها$، [Angular CLI][CliMain] خطایی تولید می‌کند که شامل مراحلی است که می‌توانید برای فعال کردن i18n در پروژه خود انجام دهید.

Optionها

OPTION	DESCRIPTION	VALUE TYPE	DEFAULT VALUE
`--project`	نام پروژه.	`string`
`--use-at-runtime`	اگر تنظیم شود، `$localize` می‌تواند در runtime استفاده شود. همچنین `@angular/localize` به جای `devDependencies`، که پیش‌فرض است، در بخش `dependencies` فایل `package.json` قرار می‌گیرد.	`boolean`	`false`

برای optionهای بیشتر، ng add را در [Angular CLI][CliMain] ببینید.

قدم بعدی

[CliMain]: cli 'CLI Overview and Command Reference | Angular' [GuideNpmPackages]: reference/configs/npm-packages 'Workspace npm dependencies | Angular' [GuideTsConfig]: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html 'TypeScript Configuration'