'\" t
.\"     Title: flatpak build-export
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/27/2026
.\"    Manual: flatpak build-export
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK BUILD\-EXPOR" "1" "" "flatpak" "flatpak build-export"
.\" -----------------------------------------------------------------
.\" * 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-build-export \- خروجی گرفتن و استقرار برنامه در یک مخزن
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ build\-export\fR\ 'u
\fBflatpak build\-export\fR [OPTION...] LOCATION DIRECTORY [BRANCH]
.SH "توضیحات (DESCRIPTION)"
.PP
مخزنی را با ساخت (build) یک برنامه ایجاد کرده یا به‌روزرسانی می‌کند\&.
LOCATION
مکان مخزن است\&.
DIRECTORY
باید یک دایرکتوری نهایی‌شدهٔ ساخت باشد\&. اگر
BRANCH
مشخص نشود، مقدار پیش‌فرض آن "master" فرض می‌شود\&.
.PP
اگر
LOCATION
از قبل وجود داشته باشد، فرض می‌شود که یک مخزن OSTree است؛ در غیر این صورت، یک مخزن جدید OSTree در این مکان ایجاد می‌شود\&. این مخزن را می‌توان با ابزار
\fBostree\fR
بررسی و بازبینی کرد\&.
.PP
محتویات
DIRECTORY
روی شاخه‌ای با نام
app/APPNAME/ARCH/BRANCH
کامیت می‌شوند، که در آن ARCH معماری محیط زمان اجرای (runtime) مورد استفادهٔ برنامه است\&. از یک فیلتر کامیت استفاده می‌شود تا تضمین شود تنها محتویات زیردایرکتوری‌های
files/
و
export/
و فایل
metadata
در کامیت گنجانده می‌شوند و سایر موارد نادیده گرفته می‌شوند\&.
.PP
هنگام خروجی گرفتن از یک فلت‌پک برای انتشار در اینترنت، گزینهٔ
\fB\-\-collection\-id=COLLECTION\-ID\fR
باید به‌صورت یک مقدار DNS معکوس و یکتا در سطح جهانی مشخص شود تا مجموعهٔ فلت‌پک‌هایی که این برنامه به آن افزوده می‌شود شناسایی گردد\&. تنظیم یک شناسهٔ مجموعهٔ (collection ID) یکتا در سطح جهانی، امکان به اشتراک‌گذاری برنامه‌های موجود در مخزن را از طریق سیستم‌های همتا‌به‌همتا (peer-to-peer) بدون نیاز به پیکربندی بیشتر فراهم می‌کند\&.
.PP
هر زمان که ساخت‌های برنامه به یک مخزن اضافه می‌شوند، باید از دستور
build\-update\-repo
برای به‌روزرسانی متادیتای مخزن استفاده شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.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) مخزن\&. تنظیم یک شناسهٔ مجموعهٔ یکتا در سطح جهانی امکان به‌اشتراک‌گذاری برنامه‌های موجود در مخزن را از طریق سیستم‌های همتا‌به‌همتا بدون نیاز به پیکربندی بیشتر فراهم می‌کند\&. در صورت خروجی گرفتن به یک مخزن موجود، شناسهٔ مجموعه باید با شناسهٔ مجموعهٔ پیکربندی‌شدهٔ فعلی آن مخزن مطابقت داشته باشد\&.
.RE
.PP
\fB\-\-subset=SUBSET\fR
.RS 4
علامت‌گذاری کامیت برای گنجانده شدن در زیرمجموعهٔ (subset) نام‌برده\&. این کار باعث می‌شود که کامیت علاوه بر خلاصهٔ اصلی در خلاصهٔ زیرمجموعهٔ نام‌برده نیز قرار گیرد، و به کاربران اجازه می‌دهد فقط این زیرمجموعه را به جای کل مخزن مشاهده کنند\&.
.RE
.PP
\fB\-\-arch=ARCH\fR
.RS 4
مشخص کردن مؤلفهٔ معماری شاخه برای خروجی گرفتن\&. تنها معماری‌های سازگار با میزبان را می‌توان مشخص کرد؛ برای مقادیر معتبر،
\fBflatpak \-\-supported\-arches\fR
را ببینید\&.
.RE
.PP
\fB\-\-exclude=PATTERN\fR
.RS 4
مستثنی کردن فایل‌های منطبق با
PATTERN
از کامیت\&. از این گزینه می‌توان چندین بار استفاده کرد\&.
.RE
.PP
\fB\-\-include=PATTERN\fR
.RS 4
مستثنی نکردن فایل‌های منطبق با
PATTERN
از کامیت، حتی اگر با الگوهای
\fB\-\-exclude\fR
مطابقت داشته باشند\&. از این گزینه می‌توان چندین بار استفاده کرد\&.
.RE
.PP
\fB\-\-metadata=FILENAME\fR
.RS 4
استفاده از نام فایل مشخص‌شده به‌عنوان متادیتا در برنامهٔ خروجی‌گرفته‌شده به‌جای فایل پیش‌فرض (به نام
metadata)\&.
این گزینه در صورتی مفید است که بخواهید چندین مورد را از یک درخت ساخت واحد کامیت کنید؛ معمولاً در ترکیب با گزینه‌های
\fB\-\-files\fR
و
\fB\-\-exclude\fR
استفاده می‌شود\&.
.RE
.PP
\fB\-\-files=SUBDIR\fR
.RS 4
استفاده از فایل‌های موجود در زیردایرکتوری مشخص‌شده به‌جای دایرکتوری عادی
files
به‌عنوان محتوای فایل\&.
.RE
.PP
\fB\-\-timestamp=DATE\fR
.RS 4
استفاده از تاریخ با قالب ISO 8601 یا عبارت NOW (برای زمان جاری) در متادیتای کامیت و همچنین داده‌های appstream (در صورت استفاده از
\fB\-\-update\-appstream\fR)\&.
.RE
.PP
\fB\-\-end\-of\-life=REASON\fR
.RS 4
علامت‌گذاری ساخت به‌عنوان پایان دورهٔ عمر (end\-of\-life)\&. مقدار REASON پیامی است که ممکن است به کاربرانی که این ساخت را نصب می‌کنند نشان داده شود\&.
.RE
.PP
\fB\-\-end\-of\-life\-rebase=ID\fR
.RS 4
علامت‌گذاری ساخت به‌عنوان پایان دورهٔ عمر (end\-of\-life)\&. برخلاف
\fB\-\-end\-of\-life\fR،
این گزینه شناسه‌ای را می‌گیرد که جایگزین شناسهٔ فعلی می‌شود\&. بنا به درخواست کاربر، داده‌های برنامه ممکن است برای برنامهٔ جدید حفظ شوند\&.
.RE
.PP
\fB\-\-disable\-fsync\fR
.RS 4
عدم اجرای fsync هنگام نوشتن در مخزن\&. این عمل می‌تواند در شرایط استثنایی منجر به از دست رفتن داده‌ها شود، اما کارایی را هنگام کار با مخازن موقت یا آزمایشی بهبود می‌بخشد\&.
.RE
.PP
\fB\-\-update\-appstream\fR
.RS 4
به‌روزرسانی شاخهٔ appstream پس از ساخت\&.
.RE
.PP
\fB\-\-no\-update\-summary\fR
.RS 4
به‌روزرسانی نکردن فایل خلاصه (summary) پس از افزودن کامیت جدید\&. این بدان معناست که مخزن تا زمان اجرای build\-update\-repo برای ارائه از طریق http قابل استفاده نخواهد بود\&. این گزینه زمانی مفید است که بخواهید چندین عملیات در مخزن را قبل از به‌روزرسانی نهایی خلاصه انجام دهید\&.
.RE
.PP
\fB\-\-gpg\-sign=KEYID\fR
.RS 4
امضای کامیت با این کلید GPG\&. از این گزینه می‌توان چندین بار استفاده کرد\&.
.RE
.PP
\fB\-\-gpg\-homedir=PATH\fR
.RS 4
دایرکتوری خانگی GPG مورد استفاده هنگام جستجوی دسته‌کلیدها (keyrings)\&.
.RE
.PP
\fB\-r\fR, \fB\-\-runtime\fR
.RS 4
خروجی گرفتن از یک محیط زمان اجرا (runtime) به‌جای برنامه (این کار از زیردایرکتوری usr به‌عنوان فایل‌ها استفاده می‌کند)\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی در حین پردازش دستور\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree در حین پردازش دستور\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ flatpak build\-export ~/repos/gnome\-calculator/ ~/build/gnome\-calculator/ org\&.gnome\&.Calculator\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Commit: 9d0044ea480297114d03aec85c3d7ae3779438f9d2cb69d717fb54237acacb8c
Metadata Total: 605
Metadata Written: 5
Content Total: 1174
Content Written: 1
Content Bytes Written: 305
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBostree\fR(1),
\fBflatpak\fR(1),
\fBflatpak-build-init\fR(1),
\fBflatpak-build\fR(1),
\fBflatpak-build-finish\fR(1),
\fBflatpak-build-sign\fR(1),
\fBflatpak-build-update-repo\fR(1)