'\" t
.\"     Title: flatpak build-init
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpak build-init
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK BUILD\-INIT" "1" "" "flatpak" "flatpak build-init"
.\" -----------------------------------------------------------------
.\" * 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-init \- مقداردهی اولیه یک دایرکتوری ساخت
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ build\-init\fR\ 'u
\fBflatpak build\-init\fR [OPTION...] DIRECTORY APPNAME SDK RUNTIME [BRANCH]
.SH "توضیحات (DESCRIPTION)"
.PP
یک پوشهٔ ساخت مجزا را مقداردهی اولیه می‌کند\&.
DIRECTORY
نام این پوشه است\&.
APPNAME
شناسهٔ برنامه (application id) برای برنامه‌ای است که ساخته خواهد شد\&.
SDK
و
RUNTIME
کیت توسعه (sdk) و محیط زمان‌اجرایی (runtime) را مشخص می‌کنند که برنامه باید بر اساس آن ساخته و در آن اجرا شود\&.
BRANCH
نسخهٔ sdk و runtime را مشخص می‌کند\&.
.PP
پوشه‌ای را به‌عنوان پوشهٔ ساخت مقداردهی اولیه می‌کند که می‌تواند به‌عنوان پوشهٔ مقصد دستور
\fBflatpak build\fR
استفاده شود\&. این دستور یک فایل
metadata
درون پوشهٔ مشخص‌شده ایجاد می‌کند\&. علاوه بر این، زیرپوشه‌های خالی
files
و
var
نیز ساخته می‌شوند\&.
.PP
اجرای build\-init روی پوشه‌ای که از قبل به‌عنوان پوشهٔ ساخت مقداردهی اولیه شده باشد، منجر به خطا می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.RE
.PP
\fB\-\-arch=ARCH\fR
.RS 4
معماری مورداستفاده\&. برای مشاهدهٔ معماری‌های پشتیبانی‌شده توسط سیستم میزبان، به
\fBflatpak \-\-supported\-arches\fR
مراجعه کنید\&.
.RE
.PP
\fB\-v\fR, \fB\-\-var=RUNTIME\fR
.RS 4
مقداردهی اولیه var از محیط زمان‌اجرای نام‌برده‌شده\&.
.RE
.PP
\fB\-w\fR, \fB\-\-writable\-sdk\fR
.RS 4
مقداردهی اولیه /usr با یک نسخه از sdk، که در طول اجرای flatpak build قابل نوشتن باشد\&. اگر نیاز دارید در طول فرآیند ساخت ابزارهای ساخت را در /usr نصب کنید، از این گزینه استفاده می‌شود\&. این اطلاعات در زیرپوشهٔ
usr
پوشهٔ برنامه ذخیره می‌شود، اما بخشی از برنامهٔ نهایی نخواهد بود\&.
.RE
.PP
\fB\-\-tag=TAG\fR
.RS 4
افزودن یک برچسب (tag) به فایل فراداده\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-sdk\-extension=EXTENSION\fR
.RS 4
هنگام استفاده از
\fB\-\-writable\-sdk\fR،
علاوه بر sdk، افزونهٔ مشخص‌شده را نیز نصب می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-extension=NAME=VARIABLE[=VALUE]\fR
.RS 4
افزودن اطلاعات نقطهٔ گسترش (extension point)\&.
.RE
.PP
\fB\-\-sdk\-dir\fR
.RS 4
مشخص کردن یک زیرپوشهٔ سفارشی برای استفاده به‌جای
usr
برای گزینهٔ
\fB\-\-writable\-sdk\fR\&.
.RE
.PP
\fB\-\-update\fR
.RS 4
مقداردهی اولیه مجدد sdk و var؛ در صورت مقداردهی قبلی با خطا مواجه نمی‌شود\&.
.RE
.PP
\fB\-\-base=APP\fR
.RS 4
مقداردهی اولیه برنامه با فایل‌هایی از یک برنامهٔ مشخص‌شدهٔ دیگر\&.
.RE
.PP
\fB\-\-base\-version=VERSION\fR
.RS 4
مشخص کردن نسخهٔ مورداستفاده برای
\fB\-\-base\fR\&.
در صورت عدم تعیین، به‌طور پیش‌فرض "master" خواهد بود\&.
.RE
.PP
\fB\-\-base\-extension=EXTENSION\fR
.RS 4
هنگام استفاده از
\fB\-\-base\fR،
افزونهٔ مشخص‌شده را نیز از برنامه نصب می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-type=TYPE\fR
.RS 4
از این گزینه می‌توان برای ساخت انواع مختلف موجودیت‌ها استفاده کرد\&. مقدار پیش‌فرض "app" است که یک برنامهٔ معمولی است، اما "runtime" یک محیط زمان‌اجرا بر پایهٔ یک محیط زمان‌اجرای موجود ایجاد می‌کند، و "extension" یک افزونه برای یک برنامه یا محیط زمان‌اجرا می‌سازد\&.
.RE
.PP
\fB\-\-extension\-tag=EXTENSION_TAG\fR
.RS 4
در صورت ساخت یک افزونه، برچسبی است که هنگام جستجو برای نقطهٔ اتصال (mount point) افزونه استفاده می‌شود\&.
.RE
.PP
\fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی در طول پردازش دستور\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree در طول پردازش دستور\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ flatpak build\-init /build/my\-app org\&.example\&.myapp org\&.gnome\&.Sdk org\&.gnome\&.Platform 3\&.36\fR
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1),
\fBflatpak-build\fR(1),
\fBflatpak-build-finish\fR(1),
\fBflatpak-build-export\fR(1)