ضبط خيارات المترجم في مشاريع MSBuild في TypeScript

مقدمة

يُمكن تحديد خيارات المترجم عبر استخدام خاصيات MSBuild في مشروع MSBuild.

مثال

  <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
    <TypeScriptRemoveComments>false</TypeScriptRemoveComments>
    <TypeScriptSourceMap>true</TypeScriptSourceMap>
  </PropertyGroup>
  <PropertyGroup Condition="'$(Configuration)' == 'Release'">
    <TypeScriptRemoveComments>true</TypeScriptRemoveComments>
    <TypeScriptSourceMap>false</TypeScriptSourceMap>
  </PropertyGroup>
  <Import
      Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets"
      Condition="Exists('$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets')" />

الاقترانات (Mappings)

الخيار	اسم خاصية MSBuild	القيم المسموح بها
‎`--allowJs`‎	‎غير مدعوم في MSBuild.	‎
‎`--allowSyntheticDefaultImports`‎	TypeScriptAllowSyntheticDefaultImports	‎قيمة منطقية
‎`--allowUnreachableCode`‎	TypeScriptAllowUnreachableCode	‎قيمة منطقية
‎`--allowUnusedLabels`‎	TypeScriptAllowUnusedLabels	‎قيمة منطقية
‎`--alwaysStrict`‎	TypeScriptAlwaysStrict	‎قيمة منطقية
‎`--baseUrl`‎	TypeScriptBaseUrl	‎مسار ملفّ
‎`--charset`‎	TypeScriptCharset	‎
‎`--declaration`‎	TypeScriptGeneratesDeclarations	‎قيمة منطقية
‎`--declarationDir`‎	TypeScriptDeclarationDir	‎مسار ملفّ
‎`--diagnostics`‎	غير مدعوم	‎
‎`--disableSizeLimit`‎	غير مدعوم
‎`--emitBOM`‎	TypeScriptEmitBOM	قيمة منطقيّة
‎`--emitDecoratorMetadata`‎	TypeScriptEmitDecoratorMetadata	قيمة منطقيّة
‎`--emitDeclarationOnly`‎	TypeScriptEmitDeclarationOnly	قيمة منطقيّة
‎`--emitBOM`‎	TypeScriptEmitBOM	قيمة منطقيّة
‎`--esModuleInterop`‎	TypeScriptESModuleInterop	قيمة منطقيّة
‎`--experimentalAsyncFunctions`‎	TypeScriptExperimentalAsyncFunctions	قيمة منطقيّة
‎`--experimentalDecorators`‎	TypeScriptExperimentalDecorators	قيمة منطقيّة
‎`--forceConsistentCasingInFileNames`‎	TypeScriptForceConsistentCasingInFileNames	قيمة منطقيّة
‎`--help`‎	غير مدعوم
‎`--importHelpers`‎	TypeScriptImportHelpers	قيمة منطقيّة
‎`--inlineSourceMap`‎	TypeScriptInlineSourceMap	قيمة منطقيّة
‎`--inlineSources`‎	TypeScriptInlineSources	قيمة منطقيّة
‎`--init`‎	غير مدعوم
‎`--isolatedModules`‎	TypeScriptIsolatedModules	قيمة منطقيّة
‎`--jsx`‎	TypeScriptJSXEmit	‎`React`‎ أو ‎`Preserve`‎
‎`--jsxFactory`‎	TypeScriptJSXFactory	اسمٌ خاصّ.
‎`--lib`‎	TypeScriptLib	قائمة سلاسلَ نصيةٍ مُفصولةٍ بفاصلة (Comma).
‎`--listEmittedFiles`‎	غير مدعوم
‎`--listFiles`‎	غير مدعوم
‎`--locale`‎	تلقائي	تُضبَط قيمته افتراضيًّا إلى قيمة PreferredUILang.
‎`--mapRoot`‎	TypeScriptMapRoot	‎مسار ملفّ
‎`--maxNodeModuleJsDepth`‎	TypeScriptMapRoot	‎غير مدعوم
‎`--module`‎	TypeScriptModuleKind	‎‎`AMD`‎، أو ‎`CommonJs`‎، أو ‎`UMD`‎، أو ‎`System`‎، أو ‎`ES6`‎.
‎`--moduleResolution`‎	TypeScriptModuleResolution	‎‎`Classic`‎ أو ‎`Node`‎
‎`--newLine`‎	TypeScriptNewLine	‎‎`CRLF`‎ أو ‎`LF`‎
‎`--noEmit`‎	غير مدعوم
‎`--noEmitHelpers`	TypeScriptNoEmitHelpers	قيمة منطقيّة
‎`--noEmitOnError`	TypeScriptNoEmitOnError	قيمة منطقيّة
‎`--noFallthroughCasesInSwitch`	TypeScriptNoFallthroughCasesInSwitch	قيمة منطقيّة
‎`--noImplicitAny`	TypeScriptNoImplicitAny	قيمة منطقيّة
‎`--noImplicitReturns`	TypeScriptNoImplicitReturns	قيمة منطقيّة
‎`--noImplicitThis`	TypeScriptNoImplicitThis	قيمة منطقيّة
‎`--noImplicitUseStrict`	TypeScriptNoImplicitUseStrict	قيمة منطقيّة
‎`--noStrictGenericChecks`	TypeScriptNoStrictGenericChecks	قيمة منطقيّة
‎`--noUnusedLocals`	TypeScriptNoUnusedLocals	قيمة منطقيّة
‎`--noUnusedParameters`	TypeScriptNoUnusedParameters	قيمة منطقيّة
‎`--noLib`	TypeScriptNoLib	قيمة منطقيّة
‎`--noResolve`	TypeScriptNoResolve	قيمة منطقيّة
‎`--out`‎	TypeScriptOutFile	‎مسار ملفّ
‎`--outDir`‎	TypeScriptOutDir	‎مسار ملفّ
‎`--outFile`‎	TypeScriptOutFile	‎مسار ملفّ
‎`--paths`‎	غير مدعوم	‎
‎`--preserveConstEnums`	TypeScriptPreserveConstEnums	قيمة منطقيّة
‎`--preserveSymlinks`	TypeScriptPreserveSymlinks	قيمة منطقيّة
‎`--listEmittedFiles`‎	غير مدعوم	‎
‎`--pretty`‎	غير مدعوم	‎
‎`--reactNamespace`‎	TypeScriptReactNamespace	سلسلة نصيّة‎
‎`--removeComments`‎	TypeScriptRemoveComments	قيمة منطقية‎
‎`--rootDir`‎	TypeScriptRootDir	مسار ملفّات‎
‎`--rootDirs`‎	غير مدعوم	‎
‎`--skipLibCheck`‎	TypeScriptSkipLibCheck	قيمة منطقيّة‎
‎`--skipDefaultLibCheck`‎	TypeScriptSkipDefaultLibCheck	قيمة منطقيّة‎
‎`--sourceMap`‎	TypeScriptSourceMap	مسار ملفّات ‎
‎`--sourceRoot`‎	TypeScriptSourceRoot	مسار ملفّات ‎
‎`--strict`‎	TypeScriptStrict	قيمة منطقيّة‎
‎`--strictFunctionTypes`	TypeScriptStrictFunctionTypes	قيمة منطقيّة
‎`--strictNullChecks`	TypeScriptStrictNullChecks	قيمة منطقيّة
‎`--strictPropertyInitialization`	TypeScriptStrictPropertyInitialization	قيمة منطقيّة
‎`--stripInternal`	TypeScriptStripInternal	قيمة منطقيّة
‎`--suppressExcessPropertyErrors`	TypeScriptSuppressExcessPropertyErrors	قيمة منطقيّة
‎`--suppressImplicitAnyIndexErrors`	TypeScriptSuppressImplicitAnyIndexErrors	قيمة منطقيّة
‎`--target`	TypeScriptTarget	‎`ES3`‎، أو ‎`ES5`‎، أو ‎`ES6`‎.
‎`--traceResolution`‎	غير مدعوم	‎
‎`--types`‎	غير مدعوم	‎
‎`--typeRoots`‎	غير مدعوم	‎
‎`--watch`‎	غير مدعوم	‎
‎خيار موجود في MSBuild فقط.	TypeScriptAdditionalFlags	أي خيار من خيارات المترجم.‎

ما هي الخيارات المدعومة في نسخة Visual Studio الخاصة بي؟

انظر ملفّ ‎C:\Program Files (x86)\MSBuild\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets‎. الاقترانات المعتمدة بين وسوم XML في MSBuild وخيارات المترجم ‎tsc‎ موجودة في هذا الملفّ.

ToolsVersion

تُحدِّد قيمة الخاصية ‎<TypeScriptToolsVersion>1.7</TypeScriptToolsVersion>‎ في ملف المشروع نسخةَ المترجم التي ستُستَخدَم لبناء المشروع (1.7 في هذا المثال). هذا يسمح لمشروعٍ بالبناء باستخدام نفس نسخة المترجم على أجهزة ومنصات مختلفة.

إذا لم تُحدَّد النسخة عبر ‎TypeScriptToolsVersion‎، فسيُستخدَم أحدث إصدار من المترجم المثبت على الجهاز لبناء المشروع.

سيُلاحظ مستخدمو النسخ الأحدث من TypeScript محثًّا (prompt) يحثّ على ترقية المشروع في أول تحميل.

‎`TypeScriptCompileBlocked`‎

إن كنت تستعمل أداة بناء مختلفة لبناء مشروعك (مثل gulp، أوgrunt أو ما شابه)، مع Visual Studio للتطوير والتنقيح (debugging)، فاضبط الوسم ‎<TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>‎ في مشروعك. سيمنحك هذا كل الدعم الذي تحتاج إليه عند التحرير دون بناء المشروع عند الضغط على مفتاح F5.

مصادر

صفحة Compiler Options in MSBuild في توثيق TypeScript الرسمي.