عرض مصدر TypeScript/compiler options in msbuild

<noinclude>{{DISPLAYTITLE:ضبط خيارات المترجم في مشاريع MSBuild في TypeScript}}</noinclude>

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

==مثال==
<syntaxhighlight lang="typescript">


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

==ما هي الخيارات المدعومة في نسخة Visual Studio الخاصة بي؟==
انظر ملفّ ‎<code>C:\Program Files (x86)\MSBuild\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets</code>‎. الاقترانات المعتمدة بين وسوم XML في MSBuild وخيارات المترجم ‎<code>tsc</code>‎ موجودة في هذا الملفّ.
==ToolsVersion==
تُحدِّد قيمة الخاصية ‎<code><TypeScriptToolsVersion>1.7</TypeScriptToolsVersion></code>‎ في ملف المشروع نسخةَ المترجم التي ستُستَخدَم لبناء المشروع (1.7 في هذا المثال). هذا يسمح لمشروعٍ بالبناء باستخدام نفس نسخة المترجم على أجهزة ومنصات مختلفة.

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

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

== مصادر ==
* [http://www.typescriptlang.org/docs/handbook/compiler-options-in-msbuild.html صفحة Compiler Options in MSBuild في توثيق TypeScript الرسمي.]
[[تصنيف:TypeScript]]