'\" t
.\"     Title: flatpak build-bundle
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/27/2026
.\"    Manual: flatpak build-bundle
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK BUILD\-BUNDL" "1" "" "flatpak" "flatpak build-bundle"
.\" -----------------------------------------------------------------
.\" * 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-bundle \- ایجاد یک بستهٔ تک‌فایلی (باندل) از یک مخزن محلی
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ build\-bundle\fR\ 'u
\fBflatpak build\-bundle\fR [OPTION...] LOCATION FILENAME NAME [BRANCH]
.SH "توضیحات (DESCRIPTION)"
.PP
یک فایل تکی به نام
FILENAME
برای برنامهٔ کاربردی (یا محیط زمان اجرای) به نام
NAME
در مخزن واقع در
LOCATION
ایجاد می‌کند\&. اگر یک
BRANCH
مشخص شده باشد، این شاخه از برنامهٔ کاربردی استفاده می‌شود\&.
.PP
شناسهٔ مجموعه (collection ID) تنظیم‌شده روی مخزن در
LOCATION
(در صورت تنظیم بودن) برای این باندل استفاده خواهد شد\&.
.PP
مگر اینکه از
\fB\-\-oci\fR
استفاده شود، قالب فایل باندل به‌صورت یک دلتای ایستا (static delta) از ostree (در برابر یک پایهٔ خالی) همراه با برخی فراداده‌های مخصوص flatpak برای آیکون‌های برنامه و appdata خواهد بود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.RE
.PP
\fB\-\-runtime\fR
.RS 4
صادر کردن یک محیط زمان اجرا به جای یک برنامهٔ کاربردی\&.
.RE
.PP
\fB\-\-arch=ARCH\fR
.RS 4
معماری مورد نظر برای ایجاد باندل\&. برای مشاهدهٔ معماری‌های پشتیبانی‌شده توسط میزبان،
\fBflatpak \-\-supported\-arches\fR
را ببینید\&.
.RE
.PP
\fB\-\-repo\-url=URL\fR
.RS 4
نشانی اینترنتی (URL) مخزنی که برنامه می‌تواند از آن به‌روزرسانی شود\&. نصب باندل به‌طور خودکار یک مخزن دوردست (remote) را برای این URL پیکربندی می‌کند\&.
.RE
.PP
\fB\-\-runtime\-repo=URL\fR
.RS 4
نشانی اینترنتی (URL) یک فایل
\&.flatpakrepo
که حاوی اطلاعات مربوط به مخزنی است که محیط‌های زمان اجرای مورد نیاز برنامه را تأمین می‌کند\&.
.RE
.PP
\fB\-\-gpg\-keys=FILE\fR
.RS 4
افزودن کلید GPG از
FILE
(از \- برای stdin استفاده کنید)\&.
.RE
.PP
\fB\-\-gpg\-homedir=PATH\fR
.RS 4
دایرکتوری خانگی GPG (مسیر Homedir) برای استفاده هنگام جستجوی دسته‌کلیدها (keyrings)\&.
.RE
.PP
\fB\-\-from\-commit=COMMIT\fR
.RS 4
کامیت OSTree که باید باندل دلتا از آن ساخته شود\&.
.RE
.PP
\fB\-\-oci\fR
.RS 4
صادر کردن به یک ایمیج OCI به‌جای باندل Flatpak\&.
.RE
.PP
\fB\-\-oci\-layer\-compress=gzip|zstd\fR
.RS 4
انتخاب نحوهٔ فشرده‌سازی لایه‌ها در ایمیج‌های OCI\&. فرمت gzip (پیش‌فرض) به‌طور همگانی پشتیبانی می‌شود، اما zstd سریع‌تر فشرده‌سازی می‌کند و به ایمیج‌های کوچک‌تری منجر می‌شود\&. از سال ۲۰۲۳، پشتیبانی از zstd در بیشتر رجیستری‌های بزرگ فراهم است\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی در طول پردازش دستور\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree در طول پردازش دستور\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
\fB$ flatpak build\-bundle /var/lib/flatpak/repo gnome\-calculator\&.flatpak org\&.gnome\&.Calculator stable\fR
.fi
.PP
.nf
\fB$ flatpak build\-bundle ~/\&.local/share/flatpak/repo gnome\-calculator\&.flatpak org\&.gnome\&.Calculator stable\fR
.fi
.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\-import\-bundle\fR(1),
\fBflatpak\-build\-update\-repo\fR(1)