FLATPAK BUILD-EXPOR(1) flatpak build-export FLATPAK BUILD-EXPOR(1)

flatpak-build-export - خروجی گرفتن و استقرار برنامه در یک مخزن

flatpak build-export [OPTION...] LOCATION DIRECTORY [BRANCH]

مخزنی را با ساخت (build) یک برنامه ایجاد کرده یا به‌روزرسانی می‌کند. LOCATION مکان مخزن است. DIRECTORY باید یک دایرکتوری نهایی‌شدهٔ ساخت باشد. اگر BRANCH مشخص نشود، مقدار پیش‌فرض آن "master" فرض می‌شود.

اگر LOCATION از قبل وجود داشته باشد، فرض می‌شود که یک مخزن OSTree است؛ در غیر این صورت، یک مخزن جدید OSTree در این مکان ایجاد می‌شود. این مخزن را می‌توان با ابزار ostree بررسی و بازبینی کرد.

محتویات DIRECTORY روی شاخه‌ای با نام app/APPNAME/ARCH/BRANCH کامیت می‌شوند، که در آن ARCH معماری محیط زمان اجرای (runtime) مورد استفادهٔ برنامه است. از یک فیلتر کامیت استفاده می‌شود تا تضمین شود تنها محتویات زیردایرکتوری‌های files/ و export/ و فایل metadata در کامیت گنجانده می‌شوند و سایر موارد نادیده گرفته می‌شوند.

هنگام خروجی گرفتن از یک فلت‌پک برای انتشار در اینترنت، گزینهٔ --collection-id=COLLECTION-ID باید به‌صورت یک مقدار DNS معکوس و یکتا در سطح جهانی مشخص شود تا مجموعهٔ فلت‌پک‌هایی که این برنامه به آن افزوده می‌شود شناسایی گردد. تنظیم یک شناسهٔ مجموعهٔ (collection ID) یکتا در سطح جهانی، امکان به اشتراک‌گذاری برنامه‌های موجود در مخزن را از طریق سیستم‌های همتا‌به‌همتا (peer-to-peer) بدون نیاز به پیکربندی بیشتر فراهم می‌کند.

هر زمان که ساخت‌های برنامه به یک مخزن اضافه می‌شوند، باید از دستور build-update-repo برای به‌روزرسانی متادیتای مخزن استفاده شود.

گزینه‌های زیر پشتیبانی می‌شوند:

-h, --help

نمایش گزینه‌های راهنما و خروج.

-s, --subject=SUBJECT

موضوع تک‌خطی برای پیام کامیت.

-b, --body=BODY

توضیحات کامل برای پیام کامیت.

--collection-id=COLLECTION-ID

تنظیم به‌عنوان شناسهٔ مجموعهٔ (collection ID) مخزن. تنظیم یک شناسهٔ مجموعهٔ یکتا در سطح جهانی امکان به‌اشتراک‌گذاری برنامه‌های موجود در مخزن را از طریق سیستم‌های همتا‌به‌همتا بدون نیاز به پیکربندی بیشتر فراهم می‌کند. در صورت خروجی گرفتن به یک مخزن موجود، شناسهٔ مجموعه باید با شناسهٔ مجموعهٔ پیکربندی‌شدهٔ فعلی آن مخزن مطابقت داشته باشد.

--subset=SUBSET

علامت‌گذاری کامیت برای گنجانده شدن در زیرمجموعهٔ (subset) نام‌برده. این کار باعث می‌شود که کامیت علاوه بر خلاصهٔ اصلی در خلاصهٔ زیرمجموعهٔ نام‌برده نیز قرار گیرد، و به کاربران اجازه می‌دهد فقط این زیرمجموعه را به جای کل مخزن مشاهده کنند.

--arch=ARCH

مشخص کردن مؤلفهٔ معماری شاخه برای خروجی گرفتن. تنها معماری‌های سازگار با میزبان را می‌توان مشخص کرد؛ برای مقادیر معتبر، flatpak --supported-arches را ببینید.

--exclude=PATTERN

مستثنی کردن فایل‌های منطبق با PATTERN از کامیت. از این گزینه می‌توان چندین بار استفاده کرد.

--include=PATTERN

مستثنی نکردن فایل‌های منطبق با PATTERN از کامیت، حتی اگر با الگوهای --exclude مطابقت داشته باشند. از این گزینه می‌توان چندین بار استفاده کرد.

--metadata=FILENAME

استفاده از نام فایل مشخص‌شده به‌عنوان متادیتا در برنامهٔ خروجی‌گرفته‌شده به‌جای فایل پیش‌فرض (به نام metadata). این گزینه در صورتی مفید است که بخواهید چندین مورد را از یک درخت ساخت واحد کامیت کنید؛ معمولاً در ترکیب با گزینه‌های --files و --exclude استفاده می‌شود.

--files=SUBDIR

استفاده از فایل‌های موجود در زیردایرکتوری مشخص‌شده به‌جای دایرکتوری عادی files به‌عنوان محتوای فایل.

--timestamp=DATE

استفاده از تاریخ با قالب ISO 8601 یا عبارت NOW (برای زمان جاری) در متادیتای کامیت و همچنین داده‌های appstream (در صورت استفاده از --update-appstream).

--end-of-life=REASON

علامت‌گذاری ساخت به‌عنوان پایان دورهٔ عمر (end-of-life). مقدار REASON پیامی است که ممکن است به کاربرانی که این ساخت را نصب می‌کنند نشان داده شود.

--end-of-life-rebase=ID

علامت‌گذاری ساخت به‌عنوان پایان دورهٔ عمر (end-of-life). برخلاف --end-of-life، این گزینه شناسه‌ای را می‌گیرد که جایگزین شناسهٔ فعلی می‌شود. بنا به درخواست کاربر، داده‌های برنامه ممکن است برای برنامهٔ جدید حفظ شوند.

--disable-fsync

عدم اجرای fsync هنگام نوشتن در مخزن. این عمل می‌تواند در شرایط استثنایی منجر به از دست رفتن داده‌ها شود، اما کارایی را هنگام کار با مخازن موقت یا آزمایشی بهبود می‌بخشد.

--update-appstream

به‌روزرسانی شاخهٔ appstream پس از ساخت.

--no-update-summary

به‌روزرسانی نکردن فایل خلاصه (summary) پس از افزودن کامیت جدید. این بدان معناست که مخزن تا زمان اجرای build-update-repo برای ارائه از طریق http قابل استفاده نخواهد بود. این گزینه زمانی مفید است که بخواهید چندین عملیات در مخزن را قبل از به‌روزرسانی نهایی خلاصه انجام دهید.

--gpg-sign=KEYID

امضای کامیت با این کلید GPG. از این گزینه می‌توان چندین بار استفاده کرد.

--gpg-homedir=PATH

دایرکتوری خانگی GPG مورد استفاده هنگام جستجوی دسته‌کلیدها (keyrings).

-r, --runtime

خروجی گرفتن از یک محیط زمان اجرا (runtime) به‌جای برنامه (این کار از زیردایرکتوری usr به‌عنوان فایل‌ها استفاده می‌کند).

-v, --verbose

چاپ اطلاعات اشکال‌زدایی در حین پردازش دستور.

--ostree-verbose

چاپ اطلاعات اشکال‌زدایی OSTree در حین پردازش دستور.

$ flatpak build-export ~/repos/gnome-calculator/ ~/build/gnome-calculator/ org.gnome.Calculator

Commit: 9d0044ea480297114d03aec85c3d7ae3779438f9d2cb69d717fb54237acacb8c
Metadata Total: 605
Metadata Written: 5
Content Total: 1174
Content Written: 1
Content Bytes Written: 305

ostree(1), flatpak(1), flatpak-build-init(1), flatpak-build(1), flatpak-build-finish(1), flatpak-build-sign(1), flatpak-build-update-repo(1)

flatpak