Tugas AL (Assembly Linker)
Tugas AL membungkus AL.exe, sebuah alat yang didistribusikan dengan Kit Pengembangan Perangkat Lunak Windows (SDK). Alat Assembly Linker ini digunakan untuk membuat rakitan dengan manifes dari satu atau beberapa file yang merupakan modul atau file sumber daya. Pengompilasi dan lingkungan pengembangan mungkin sudah menyediakan kemampuan ini, sehingga sering kali tidak perlu menggunakan tugas ini secara langsung. Assembly Linker sangat berguna bagi pengembang yang perlu membuat satu rakitan dari beberapa file komponen, seperti yang dihasilkan dari pengembangan bahasa campuran. Tugas ini tidak menggabungkan modul ke dalam satu file rakitan; modul individual masih harus didistribusikan dan tersedia agar perakitan yang dihasilkan dimuat dengan benar. Untuk informasi selengkapnya tentang AL.exe, lihat Al.exe (Assembly Linker).
Parameter
Tabel berikut ini menjelaskan parameter tugas AL.
| Parameter | Deskripsi |
|---|---|
AlgorithmID |
Parameter String opsional.Menentukan algoritma untuk melakukan hash pada semua file dalam assembly multifile kecuali file yang berisi manifes assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /algid di Al.exe (Assembly Linker). |
BaseAddress |
Parameter String opsional.Menentukan alamat di mana DLL akan dimuat pada komputer pengguna selama waktu pelaksanaan. Aplikasi dimuat lebih cepat jika Anda menentukan alamat dasar DLL, daripada membiarkan sistem operasi merelokasi DLL di ruang proses. Parameter ini sesuai dengan /baseaddress. |
CompanyName |
Parameter String opsional.Menentukan string untuk bidang Company dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /comp[any] di Al.exe (Assembly Linker). |
Configuration |
Parameter String opsional.Menentukan string untuk bidang Configuration dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /config[uration] di Al.exe (Assembly Linker). |
Copyright |
Parameter String opsional.Menentukan string untuk bidang Copyright dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /copy[right] di Al.exe (Assembly Linker). |
Culture |
Parameter String opsional.Menentukan string kultur yang akan dikaitkan dengan assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /c[ulture] di Al.exe (Assembly Linker). |
DelaySign |
Parameter Boolean opsional.true untuk menempatkan kunci umum saja di perakitan; false untuk menandatangani perakitan sepenuhnya. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /delay[sign] di Al.exe (Assembly Linker). |
Description |
Parameter String opsional.Menentukan string untuk bidang Description dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /descr[iption] di Al.exe (Assembly Linker). |
EmbedResources |
Parameter ITaskItem[] opsional.Menyematkan sumber daya yang ditentukan dalam gambar yang berisi manifes rakitan. Tugas ini menyalin isi file sumber daya ke dalam gambar. Item yang diteruskan ke parameter ini mungkin memiliki metadata opsional yang melekat, yang disebut LogicalName dan Access. Metadata LogicalName digunakan untuk menentukan pengidentifikasi internal pada sumber daya. Metadata Access dapat diatur ke private untuk membuat sumber daya yang tidak terlihat oleh rakitan lain. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /embed[resource] di Al.exe (Assembly Linker). |
EvidenceFile |
Parameter String opsional.Menyematkan file yang ditentukan dalam rakitan dengan nama sumber daya Security.Evidence.Anda tidak dapat menggunakan Security.Evidence untuk sumber daya reguler. Parameter ini sesuai dengan opsi /e[vidence] di Al.exe (Assembly Linker). |
ExitCode |
Parameter baca-saja output Int32 opsional.Menentukan kode keluar yang disediakan oleh perintah yang dijalankan. |
FileVersion |
Parameter String opsional.Menentukan string untuk bidang File Version dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /fileversion di Al.exe (Assembly Linker). |
Flags |
Parameter String opsional.Menentukan nilai untuk bidang Flags dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /flags di Al.exe (Assembly Linker). |
GenerateFullPaths |
Parameter Boolean opsional.Menyebabkan tugas tersebut menggunakan jalur absolut untuk file apa pun yang dilaporkan dalam pesan kesalahan. Parameter ini sesuai dengan opsi /fullpaths di Al.exe (Assembly Linker). |
KeyContainer |
Parameter String opsional.Menentukan kontainer yang menampung pasangan kunci. Parameter ini akan menandatangani assembly (memberi nama yang kuat) dengan memasukkan kunci umum ke dalam manifes assembly. Tugas kemudian akan menandatangani rakitan akhir dengan kunci privat. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /keyn[ame] di Al.exe (Assembly Linker). |
KeyFile |
Parameter String opsional.Menentukan file yang berisi pasangan kunci atau kunci umum saja untuk menandatangani rakitan. Pengompilasi menyisipkan kunci umum dalam manifes assembly lalu menandatangani assembly akhir dengan kunci privat. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /keyf[ile] di Al.exe (Assembly Linker). |
LinkResources |
Parameter ITaskItem[] opsional.Menautkan file sumber daya yang ditentukan ke rakitan. Sumber daya itu menjadi bagian dari rakitan, tetapi file tersebut tidak disalin. Item yang diteruskan ke parameter ini mungkin memiliki metadata opsional yang melekat, yang disebut LogicalName, Target, dan Access. Metadata LogicalName digunakan untuk menentukan pengidentifikasi internal pada sumber daya. Metadata Target dapat menentukan jalur dan nama file tempat tugas tersebut menyalin file, kemudian mengompilasi file baru ini ke dalam rakitan. Metadata Access dapat diatur ke private untuk membuat sumber daya yang tidak terlihat oleh rakitan lain. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /link[resource] di Al.exe (Assembly Linker). |
MainEntryPoint |
Parameter String opsional.Menentukan nama yang sepenuhnya memenuhi syarat (class.method) dari metode yang akan digunakan sebagai titik masuk saat mengonversi modul menjadi file yang dapat dieksekusi. Parameter ini sesuai dengan opsi /main di Al.exe (Assembly Linker). |
OutputAssembly |
Parameter output ITaskItem yang diperlukan. Menentukan nama file yang dihasilkan oleh tugas ini. Parameter ini sesuai dengan opsi /out di Al.exe (Assembly Linker). |
Platform |
Parameter String opsional.Membatasi platform mana yang dapat dijalankan kode ini; harus salah satu dari x86, Itanium, x64, atau anycpu. Default adalah anycpu. Parameter ini sesuai dengan opsi /platform di Al.exe (Assembly Linker). |
ProductName |
Parameter String opsional.Menentukan string untuk bidang Product dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /prod[uct] di Al.exe (Assembly Linker). |
ProductVersion |
Parameter String opsional.Menentukan string untuk bidang ProductVersion dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /productv[ersion] di Al.exe (Assembly Linker). |
ResponseFiles |
Parameter String[] opsional.Menentukan file respons yang berisi opsi tambahan untuk diteruskan ke Assembly Linker. |
SdkToolsPath |
Parameter String opsional.Menentukan jalur ke alat SDK, seperti resgen.exe. |
SourceModules |
Parameter ITaskItem[] opsional.Satu atau beberapa modul yang akan dikompilasi ke dalam rakitan. Modul akan tercantum dalam manifes rakitan yang dihasilkan, dan masih perlu tersedia dan didistribusikan agar perakitan dapat dimuat. Item yang diteruskan ke parameter ini mungkin memiliki metadata tambahan yang disebut Target, yang menentukan jalur dan nama file tempat tugas menyalin file, kemudian mengompilasi file baru ini ke dalam rakitan. Untuk informasi selengkapnya, lihat dokumentasi untuk Al.exe (Assembly Linker). Parameter ini sesuai dengan daftar modul yang diteruskan ke Al.exe tanpa sakelar tertentu. |
TargetType |
Parameter String opsional.Menentukan format file output: library (pustaka kode), exe (aplikasi konsol), atau win (aplikasi berbasis Windows). Default adalah library. Parameter ini sesuai dengan opsi /t[arget] di Al.exe (Assembly Linker). |
TemplateFile |
Parameter String opsional.Menentukan rakitan untuk mendapatkan warisan semua metadata rakitan, kecuali bidang kultur. Rakitan yang ditentukan harus memiliki nama yang kuat. Perakitan yang Anda buat dengan parameter TemplateFile akan menjadi rakitan satelit. Parameter ini sesuai dengan opsi /template di Al.exe (Assembly Linker). |
Timeout |
Parameter Int32 opsional.Menentukan jumlah waktu, dalam milidetik, yang setelahnya tugas yang dapat dieksekusi dihentikan. Nilai defaultnya adalah Int.MaxValue, menunjukkan bahwa tidak ada periode waktu habis. |
Title |
Parameter String opsional.Menentukan string untuk bidang Title dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /title di Al.exe (Assembly Linker). |
ToolPath |
Parameter String opsional.Menentukan lokasi dari mana tugas tersebut akan memuat file yang dapat dieksekusi (Al.exe). Jika parameter ini tidak ditentukan, tugas akan menggunakan jalur penginstalan SDK yang sesuai dengan versi kerangka kerja yang menjalankan MSBuild. |
Trademark |
Parameter String opsional.Menentukan string untuk bidang Trademark dalam assembly. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /trade[mark] di Al.exe (Assembly Linker). |
Version |
Parameter String opsional.Menentukan informasi versi untuk rakitan ini. Format stringnya adalah major.minor.build.revision. Nilai default adalah 0. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /v[ersion] di Al.exe (Assembly Linker). |
Win32Icon |
Parameter String opsional.Menyisipkan file .ico dalam rakitan. File .ico memberikan tampilan yang diinginkan kepada file output dalam File Explorer. Parameter ini sesuai dengan opsi /win32icon di Al.exe (Assembly Linker). |
Win32Resource |
Parameter String opsional.Menyisipkan sumber daya Win32 (file .res) dalam file output. Untuk informasi selengkapnya, lihat dokumentasi untuk opsi /win32res di Al.exe (Assembly Linker). |
Parameter ToolTaskExtension
Tugas ini mewarisi dari kelas ToolTaskExtension, yang mewarisi dari kelas ToolTask, yang mewarisi dari Task kelas itu sendiri. Rantai pewarisan ini menambahkan beberapa parameter ke tugas yang berasal dari tugas itu sendiri.
Tabel berikut ini menjelaskan parameter kelas dasar:
| Parameter | Deskripsi |
|---|---|
| EchoOff | Parameter bool opsional.Ketika diatur ke true, tugas ini meneruskan /Q ke baris perintahcmd.exe, sehingga baris perintah tidak disalin ke stdout. |
| EnvironmentVariables | Parameter array String opsional.Array definisi variabel lingkungan, dipisahkan oleh titik koma. Setiap definisi harus menentukan nama dan nilai variabel lingkungan yang dipisahkan oleh tanda sama dengan. Variabel-variabel ini diteruskan ke yang dapat dijalankan yang dihasilkan selain, atau secara selektif mengambil alih, blok lingkungan reguler. Misalnya, Variable1=Value1;Variable2=Value2. |
| ExitCode | Parameter baca-saja output Int32 opsional.Tentukan kode keluar yang disediakan oleh perintah yang dijalankan. Jika tugas mencatat kesalahan apa pun, tetapi prosesnya memiliki kode keluar 0 (berhasil), ini diatur ke -1. |
| LogStandardErrorAsError | Parameter bool opsional.Jika true, semua pesan yang diterima pada aliran kesalahan standar dicatat sebagai kesalahan. |
| StandardErrorImportance | Parameter String opsional.Pentingnya untuk mencatat teks dari aliran kesalahan standar. |
| StandardOutputImportance | Parameter String opsional.Pentingnya untuk mencatat teks dari aliran keluar standar. |
| Timeout | Parameter Int32 opsional.Menentukan jumlah waktu, dalam milidetik, yang setelahnya tugas yang dapat dieksekusi dihentikan. Nilai defaultnya adalah Int.MaxValue, menunjukkan bahwa tidak ada periode waktu habis. Waktu habis dalam milidetik. |
| ToolExe | Parameter string opsional.Proyek dapat menerapkan ini untuk mengambil alih ToolName. Tugas dapat mengambil alih ini untuk mempertahankan ToolName. |
| ToolPath | Parameter string opsional.Tentukan lokasi dari mana tugas memuat file eksekusi yang mendasarinya. Jika parameter ini tidak ditentukan, tugas menggunakan jalur penginstalan SDK yang sesuai dengan versi kerangka kerja yang menjalankan MSBuild. |
| UseCommandProcessor | Parameter bool opsional.Saat diatur ke true, tugas ini membuat file batch untuk baris perintah dan menjalankannya dengan menggunakan prosesor perintah alih-alih menjalankan perintah secara langsung. |
| YieldDuringToolExecution | Parameter bool opsional.Saat diatur ke true, tugas ini menghasilkan node saat tugasnya dijalankan. |
Contoh
Contoh berikut membuat rakitan dengan opsi yang ditentukan.
<AL
EmbedResources="@(EmbeddedResource)"
Culture="%(EmbeddedResource.Culture)"
TemplateFile="@(IntermediateAssembly)"
KeyContainer="$(KeyContainerName)"
KeyFile="$(KeyOriginatorFile)"
DelaySign="$(DelaySign)"
OutputAssembly=
"%(EmbeddedResource.Culture)\$(TargetName).resources.dll">
<Output TaskParameter="OutputAssembly"
ItemName="SatelliteAssemblies"/>
</AL>