dmcs - Dalam talian dalam Awan

JADUAL:

NAMA

mcs - Pengkompil Mono C#

SINOPSIS

mcs [pilihan] [fail sumber]

DESCRIPTION

mcs ialah pengkompil Mono C#, pelaksanaan spesifikasi bahasa ECMA-334.
Anda boleh lulus satu atau lebih pilihan untuk memacu pengkompil, dan satu set fail sumber. Tambahan
pilihan atau hujah boleh disediakan dalam fail respons. Fail respons dirujuk oleh
menambahkan simbol @ pada nama fail respons.

. mcs pengkompil digunakan untuk menyusun terhadap versi Perpustakaan Kelas Asas Mono terkini dan
melaksanakan sepenuhnya spesifikasi C# 1.0, 2.0, 3.0 dan 4.0.

Lihat bahagian pakej untuk maklumat lanjut.

Pengkompil Mono C# menerima pilihan baris arahan yang sama dengan pengkompil Microsoft C#
tidak. Pilihan tersebut boleh bermula dengan slash atau sengkang (/checked adalah sama dengan -checked).
Selain itu beberapa pilihan seperti GNU disokong, yang bermula dengan "--". Semua khusus MCS
bendera yang tidak tersedia dalam pengkompil Microsoft C# hanya tersedia dengan
Pilihan gaya GNU.

Fail sumber C# mesti berakhir dengan sambungan ".cs". Penyusunan kod sumber C# memerlukan
semua fail yang membentuk perpustakaan, modul atau boleh laku untuk disediakan pada arahan
barisan. Tiada sokongan untuk kompilasi separa. Untuk mencapai faedah separa
penyusunan, anda harus menyusun atur cara ke dalam perhimpunan mereka sendiri, dan rujukan kemudian
mereka dengan bendera "-r".

Pengkompil Mono C# menjana imej (fail .exe) yang mengandungi kod bait CIL yang boleh
dilaksanakan oleh mana-mana sistem yang melaksanakan mesin maya Infrastruktur Bahasa Biasa
seperti enjin masa jalan Microsoft .NET pada Windows atau enjin masa jalan Mono pada Unix
sistem. Boleh laku tidak terikat pada CPU atau sistem pengendalian tertentu.

Pengkompil Mono C# secara lalai hanya merujuk kepada tiga himpunan: mscorlib.dll, System.dll
dan System.Xml.dll. Jika anda ingin merujuk perpustakaan tambahan, anda mesti menentukan secara manual
mereka menggunakan pilihan baris arahan -pkg: atau pilihan baris arahan -r:. Sebagai alternatif jika
anda ingin mendapatkan semua perpustakaan Sistem, anda boleh menggunakan baris arahan -pkg:dotnet
pilihan.

PILIHAN

--kira-kira
Memaparkan maklumat tentang pengkompil Mono C#

--addmodule:MODULE1[,MODULE2]
Termasuk modul yang ditentukan dalam pemasangan yang terhasil. Modul dicipta oleh
memanggil pengkompil dengan pilihan -target:modul

-diperiksa, -disemak+
Menetapkan mod kompilasi lalai kepada `disemak'. Ini menjadikan semua operasi matematik
diperiksa (lalai tidak ditanda).

-disemak-
Tetapkan mod kompilasi lalai kepada `tidak ditanda'. Ini menjadikan semua matematik
operasi tidak ditandai (ini adalah lalai).

-clscheck-, -clscheck+
Lumpuhkan atau dayakan semakan Common Language Specification (CLS) (ia didayakan
secara lalai).

Spesifikasi Bahasa Biasa (CLS) mentakrifkan subset jenis yang boleh dikendalikan sebagai
serta konvensyen yang mesti diikuti oleh penyusun (pengeluar CLS) dan pembangun
dedahkan kod kepada bahasa pengaturcaraan lain (pengguna CLS).

-halaman kod:ID
Menentukan halaman kod yang digunakan untuk memproses fail input dari tempat ia berada
dinyatakan pada. Secara lalai, fail akan diproses dalam persekitaran yang bergantung
halaman kod asli. Pengkompil juga secara automatik akan mengesan fail Unicode yang
mempunyai tanda bait terbenam pada permulaannya.

Pengekodan popular lain ialah 28591 (Latin1), 1252 (iso-8859-1) dan 65001 (UTF-8).

MCS menyokong beberapa singkatan: "utf8" boleh digunakan untuk menentukan utf-8 dan bukannya
menggunakan cryptic 65001 dan "set semula" memulihkan pengendalian automatik halaman kod.
Pendek kata ini tidak tersedia pada pengkompil Microsoft.

-define:SYMLIST, -d:SYMLIST
Mentakrifkan simbol yang disenaraikan oleh senarai dipisahkan koma bertitik SYMLIST SYMBOL. ini
boleh diuji dalam kod sumber oleh pra-pemproses, atau boleh digunakan dengan kaedah
yang telah ditag dengan atribut Bersyarat.

-nyahpepijat, -debug+
Hasilkan maklumat penyahpepijatan. Untuk mendapatkan surih tindanan dengan maklumat penyahpepijatan,
anda perlu menggunakan masa jalan mono dengan bendera `--debug'. Penyahpepijatan
maklumat disimpan dalam fail MDB yang terletak dalam folder output yang sama seperti yang dihasilkan
perhimpunan.

-debug-
Jangan jana maklumat penyahpepijatan.

-tanda kelewatan+
Hanya benamkan kunci awam nama kuat ke dalam perhimpunan. Penandatanganan sebenar mestilah
dilakukan pada peringkat seterusnya menggunakan alat SN. Ini berguna untuk melindungi kunci peribadi
semasa pembangunan. Ambil perhatian bahawa tandatangan kelewatan hanya boleh dilakukan menggunakan kunci nama kuat
fail (bukan bekas kunci). Pilihannya bersamaan dengan memasukkan [assembly:
AssemblyDelaySign (true)] dalam kod sumber anda. Pilihan pengkompil diutamakan
atas sifat-sifat.

-tanda kelewatan-
lalai. Nama kuat (tandatangani) perhimpunan menggunakan fail kunci nama yang kuat (atau
bekas). Pilihannya bersamaan dengan memasukkan [assembly: AssemblyDelaySign
(palsu)] dalam kod sumber anda. Pilihan pengkompil diutamakan daripada atribut.

-doc:FAIL
Mengekstrak dokumentasi C#/XML daripada kod sumber dan menyimpan dalam yang diberikan
FAIL.

-laporan ralat
Bendera ini diabaikan oleh pengkompil C# Mono dan hadir hanya untuk membenarkan MCS
digunakan sebagai pengganti CSC untuk msbuild/xbuild.

--maut
Ini digunakan untuk menyahpepijat pengkompil. Ini menjadikan pelepasan ralat menghasilkan a
pengecualian yang boleh ditangkap oleh penyahpepijat.

-filealign
Bendera ini diabaikan oleh pengkompil C# Mono dan hadir hanya untuk membenarkan MCS
digunakan sebagai pengganti CSC untuk msbuild/xbuild.

-fullpats
Sebarang ralat kod sumber atau amaran yang dikeluarkan oleh pengkompil termasuk nama fail hanya oleh
lalai. Pilihan ini menyebabkan pengkompil mengeluarkan laluan fail mutlak sebaliknya.

-keyfile:KEYFILE
Nama kuat (tandatangani) pemasangan output menggunakan pasangan kunci yang terdapat dalam yang dinyatakan
fail kunci nama yang kuat (snk). Pasangan kunci penuh diperlukan secara lalai (atau apabila menggunakan
tanda kelewatan-). Fail yang mengandungi kunci awam sahaja boleh digunakan dengan delaysign+. The
pilihan adalah bersamaan dengan memasukkan [assembly: AssemblyKeyFile ("KEYFILE")] dalam anda
kod sumber. Pilihan pengkompil diutamakan daripada atribut.

-bekas kunci:BEKAS
Nama kuat (tandatangani) pemasangan output menggunakan pasangan kunci yang terdapat dalam yang dinyatakan
bekas. Ambil perhatian bahawa tanda kelewatan+ diabaikan apabila menggunakan bekas kunci. Pilihannya ialah
bersamaan dengan memasukkan [assembly: AssemblyKeyName ("CONTAINER")] dalam sumber anda
kod. Pilihan pengkompil diutamakan daripada atribut.

-langversion:TEXT
Pilihan menentukan versi bahasa untuk digunakan. Set ciri ialah
berbeza dalam setiap versi C#. Suis ini boleh digunakan untuk memaksa pengkompil untuk
membenarkan hanya subset ciri. Nilai yang mungkin adalah:

Lalai
Arahkan pengkompil untuk menggunakan versi terkini. Setara adalah untuk meninggalkan
suis (pada masa ini lalai kepada spesifikasi bahasa C# 4.0).

ISO-1 Hadkan pengkompil untuk menggunakan ciri standard ISO yang pertama sahaja. Penggunaan
ciri seperti generik, kelas statik, kaedah tanpa nama akan membawa kepada
kesilapan.

ISO-2 Hadkan pengkompil untuk menggunakan hanya ciri standard ISO kedua. ini
membenarkan penggunaan generik, kelas statik, iterator dan kaedah tanpa nama
sebagai contoh.

3 Hadkan pengkompil untuk menggunakan hanya ciri yang tersedia dalam C# 3.0 (a
superset ISO-1 dan ISO-2).

4 Hadkan pengkompil untuk menggunakan hanya ciri yang tersedia dalam C# 4.0
spesifikasi.

eksperimen
Mendayakan ciri yang tidak stabil daripada versi bahasa yang akan datang.

Perhatikan bahawa bendera ini hanya mengehadkan ciri bahasa yang tersedia untuk
pengaturcara. Versi pemasangan yang dihasilkan boleh dikawal menggunakan SDK pilihan.

-lib:PATHLIST
Setiap laluan yang dinyatakan dalam senarai yang dipisahkan koma akan mengarahkan pengkompil untuk melihat
untuk perpustakaan dalam laluan yang ditentukan itu.

-L PATH
Mengarahkan pengkompil untuk mencari perpustakaan dalam laluan yang ditentukan. Berbilang laluan
boleh disediakan dengan menggunakan pilihan beberapa kali.

-utama:KELAS
Memberitahu pengkompil yang CLASS mengandungi titik masuk. Berguna apabila anda
menyusun beberapa kelas dengan kaedah Utama.

-nostdlib, -nostdlib+
Gunakan bendera ini jika anda ingin menyusun pustaka teras. Ini menjadikan pengkompil
memuatkan jenis dalamannya daripada pemasangan yang sedang disusun.

-noconfig, -noconfig+
Melumpuhkan konfigurasi pengkompil lalai untuk dimuatkan. Pengkompil secara lalai
mempunyai rujukan kepada pemasangan sistem.

-nowarn:WARNLIST
Membuat pengkompil mengabaikan amaran yang dinyatakan dalam senarai dipisahkan koma WARNLIST>

-optimumkan, -optimumkan+, -optimumkan-
Mengawal pengoptimuman penjanaan kod pengkompil pada kod. Menggunakan -optimumkan atau
-optimum+ akan menghidupkan pengoptimuman, -optimum- akan mematikannya. lalai dalam
mcs adalah untuk mengoptimumkan-. Pilihan boleh dicampur dengan -debug tetapi untuk penyahpepijatan terbaik
pengalaman adalah disyorkan untuk meninggalkan pilihan.

-keluar:FNAME, -o NAMA
Namakan fail output yang akan dijana.

--menghuraikan
Digunakan untuk penanda aras. Pengkompil hanya akan menghuraikan fail inputnya.

-pkg:pakej1[,pakejN]
Perhimpunan rujukan untuk pakej yang diberikan.

Pengkompil akan menggunakan pkg-config --libs pada set pakej yang dinyatakan pada
baris arahan untuk mendapatkan perpustakaan dan direktori untuk menyusun kod.

Ini biasanya digunakan dengan komponen pihak ketiga, seperti ini:

$ mcs -pkg:gtk-sharp demo.cs

-pkg:dotnet
Ini akan mengarahkan pengkompil untuk merujuk perpustakaan Sistem.*
tersedia pada pemasangan rangka kerja dotnet biasa, perhatikan bahawa ini berlaku
tidak termasuk semua perpustakaan Mono, hanya Sistem.* yang. Ini adalah
pintasan mudah untuk kod port tersebut.

-platform:ARCH
Digunakan untuk menentukan platform sasaran. Nilai yang mungkin adalah: anycpu,
anycpu32bitpreferred, lengan, x86, x64 atau itanium. Pilihan lalai ialah anycpu.

-sumber:RESOURCE[,ID]
Benam pada fail sumber yang diberikan. ID pilihan boleh digunakan untuk memberikan yang berbeza
nama kepada sumber. Jika tidak dinyatakan, nama sumber akan menjadi nama fail.

-linkresource:RESOURCE[,ID]
Pautan kepada SUMBER yang ditentukan. ID pilihan boleh digunakan untuk memberi nama kepada
sumber terpaut.

-r:PERHIMPUNAN1[,PERHIMPUNAN2], -rujukan PERHIMPUNAN1[,PERHIMPUNAN2]
Rujuk perhimpunan yang dinamakan. Gunakan ini untuk menggunakan kelas daripada perhimpunan yang dinamakan dalam
program anda. Perhimpunan akan dimuatkan dari sama ada direktori sistem di mana
semua perhimpunan hidup, atau dari laluan yang diberikan secara eksplisit dengan pilihan -L.

Anda juga boleh menggunakan koma bertitik untuk memisahkan himpunan dan bukannya koma.

-rujukan:ALIAS=PERHIMPUNAN
Sokongan rujukan alias luaran untuk C#.

Jika anda mempunyai perhimpunan berbeza yang menyediakan jenis yang sama, alias luaran
sokongan membolehkan anda memberikan nama yang boleh digunakan oleh perisian anda untuk memberitahu mereka
apartmen. Jenis dari ASSEMBLY akan didedahkan sebagai ALIAS, kemudian pada sumber C#
kod, anda perlu lakukan:

alias luar ALIAS;
Untuk membawanya ke ruang nama anda. Sebagai contoh, untuk mengatasi dua perpustakaan grafik
yang mentakrifkan "Graphics.Point", satu dalam "OpenGL.dll" dan satu dalam "Postscript.dll", anda
akan memanggil pengkompil seperti ini:

mcs -r:Postscript=Postscript.dll -r:OpenGL=OpenGL.dll

Dan dalam kod sumber anda, anda akan menulis:

alias luaran Postscript;
alias luaran OpenGL;

kelas X {
// Ini ialah Graphics.Point daripada Postscrip.dll
Postscript.Point p = Postscript.Point baharu ();

// Ini ialah Graphics.Point daripada OpenGL.dll
OpenGL.Point p = OpenGL.Point baharu ();
}

-berulang:POLA, --berulang CORAK
Adakah kompilasi rekursif menggunakan corak yang ditentukan. Dalam Unix shell akan
lakukan globbing, jadi anda mungkin mahu menggunakannya seperti ini:

$ mcs -recurse:'*.cs'

-sdk:VERSION
Digunakan untuk menentukan versi himpunan Perpustakaan Kelas Asas yang digunakan untuk penyusunan.
Mengikut nilai pratakrif adalah sah: 2, 4 (lalai) serta sebarang nilai tersuai.
Nombor versi yang dipratentukan bermaksud nilai tersuai yang akan dicuba oleh mcs yang ditentukan
cari Perpustakaan Kelas Asas di lokasi yang dipasang mono PREFIX/lib/mono/ .

- cengkaman
Memulakan pengkompil dalam mod interaktif, menyediakan shell C# untuk pernyataan dan
ungkapan. Jalan pintas adalah dengan menggunakan csharp perintah secara langsung.

--jejak timbunan
Menjana surih tindanan pada masa ralat dilaporkan, berguna untuk penyahpepijatan
penyusun

-sasaran:JENIS, -t:JENIS
Digunakan untuk menentukan sasaran yang dikehendaki. Nilai yang mungkin adalah: exe (plain
boleh laku), winexe (Windows.Forms boleh laku), perpustakaan (perpustakaan komponen) dan
modul (separa perpustakaan).

--cap masa
Satu lagi bendera penyahpepijatan. Digunakan untuk memaparkan masa pada pelbagai titik dalam
proses penyusunan.

-tidak selamat, -tidak selamat+
Membolehkan penyusunan kod tidak selamat.

-v Penyahpepijatan. Menghidupkan verbose yacc parsing.

--versi
Menunjukkan versi pengkompil.

-warnaserror, -warnaserror+
Semua amaran penyusun akan dilaporkan sebagai ralat.

-serror warna:W1,[Wn], -warnaserror+:W1,[Wn]
Menganggap satu atau lebih amaran pengkompil sebagai ralat.

-warnaserror-:W1,[Wn]
Menetapkan satu atau lebih amaran pengkompil untuk sentiasa diancam sebagai amaran. menjadi
berguna apabila digunakan bersama -warnaserror.

-amaran:PERINGKAT
Menetapkan tahap amaran. 0 ialah tahap amaran terendah, dan 4 ialah tahap tertinggi. The
lalai adalah 4.

-win32res:FILE
Menentukan fail sumber Win32 (.res) untuk digabungkan ke dalam pemasangan yang terhasil.

-win32icon:FILE
Melampirkan ikon yang dinyatakan dalam FILE pada output ke dalam pemasangan yang dihasilkan.

-- Gunakan ini untuk menghentikan penghuraian pilihan dan membenarkan parameter yang kelihatan pilihan diluluskan
pada baris arahan.

PAKET DAN PERPUSTAKAAN

Apabila merujuk perhimpunan, jika nama perhimpunan ialah laluan, pengkompil akan mencuba
untuk memuatkan perhimpunan yang dinyatakan dalam laluan. Jika tidak, maka pengkompil akan mencuba
memuatkan pemasangan dari direktori semasa, direktori asas pengkompil dan jika
perhimpunan tidak ditemui di mana-mana tempat tersebut dalam direktori yang dinyatakan sebagai hujah kepada
the -lib: hujah arahan.

Pengkompil menggunakan laluan perpustakaan untuk mencari perpustakaan, dan dapat merujuk perpustakaan
daripada pakej tertentu jika direktori itu digunakan. Untuk memudahkan penggunaan pakej, the
Pengkompil C# termasuk -pkg: pilihan baris arahan yang digunakan untuk memuatkan khusus
koleksi perpustakaan.

Perpustakaan yang kelihatan kepada pengkompil disimpan secara relatif kepada awalan pemasangan di bawah
PREFIX/lib/mono/ dipanggil PACKAGEBASE dan lalai untuk mcs, gmcs dan smcs adalah seperti
ikut:

mcs Merujuk direktori PACKAGEBASE/1.0

gmcs Merujuk direktori PACKAGEBASE/2.0

smcs Merujuk direktori PACKAGEBASE/2.1

Itu adalah satu-satunya profil masa jalan yang wujud. Walaupun direktori lain wujud (seperti
3.0 dan 3.5) itu bukan profil masa jalan sebenarnya, ia hanyalah pemegang tempat untuk tambahan
perpustakaan yang dibina di atas asas 2.0.

Pembekal perisian akan mengedarkan perisian yang dipasang secara relatif kepada PACKAGEBASE
direktori. Ini disepadukan ke dalam gacutil alat yang bukan sahaja memasang awam
pemasangan ke dalam Global Assembly Cache (GAC) tetapi juga memasangnya ke dalam
Direktori PACKAGEBASE/PKG (di mana PKG ialah nama yang dihantar ke bendera -package ke gacutil).

Sebagai pembangun, jika anda ingin menggunakan perpustakaan Gtk#, anda akan menggunakan pengkompil
seperti ini:

$ mcs -pkg:gtk-sharp-2.0 main.cs

Pilihan -pkg: mengarahkan pengkompil untuk mengambil definisi untuk gtk-sharp-2.0 daripada
pkg-config, ini bersamaan dengan menghantar kepada pengkompil C# output:

$ pkg-config --libs gtk-sharp-2.0

Biasanya ini hanya merujuk kepada perpustakaan daripada PACKAGEBASE/PKG.

Walaupun terdapat nama direktori untuk 3.0 dan 3.5, itu tidak bermakna terdapat 3.0
dan 3.5 edisi atau profil penyusun. Itu hanyalah perpustakaan baru yang mesti ada
dirujuk secara manual sama ada dengan -pkg: invocation yang betul, atau dengan merujuk pada
perpustakaan secara langsung.

KHAS TAKRIFKAN

. TRACE and HUTANG mentakrifkan mempunyai makna khusus kepada pengkompil.

Secara lalai, panggilan ke kaedah dan sifat dalam kelas System.Diagnostics.Trace tidak
dijana melainkan simbol TRACE ditakrifkan (sama ada melalui "#define TRACE") dalam anda
kod sumber, atau dengan menggunakan --takrifkan TRACE dalam baris arahan.

Secara lalai, panggilan ke kaedah dan sifat dalam kelas System.Diagnostics.Debug tidak
dijana melainkan simbol DEBUG ditakrifkan (sama ada melalui "#define DEBUG") dalam anda
kod sumber, atau dengan menggunakan --takrifkan HUTANG dalam baris arahan.

Ambil perhatian bahawa kesan mentakrifkan TRACE dan DEBUG ialah tetapan global, walaupun ia berlaku
hanya ditakrifkan dalam satu fail.

MENGHILANGKAN PERTANYAAN

Apabila menggunakan bendera "-debug", MCS akan menjana fail dengan sambungan .mdb itu
mengandungi maklumat penyahpepijatan untuk pemasangan yang dijana. Fail ini digunakan oleh
penyahpepijat Mono (mdb).

PERSEKITARAN PELBAGAI

MCS_COLORS
Jika pembolehubah ini ditetapkan, ia mengandungi rentetan dalam bentuk "latar hadapan, latar belakang"
yang menentukan warna yang hendak digunakan untuk memaparkan ralat pada beberapa terminal.

Latar belakang adalah pilihan dan lalai kepada latar belakang semasa terminal anda. The
warna yang mungkin untuk latar depan ialah: hitam, merah, merah terang, hijau, hijau terang,
kuning, kuning terang, biru, biru terang, magenta, brightmagenta, cyan, brightcyan,
kelabu, putih dan putih terang.

Warna yang mungkin untuk latar belakang ialah: hitam, merah, hijau, kuning, biru, magenta,
cyan, kelabu dan putih.

Sebagai contoh, anda boleh menetapkan pembolehubah ini daripada shell anda:
eksport MCS_COLORS
MCS_COLORS=errors=cerahputih,merah

Anda boleh melumpuhkan skema warna terbina dalam dengan menetapkan pembolehubah ini kepada "lumpuhkan".

NOTA

Semasa penyusunan, pengkompil MCS mentakrifkan simbol __MonoCS__, ini boleh digunakan oleh
arahan pra-pemproses untuk menyusun kod khusus pengkompil Mono C#. Sila ambil perhatian bahawa
simbol ini hanya untuk menguji pengkompil, dan tidak berguna untuk membezakan kompilasi
atau platform penggunaan.

PENGARANG

Pengkompil Mono C# telah ditulis oleh Miguel de Icaza, Ravi Pratap, Martin Baulig, Marek
Safar dan Raja Harinath. Pembangunan itu dibiayai oleh Ximian, Novell dan Marek Safar.

Gunakan dmcs dalam talian menggunakan perkhidmatan onworks.net