'\" t
.\"     Title: flatpak build
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpak build
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK BUILD" "1" "" "flatpak" "flatpak build"
.\" -----------------------------------------------------------------
.\" * 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 \- اجرای دستور ساخت در یک دایرکتوری
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ build\fR\ 'u
\fBflatpak build\fR [OPTION...] DIRECTORY [COMMAND\ [ARG...]]
.SH "توضیحات (DESCRIPTION)"
.PP
یک دستور ساخت (build) را درون یک دایرکتوری اجرا می‌کند\&.
DIRECTORY
باید از قبل با استفاده از
\fBflatpak build\-init\fR
مقداردهی اولیه شده باشد\&.
.PP
محیط توسعه نرم‌افزار (sdk) که در فایل
metadata
درون این پوشه مشخص شده است در مسیر
/usr
و زیرپوشه‌های
files
و
var
به‌ترتیب در مسیرهای
/app
و
/var
سوار (mount) می‌شوند\&. این مسیرها قابل نوشتن هستند و محتویات آن‌ها بین دستورات ساخت حفظ می‌شود تا امکان جمع‌آوری خروجی‌های ساخت در آنجا فراهم باشد\&.
.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\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree در طول پردازش دستور\&.
.RE
.PP
\fB\-r\fR, \fB\-\-runtime\fR
.RS 4
استفاده از محیط زمان اجرای غیرتوسعه‌ای مشخص‌شده در فرادادهٔ برنامه به‌جای محیط زمان اجرای توسعه (devel)\&.
.RE
.PP
\fB\-p\fR, \fB\-\-die\-with\-parent\fR
.RS 4
کشتن فرآیند ساخت و تمام فرزندان آن در هنگام خاتمه یافتن فرآیند اجراکننده\&.
.RE
.PP
\fB\-\-bind\-mount=DEST=SOURCE\fR
.RS 4
افزودن یک اتصال سفارشی (bind mount) در فضای نام ساخت\&. این گزینه می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\fB\-\-build\-dir=PATH\fR
.RS 4
شروع فرآیند ساخت در این دایرکتوری (پیش‌فرض، دایرکتوری جاری است)\&.
.RE
.PP
\fB\-\-share=SUBSYSTEM\fR
.RS 4
اشتراک‌گذاری یک زیرسیستم با نشست میزبان\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&.
SUBSYSTEM
باید یکی از موارد زیر باشد: network، ipc\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-unshare=SUBSYSTEM\fR
.RS 4
عدم اشتراک‌گذاری یک زیرسیستم با نشست میزبان\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&.
SUBSYSTEM
باید یکی از موارد زیر باشد: network، ipc\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-socket=SOCKET\fR
.RS 4
در دسترس قرار دادن یک سوکت شناخته‌شده برای برنامه\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&.
SOCKET
باید یکی از موارد زیر باشد: x11، wayland، fallback\-x11، pulseaudio، system\-bus، session\-bus، ssh\-auth، pcsc، cups، gpg\-agent، inherit\-wayland\-socket\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-nosocket=SOCKET\fR
.RS 4
عدم دسترسی برنامه به یک سوکت شناخته‌شده\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&.
SOCKET
باید یکی از موارد زیر باشد: x11، wayland، fallback\-x11، pulseaudio، system\-bus، session\-bus، ssh\-auth، pcsc، cups، gpg\-agent، inherit\-wayland\-socket\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-device=DEVICE\fR
.RS 4
در دسترس قرار دادن یک دستگاه برای برنامه\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&.
DEVICE
باید یکی از موارد زیر باشد: dri، input، usb، kvm، shm، all\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-nodevice=DEVICE\fR
.RS 4
عدم دسترسی برنامه به یک دستگاه\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&.
DEVICE
باید یکی از موارد زیر باشد: dri، input، usb، kvm، shm، all\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-allow=FEATURE\fR
.RS 4
اجازهٔ دسترسی به یک ویژگی خاص\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&.
FEATURE
باید یکی از موارد زیر باشد: devel، multiarch، bluetooth، canbus، per\-app\-dev\-shm\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.sp
برای آشنایی با معانی ویژگی‌های گوناگون،
\fBflatpak-build-finish\fR(1)
را ببینید\&.
.RE
.PP
\fB\-\-disallow=FEATURE\fR
.RS 4
عدم اجازهٔ دسترسی به یک ویژگی خاص\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&.
FEATURE
باید یکی از موارد زیر باشد: devel، multiarch، bluetooth، canbus، per\-app\-dev\-shm\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-filesystem=FILESYSTEM[:ro|:create]\fR
.RS 4
اجازهٔ دسترسی برنامه به زیرمجموعه‌ای از سیستم‌فایل\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&.
FILESYSTEM
می‌تواند یکی از موارد زیر باشد: home، host، host\-os، host\-etc، host\-root، xdg\-desktop، xdg\-documents، xdg\-download، xdg\-music، xdg\-pictures، xdg\-public\-share، xdg\-templates، xdg\-videos، xdg\-run، xdg\-config، xdg\-cache، xdg\-data، یک مسیر مطلق، یا یک مسیر نسبی به پوشهٔ خانگی مانند ~/dir یا مسیرهای نسبی به دایرکتوری‌های xdg مانند xdg\-download/subdir\&. پسوند اختیاری :ro نشان می‌دهد که مسیر فقط‌خواندنی خواهد بود\&. پسوند اختیاری :create نشان می‌دهد که مسیر خواندنی-نوشتنی است و در صورت عدم وجود ایجاد می‌شود\&. این گزینه می‌تواند چندین بار استفاده شود\&. برای جزئیات مربوط به معانی این سیستم‌فایل‌ها، به فهرست "[Context] filesystems" در
\fBflatpak-metadata\fR(5)
مراجعه کنید\&. پیش از فلت‌پک ۱.۱۷.۰، دسترسی به host به‌طور پیش‌فرض داده می‌شد\&.
.RE
.PP
\fB\-\-nofilesystem=FILESYSTEM\fR
.RS 4
حذف دسترسی به زیرمجموعهٔ مشخص‌شده از سیستم‌فایل از برنامه\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&.
FILESYSTEM
می‌تواند یکی از موارد زیر باشد: home، host، host\-os، host\-etc، host\-root، xdg\-desktop، xdg\-documents، xdg\-download، xdg\-music، xdg\-pictures، xdg\-public\-share، xdg\-templates، xdg\-videos، یک مسیر مطلق، یا یک مسیر نسبی به پوشهٔ خانگی مانند ~/dir\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-with\-appdir\fR
.RS 4
در دسترس قرار دادن و پیکربندی دسترسی به پوشهٔ ذخیره‌سازی اختصاصی هر برنامه در
$HOME/\&.var/app\&.
این گزینه معمولاً هنگام ساخت کاربردی ندارد، اما برای آزمایش برنامه‌های ساخته‌شده مفید است\&.
.RE
.PP
\fB\-\-add\-policy=SUBSYSTEM\&.KEY=VALUE\fR
.RS 4
افزودن گزینهٔ خط‌مشی عمومی\&. برای نمونه، "\-\-add\-policy=subsystem\&.key=v1 \-\-add\-policy=subsystem\&.key=v2" به این فراداده نگاشت می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
[Policy subsystem]
key=v1;v2;
.fi
.if n \{\
.RE
.\}
.sp
این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-remove\-policy=SUBSYSTEM\&.KEY=VALUE\fR
.RS 4
حذف گزینهٔ خط‌مشی عمومی\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-env=VAR=VALUE\fR
.RS 4
تنظیم یک متغیر محیطی در برنامه\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-unset\-env=VAR\fR
.RS 4
حذف یک متغیر محیطی در برنامه\&. این گزینه ورودی unset\-environment در گروه [Context] فراداده و همچنین گروه [Environment] را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-env\-fd=\fR\fB\fIFD\fR\fR
.RS 4
خواندن متغیرهای محیطی از توصیف‌گر فایل
\fIFD\fR
و تنظیم آن‌ها به‌گونه‌ای که گویی از طریق
\fB\-\-env\fR
اعمال شده‌اند\&. از این گزینه می‌توان برای جلوگیری از مشاهده‌پذیر شدن متغیرهای محیطی و مقادیر آن‌ها برای سایر کاربران استفاده کرد\&.
.sp
هر متغیر محیطی در قالب
\fIVAR\fR=\fIVALUE\fR
به همراه یک بایت صفر در انتها است\&. این همان قالبی است که توسط
env \-0
و
/proc/*/environ
استفاده می‌شود\&.
.RE
.PP
\fB\-\-own\-name=NAME\fR
.RS 4
اجازه دادن به برنامه برای تملک نام شناخته‌شدهٔ NAME روی گذرگاه نشست (session bus)\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-talk\-name=NAME\fR
.RS 4
اجازه دادن به برنامه برای گفتگو با نام شناخته‌شدهٔ NAME روی گذرگاه نشست\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-own\-name=NAME\fR
.RS 4
اجازه دادن به برنامه برای تملک نام شناخته‌شدهٔ NAME روی گذرگاه سیستم (system bus)\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-talk\-name=NAME\fR
.RS 4
اجازه دادن به برنامه برای گفتگو با نام شناخته‌شدهٔ NAME روی گذرگاه سیستم\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-persist=FILENAME\fR
.RS 4
اگر برنامه به پوشهٔ خانگی واقعی دسترسی ندارد، مسیر (نسبی به پوشهٔ خانگی)
FILENAME
را به یک پیوند اتصالی (bind mount) به مسیر متناظر در پوشهٔ اختصاصی برنامه تبدیل می‌کند، که امکان نگهداری دائمی داده‌ها را در آن مکان فراهم می‌سازد\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-sdk\-dir=DIR\fR
.RS 4
به‌طور معمول اگر پوشه‌ای به نام
usr
در دایرکتوری ساخت وجود داشته باشد، برای فایل‌های محیط زمان‌اجرا استفاده می‌شود (این پوشه می‌تواند با آرگومان‌های
\fB\-\-writable\-sdk\fR
یا
\fB\-\-type=runtime\fR
در دستور build\-init ایجاد شده باشد)\&. اگر
\fB\-\-sdk\-dir\fR
را مشخص کنید، به‌جای آن از این پوشه استفاده خواهد شد\&. اگر در build\-init از
\fB\-\-sdk\-dir\fR
استفاده کرده‌اید، اینجا نیز از آن استفاده کنید\&.
.RE
.PP
\fB\-\-readonly\fR
.RS 4
سوار کردن دایرکتوری‌های مقصد که معمولاً قابل نوشتن هستند به‌صورت فقط‌خواندنی\&. این گزینه زمانی مفید است که می‌خواهید چیزی را درون محیط ایزوله (sandbox) اجرا کنید و مطمئن شوید که تغییری در نتایج ساخت ایجاد نمی‌کند، مانند اجرای آزمون‌ها\&.
.RE
.PP
\fB\-\-metadata=FILE\fR
.RS 4
استفاده از فایل مشخص‌شده به‌عنوان فراداده در برنامهٔ صادرشده به‌جای فایل پیش‌فرض (به نام
metadata)\&.
این گزینه زمانی مفید است که چندین مورد را از یک درخت ساخت واحد تولید می‌کنید (مانند ساخت همزمان پلتفرم و sdk)\&.
.RE
.PP
\fB\-\-log\-session\-bus\fR
.RS 4
ثبت لاگ ترافیک گذرگاه نشست (session bus)\&. این گزینه می‌تواند برای بررسی اینکه چه دسترسی‌هایی را باید در خط‌مشی D\-Bus مجاز کنید، مفید باشد\&.
.RE
.PP
\fB\-\-log\-system\-bus\fR
.RS 4
ثبت لاگ ترافیک گذرگاه سیستم (system bus)\&. این گزینه می‌تواند برای بررسی اینکه چه دسترسی‌هایی را باید در خط‌مشی D\-Bus مجاز کنید، مفید باشد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ flatpak build /build/my\-app rpmbuild my\-app\&.src\&.rpm\fR
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1),
\fBflatpak-build-init\fR(1),
\fBflatpak-build-finish\fR(1),
\fBflatpak-build-export\fR(1)