این دستور قوانین نصب را برای یک پروژه ایجاد می کند. قوانین نصب مشخص شده توسط تماس ها به دستور نصب () در یک دایرکتوری منبع به ترتیب در هنگام نصب اجرا می شوند.
تغییر در نسخه 3.14: نصب قوانین در زیرشاخه های اضافه شده توسط تماس ها به دایرکتوری افزودنی() دستور با کسانی که در دایرکتوری اصلی قرار دارند برای اجرای به ترتیب اعلام شده (نگاه کنید به خط مشی 0082 ).
تغییر در نسخه 3.22: حالت متغیر محیطی می تواند رفتار کپی پیش فرض نصب () را لغو کند .
چندین امضا برای این دستور وجود دارد. برخی از گزینه های نصب برای فایل ها و اهداف را تعریف می کنند. گزینه های رایج در چندین امضا در اینجا پوشش داده می شوند اما فقط برای امضاهایی که مشخص می کنند معتبر هستند. گزینه های رایج عبارتند از:
دایرکتوری را بر روی دیسک مشخص کنید که یک فایل نصب خواهد شد. استدلال ها می توانند مسیرهای نسبی یا مطلق باشند.
اگر یک مسیر نسبی داده شود نسبت به مقدار تفسیر می شود سیماک_نصب کنیدتغیر پیش فرض. پیشوند را می توان در زمان نصب با استفاده از مکانیزم دستیر توضیح داده شده در مستندات متغیر را نصب کنید.
اگر یک مسیر مطلق (با یک اسلش یا حرف درایو پیشرو) داده شود کلمه به کلمه استفاده می شود.
به عنوان مسیرهای مطلق توسط ژنراتور نصب کپک پشتیبانی نمی, بهتر است به استفاده از مسیرهای نسبی در سراسر. این پیشوند به طور پیش فرض استفاده می شود اگر مقصد یک مسیر نسبی باشد.
مجوزهای پرونده های نصب شده را مشخص کنید. مجوزهای معتبر هستند مالک_خوانده شده, مالک_نوشتن, مالک_خوانده شده, گروه_خوانده شده , گروه_نوشته_گروه_خوانده شده , جهان_خوانده شده , جهان_نوشته_خوانده جهانی , تنظیم شده , و مجموعه . مجوزهایی که در سیستم عامل های خاص منطقی نیستند در این سیستم عامل ها نادیده گرفته می شوند.
مشخص کردن یک لیست از تنظیمات ساخت که حکومت نصب اعمال (اشکال زدایی, رهایی, و غیره.). توجه داشته باشید که مقادیر مشخص شده برای این گزینه فقط برای گزینه های ذکر شده بعد از گزینه تنظیمات اعمال می شود. به عنوان مثال برای تنظیم مسیرهای نصب جداگانه برای تنظیمات اشکال زدایی و انتشار موارد زیر را انجام دهید:
توجه داشته باشید که تنظیمات قبل از مقصد زمان اجرا به نظر می رسد .
یک نام کامپوننت نصب را مشخص کنید که قانون نصب مانند زمان اجرا یا توسعه مرتبط است . در طول نصب و راه اندازی کامپوننت خاص تنها نصب قوانین مرتبط با نام کامپوننت داده شده اجرا خواهد شد. در حین نصب کامل همه اجزا نصب می شوند مگر اینکه با علامت گذاری شده باشند_از_همه . اگر کامپوننت فراهم نشده باشد یک کامپوننت پیش فرض "نامشخص" ایجاد می شود. نام کامپوننت پیش فرض ممکن است با متغیر نام کامپوننت _ نصب _ پیش فرض _ کنترل شود.
جدید در نسخه 3.6.
مشخص کنید که پرونده از نصب کامل مستثنی است و فقط به عنوان بخشی از نصب خاص کامپوننت نصب شده است
نامی را برای یک فایل نصب شده مشخص کنید که ممکن است با پرونده اصلی متفاوت باشد. تغییر نام تنها زمانی مجاز است که یک فایل توسط دستور نصب شود.
مشخص کنید که اگر فایل نصب شده وجود نداشته باشد خطایی نیست.
جدید در نسخه 3.1: امضاهای فرمان که فایل ها را نصب می کنند ممکن است پیام ها را در هنگام نصب چاپ کنند. از متغیر پیام برای کنترل پیام های چاپ شده استفاده کنید.
جدید در نسخه 3.11: بسیاری از انواع نصب() به طور ضمنی دایرکتوری های حاوی فایل های نصب شده را ایجاد می کنند. این دایرکتوری ها با مجوزهای مشخص شده ایجاد می شوند. در غیر این صورت طبق قوانین یکسان در سیستم عامل های شبه یونیکس ایجاد می شوند. سیستم عامل های ویندوز بی پیرایه هستند.
نصب اهداف¶
فرم اهداف قوانینی را برای نصب اهداف از یک پروژه مشخص می کند. انواع مختلفی از مصنوعات خروجی هدف وجود دارد که ممکن است نصب شوند:
مصنوعات هدف از این نوع عبارتند از:
کتابخانه استاتیک (به جز در سیستم عامل مکینتاش زمانی که به عنوان چارچوب مشخص شده اند , پایین را ببینید);
کتابخانه های ال ال واردات (در تمام سیستم های مبتنی بر ویندوز از جمله سایگوین .معاونت, در مقابل به .کتابخانه های ال ال که به زمان اجرا می روند );
در اکس, فایل واردات لینکر ایجاد شده برای اجرایی با فعال _ صادرات را فعال کنید.
مصنوعات هدف از این نوع عبارتند از:
کتابخانههای مشترک به جز
ال ال (این رفتن به زمان اجرا, پایین را ببینید),
در سیستم عامل مکینتاش زمانی که به عنوان چارچوب مشخص شده اند (پایین را ببینید).
مصنوعات هدف از این نوع عبارتند از:
اجرایی (به جز در سیستم عامل مکینتاش زمانی که به عنوان بسته نرم افزاری مکوکس مشخص شده اند , بسته نرم افزاری زیر را ببینید);
توجه داشته باشید که کتابخانه های واردات همراه از نوع بایگانی هستند).
جدید در نسخه 3.9.
فایل های شی مرتبط با کتابخانه های شی .
هر دو کتابخانه استاتیک و مشترک مشخص شده با ویژگی چارچوب به عنوان اهداف چارچوب در سیستم عامل مکینتاش درمان.
اجرایی مشخص شده با اموال مک اوکس_باندل به عنوان اهداف بسته نرم افزاری در سیستم عامل مکینتاش درمان می شود.
هر فایل سربرگ عمومی مرتبط با یک کتابخانه در مقصد مشخص شده توسط استدلال سربرگ عمومی در سیستم عامل های غیر اپل نصب می شود. قوانین تعریف شده توسط این استدلال برای کتابخانه های چارچوب در سیستم عامل های اپل نادیده گرفته می شوند زیرا فایل های مرتبط به مکان های مناسب در داخل پوشه چارچوب نصب می شوند. برای اطلاعات بیشتر به سربرگ عمومی مراجعه کنید.
شبیه به سربرگ عمومی, اما برای فایل های سربرگ خصوصی. برای اطلاعات بیشتر به سربرگ خصوصی مراجعه کنید.
مشابه سربرگ عمومی و سربرگ خصوصی اما برای پرونده های منبع. برای اطلاعات بیشتر به منبع مراجعه کنید.
جدید در نسخه 3.23.
مجموعه پرونده ها توسط دستور _ منابع هدف(مجموعه پرونده) تعریف می شوند. اگر مجموعه فایل وجود دارد و عمومی و یا رابط است , هر فایل در مجموعه تحت مقصد نصب (پایین را ببینید). ساختار دایرکتوری نسبت به دایرکتوری های پایه مجموعه فایل حفظ می شود. مثلا, یک فایل اضافه شده به مجموعه فایل به عنوان /اه/شامل/میپروج/اینجا.ساعت با یک دایرکتوری پایه/اه / شامل می شود به میپروج نصب/اینجا.ساعت زیر مقصد.
یادداشت
تجربی. دروازه توسط سیماک_تجربی_مدول_مدول_مدول_مدول_اپی
هر فایل ماژول از سی پلاس پلاس ماژول از منابع عمومی در یک مجموعه فایل از نوع ماژول خواهد شد به مقصد داده شده نصب شده است . همه ماژول ها به طور مستقیم در مقصد قرار می گیرند زیرا هیچ ساختار دایرکتوری از نام ماژول ها گرفته نشده است. مقصد خالی ممکن است مورد استفاده برای سرکوب نصب این فایل ها (برای استفاده در کد عمومی).
برای هر یک از این استدلال ها استدلال های زیر فقط برای هدف یا نوع پرونده مشخص شده در استدلال اعمال می شود. اگر هیچ داده شده است, خواص نصب و راه اندازی به تمام انواع هدف اعمال.
برای اجرایی به طور منظم, کتابخانه استاتیک و کتابخانه های مشترک, استدلال مقصد مورد نیاز نمی باشد. برای این نوع هدف, هنگامی که مقصد حذف شده است , مقصد پیش فرض خواهد شد از متغیر مناسب از گنوین استالدیرز گرفته, و یا مجموعه ای به یک مقدار پیش فرض ساخته شده است در صورتی که متغیر تعریف نشده است. همین امر در مورد مجموعه پرونده ها و سرصفحه های عمومی و خصوصی مرتبط با اهداف نصب شده از طریق ویژگی های هدف عمومی و سرصفحه خصوصی نیز صادق است. یک قسمت را همیشه باید برای کتابخانه ماژول فراهم شود, بسته نرم افزاری اپل و چارچوب. مقصد را می توان برای کتابخانه رابط و شی حذف, اما متفاوت به کار گرفته (بحث در مورد این موضوع نسبت به پایان این بخش را ببینید). r
برای کتابخانه های به اشتراک گذاشته شده بر روی سیستم عامل ال ال, اگر نه زمان اجرا و نه مقصدهای بایگانی مشخص می شوند, هر دو زمان اجرا و بایگانی قطعات به مقصدهای پیش فرض خود نصب. اگر هم یک زمان اجرا و یا مقصد بایگانی مشخص شده است, کامپوننت به مقصد نصب شده است, و کامپوننت دیگر نصب نشده است. اگر هر دو زمان اجرا و مقصد بایگانی مشخص شده است, سپس هر دو اجزای به مقصد مربوطه می باشند نصب.
جدول زیر انواع هدف را با متغیرهای مرتبط و پیش فرض های داخلی نشان می دهد که در صورت عدم مقصد اعمال می شوند:
مجموعه پرونده (نوع سرصفحه )
پروژه هایی که مایل به پیروی از روش معمول نصب سرصفحه ها در یک زیر شاخه خاص پروژه هستند ممکن است استفاده از مجموعه پرونده ها با مسیرهای مناسب و دایرکتوری های پایه را ترجیح دهند. در غیر این صورت به جای اینکه بتوانند به موارد فوق تکیه کنند باید مقصدی را فراهم کنند (مثال بعدی را در زیر ببینید).
برای انطباق بسته ها با سیاست های چیدمان فایل سیستم توزیع, اگر پروژه ها باید مقصد را مشخص کنند , توصیه می شود از مسیری استفاده کنند که با متغیر مناسب گنوین نصب شده شروع شود. این به نگهدارنده های بسته اجازه می دهد تا مقصد نصب را با تنظیم متغیرهای حافظه پنهان مناسب کنترل کنند. مثال زیر نشان می دهد که یک کتابخانه ثابت در مقصد پیش فرض گنوین استالدیرها نصب شده است اما با سرصفحه های نصب شده بر روی یک زیرشاخه مخصوص پروژه بدون استفاده از مجموعه پرونده ها:
علاوه بر گزینه های مشترک ذکر شده در بالا, هر هدف می توانید استدلال اضافی زیر را قبول:
جدید در نسخه 3.12.
در برخی از سیستم عامل ها یک کتابخانه مشترک نسخه دار دارای یک پیوند نمادین مانند:
جایی که معاونت.بنابراین.1 سونام کتابخانه است و lib. so یک "پیوند نام" است که به لینکرها اجازه می دهد کتابخانه را در صورت داده شدن پیدا کنند-ل . گزینه پیوند نام_ کامپوننت مشابه گزینه کامپوننت است اما در صورت ایجاد پیوند نام کتابخانه مشترک اجزای نصب را تغییر می دهد. اگر مشخص نشده, این به طور پیش فرض به مقدار کامپوننت . استفاده از این پارامتر در خارج از بلوک کتابخانه خطا است.
مثال زیر را در نظر بگیرید:
در این سناریو, اگر شما انتخاب می کنید برای نصب تنها مولفه توسعه, هر دو هدر و ناملینک خواهد شد بدون کتابخانه نصب. (اگر کامپوننت کتابخانه ها را نیز نصب نکنید ناملینک یک پیوند سیملینک اویزان خواهد بود و پروژه هایی که به کتابخانه پیوند می دهند دارای خطاهای ساخت هستند.) اگر شما نصب تنها کامپوننت کتابخانه, تنها کتابخانه نصب خواهد شد, بدون هدر و لینک نام.
این گزینه معمولا برای مدیران بسته استفاده می شود که دارای بسته های زمان اجرا و توسعه جداگانه هستند. به عنوان مثال در سیستم های دبیان انتظار می رود کتابخانه در بسته زمان اجرا باشد و انتظار می رود هدرها و پیوند نام در بسته توسعه باشد.
برای اطلاعات بیشتر در مورد ایجاد کتابخانه های مشترک نسخه ای به نسخه و ویژگی های هدف اصلی مراجعه کنید.
این گزینه باعث نصب فقط پیوند نام هنگام نصب هدف کتابخانه می شود. در پلتفرمهایی که کتابخانههای اشتراکی نسخهبندی شده لینکهای نام ندارند یا وقتی کتابخانه نسخهبندی نشده است ناملینک تنها گزینه نصب نمیشود. استفاده از این پارامتر در خارج از بلوک کتابخانه خطا است.
هنگامی که ناملینک به تنهایی داده می شود ممکن است برای تعیین کامپوننت نصب ناملینک یا کامپوننت استفاده شود اما به طور کلی باید کامپوننت ترجیح داده شود.
مشابه پیوند نام_فقط, اما نتیجه عکس دارد: هنگام نصب یک هدف کتابخانه باعث نصب فایلهای کتابخانه ای غیر از پیوند نام می شود. هنگامی که هیچ کدام از این دو قسمت فقط به نام یا نام پیوند داده نمی شوند هر دو قسمت نصب می شوند. در سیستم عامل هایی که کتابخانه های به اشتراک گذاشته شده نسخه بندی شده پیوند نمادین ندارند یا وقتی کتابخانه نسخه بندی نشده است کتابخانه را نصب می کند. استفاده از این پارامتر در خارج از بلوک کتابخانه خطا است.
اگر پیوند نام_اسکپیپ مشخص شود, پیوند نام_مفهوم هیچ تاثیری ندارد. توصیه نمی شود از ناملینک در ارتباط با ناملینک _ کامپوننت استفاده کنید .
دستور نصب (اهداف) همچنین می تواند گزینه های زیر را در سطح بالا بپذیرد:
این گزینه پرونده های هدف نصب شده را با صادراتی به نام مرتبط می کند . باید قبل از هر گزینه هدف ظاهر شود. در واقع نصب فایل صادرات خود را, پاسخ نصب (صادرات), مستند زیر. برای تغییر نام هدف صادر شده به مستندات خاصیت هدف صادراتی مراجعه کنید.
اگر صادرات استفاده می شود و اهداف شامل مجموعه فایل های عمومی و یا رابط, همه باید با استدلال مجموعه فایل مشخص شود. تمام مجموعه فایل های عمومی یا رابط مرتبط با یک هدف در صادرات گنجانده شده است.
این گزینه لیستی از دایرکتوری ها را مشخص می کند که به رابط اضافه می شود_شاخه ها اموال مورد نظر هنگام صادر شدن توسط دستور نصب(صادرات) را هدف قرار می دهند. اگر یک مسیر نسبی مشخص شده است, این است که به عنوان نسبت به درمان $ .
جدید در نسخه 3.21.
این گزینه باعث می شود تمام وابستگی در زمان اجرا از اجرایی نصب, کتابخانه به اشتراک گذاشته, و اهداف ماژول به مجموعه وابستگی زمان اجرا مشخص اضافه شود. سپس این مجموعه را می توان با دستور نصب(زمان اجرا _ مجموعه وابستگی) نصب کرد.
این کلمه کلیدی و کلمه کلیدی وابستگی زمان اجرا متقابلا منحصر به فرد هستند.
جدید در نسخه 3.21.
این گزینه باعث می شود تمام وابستگی زمان اجرا از اجرایی نصب شده, کتابخانه مشترک, و اهداف ماژول به همراه اهداف خود نصب شود. زمان اجرا, کتابخانه , چارچوب , و استدلال عمومی برای تعیین خواص استفاده می شود ( مقصد , مولفه, و غیره.) از نصب این وابستگی ها.
وابستگی های زمان اجرا از نظر معنایی معادل جفت تماس زیر است:
از کجا خواهد بود یک نام مجموعه ای به طور تصادفی تولید. استدلال. ممکن است شامل هر یک از کلمات کلیدی زیر باشد که توسط دستور نصب(زمان اجرا _ وابستگی _ مجموعه) پشتیبانی می شود:
زمان اجرا _ وابستگی ها و زمان اجرا _ وابستگی _ کلمات کلیدی متقابلا منحصر به فرد هستند.
یک یا چند گروه از خواص ممکن است در یک تماس واحد به شکل اهداف این دستور مشخص شود. یک هدف ممکن است بیش از یک بار در مکان های مختلف نصب شود. اهداف فرضی را در نظر بگیرید . کد:
میکس را به /بن و میستاتیکلیب به /معاونت/استاتیک نصب می کند . در سیستم عامل های غیر ال ال میشاردلیب خواهد شد به /معاونت و /برخی/کامل/مسیر نصب شده است . بر روی سیستم عامل ال ال ال ال به /بن و /برخی/کامل/مسیر نصب و کتابخانه واردات خود را به /معاونت/استاتیک و /برخی/کامل/مسیر نصب خواهد شد .
کتابخانه رابط ممکن است در میان اهداف ذکر شده برای نصب. هیچ مصنوعاتی را نصب نمی کنند اما در صادرات مرتبط گنجانده می شوند . اگر کتابخانههای شی فهرست شده باشند اما هیچ مقصدی برای فایلهای شی ندارند به عنوان کتابخانههای رابط صادر میشوند . این کافی است برای ارضای الزامات استفاده انتقالی از اهداف دیگر که به کتابخانه شی در اجرای خود پیوند.
نصب یک هدف با استثنا_از_همه ویژگی هدف تعیین شده روی درست رفتار نامشخصی دارد.
جدید در نسخه 3.3: مقصد نصب داده شده به عنوان یک استدلال مقصد ممکن است "عبارات ژنراتور" با نحو استفاده use<. >. برای عبارات موجود به دفترچه راهنمای عبارات سازنده(7) مراجعه کنید.
جدید در نسخه 3.13: نصب(اهداف) می تواند اهدافی را که در دایرکتوری های دیگر ایجاد شده اند نصب کند. هنگام استفاده از چنین متقابل دایرکتوری نصب قوانین, در حال اجرا را نصب (یا مشابه) از یک دایرکتوری فرعی نمی خواهد تضمین می کنند که اهداف از دایرکتوری های دیگر تا به تاریخ. می توانید از کتابخانه های هدف() یا وابستگی های اضافی() استفاده کنید تا اطمینان حاصل کنید که چنین اهداف خارج از دایرکتوری قبل از اجرای قوانین نصب خاص زیر شاخه ساخته شده اند.
نصب مصنوعات زمان اجرا وارد شده¶
جدید در نسخه 3.21.
فرم مقررات وارداتی قوانینی را برای نصب مصنوعات زمان اجرا اهداف وارد شده مشخص می کند. پروژه ها ممکن است این کار را انجام دهند اگر بخواهند اجرایی یا ماژول های خارج از نصب خود را بسته بندی کنند. کتابخانه , زمان اجرا , چارچوب, و استدلال های بسته نرم افزاری همان معناشناسی را دارند که در حالت اهداف انجام می دهند. فقط مصنوعات زمان اجرا از اهداف وارداتی نصب شده اند (به جز در مورد کتابخانه های چارچوب, فایل های اجرایی بسته نرم افزاری و بسته نرم افزاری.) مثلا, هدر و کتابخانه واردات مرتبط با ال ال اس نصب نشده است. در مورد کتابخانه های چارچوب, فایل های اجرایی مک و بسته نرم افزاری, کل دایرکتوری نصب شده است.
گزینه زمان اجرا _ وابستگی _ مجموعه باعث می شود مصنوعات زمان اجرا از اجرایی وارد, کتابخانه به اشتراک گذاشته, و اهداف کتابخانه ماژول به مجموعه وابستگی زمان اجرا اضافه می شود. سپس این مجموعه را می توان با دستور نصب(زمان اجرا _ مجموعه وابستگی) نصب کرد.
نصب فایل ها¶
در صورت نصب فایل های هدر, در نظر بگیرید با استفاده از مجموعه فایل های تعریف شده توسط منابع هدف(مجموعه فایل) به جای. فایل ها هدر های مرتبط را با یک هدف تنظیم می کنند و به عنوان بخشی از هدف نصب می شوند.
فرم فایل ها قوانینی را برای نصب فایل ها برای یک پروژه مشخص می کند. نام پرونده هایی که به عنوان مسیرهای نسبی داده می شوند با توجه به فهرست منبع فعلی تفسیر می شوند. فایل های نصب شده توسط این فرم به طور پیش فرض با توجه به مجوز مالک_ نوشتن , مالک_خوانده شده , گروه _خوانده شده , و جهان _خوانده شده اگر هیچ استدلال مجوز داده شده است.
فرم برنامه ها با فرم فایل ها یکسان است با این تفاوت که مجوزهای پیش فرض برای فایل نصب شده نیز شامل می شود مالک_عالی , گروه_عالی , و _عالی جهانی . این فرم برای نصب برنامه هایی که هدف نیستند مانند اسکریپت های پوسته در نظر گرفته شده است. از فرم اهداف برای نصب اهداف ساخته شده در پروژه استفاده کنید.
لیست فایل های. داده شده به پرونده ها یا برنامه ها ممکن است استفاده کنند "عبارات ژنراتور" با نحو $<. >. برای عبارات موجود به دفترچه راهنمای عبارات سازنده(7) مراجعه کنید. با این حال, اگر هر مورد در یک عبارت ژنراتور شروع می شود باید به یک مسیر کامل ارزیابی.
یا یک نوع یا یک مقصد باید فراهم شود, اما نه هر دو. یک نوع استدلال نوع فایل عمومی فایل های نصب شده را مشخص می کند. سپس یک مقصد به طور خودکار با گرفتن متغیر مربوطه از گنوین نصب شده یا با استفاده از یک پیش فرض داخلی در صورتی که این متغیر تعریف نشده باشد تنظیم می شود. جدول زیر را برای انواع فایل های پشتیبانی شده و متغیرهای مربوطه و پیش فرض های داخلی مشاهده کنید. پروژه می تواند یک استدلال مقصد به جای یک نوع فایل فراهم می کند در صورتی که مایل به صراحت تعریف مقصد نصب.
پروژه هایی که مایل به پیروی از روش معمول نصب سرصفحه ها در یک زیر شاخه خاص پروژه هستند باید مقصدی را فراهم کنند تا به موارد فوق اعتماد کنند. استفاده از مجموعه پرونده ها برای هدرها به جای نصب(پرونده ها) حتی بهتر خواهد بود (به منابع هدف(مجموعه پرونده) مراجعه کنید ).
توجه داشته باشید که برخی از انواع' پیش فرض های داخلی از دایرکتوری داده به عنوان پیشوند استفاده می کنند. پیشوند دیتاروت به طور مشابه با انواع محاسبه می شود ج_نصب_داتاروتدیر به عنوان متغیر و به اشتراک گذاری به عنوان پیش فرض داخلی. شما نمی توانید از داده به عنوان یک پارامتر نوع استفاده کنید.
برای انطباق بسته ها با سیاست های چیدمان فایل سیستم توزیع, اگر پروژه ها باید مقصد را مشخص کنند , توصیه می شود از مسیری استفاده کنند که با متغیر مناسب گنوین نصب شده شروع شود. این به نگهدارنده های بسته اجازه می دهد تا مقصد نصب را با تنظیم متغیرهای حافظه پنهان مناسب کنترل کنند. مثال زیر نحوه پیروی از این توصیه را هنگام نصب تصویر در زیر شاخه اسناد خاص پروژه نشان می دهد:
جدید در نسخه 3.4: مقصد نصب داده شده به عنوان یک استدلال مقصد ممکن است "عبارات ژنراتور" با نحو استفاده use<. >. برای عبارات موجود به دفترچه راهنمای عبارات سازنده(7) مراجعه کنید.
جدید در نسخه 3.20: نصب تغییر نام داده شده به عنوان یک استدلال تغییر نام ممکن است "عبارات ژنراتور" با نحو استفاده use<. >. برای عبارات موجود به دفترچه راهنمای عبارات سازنده(7) مراجعه کنید.
نصب دایرکتوری ها¶
برای نصب یک دایرکتوری زیر درخت هدر, در نظر بگیرید با استفاده از مجموعه فایل های تعریف شده توسط منابع هدف(مجموعه فایل) به جای. مجموعه فایل ها نه تنها ساختار دایرکتوری را حفظ می کنند بلکه هدر ها را با یک هدف مرتبط می کنند و به عنوان بخشی از هدف نصب می کنند.
فرم دایرکتوری محتویات یک یا چند دایرکتوری را به یک مقصد مشخص نصب می کند. ساختار دایرکتوری کلمه به کلمه در مقصد کپی می شود. کامپوننت نهایی هر نام دایرکتوری به دایرکتوری مقصد اضافه می شود اما ممکن است برای جلوگیری از این کار از یک اسلش دنباله دار استفاده شود زیرا کامپوننت نهایی را خالی می گذارد. نام دایرکتوری داده شده به عنوان مسیرهای نسبی با توجه به دایرکتوری منبع فعلی تفسیر شده است. اگر نام دایرکتوری ورودی داده نشود دایرکتوری مقصد ایجاد می شود اما هیچ چیز نصب نمی شود. گزینه های مجوز فایل و مجوز های دایرکتوری مجوز های داده شده به فایل ها و دایرکتوری ها را در مقصد مشخص می کنند. اگر مجوزهای استفاده مشخص شده و مجوزهای پرونده مشخص نشود مجوزهای پرونده از ساختار فهرست منبع کپی می شوند. اگر هیچ مجوزی مشخص نشود فایل ها به مجوزهای پیش فرض مشخص شده در فرم فایل های دستور داده می شوند و به دایرکتوری ها مجوزهای پیش فرض مشخص شده در فرم برنامه دستور داده می شود.
جدید در نسخه 3.1: پیام هیچ وقت گزینه خروجی وضعیت نصب فایل را غیرفعال نمی کند.
نصب و راه اندازی دایرکتوری ها ممکن است با دانه دانه خوب با استفاده از الگوی یا عبارت منظم گزینه های کنترل می شود. این گزینه های "مطابقت" یک الگوی جهش یا عبارت منظم را برای مطابقت با دایرکتوری ها یا پرونده های موجود در دایرکتوری های ورودی مشخص می کنند. ممکن است برای اعمال گزینه های خاصی (به زیر مراجعه کنید) در زیر مجموعه ای از پرونده ها و دایرکتوری های موجود استفاده شوند. مسیر کامل به هر فایل ورودی یا دایرکتوری (با اسلش رو به جلو) در برابر بیان همسان. یک الگو فقط با نام پرونده های کامل مطابقت دارد: بخشی از مسیر کامل مطابق با الگو باید در انتهای نام پرونده رخ دهد و قبل از یک اسلش باشد. عبارت منظم هر بخشی از مسیر کامل مطابقت اما ممکن است استفاده کنید / و $ برای شبیه سازی رفتار الگوی. به طور پیش فرض تمام فایل ها و دایرکتوری ها نصب می شوند یا نه. گزینه تطبیق فایل ها ممکن است قبل از اولین گزینه مسابقه برای غیرفعال کردن نصب فایل ها (اما نه دایرکتوری ها) با هیچ عبارتی مطابقت نداشته باشد. به عنوان مثال کد
تصاویر را از یک درخت منبع استخراج و نصب می کند.
برخی از گزینه ها ممکن است از یک الگو یا عبارت عبارت منظم پیروی کنند که در زیر توضیح داده شده است رشته(عبارت منظم) و فقط برای پرونده ها یا دایرکتوری های منطبق اعمال می شوند. گزینه حذف فایل یا دایرکتوری همسان را رد می کند. گزینه مجوز لغو مجوز تنظیم برای فایل یا دایرکتوری همسان. به عنوان مثال کد
دایرکتوری نمادها را برای به اشتراک گذاشتن/میپروج/نمادها و دایرکتوری اسکریپت ها را برای به اشتراک گذاشتن/میپروج نصب می کند . نمادها مجوزهای پرونده پیش فرض را دریافت می کنند, به اسکریپت ها مجوزهای خاصی داده می شود, و هرگونه دایرکتوری رزومه حذف می شود.
یا یک نوع یا یک مقصد باید فراهم شود, اما نه هر دو. یک نوع استدلال نوع فایل عمومی فایل ها را در دایرکتوری های ذکر شده در حال نصب مشخص می کند. سپس یک مقصد به طور خودکار با گرفتن متغیر مربوطه از گنوین نصب شده یا با استفاده از یک پیش فرض داخلی در صورتی که این متغیر تعریف نشده باشد تنظیم می شود. جدول زیر را برای انواع فایل های پشتیبانی شده و متغیرهای مربوطه و پیش فرض های داخلی مشاهده کنید. پروژه می تواند یک استدلال مقصد به جای یک نوع فایل فراهم می کند در صورتی که مایل به صراحت تعریف مقصد نصب.
توجه داشته باشید که برخی از انواع' پیش فرض های داخلی از دایرکتوری داده به عنوان پیشوند استفاده می کنند. پیشوند دیتاروت به طور مشابه با انواع محاسبه می شود ج_نصب_داتاروتدیر به عنوان متغیر و به اشتراک گذاری به عنوان پیش فرض داخلی. شما نمی توانید از داده به عنوان یک پارامتر نوع استفاده کنید.
برای انطباق بسته ها با سیاست های چیدمان فایل سیستم توزیع, اگر پروژه ها باید مقصد را مشخص کنند , توصیه می شود از مسیری استفاده کنند که با متغیر مناسب گنوین نصب شده شروع شود. این به نگهدارنده های بسته اجازه می دهد تا مقصد نصب را با تنظیم متغیرهای حافظه پنهان مناسب کنترل کنند.
جدید در نسخه 3.4: مقصد نصب داده شده به عنوان یک استدلال مقصد ممکن است "عبارات ژنراتور" با نحو استفاده use<. >. برای عبارات موجود به دفترچه راهنمای عبارات سازنده(7) مراجعه کنید.
جدید در نسخه 3.5: لیست دیرها. با توجه به دایرکتوری ممکن است "عبارات ژنراتور" بیش از حد استفاده کنید.
منطق نصب سفارشی¶
فرم اسکریپت در هنگام نصب فایل های اسکریپت داده شده را فراخوانی می کند. اگر نام فایل اسکریپت یک مسیر نسبی باشد با توجه به فهرست منبع فعلی تفسیر می شود. فرم کد هنگام نصب کد داده شده را فراخوانی می کند. کد به عنوان یک استدلال واحد در داخل یک رشته دو نقل قول مشخص شده است. به عنوان مثال کد
یک پیام در هنگام نصب چاپ.
جدید در نسخه 3.21: هنگامی که گزینه تمام اجزای داده شده است, کد اسکریپت نصب و راه اندازی سفارشی خواهد شد برای هر یک از اجزای نصب و راه اندازی کامپوننت خاص اجرا. این گزینه متقابلا با گزینه کامپوننت منحصر به فرد است.
جدید در نسخه 3.14: یا ممکن است "عبارات ژنراتور" با نحو استفاده کنید use<. >(در مورد, این اشاره به استفاده خود را در نام فایل, نه محتویات فایل). برای عبارات موجود به دفترچه راهنمای عبارات سازنده(7) مراجعه کنید.
نصب صادرات¶
فرم صادرات یک فایل حاوی کد را تولید و نصب می کند تا اهداف را از درخت نصب به پروژه دیگری وارد کند. تاسیسات هدف با صادرات با استفاده از گزینه صادرات امضای نصب(اهداف) مستند شده در بالا همراه است. گزینه فضای نام همانطور که در فایل واردات نوشته شده است به نام های هدف اضافه می شود. به طور پیش فرض فایل تولید شده فراخوانی می شود .ساختن اما ممکن است از گزینه فایل برای تعیین نام دیگری استفاده شود. مقدار داده شده به گزینه فایل باید یک نام فایل با باشد .پسوند درست کنید. اگر یک گزینه تنظیمات داده شده است و سپس فایل تنها نصب خواهد شد زمانی که یکی از تنظیمات به نام نصب شده است. علاوه بر این, فایل واردات تولید خواهد شد تنها تنظیمات هدف تطبیق مرجع. صادرات_لینک _ اینترفیس_لبریج کلمه کلیدی, در صورت وجود, باعث می شود محتویات خواص تطبیق (وارداتی_)?لینک_ اینترفیس_کتابخانه ها (_)? به صادر می شود, زمانی که سیاست سی ام پی 0022 جدید است .
نصب .فایل ممکن است با هر پیکربندی اضافی همراه باشد -*.فایل ها را با استفاده از گلوب بارگذاری کنید. هنوز یک نام صادرات است که همان نام بسته در ترکیب با نصب یک پیکربندی استفاده نمی.فایل یا دومی ممکن است به اشتباه با لکه مطابقت داشته باشد و بارگذاری شود.
هنگامی که یک گزینه کامپوننت داده شده است, ذکر شده به طور ضمنی در تمام اجزای ذکر شده در مجموعه صادرات بستگی دارد. صادر .برای ساخت صحیح پروژه های وابسته نیاز به حضور هر یک از اجزای صادر شده است. برای مثال یک پروژه ممکن است اجزای زمان اجرا و توسعه را تعریف کند و کتابخانههای مشترک وارد کامپوننت زمان اجرا شوند و کتابخانههای استاتیک و هدرها وارد بخش توسعه شوند. مجموعه صادرات نیز معمولا بخشی از مولفه توسعه خواهد بود اما اهداف را از اجزای زمان اجرا و توسعه صادر می کند. از این رو, کامپوننت زمان اجرا نیاز به نصب شود اگر کامپوننت توسعه نصب شد, اما نه برعکس. اگر کامپوننت توسعه بدون کامپوننت زمان اجرا نصب شده باشد پروژه های وابسته ای که سعی در ایجاد خطا دارند. مدیران بسته مانند دور در دقیقه و دور در دقیقه معمولا این کار را با فهرست کردن کامپوننت زمان اجرا به عنوان وابستگی به کامپوننت توسعه در فراداده بسته انجام می دهند و اطمینان حاصل می کنند که کتابخانه همیشه نصب شده است اگر هدر و فایل صادراتی وجود داشته باشد.
جدید در نسخه 3.7: علاوه بر ساخت فایل های زبان ممکن است از حالت صادرات _ اندروید _ مک برای تعیین صادرات به سیستم ساخت اندروید استفاده شود. این حالت همان گزینه های حالت صادرات عادی را می پذیرد. اندروید ان دی کی از استفاده از کتابخانه های از پیش ساخته شده اعم از استاتیک و مشترک پشتیبانی می کند. این اجازه می دهد تا کتابخانه های یک پروژه را بسازد و در دسترس سیستم ساخت ان دی کی کامل با وابستگی های انتقالی قرار دهد که شامل پرچم ها و تعریف های مورد نیاز برای استفاده از کتابخانه ها است.
یادداشت
تجربی. دروازه توسط سیماک_تجربی_مدول_مدول_مدول_مدول_اپی
مشخص یک دایرکتوری فرعی برای ذخیره اطلاعات ماژول سی پلاس پلاس برای اهداف در مجموعه صادرات. این دایرکتوری خواهد شد با فایل های که اضافه کردن اطلاعات ملک هدف لازم را به اهداف مربوطه جمعیت. توجه داشته باشید که بدون این اطلاعات هیچ یک از ماژول های سی پلاس پلاس که بخشی از اهداف مجموعه صادرات هستند از واردات در اهداف مصرفی پشتیبانی نمی کنند.
فرم صادرات برای کمک به پروژه های خارج از استفاده از اهداف ساخته شده و نصب شده توسط پروژه فعلی مفید است. به عنوان مثال کد
این نرم افزار به شما امکان می دهد تا در هر زمان و هر زمان که می خواهید وارد شوید.ماژول ها/ماژول ها / اندروید. یک پروژه خارجی ممکن است این فایل را با دستور شامل بارگیری کند و با استفاده از نام هدف وارد شده به عنوان هدف در درخت خود ساخته شده است.
این دستور جایگزین دستورات نصب() و ویژگیهای هدف پیش نصب _ اسکریپت و پس نصب _ اسکریپت می شود. همچنین جایگزین فرم های فایل های دستورات نصب _ فایل ها() و نصب _برنامه ها() می شود. ترتیب پردازش این قوانین نصب نسبت به قوانین تولید شده توسط اهداف نصب() , نصب _ فایل ها() , و نصب _برنامه ها() دستورات تعریف نشده است.
نصب وابستگی های زمان اجرا¶
جدید در نسخه 3.21.
یک مجموعه وابستگی زمان اجرا را که قبلا توسط یک یا چند دستور نصب(اهداف) ایجاد شده یا دستورات(وارد شده _ تایم_نویسی) را نصب می کند نصب می کند. وابستگی از اهداف متعلق به یک مجموعه وابستگی زمان اجرا در مقصد زمان اجرا و کامپوننت بر روی سیستم عامل ال ال نصب, و در مقصد کتابخانه و کامپوننت بر روی سیستم عامل غیر ال ال. چارچوب های سیستم عامل در مقصد چارچوب و کامپوننت نصب شده است. اهداف ساخته شده در درخت ساخت هرگز به عنوان وابستگی های زمان اجرا نصب نخواهند شد و وابستگی های خود را نخواهند داشت مگر اینکه اهداف خود را با نصب(اهداف) نصب کنند.
تولید نصب اسکریپت خواستار فایل (دریافت _زمان _ وابستگی) در فایل های ساخت درخت برای محاسبه وابستگی در زمان اجرا. فایل های اجرایی ساخت درخت به عنوان استدلال اجرایی گذشت, ساخت درخت کتابخانه به اشتراک گذاشته شده به عنوان استدلال کتابخانه, و ماژول ساخت درخت به عنوان استدلال ماژول. در سیستم عامل مک, اگر یکی از فایل های اجرایی یک بسته نرم افزاری است , که اجرایی به عنوان استدلال بسته نرم افزاری به تصویب رسید. حداکثر یکی از این بسته های اجرایی ممکن است در زمان اجرا باشد وابستگی تنظیم شده بر روی مک. اینستاگرام هیچ تاثیری بر روی سیستم عامل های دیگر ندارد. توجه داشته باشید که فایل(دریافت-زمان_ وابستگیها) فقط از جمع کردن وابستگیهای زمان اجرا برای پلتفرمهای ویندوز, لینوکس و مک پشتیبانی میکند.
زیر استدلال از طریق به عنوان استدلال مربوطه به فایل فرستاده(دریافت _زمان _ وابستگی) (برای کسانی که یک لیست غیر خالی از دایرکتوری, عبارات منظم و یا فایل های). همه از عبارات ژنراتور پشتیبانی می کنند .
اسکریپت نصب تولید شده¶
استفاده از این ویژگی توصیه نمی شود. لطفا در نظر بگیرید با استفاده از کامake نصب به جای.
دستور نصب () یک فایل را تولید می کند.در داخل دایرکتوری ساخت که به صورت داخلی توسط هدف نصب تولید شده و توسط کپک استفاده می شود. همچنین می توانید این اسکریپت را به صورت دستی فراخوانی کنید . این اسکریپت چندین متغیر را می پذیرد:
این متغیر را طوری تنظیم کنید که فقط یک کامپوننت کپک را بر خلاف همه نصب کند. به عنوان مثال اگر فقط می خواهید کامپوننت توسعه را نصب کنید, اجرا کنیدساخت-دیکامپوننت=توسعه-پ سیمک_نصب کنید.درست کردن .
تنظیم این متغیر برای تغییر نوع ساخت اگر شما با استفاده از یک ژنراتور چند پیکربندی. برای مثال برای نصب با پیکربندی اشکالزدایی اجرا کنید.درست کردن .
این یک متغیر محیطی است تا یک متغیر ساخت. به شما امکان می دهد پیشوند نصب را در سیستم های یونیکس تغییر دهید. برای اطلاعات بیشتر به دستگیر مراجعه کنید.
