.TH illinkanalyzer 1
.SH "نام (NAME)"
illinkanalyzer \- تحلیل‌گر وابستگی‌ها و بهینه‌ساز اسمبلی‌های باینری IL در Mono
.SH "خلاصه دستور (SYNOPSIS)"
.B illinkanalyzer
[\fIگزینه‌ها\fR] <\fIlinker-dependency-file.xml.gz\fR>
.SH "توضیحات (DESCRIPTION)"
ابزار تحلیل‌گر لینکر (\fBlinker analyzer\fR) یک ابزار خط فرمان برای تحلیل وابستگی‌هایی است که هنگام پردازش توسط لینکر ثبت شده‌اند؛ فرآیندی که در آن لینکر آیتم‌هایی را نشانه‌گذاری می‌کند تا در اسمبلی پیوندخورده نهایی باقی بمانند.
.PP
این ابزار بر روی یک گراف جهت‌دار از وابستگی‌ها کار می‌کند که در حین اجرای لینکر جمع‌آوری و استخراج (Dump) شده‌اند. رأس‌های این گراف آیتم‌های مورد نظر مانند اسمبلی‌ها، نوع‌ها، متدها، فیلدها، مراحل لینکر و غیره هستند. یال‌ها نیز نشان‌دهنده وابستگی‌ها میان این موارد می‌باشند.
.SH "نحوه استخراج وابستگی‌ها (HOW TO DUMP DEPENDENCIES)"
تحلیل‌گر لینکر به عنوان ورودی به یک پرونده وابستگی‌های لینکر نیاز دارد. این پرونده را می‌توان با فعال‌سازی استخراج وابستگی‌ها حین پیوند زدن یک پروژه Xamarin.Android یا Xamarin.iOS به دست آورد.
.PP
این کار را می‌توان از طریق خط فرمان با تنظیم ویژگی \fBLinkerDumpDependencies\fR روی مقدار \fBtrue\fR و سپس بیلد پروژه انجام داد. (اطمینان حاصل کنید که تسک \fBLinkAssemblies\fR فراخوانی شود؛ گاهی اوقات ممکن است نیاز به پاک‌سازی و Clean کردن پروژه باشد). معمولاً بیلد پروژه به شکل زیر کافی است:
.PP
.nf
.RS
rm -f obj/Release/link.flag
msbuild /p:LinkerDumpDependencies=true /p:Configuration=Release YourAppProject.csproj
.RE
.fi
.PP
پس از یک بیلد موفق، یک پرونده به نام \fBlinker-dependencies.xml.gz\fR ایجاد می‌شود که شامل اطلاعات مورد نیاز برای تحلیل‌گر است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR, \fB\-\-alldeps\fR
نمایش تمام وابستگی‌ها.
.TP
\fB\-\-csvoutput\fR=\fIVALUE\fR
خروجی نوع‌ها و در صورت تمایل تحلیل اندازه در پرونده CSV.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این پیام راهنما و خروج.
.TP
\fB\-l\fR, \fB\-\-linkedpath\fR=\fIVALUE\fR
تنظیم مسیر دایرکتوری اسمبلی‌های پیوندخورده (لینک‌شده). امکان نمایش تخمین اندازه را فعال می‌کند.
.TP
\fB\-r\fR, \fB\-\-rawdeps\fR=\fIVALUE\fR
نمایش وابستگی‌های خام رأس (گره). مقدار خام رأس در همان قالبی است که لینکر در پرونده XML وابستگی ثبت کرده است. مقدار می‌تواند یک عبارت باقاعده (Regex) باشد.
.TP
\fB\-\-roots\fR
نمایش وابستگی‌های ریشه.
.TP
\fB\-\-stat\fR
نمایش آمار وابستگی‌های بارگذاری‌شده.
.TP
\fB\-\-tree\fR
کاهش و تبدیل گراف وابستگی به یک درخت.
.TP
\fB\-\-types\fR
نمایش وابستگی‌های تمام نوع‌ها.
.TP
\fB\-t\fR, \fB\-\-typedeps\fR=\fIVALUE\fR
نمایش وابستگی‌های نوع. مقدار می‌تواند یک عبارت باقاعده (Regex) باشد.
.TP
\fB\-f\fR, \fB\-\-flat\fR
نمایش تمام وابستگی‌ها به ازای هر رأس به همراه فاصله آن‌ها.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
نمایش با جزئیات بیشتر. گزینه‌های \fB\-\-stat\fR و \fB\-\-roots\fR را نیز فعال می‌کند.
.SH "مثال‌ها (EXAMPLES)"
فرض کنید می‌خواهید بدانید چرا یک نوع مشخص، به عنوان مثال \fBAndroid.App.Activity\fR، توسط لینکر نشانه‌گذاری شده است. تحلیل‌گر را به این صورت اجرا کنید:
.PP
.nf
.RS
illinkanalyzer -t Android.App.Activity linker-dependencies.xml.gz
.RE
.fi
.PP
خروجی:
.PP
.nf
.RS
Loading dependency tree from: linker-dependencies.xml.gz

--- Type dependencies: 'Android.App.Activity' -----------------------

--- TypeDef:Android.App.Activity dependencies -----------------------
Dependency #1
	TypeDef:Android.App.Activity
	| TypeDef:XA.App.MainActivity [2 deps]
	| Assembly:XA.App, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null [3 deps]
	| Other:Mono.Linker.Steps.ResolveFromAssemblyStep
.RE
.fi
.PP
خروجی شامل رشته(های) وابستگی است که با نوع مورد نظر آغاز شده و با آیتم‌هایی که به آن نوع وابسته‌اند ادامه می‌یابد. یک وابستگی می‌تواند به دلایل متعددی رخ دهد؛ به عنوان مثال نوع در یک متد ارجاع داده شده باشد، یا نام آن نوع در پرونده xml لینکر برای محافظت و نگهداری ثبت شده باشد.
.PP
در این مثال، تنها یک زنجیره وابستگی به نام Dependency #1 وجود دارد. این زنجیره نشان می‌دهد که نوع \fBAndroid.App.Activity\fR در حین پردازش نوع \fBXA.App.MainActivity\fR توسط لینکر نشانه‌گذاری شده است. در این مورد خاص، به این دلیل که نوع MainActivity از نوع Activity ارث‌بری کرده و در نتیجه لینکر آن را علامت‌گذاری نموده و در اسمبلی نهایی نگه داشته است. همچنین می‌توان مشاهده کرد که ۲ وابستگی برای کلاس MainActivity وجود دارد. توجه داشته باشید که در رشته وابستگی بالا فقط اولین وابستگی از این دو (وابستگی به اسمبلی XA.App) نشان داده شده است. در نهایت، رأس اسمبلی به رأس ResolveFromAssemblyStep وابسته است. بنابراین مشاهده می‌کنیم که این اسمبلی در مرحله لینکر ResolveFromAssembly پردازش شده است.
.PP
حال ممکن است بخواهیم وابستگی‌های MainActivity را مشاهده کنیم. این کار با اجرای دستور زیر در تحلیل‌گر انجام می‌شود:
.PP
.nf
.RS
illinkanalyzer -r TypeDef:XA.App.MainActivity linker-dependencies.xml.gz
.RE
.fi
.PP
خروجی:
.PP
.nf
.RS
Loading dependency tree from: linker-dependencies.xml.gz

--- Raw dependencies: 'TypeDef:XA.App.MainActivity' -----------------

--- TypeDef:XA.App.MainActivity dependencies ------------------------
Dependency #1
	TypeDef:XA.App.MainActivity
	| Assembly:XA.App, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null [3 deps]
	| Other:Mono.Linker.Steps.ResolveFromAssemblyStep
Dependency #2
	TypeDef:XA.App.MainActivity
	| TypeDef:XA.App.MainActivity/<>c__DisplayClass1_0 [2 deps]
	| TypeDef:XA.App.MainActivity [2 deps]
	| Assembly:XA.App, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null [3 deps]
	| Other:Mono.Linker.Steps.ResolveFromAssemblyStep
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR msbuild (1)