'\" t .\" Title: flatpak-builder .\" Author: Alexander Larsson .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 06/24/2026 .\" Manual: flatpak builder .\" Source: flatpak .\" Language: Persian .\" .TH "FLATPAK\-BUILDER" "1" "" "flatpak" "flatpak builder" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" flatpak-builder \- کمک به ساخت وابستگی‌های برنامه .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBflatpak\-builder\fR\ 'u \fBflatpak\-builder\fR [OPTION...] DIRECTORY MANIFEST .HP \w'\fBflatpak\-builder\fR\ 'u \fBflatpak\-builder\fR \-\-run [OPTION...] DIRECTORY MANIFEST COMMAND .HP \w'\fBflatpak\-builder\fR\ 'u \fBflatpak\-builder\fR \-\-show\-deps [OPTION...] MANIFEST .HP \w'\fBflatpak\-builder\fR\ 'u \fBflatpak\-builder\fR \-\-show\-manifest [OPTION...] MANIFEST .SH "توضیحات (DESCRIPTION)" .PP دستور \fBflatpak\-builder\fR پوسته‌ای (wrapper) بر روی دستور \fBflatpak build\fR است که فرآیند ساخت برنامه‌ها و وابستگی‌های آن‌ها را خودکار می‌کند\&. این یکی از گزینه‌هایی است که می‌توانید برای ساخت برنامه‌ها به کار ببرید\&. .PP هدف \fBflatpak\-builder\fR این است که تا جای ممکن دانش مربوط به نحوهٔ ساخت پودمان‌ها (modules) را به خود پروژه‌های بالادستی منتقل کند\&. این کار با فرض این‌که پودمان‌ها از Build API مشخص‌شده در https://github\&.com/cgwalters/build\-api پیروی می‌کنند انجام می‌شود\&. این اساساً بدان معناست که از الگوی \fB\&./configure && make && make install\fR با یک اسکریپت اختیاری autogen پیروی می‌کند\&. اگر پروژهٔ بالادستی از این API پیروی نمی‌کند، می‌توانید با افزودن وصله‌ها (patches) و فایل‌های اضافی آن را سازگار کنید\&. .PP اجرای \fBflatpak\-builder\fR در مراحل زیر پیش می‌رود که هر یک با جزئیات در قالب json در MANIFEST مشخص شده است: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} بارگیری تمام منابع .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مقداردهی اولیهٔ دایرکتوری برنامه با \fBflatpak build\-init\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} ساخت و نصب هر پودمان با \fBflatpak build\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} پاک‌سازی درخت نهایی ساخت با حذف فایل‌های ناخواسته و برای مثال پیراستن باینری‌ها (stripping binaries) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} نهایی‌سازی دایرکتوری برنامه با \fBflatpak build\-finish\fR .RE .sp پس از این، ساخت برنامه را در DIRECTORY خواهید داشت که می‌توانید آن را با دستور \fBflatpak build\-export\fR به یک مخزن صادر (export) کنید\&. اگر از گزینهٔ \fB\-\-repo\fR استفاده کنید، flatpak\-builder در پایان فرآیند ساخت، عمل خروجی گرفتن را برای شما انجام می‌دهد\&. هنگامی که flatpak\-builder خروجی می‌گیرد، مانیفست مورد استفاده برای ساخت را نیز در /app/manifest\&.json ذخیره می‌کند\&. این مانیفست به‌اصطلاح «حل‌شده» (resolved) است؛ یعنی نام شاخه‌های git با شناسه‌های کامیت واقعی استفاده‌شده در ساخت جایگزین می‌شوند\&. .PP در هر یک از مراحل بالا، flatpak نتیجه را در حافظهٔ موقت (cache) ذخیره می‌کند و اگر همان فایل را دوباره بسازید، از نخستین مرحله‌ای که چیزی در آن تغییر کرده آغاز به کار خواهد کرد\&. برای نمونه، نخستین منبع تحت کنترل نسخه‌ای که کامیت‌های جدیدی به آن افزوده شده، یا نخستین پودمانی که تغییراتی در فایل MANIFEST آن موجب دگرگونی محیط ساخت شده است\&. این امر flatpak\-builder را برای ساخت‌های افزایشی (incremental builds) بسیار کارآمد می‌سازد\&. .PP هنگام ساخت یک فلت‌پک برای انتشار در اینترنت، گزینهٔ \fB\-\-collection\-id=COLLECTION\-ID\fR باید به‌صورت یک مقدار DNS معکوس و یکتا در سطح جهانی مشخص شود تا مجموعهٔ فلت‌پک‌هایی که این برنامه به آن افزوده می‌شود شناسایی گردد\&. تنظیم یک شناسهٔ مجموعهٔ یکتا در سطح جهانی، امکان به اشتراک‌گذاری برنامه‌های موجود در مخزن را از طریق سیستم‌های همتا‌به‌همتا (peer-to-peer) بدون نیاز به پیکربندی بیشتر فراهم می‌کند\&. .SH "مانیفست (MANIFEST)" .PP فایل مانیفست یک فایل json یا yaml است که قالب آن با جزئیات در صفحهٔ راهنمای اختصاصی خودش شرح داده شده است\&. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌های زیر پشتیبانی می‌شوند: .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 نمایش گزینه‌های راهنما و خروج\&. .RE .PP \fB\-v\fR, \fB\-\-verbose\fR .RS 4 چاپ اطلاعات اشکال‌زدایی در طول پردازش دستور\&. .RE .PP \fB\-\-version\fR .RS 4 چاپ اطلاعات نسخه و خروج\&. .RE .PP \fB\-\-arch=ARCH\fR .RS 4 مشخص کردن معماری دستگاه برای ساخت\&. اگر هیچ معماری‌ای مشخص نشود، معماری میزبان به‌طور خودکار شناسایی خواهد شد\&. تنها معماری‌های سازگار با میزبان را می‌توان مشخص کرد\&. .RE .PP \fB\-\-default\-branch=\fR\fB\fIBRANCH\fR\fR .RS 4 تنظیم شاخهٔ پیش‌فرض به \fIBRANCH\fR\&. از این گزینه زمانی استفاده می‌شود که در مانیفست شاخه‌ای مشخص نشده باشد\&. مقدار پیش‌فرض master است\&. .RE .PP \fB\-\-disable\-cache\fR .RS 4 عدم بررسی حافظهٔ موقت موجود برای ساخت قبلی؛ در عوض همیشه پودمان‌ها از نو ساخته شوند\&. .RE .PP \fB\-\-disable\-rofiles\-fuse\fR .RS 4 غیرفعال کردن استفاده از rofiles\-fuse برای بهینه‌سازی مصرف حافظهٔ موقت از طریق بررسی لینک‌های سخت (hardlink checkouts)\&. .RE .PP \fB\-\-disable\-download\fR .RS 4 هیچ منبعی بارگیری نشود\&. این فقط زمانی کار می‌کند که نسخه‌ای از تمام منابع از پیش بارگیری شده باشد\&. این گزینه زمانی مفید است که می‌خواهید تضمین کنید هیچ ورودی/خروجی شبکه‌ای انجام نمی‌شود\&. با این حال، اگر منبعی به‌صورت محلی موجود نباشد، فرآیند ساخت شکست خواهد خورد\&. .RE .PP \fB\-\-disable\-updates\fR .RS 4 منابع ناموجود بارگیری شوند، اما آینه‌های محلی مخازن کنترل نسخه به‌روزرسانی نشوند\&. این گزینه برای ساخت مجدد موارد بدون به‌روزرسانی مخازن git، bzr یا svn از مخزن دوردست مفید است\&. .RE .PP \fB\-\-disable\-tests\fR .RS 4 هیچ‌یک از آزمون‌ها اجرا نشوند\&. .RE .PP \fB\-\-run\fR .RS 4 اجرای یک دستور در یک جعبه‌شن (sandbox) بر اساس دایرکتوری ساخت\&. این کار flatpak build را با آرگومان‌های اضافی برای ایجاد همان محیط ساخت و همان دسترسی‌هایی که برنامهٔ نهایی خواهد داشت (به‌جز دسترسی‌های سیستم فایل) آغاز می‌کند\&. دستوری که باید اجرا شود باید آخرین آرگومان ارائه‌شده به flatpak\-builder پس از دایرکتوری و مانیفست باشد\&. .sp تنها گزینه‌های \fB\-\-arch=\fR\fIARCH\fR، \fB\-\-ccache\fR، \fB\-\-verbose\fR و \fB\-\-state\-dir\fR\fIPATH\fR (از نسخهٔ 1\&.4\&.8 به بعد) را می‌توان با این گزینه ترکیب کرد\&. .RE .PP \fB\-\-build\-shell=MODULENAME\fR .RS 4 استخراج و آماده‌سازی منابع برای پودمان نام‌برده‌شده، و سپس راه‌اندازی یک پوسته در یک جعبه‌شن همسان با آنچه flatpak\-builder برای ساخت پودمان استفاده می‌کرد\&. این گزینه برای اشکال‌زدایی یک پودمان مفید است\&. .RE .PP \fB\-\-show\-deps\fR .RS 4 فهرست کردن تمام فایل‌های (محلی) که مانیفست به آن‌ها وابسته است\&. .sp تنها گزینهٔ \fB\-\-verbose\fR را می‌توان با این گزینه ترکیب کرد\&. .RE .PP \fB\-\-show\-manifest\fR .RS 4 مانیفست را به‌همراه تمامی فایل‌های گنجانده‌شده بارگذاری کرده و آن را در قالبی استاندارد (canonical) از json چاپ می‌کند\&. این گزینه برای ابزارهایی مفید است که مانیفست‌ها را مدیریت می‌کنند تا از پشتیبانی هم‌زمان از yaml و json و همچنین برخی رفتارهای غیراستاندارد json که پشتیبانی می‌شوند (مانند کامنت‌ها و رشته‌های چندخطی) بی‌نیاز شوند\&. .sp تنها گزینهٔ \fB\-\-verbose\fR را می‌توان با این گزینه ترکیب کرد\&. .RE .PP \fB\-\-download\-only\fR .RS 4 خروج موفقیت‌آمیز پس از بارگیری منابع مورد نیاز\&. .RE .PP \fB\-\-bundle\-sources\fR .RS 4 ایجاد یک محیط زمان اجرای اضافی شامل کد منبع این پودمان\&. نام آن به‌صورت \fIapp\-id\fR\&.Sources خواهد بود؛ برای نمونه org\&.gnome\&.Maps\&.Sources\&. .RE .PP \fB\-\-build\-only\fR .RS 4 عدم انجام مراحل پاک‌سازی و نهایی‌سازی؛ این گزینه زمانی مفید است که بخواهید موارد بیشتری را در برنامه بسازید\&. .RE .PP \fB\-\-finish\-only\fR .RS 4 تنها انجام مراحل پاک‌سازی، نهایی‌سازی و خروجی گرفتن، با ادامه از جایی که دستور \-\-build\-only متوقف شده بود\&. .RE .PP \fB\-\-export\-only\fR .RS 4 تنها انجام مراحل خروجی گرفتن، با دریافت نتیجهٔ ساخت از یک ساخت پیشین\&. این گزینه می‌تواند برای تقسیم ساخت و صدور/امضا به دو فراخوانی جداگانه با حذف \-\-repo در فراخوانی نخست استفاده شود\&. .RE .PP \fB\-\-require\-changes\fR .RS 4 هیچ کاری انجام ندهد و در صورتی که پس از آخرین ساخت ذخیره‌شده در حافظهٔ موقت تغییری رخ نداده باشد، DIRECTORY را در وضعیت ناموجود رها کند\&. اگر این گزینه مشخص نشود، آخرین نسخه از حافظهٔ موقت در DIRECTORY قرار داده خواهد شد\&. .RE .PP \fB\-\-state\-dir=PATH\fR .RS 4 استفاده از این دایرکتوری برای ذخیرهٔ وضعیت (بارگیری‌ها، دایرکتوری‌های ساخت، حافظهٔ موقت ساخت و غیره) به‌جای \&.flatpak\-builder\&. این می‌تواند یک مسیر مطلق یا نسبی باشد، اما باید روی همان سیستم فایلی باشد که DIRECTORY هدف مشخص‌شده قرار دارد\&. .RE .PP \fB\-\-keep\-build\-dirs\fR .RS 4 عدم حذف منابع و فایل‌های ساخت پس از ساختن و نصب هر پودمان\&. این کار همچنین یک پیوند نمادین (symlink) با نامی پایدار ("build\-modulename") به دایرکتوری ساخت ایجاد می‌کند\&. .RE .PP \fB\-\-delete\-build\-dirs\fR .RS 4 همیشه منابع و فایل‌های ساخت پس از ساخت هر پودمان حذف شوند، حتی اگر ساخت با شکست مواجه شده باشد\&. حالت پیش‌فرض این است که دایرکتوری‌های ساخت‌های ناموفق نگه داشته شوند اما ساخت‌های موفق حذف گردند\&. این گزینه برای مثال در سیستم‌های ساخت خودکار مفید است\&. .RE .PP \fB\-\-ccache\fR .RS 4 فعال‌سازی استفاده از ccache در فرآیند ساخت (نیاز به وجود ccache در sdk دارد)\&. پوشهٔ پیش‌فرض ccache را می‌توان با تنظیم متغیر محیطی CCACHE_DIR بازنویسی کرد\&. .RE .PP \fB\-\-stop\-at=MODULENAME\fR .RS 4 توقف در پودمان مشخص‌شده، با نادیده گرفتن آن و تمام پودمان‌های پس از آن در هر دو فاز "download" و "build"\&. این گزینه برای اشکال‌زدایی و توسعه مفید است\&. برای نمونه، می‌توانید تمام وابستگی‌ها را بسازید، اما در برنامهٔ اصلی متوقف شوید تا بتوانید ساخت را از روی یک مخزن چک‌اوت‌شده از پیش موجود انجام دهید\&. این گزینه مستلزم \-\-build\-only است\&. .RE .PP \fB\-\-repo=DIR\fR .RS 4 پس از پایان ساخت، دستور \fBflatpak build\-export\fR را اجرا کند تا نتیجه را به مخزن DIR صادر نماید\&. اگر DIR وجود داشته باشد، باید یک مخزن OSTree باشد؛ در غیر این صورت یک مخزن جدید ایجاد خواهد شد\&. .RE .PP \fB\-s\fR, \fB\-\-subject=SUBJECT\fR .RS 4 عنوان یک‌خطی برای پیام کامیت\&. هنگام صدور نتایج ساخت استفاده می‌شود\&. .RE .PP \fB\-b\fR, \fB\-\-body=BODY\fR .RS 4 توضیحات کامل برای پیام کامیت\&. هنگام صدور نتایج ساخت استفاده می‌شود\&. .RE .PP \fB\-\-collection\-id=COLLECTION\-ID\fR .RS 4 تنظیم به‌عنوان شناسهٔ مجموعهٔ (collection ID) مخزن\&. تنظیم یک شناسهٔ مجموعهٔ یکتا در سطح جهانی، امکان به اشتراک‌گذاری برنامه‌های موجود در مخزن را از طریق سیستم‌های همتا‌به‌همتا (peer-to-peer) بدون نیاز به پیکربندی بیشتر فراهم می‌کند\&. در صورت ساخت در یک مخزن موجود، شناسهٔ مجموعه باید با شناسهٔ مجموعهٔ پیکربندی‌شدهٔ فعلی آن مخزن مطابقت داشته باشد\&. .RE .PP \fB\-\-token\-type=VAL\fR .RS 4 تنظیم نوع توکن مورد نیاز برای نصب این کامیت\&. تنظیم این گزینه به مقداری بزرگتر از 0 به این معنی است که برای نصب فلت‌پک به احراز هویت نیاز خواهد بود\&. ویژگی \fBtoken\-type\fR تنظیم‌شده در مانیفست نسبت به این گزینه اولویت دارد\&. هنگام صدور نتایج ساخت استفاده می‌شود\&. .RE .PP \fB\-\-gpg\-sign=KEYID\fR .RS 4 امضای کامیت با این کلید GPG\&. هنگام صدور نتایج ساخت استفاده می‌شود\&. از این گزینه می‌توان چندین بار استفاده کرد\&. .RE .PP \fB\-\-gpg\-homedir=PATH\fR .RS 4 مسیر دایرکتوری خانگی GPG (Homedir) برای جستجوی دسته‌کلیدها (keyrings)\&. هنگام صدور نتایج ساخت استفاده می‌شود\&. .RE .PP \fB\-\-jobs=JOBS\fR .RS 4 محدود کردن تعداد وظایف موازی در طول ساخت\&. مقدار پیش‌فرض برابر با تعداد پردازنده‌های (CPUs) دستگاه است\&. .RE .PP \fB\-\-force\-clean\fR .RS 4 پاک کردن محتویات قبلی DIRECTORY در صورتی که خالی نباشد\&. از نسخهٔ 1\&.4\&.6، اگر DIRECTORY دایرکتوری کاری جاری، دایرکتوری وضعیت یا هر یک از دایرکتوری‌های والد آن‌ها باشد، از حذف آن خودداری خواهد شد\&. .RE .PP \fB\-\-sandbox\fR .RS 4 غیرفعال کردن امکان تعیین build\-args که به flatpak build ارسال می‌شوند\&. این بدان معناست که فرآیند ساخت نمی‌تواند از جعبه‌شن خود خارج شود، و هنگام ساخت نرم‌افزارهای با قابلیت اعتماد کمتر مفید است\&. .RE .PP \fB\-\-allow\-missing\-runtimes\fR .RS 4 در صورتی که ران‌تایم‌های sdk یا platform روی این سیستم نصب نباشند، بلافاصله با خطا مواجه نشود\&. در صورت نبود sdk، تلاش برای ساخت هر پودمان مانیفست همچنان شکست خواهد خورد، اما ممکن است برای برنامه‌هایی که فایل‌ها را بدون ساخت در جعبه‌شن نصب می‌کنند مفید باشد\&. .RE .PP \fB\-\-rebuild\-on\-sdk\-change\fR .RS 4 ثبت نسخهٔ دقیق sdk در حافظهٔ موقت، و ساخت مجدد همه چیز در صورت تغییر آن\&. این گزینه زمانی مفید است که در حال ساخت در برابر یک زمان اجرای با API ناپایدار، مانند یک ساخت شبانه (nightly build) هستید\&. .RE .PP \fB\-\-skip\-if\-unchanged\fR .RS 4 اگر json از زمان آخرین ساخت این نام فایل تغییری نکرده باشد، هیچ کاری انجام ندهد و کد خروج 42 را برگرداند\&. .RE .PP \fB\-\-mirror\-screenshots\-url=URL\fR .RS 4 آینه‌کردن هرگونه چندرسانه‌ای در appstream و بازنویسی نشانی‌های وب (URLs) رسانه‌ها در appstream xml به نشانی مشخص‌شده\&. فایل‌های حاصل در زیردایرکتوری "screenshots" در دایرکتوری برنامه برای نسخه‌های پیش از 1\&.3\&.4 و در زیردایرکتوری "files/share/app\-info/media" برای نسخه‌های جدیدتر ذخیره خواهند شد\&. از نسخهٔ 1\&.4\&.5 به بعد، این گزینه همچنین یک مرجع تصویر (screenshot ref) در مخزن OSTree صادرشده برای هر معماری شامل رسانهٔ آینه‌شده ایجاد می‌کند\&. .RE .PP \fB\-\-extra\-sources=SOURCE\-DIR\fR .RS 4 هنگام بارگیری منابع (آرشیوها، فایل‌ها، git، bzr، svn)، برای نسخه‌های از پیش موجود در این دایرکتوری جستجو کرده و به‌جای بارگیری از آن‌ها استفاده شود\&. ساختار این دایرکتوری باید با ساختار دایرکتوری وضعیت مطابقت داشته باشد: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} فایل‌ها و آرشیوها باید درون پوشهٔ زیر باشند: downloads// .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} منابع از نوع git، bzr و svn باید درون پوشهٔ زیر باشند: // .RE .sp مقدار converted\-uri از روی path یا url (در مورد git) و از روی url (در مورد bzr و svn) ساخته می‌شود\&. :// به یک زیرخط (_) تبدیل شده و هر / دیگری نیز با یک زیرخط جایگزین می‌شود\&. برای نمونه، https://github\&.com/user/repo\&.git تبدیل به https_github\&.com_user_repo\&.git می‌شود\&. در مورد منابع svn اگر revision موجود باشد، نام پوشه svn/__r/ خواهد بود\&. در مورد منابع git، باید یک کلون آینه‌شده (mirrored clone) باشد\&. .RE .PP \fB\-\-extra\-sources\-url=URL\fR .RS 4 هنگام بارگیری منابع (آرشیوها، فایل‌ها، git، bzr، svn)، پیش از بارگیری از نشانی اینترنتی اصلی، این نشانی را برای بارگیری‌های آینه‌شده بررسی کند\&. .RE .PP \fB\-\-from\-git=GIT\fR .RS 4 جستجوی مانیفست در مخزن git مشخص‌شده\&. در صورت ارائهٔ این گزینه، MANIFEST به‌عنوان یک مسیر نسبی درون مخزن تفسیر می‌شود\&. .RE .PP \fB\-\-from\-git\-branch=BRANCH\fR .RS 4 شاخه‌ای که باید به همراه \-\-from\-git استفاده شود\&. .RE .PP \fB\-\-no\-shallow\-clone\fR .RS 4 عدم استفاده از کلون‌های کم‌عمق (shallow clones) هنگام آینه‌کردن مخازن git\&. .RE .PP \fB\-\-override\-source\-date\-epoch\fR .RS 4 تنظیم این برچسب زمانی به‌عنوان SOURCE_DATE_EPOCH برای اجرای ساخت، به‌جای زمان آخرین تغییر مانیفست\&. این گزینه از نسخهٔ 1\&.3\&.1 به بعد در دسترس است\&. .RE .PP \fB\-\-compose\-url\-policy=POLICY\fR .RS 4 تنظیم خط‌مشی نشانی اینترنتی AppStream compose\&. مقادیر پذیرفته‌شده عبارتند از partial و full\&. مقدار full نیازمند AppStream نسخهٔ >= 0\&.16\&.3 است\&. در صورت عدم تعیین، مقدار پیش‌فرض partial خواهد بود\&. این خط‌مشی تنها زمانی اعمال می‌شود که همراه با \fB\-\-mirror\-screenshots\-url=URL\fR استفاده شود؛ در غیر این صورت، کاتالوگ AppStream نشانی‌های منبع رسانه‌ها را حفظ خواهد کرد\&. .RE .PP \fB\-\-add\-tag=TAG\fR .RS 4 افزودن این برچسب (tag) به فهرست برچسب‌های مانیفست پیش از ساخت\&. .RE .PP \fB\-\-remove\-tag=TAG\fR .RS 4 حذف این برچسب از فهرست برچسب‌های مانیفست پیش از ساخت\&. حذف پیش از پردازش گزینهٔ \-\-add\-tag انجام می‌شود، بنابراین اگر هر دو مشخص شوند، گزینهٔ \-\-add\-tag پیروز خواهد بود\&. .RE .PP \fB\-\-install\-deps\-from=REMOTE\fR .RS 4 نصب یا به‌روزرسانی وابستگی‌های مورد نیاز ساخت از منبع دوردست (remote) مشخص‌شده\&. .RE .PP \fB\-\-install\-deps\-only\fR .RS 4 توقف پس از بارگیری وابستگی‌ها\&. .RE .PP \fB\-\-install\fR .RS 4 پس از پایان ساخت، نتیجه را به‌صورت محلی نصب کند\&. .RE .PP \fB\-\-user\fR .RS 4 نصب وابستگی‌ها در یک نصب مختص کاربر (per\-user)\&. .RE .PP \fB\-\-system\fR .RS 4 نصب وابستگی‌ها در نصب سراسری پیش‌فرض سیستم (system\-wide)\&. .RE .PP \fB\-\-installation=NAME\fR .RS 4 نصب وابستگی‌ها در یک نصب سراسری سیستم که توسط NAME از میان موارد تعریف‌شده در /etc/flatpak/installations\&.d/ مشخص شده است\&. استفاده از \-\-installation=default معادل استفاده از \-\-system است\&. .RE .SH "حافظهٔ موقت (CACHING)" .PP دستور flatpak\-builder منابع و نتایج جزئی ساخت را در دایرکتوری وضعیت (که به‌طور پیش‌فرض زیردایرکتوری \&.flatpak\-builder در دایرکتوری جاری است) ذخیره می‌کند\&. اگر از \fB\-\-keep\-build\-dirs\fR استفاده کنید، دایرکتوری‌های ساخت هر پودمان نیز در اینجا ذخیره می‌شوند\&. .PP حذف دایرکتوری وضعیت بی‌خطر است\&. این کار موجب می‌شود که در ساخت بعدی، یک ساخت کامل (full build) انجام شود\&. .SH "مثال‌ها (EXAMPLES)" .PP \fB$ flatpak\-builder my\-app\-dir manifest\&.json\fR .PP نمونه فایل مانیفست: .sp .if n \{\ .RS 4 .\} .nf { "id": "org\&.test\&.TestApp", "runtime": "org\&.freedesktop\&.Platform", "runtime\-version": "1\&.2", "sdk": "org\&.freedesktop\&.Sdk", "command": "test", "cleanup": [ "/include", "*\&.la" ], "build\-options" : { "cflags": "\-O2 \-g", "cxxflags": "\-O2 \-g", "env": { "V": "1" }, "arch": { "x86_64": { "cflags": "\-O3 \-g", } } }, "modules": [ { "name": "pygobject", "config\-opts": [ "\-\-disable\-introspection" ], "sources": [ { "type": "archive", "url": "http://ftp\&.gnome\&.org/pub/GNOME/sources/pygobject/2\&.28/pygobject\-2\&.28\&.6\&.tar\&.xz", "sha256": "fb8a1d4f665130a125011659bd347c7339c944232163dbb9a34fd0686577adb8" }, { "type": "patch", "path": "required\-pygobject\-fix\&.patch" }, { "type": "file", "path": "pygobject\-extra\-file", "dest\-filename": "extra\-file" } ] }, { "name": "babl", "build\-options" : { "cxxflags": "\-O2 \-g \-std=c++11" }, "cleanup": [ "/bin" ], "sources": [ { "type": "git", "url": "https://gitlab\&.gnome\&.org/GNOME/babl\&.git" } ] }, { "name": "testapp", "sources": [ { "type": "bzr", "url": "lp:testapp" } ] } ] } .fi .if n \{\ .RE .\} .SH "همچنین ببینید (SEE ALSO)" .PP \fBflatpak\fR(1), \fBflatpak\-manifest\fR(5), \fBflatpak\-build\-init\fR(1), \fBflatpak\-build\fR(1), \fBflatpak\-build\-finish\fR(1), \fBflatpak\-build\-export\fR(1)