'\" t
.\"     Title: flatpak build-finish
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpak build-finish
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK BUILD\-FINIS" "1" "" "flatpak" "flatpak build-finish"
.\" -----------------------------------------------------------------
.\" * 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-finish \- نهایی‌سازی یک دایرکتوری ساخت
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ build\-finish\fR\ 'u
\fBflatpak build\-finish\fR [OPTION...] DIRECTORY
.SH "توضیحات (DESCRIPTION)"
.PP
یک پوشهٔ ساخت را نهایی می‌کند تا آن را برای صدور (export) آماده سازد\&.
DIRECTORY
نام این پوشه است\&.
.PP
نتیجهٔ این دستور آن است که فایل‌های دسکتاپ، آیکون‌ها، فایل‌های سرویس D\-Bus و فایل‌های متادیتای AppStream از زیرپوشهٔ
files
به یک زیرپوشهٔ جدید به نام
export
کپی می‌شوند\&. در فایل
metadata،
کلید command در گروه [Application] تنظیم شده و کلیدهای پشتیبانی‌شده در گروه [Environment] بر اساس گزینه‌های مشخص‌شده مقداردهی می‌شوند\&.
.PP
به‌عنوان بخشی از نهایی‌سازی، شما همچنین می‌توانید با استفاده از گزینه‌های گوناگون مشخص‌شده در زیر، مجوزهایی را که برنامه به آن‌ها نیاز دارد تعیین کنید\&. علاوه بر این، در هنگام نهایی‌سازی، مجوزهای محیط زمان‌اجرا به برنامه به ارث می‌رسد، مگر اینکه گزینهٔ
\fB\-\-no\-inherit\-permissions\fR
را مشخص کنید\&.
.PP
پیش از ایجاد و توزیع بستهٔ برنامه (application bundle)، باید فایل‌های صادرشده و فرادادهٔ برنامه را بررسی و بازبینی نمایید\&.
.PP
اجرای build\-finish روی پوشه‌ای که به‌عنوان پوشهٔ ساخت مقداردهی اولیه نشده باشد، یا از قبل نهایی شده باشد، منجر به خطا می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.RE
.PP
\fB\-\-command=COMMAND\fR
.RS 4
دستوری که باید استفاده شود\&. اگر این گزینه مشخص نشود، نخستین فایل اجرایی یافت‌شده در
files/bin
استفاده خواهد شد\&.
.sp
توجه داشته باشید که این دستور زمانی استفاده می‌شود که برنامه از طریق
\fBflatpak run\fR
اجرا شود، و بر آنچه هنگام اجرای برنامه به روش‌های دیگر (مثلاً از طریق فایل دسکتاپ یا فعال‌سازی D\-Bus) اجرا می‌شود تأثیری ندارد\&.
.RE
.PP
\fB\-\-require\-version=MAJOR\&.MINOR\&.MICRO\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\-\-share\-if=SUBSYSTEM:CONDITION\fR
.RS 4
اشتراک‌گذاری مشروط یک زیرسیستم با نشست میزبان، تنها زمانی که شرط مشخص‌شده در زمان اجرا برقرار باشد\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&.
SUBSYSTEM
باید یکی از موارد زیر باشد: network، ipc\&.
CONDITION
باید یکی از موارد زیر باشد:
\fBtrue\fR،
\fBfalse\fR،
\fBhas\-input\-device\fR،
\fBhas\-wayland\fR،
\fBhas\-usb\-device\fR،
\fBhas\-usb\-portal\fR\&.
شرط‌ها را می‌توان با
!
نقیض کرد، برای نمونه
\fB!has\-input\-device\fR\&.
این گزینه می‌تواند چندین بار استفاده شود\&. در دسترس از نسخهٔ ۱.۱۷ به بعد\&.
.sp
برای جزئیات بیشتر، بخش Conditional Permissions را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.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\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.sp
گزینهٔ fallback\-x11 سوکت X11 را تنها در صورتی در دسترس قرار می‌دهد که سوکت Wayland وجود نداشته باشد\&. این گزینه در نسخهٔ ۰.۱۱.۳ معرفی شده است\&. برای پشتیبانی از انتشار‌های قدیمی‌تر فلت‌پک، هر دو گزینهٔ x11 و fallback\-x11 را مشخص کنید\&. در صورتی که هر دو پشتیبانی شوند، گزینهٔ fallback\-x11 اولویت خواهد داشت\&.
.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\-\-socket\-if=SOCKET:CONDITION\fR
.RS 4
در دسترس قرار دادن مشروط یک سوکت شناخته‌شده برای برنامه، تنها زمانی که شرط مشخص‌شده در زمان اجرا برقرار باشد\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&. SOCKET باید یکی از موارد زیر باشد: x11، wayland، fallback\-x11، pulseaudio، system\-bus، session\-bus، ssh\-auth، pcsc، cups، gpg\-agent، inherit\-wayland\-socket\&. شرط CONDITION باید یکی از موارد زیر باشد: true، false، has\-input\-device، has\-wayland، has\-usb\-device، has\-usb\-portal\&. شرط‌ها را می‌توان با
!
نقیض کرد، برای نمونه
\fB!has\-wayland\fR\&.
این گزینه می‌تواند چندین بار استفاده شود\&. در دسترس از نسخهٔ ۱.۱۷ به بعد\&.
.sp
برای جزئیات بیشتر، بخش Conditional Permissions را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.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\-\-device\-if=DEVICE:CONDITION\fR
.RS 4
در دسترس قرار دادن مشروط یک دستگاه برای برنامه، تنها زمانی که شرط مشخص‌شده در زمان اجرا برقرار باشد\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&. DEVICE باید یکی از موارد زیر باشد: dri، input، usb، kvm، shm، all\&. شرط CONDITION باید یکی از موارد زیر باشد: true، false، has\-input\-device، has\-wayland، has\-usb\-device، has\-usb\-portal\&. شرط‌ها را می‌توان با
!
نقیض کرد، برای نمونه
\fB!has\-input\-device\fR\&.
این گزینه می‌تواند چندین بار استفاده شود\&. در دسترس از نسخهٔ ۱.۱۷ به بعد\&.
.sp
برای جزئیات بیشتر، بخش Conditional Permissions را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.RE
.PP
\fB\-\-allow=FEATURE\fR
.RS 4
اجازهٔ دسترسی به یک ویژگی خاص\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&. FEATURE باید یکی از موارد زیر باشد: devel، multiarch، bluetooth، canbus، per\-app\-dev\-shm\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.sp
ویژگی
devel
به برنامه امکان می‌دهد به فراخوان‌های سیستمی خاصی نظیر
ptrace()
و
perf_event_open()
دسترسی داشته باشد\&.
.sp
ویژگی
multiarch
به برنامه اجازه می‌دهد تا برنامه‌های کامپایل‌شده برای یک ABI غیر از آنچه به‌صورت محلی توسط سیستم پشتیبانی می‌شود را اجرا کند\&. برای نمونه، در معماری
x86_64،
فایل‌های دودویی ۳۲ بیتی
x86
نیز مجاز خواهند بود\&.
.sp
ویژگی
bluetooth
به برنامه امکان استفاده از سوکت‌های بلوتوث (AF_BLUETOOTH) را می‌دهد\&. توجه داشته باشید که برای کارکرد کامل بلوتوث باید دسترسی شبکه نیز داشته باشید\&.
.sp
ویژگی
canbus
به برنامه اجازه می‌دهد از سوکت‌های canbus (AF_CAN) استفاده کند\&. توجه داشته باشید که برای این کار باید دسترسی شبکه نیز داشته باشید\&.
.sp
ویژگی
per\-app\-dev\-shm
یک نمونهٔ واحد از
/dev/shm
را بین برنامه، هر سن‌باکس فرعی نامحدودی که ایجاد می‌کند، و سایر نمونه‌های برنامه که هم‌زمان اجرا می‌شوند به اشتراک می‌گذارد\&.
.RE
.PP
\fB\-\-disallow=FEATURE\fR
.RS 4
عدم اجازهٔ دسترسی به یک ویژگی خاص\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&. FEATURE باید یکی از موارد زیر باشد: devel، multiarch، bluetooth، canbus، per\-app\-dev\-shm\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-allow\-if=FEATURE:CONDITION\fR
.RS 4
اجازهٔ دسترسی مشروط به یک ویژگی خاص، تنها زمانی که شرط مشخص‌شده در زمان اجرا برقرار باشد\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&.
FEATURE
باید یکی از موارد زیر باشد: devel، multiarch، bluetooth\&.
CONDITION
باید یکی از موارد زیر باشد:
\fBtrue\fR،
\fBfalse\fR،
\fBhas\-input\-device\fR،
\fBhas\-wayland\fR،
\fBhas\-usb\-device\fR،
\fBhas\-usb\-portal\fR\&.
شرط‌ها را می‌توان با
!
نقیض کرد، برای نمونه
\fB!has\-input\-device\fR\&.
این گزینه می‌تواند چندین بار استفاده شود\&. در دسترس از نسخهٔ ۱.۱۷ به بعد\&.
.sp
برای جزئیات بیشتر، بخش Conditional Permissions را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.RE
.PP
\fB\-\-filesystem=FS\fR
.RS 4
اجازهٔ دسترسی برنامه به زیرمجموعه‌ای از سیستم‌فایل\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&. FS می‌تواند یکی از موارد زیر باشد: 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)
مراجعه کنید\&.
.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\-\-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\-\-usb=TYPE[:DATA]\fR
.RS 4
دستگاه‌های USB منطبق با پرس‌وجو را با افزودن آن پرس‌وجو به فرادادهٔ برنامه برای پورتال USB نمایان می‌سازد\&. این گزینه هیچ تأثیری بر دستگاه‌های نمایان‌شده در /dev ندارد\&.
TYPE
باید یکی از موارد زیر باشد: all، cls، dev، vnd\&.
.PP
\fBall\fR
.RS 4
تطبیق تمام دستگاه‌ها\&.
.RE
.PP
\fBcls\fR
.RS 4
پرس‌وجوی کلاس و زیرکلاس دستگاه\&.
DATA
باید به قالب
CLASS:SUBCLASS
باشد که در آن هر دو مقدار
CLASS
و
SUBCLASS
باید شناسه‌های عددی ۲ رقمی معتبر هگزادسیمال برای کلاس باشند\&. همچنین،
SUBCLASS
می‌تواند
*
باشد تا با تمام زیرکلاس‌ها تطبیق یابد\&.
.RE
.PP
\fBdev\fR
.RS 4
پرس‌وجوی شناسهٔ محصول (product id) دستگاه\&.
DATA
باید یک عدد شناسهٔ محصول هگزادسیمال معتبر ۴ نویسه‌ای باشد، برای نمونه
\fB0a1b\fR\&.
این گزینه به یک فیلتر
\fBvnd\fR
در پرس‌وجو نیاز دارد\&.
.RE
.PP
\fBvnd\fR
.RS 4
پرس‌وجوی شناسهٔ سازنده (vendor id) دستگاه\&.
DATA
باید یک عدد شناسهٔ سازندهٔ هگزادسیمال معتبر ۴ نویسه‌ای بزرگ‌تر از صفر باشد، برای نمونه
\fB0fab\fR\&.
.RE
.sp
امکان ترکیب چندین پرس‌وجوی دستگاه به همراه علامت
+
وجود دارد، برای نمونه
\fB\-\-usb=vnd:0123+dev:4567\fR\&.
فیلتر
dev
نیاز به یک
vnd
دارد\&. در دسترس از نسخهٔ ۱.۱۵.۱۱ به بعد\&.
.RE
.PP
\fB\-\-nousb=TYPE[:DATA]\fR
.RS 4
پنهان کردن دستگاه‌های USB منطبق با پرس‌وجو از پورتال USB با افزودن پرس‌وجو به فرادادهٔ برنامه\&. پرس‌وجوهای پنهان‌کنندهٔ دستگاه‌ها نسبت به پرس‌وجوهای نمایان‌کننده اولویت دارند (نگاه کنید به
\fB\-\-usb\fR)\&.
ساختار نگارش دقیقاً مشابه
\fB\-\-usb\fR
است\&. این گزینه هیچ تأثیری بر دستگاه‌های نمایان‌شده در /dev ندارد\&. در دسترس از نسخهٔ ۱.۱۵.۱۱ به بعد\&.
.RE
.PP
\fB\-\-usb\-list\-file=FILENAME\fR
.RS 4
افزودن پرس‌وجوهای دستگاه USB به فرادادهٔ برنامه از فایل
FILE_NAME\&.
ساختار نگارش خطوط دقیقاً معادل
\fB\-\-usb\fR
است\&. علاوه بر این، اگر خطی با ! آغاز شود، پرس‌وجو مشابه
\fB\-\-nousb\fR
خواهد بود\&. خطوطی که با
#
آغاز می‌شوند مانند یادداشت (comment) نادیده گرفته می‌شوند\&. یادداشت‌ها ذخیره نخواهند شد\&. در دسترس از نسخهٔ ۱.۱۵.۱۱ به بعد\&.
.RE
.PP
\fB\-\-usb\-list=LIST\fR
.RS 4
افزودن پرس‌وجوهای دستگاه USB به فرادادهٔ برنامه از
LIST\&.
ساختار نگارش دقیقاً معادل
\fB\-\-usb\fR
است و پرس‌وجوها با
;
از یکدیگر جدا می‌شوند\&. همچنین اگر پرس‌وجویی با
!
آغاز شود، همانند
\fB\-\-nousb\fR
خواهد بود\&. در دسترس از نسخهٔ ۱.۱۵.۱۱ به بعد\&.
.RE
.PP
\fB\-\-env=VAR=VALUE\fR
.RS 4
تنظیم یک متغیر محیطی در برنامه\&. این گزینه گروه [Environment] را در فراداده به‌روزرسانی می‌کند\&. این گزینه بخش Context فرادادهٔ برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-unset\-env=VAR\fR
.RS 4
حذف یک متغیر محیطی در برنامه\&. این گزینه ورودی unset\-environment را در گروه [Context] فراداده به‌روزرسانی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.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)\&. اگر
NAME
به \&.* ختم شود، به برنامه اجازه می‌دهد تا مالک تمام نام‌های منطبق باشد\&. این گزینه گروه [Session Bus Policy] را در فراداده به‌روزرسانی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-talk\-name=NAME\fR
.RS 4
اجازه دادن به برنامه برای گفتگو با نام شناخته‌شدهٔ
NAME
روی گذرگاه نشست\&. اگر
NAME
به \&.* ختم شود، به برنامه اجازه می‌دهد تا با تمام نام‌های منطبق گفتگو کند\&. این گزینه گروه [Session Bus Policy] را در فراداده به‌روزرسانی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-own\-name=NAME\fR
.RS 4
اجازه دادن به برنامه برای تملک نام شناخته‌شدهٔ
NAME
روی گذرگاه سیستم (system bus)\&. اگر
NAME
به \&.* ختم شود، به برنامه اجازه می‌دهد تا مالک تمام نام‌های منطبق باشد\&. این گزینه گروه [System Bus Policy] را در فراداده به‌روزرسانی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-talk\-name=NAME\fR
.RS 4
اجازه دادن به برنامه برای گفتگو با نام شناخته‌شدهٔ
NAME
روی گذرگاه سیستم\&. اگر
NAME
به \&.* ختم شود، به برنامه اجازه می‌دهد تا با تمام نام‌های منطبق گفتگو کند\&. این گزینه گروه [System Bus Policy] را در فراداده به‌روزرسانی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-persist=FILENAME\fR
.RS 4
اگر برنامه به پوشهٔ خانگی واقعی دسترسی ندارد، مسیر (نسبی به پوشهٔ خانگی)
FILENAME
را به یک پیوند اتصالی (bind mount) به مسیر متناظر در پوشهٔ اختصاصی برنامه تبدیل می‌کند، که امکان استفاده از آن مکان را برای نگهداری داده‌های پایدار فراهم می‌سازد\&. این گزینه گروه [Context] را در فراداده به‌روزرسانی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-runtime=RUNTIME\fR, \fB\-\-sdk=SDK\fR
.RS 4
تغییر محیط زمان‌اجرا یا sdk مورداستفاده توسط برنامه به مرجع جزئی (partial ref) مشخص‌شده\&. بخش‌های تعیین‌نشده از مرجع، از مقادیر پیشین یا مقادیر پیش‌فرض گرفته می‌شوند\&.
.RE
.PP
\fB\-\-metadata=GROUP=KEY[=VALUE]\fR
.RS 4
تنظیم یک کلید عمومی در فایل فراداده\&. در صورت حذف مقدار، مقدار "true" تنظیم خواهد شد\&.
.RE
.PP
\fB\-\-extension=NAME=VARIABLE[=VALUE]\fR
.RS 4
افزودن اطلاعات نقطهٔ گسترش (extension point)\&. برای مقادیر ممکن
\fIVARIABLE\fR
و
\fIVALUE\fR،
مستندات
\fBflatpak-metadata\fR(5)
را ببینید\&.
.RE
.PP
\fB\-\-remove\-extension=NAME\fR
.RS 4
حذف اطلاعات نقطهٔ گسترش\&.
.RE
.PP
\fB\-\-extension\-priority=VALUE\fR
.RS 4
تنظیم اولویت (ترتیب بازنویسی کتابخانه) نقطهٔ گسترش\&. تنها برای افزونه‌ها کاربرد دارد\&. مقدار ۰ پیش‌فرض است، و مقدار بالاتر به معنای اولویت بیشتر خواهد بود\&.
.RE
.PP
\fB\-\-extra\-data=NAME:SHA256:DOWNLOAD\-SIZE:INSTALL\-SIZE:URL\fR
.RS 4
افزودن اطلاعات نشانی‌های داده‌های اضافی به برنامه\&. این داده‌ها هنگام نصب برنامه توسط کلاینت بارگیری و اعتبارسنجی شده و در پوشهٔ
/app/extra
قرار می‌گیرند\&. همچنین می‌توانید یک اسکریپت
/app/bin/apply_extra
ارائه دهید که پس از بارگیری فایل‌ها اجرا خواهد شد\&.
.RE
.PP
\fB\-\-no\-exports\fR
.RS 4
عدم جستجو برای موارد صادراتی (exports) در ساخت\&.
.RE
.PP
\fB\-\-no\-inherit\-permissions\fR
.RS 4
عدم ارث‌بری مجوزهای محیط زمان‌اجرا در برنامه\&.
.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\-finish /build/my\-app \-\-socket=x11 \-\-share=ipc \-\-usb=vnd:0fd9\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Exporting share/applications/gnome\-calculator\&.desktop
Exporting share/dbus\-1/services/org\&.gnome\&.Calculator\&.SearchProvider\&.service
More than one executable
Using gcalccmd as command
Please review the exported files and the metadata
.fi
.if n \{\
.RE
.\}
.PP
\fB$ flatpak build\-finish /build/my\-app \-\-socket=wayland \-\-socket\-if=x11:!has\-wayland \-\-share=ipc\fR
.PP
این دستور دسترسی Wayland را به‌صورت بدون قید و شرط اعطا می‌کند و دسترسی X11 را تنها زمانی می‌دهد که نشست در حالت Wayland اجرا نشود؛ این کار به برنامه امکان می‌دهد در صورت نیاز به X11 بازگردد (fall back)\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1),
\fBflatpak-build-init\fR(1),
\fBflatpak-build\fR(1),
\fBflatpak-build-export\fR(1)