.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JPACKAGE" "1" "2026" "JDK 26.0.2.1" "JDK Commands"
.SH "نام (NAME)"
jpackage \- ابزار بسته‌بندی برنامه‌های مستقل جاوا در قالب بسته‌های نصبی (نسخه ۲۶)
.SH "خلاصه دستور (SYNOPSIS)"
\f[CR]jpackage\f[R] [\f[I]گزینه‌ها\f[R]]
.TP
\f[I]گزینه‌ها\f[R]
گزینه‌های خط فرمان که با فاصله از یکدیگر جدا شده‌اند.
بخش \f[B]گزینه‌های jpackage\f[R] را ببینید.
.SH "توضیحات (DESCRIPTION)"
ابزار \f[CR]jpackage\f[R] یک برنامه جاوا و یک ایمیج زمان اجرای جاوا را به عنوان ورودی دریافت کرده و یک ایمیج برنامه جاوا شامل تمام وابستگی‌های لازم تولید می‌کند.
این ابزار قادر به تولید بسته بومی در قالب‌های مخصوص هر پلتفرم، مانند exe در ویندوز یا dmg در macOS است.
هر قالب باید روی همان پلتفرمی که اجرا می‌شود ساخته شود؛ هیچ پشتیبانی بین‌پلتفرمی (cross-platform) وجود ندارد.
این ابزار دارای گزینه‌هایی است که امکان سفارشی‌سازی برنامه‌های بسته‌بندی‌شده را به روش‌های مختلف فراهم می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های عمومی:"
.TP
\f[CR]\(at\f[R]\f[I]filename\f[R]
خواندن گزینه‌ها از یک فایل.
.RS
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[CR]\-\-type\f[R] یا \f[CR]\-t\f[R] \f[I]type\f[R]
نوع بسته‌ای که باید ایجاد شود
.RS
مقادیر معتبر عبارتند از: {\(dqapp\-image\(dq, \(dqexe\(dq, \(dqmsi\(dq, \(dqrpm\(dq, \(dqdeb\(dq, \(dqpkg\(dq, \(dqdmg\(dq}
اگر این گزینه مشخص نشود، نوع پیش‌فرض وابسته به پلتفرم ایجاد خواهد شد.
.RE
.TP
\f[CR]\-\-app\-version\f[R] \f[I]version\f[R]
نسخه برنامه و/یا بسته
.TP
\f[CR]\-\-copyright\f[R] \f[I]copyright\f[R]
حق نشر (کپی‌رایت) برنامه
.TP
\f[CR]\-\-description\f[R] \f[I]description\f[R]
توضیحات برنامه
.TP
\f[CR]\-\-help\f[R] یا \f[CR]\-h\f[R]
چاپ متن راهنمای استفاده همراه با فهرست و توضیحات هر گزینه معتبر برای پلتفرم جاری در جریان خروجی و سپس خروج.
.TP
\f[CR]\-\-icon\f[R] \f[I]path\f[R]
مسیر آیکون بسته برنامه
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.RE
.TP
\f[CR]\-\-name\f[R] یا \f[CR]\-n\f[R] \f[I]name\f[R]
نام برنامه و/یا بسته
.TP
\f[CR]\-\-dest\f[R] یا \f[CR]\-d\f[R] \f[I]destination\f[R]
مسیری که فایل خروجی تولیدشده در آن قرار می‌گیرد
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری).
.PP
به‌طور پیش‌فرض دایرکتوری کاری جاری است.
.RE
.TP
\f[CR]\-\-resource\-dir\f[R] \f[I]path\f[R]
مسیر برای بازنویسی منابع jpackage
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
آیکون‌ها، فایل‌های الگو و سایر منابع jpackage را می‌توان با افزودن منابع جایگزین به این دایرکتوری بازنویسی کرد.
.RE
.TP
\f[CR]\-\-temp\f[R] \f[I]directory\f[R]
مسیر یک دایرکتوری جدید یا خالی برای ایجاد فایل‌های موقت
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
در صورت تعیین، دایرکتوری موقت پس از اتمام کار حذف نخواهد شد و باید به‌صورت دستی حذف شود.
.PP
در صورت عدم تعیین، یک دایرکتوری موقت ایجاد شده و پس از اتمام کار حذف خواهد شد.
.RE
.TP
\f[CR]\-\-vendor\f[R] \f[I]vendor\f[R]
ارائه‌دهنده (سازنده) برنامه
.TP
\f[CR]\-\-verbose\f[R]
فعال‌سازی خروجی با جزئیات کامل.
.TP
\f[CR]\-\-version\f[R]
چاپ نسخه محصول در جریان خروجی و سپس خروج.
.SS "گزینه‌های ایجاد ایمیج زمان اجرا:"
.TP
\f[CR]\-\-add\-modules\f[R] \f[I]module\-name\f[R] [\f[CR],\f[R]\f[I]module\-name\f[R]...]
فهرستی از ماژول‌ها برای افزودن که با کاما (\(dq,\(dq) از هم جدا شده‌اند
.RS
.PP
این فهرست ماژول‌ها، همراه با ماژول اصلی (در صورت تعیین)، به عنوان آرگومان \-\-add\-module به jlink ارسال می‌شوند.
اگر تعیین نشود، یا فقط ماژول اصلی (اگر \-\-module تعیین شده باشد) یا مجموعه پیش‌فرض ماژول‌ها (اگر \-\-main\-jar تعیین شده باشد) استفاده می‌شود.
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[CR]\-\-module\-path\f[R] یا \f[CR]\-p\f[R] \f[I]module\-path\f[R] [\f[CR],\f[R]\f[I]module\-path\f[R]...]
فهرستی از مسیرها که با File.pathSeparator از هم جدا شده‌اند
.RS
.PP
هر مسیر یا دایرکتوری ماژول‌ها است یا مسیر به یک فایل jar ماژولار، و می‌تواند مطلق یا نسبی نسبت به دایرکتوری جاری باشد.
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[CR]\-\-jlink\-options\f[R] \f[I]options\f[R]
فهرستی از گزینه‌ها که با فاصله از هم جدا شده‌اند تا به jlink ارسال شوند
.RS
.PP
در صورت عدم تعیین، مقدار پیش‌فرض آن \(dq\-\-strip\-native\-commands \-\-strip\-debug \-\-no\-man\-pages \-\-no\-header\-files\(dq است.
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[CR]\-\-runtime\-image\f[R] \f[I]directory\f[R]
مسیر ایمیج زمان اجرای از پیش تعریف‌شده که در ایمیج برنامه کپی خواهد شد
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
اگر \-\-runtime\-image مشخص نشود، jpackage ابزار jlink را برای ایجاد ایمیج زمان اجرا با استفاده از گزینه‌های تعیین‌شده توسط \-\-jlink\-options اجرا می‌کند.
.RE
.SS "گزینه‌های ایجاد ایمیج برنامه:"
.TP
\f[CR]\-\-input\f[R] یا \f[CR]\-i\f[R] \f[I]directory\f[R]
مسیر دایرکتوری ورودی که حاوی فایل‌های مورد نظر برای بسته‌بندی است
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
تمام فایل‌های موجود در دایرکتوری ورودی در ایمیج برنامه بسته‌بندی خواهند شد.
.RE
.TP
\f[CR]\-\-app\-content\f[R] \f[I]additional\-content\f[R] [\f[CR],\f[R]\f[I]additional\-content\f[R]...]
فهرستی از مسیرها به فایل‌ها و/یا دایرکتوری‌ها که با کاما از هم جدا شده‌اند تا به محتوای اصلی برنامه اضافه شوند.
.RS
.PP
از این گزینه می‌توان بیش از یک بار استفاده کرد.
.PP
نکته macOS: مقدار باید دایرکتوری با زیردایرکتوری \(dqResources\(dq باشد (یا هر دایرکتوری معتبر دیگر در دایرکتوری \(dqContents\(dq بسته برنامه).
در غیر این صورت، jpackage ممکن است بسته برنامه نامعتبر تولید کند که در امضای کد و/یا اعتبارسنجی (notarization) ناموفق باشد.
.RE
.SS "گزینه‌های ایجاد راه‌انداز(های) برنامه:"
.TP
\f[CR]\-\-add\-launcher\f[R] \f[I]name\f[R]=\f[I]path\f[R]
نام راه‌انداز و مسیر یک فایل Properties که شامل فهرستی از جفت‌های کلید و مقدار است
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
کلیدهای \(dqmodule\(dq, \(dqmain\-jar\(dq, \(dqmain\-class\(dq, \(dqdescription\(dq, \(dqarguments\(dq, \(dqjava\-options\(dq, \(dqicon\(dq, \(dqlauncher\-as\-service\(dq, \(dqwin\-console\(dq, \(dqwin\-shortcut\(dq, \(dqwin\-menu\(dq و \(dqlinux\-shortcut\(dq قابل استفاده هستند.
.PP
این گزینه‌ها برای ساخت یک راه‌انداز جایگزین اضافی، به گزینه‌های اصلی خط فرمان اضافه شده یا برای بازنویسی آن‌ها استفاده می‌شوند.
راه‌انداز اصلی برنامه از روی گزینه‌های خط فرمان ساخته خواهد شد.
راه‌اندازهای جایگزین اضافی را می‌توان با استفاده از این گزینه ساخت، و از این گزینه می‌توان چندین بار برای ساخت چندین راه‌انداز اضافی استفاده کرد.
.RE
.TP
\f[CR]\-\-arguments\f[R] \f[I]arguments\f[R]
آرگومان‌های خط فرمان برای ارسال به کلاس اصلی در صورتی که هیچ آرگومان خط فرمانی به راه‌انداز داده نشود
.RS
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.PP
مقدار می‌تواند شامل زیررشته‌هایی باشد که در زمان اجرا بسط داده می‌شوند.
دو نوع از چنین زیررشته‌هایی پشتیبانی می‌شوند: متغیرهای محیطی و توکن‌های \(dqAPPDIR\(dq, \(dqBINDIR\(dq و \(dqROOTDIR\(dq.
.PP
یک زیررشته قابل بسط باید بین نویسه علامت دلار ($) و اولین نویسه غیرحرفی-عددی پس از آن قرار گیرد.
یا اینکه می‌تواند بین زیررشته‌های \(dq${\(dq و \(dq}\(dq محصور شود.
.PP
زیررشته‌های قابل بسط در یونیکس حساس به حروف بزرگ و کوچک و در ویندوز غیرحساس به حروف هستند.
اگر متغیر محیطی ارجاع داده شده تعریف نشده باشد، هیچ بسط رشته‌ای رخ نمی‌دهد.
.PP
متغیرهای محیطی با نام‌های \(dqAPPDIR\(dq, \(dqBINDIR\(dq و \(dqROOTDIR\(dq نادیده گرفته می‌شوند و این زیررشته‌های قابل بسط با مقادیر محاسبه‌شده توسط راه‌انداز برنامه جایگزین خواهند شد.
.PP
برای جلوگیری از بسط زیررشته، نویسه علامت دلار را با نویسه بک‌اسلش (\(rs) پیشوندگذاری کنید.
.RE
.TP
\f[CR]\-\-java\-options\f[R] \f[I]options\f[R]
گزینه‌هایی برای ارسال به زمان اجرای جاوا
.RS
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.PP
مقدار می‌تواند شامل زیررشته‌هایی باشد که در زمان اجرا جایگزین می‌شوند، همانند گزینه \-\-arguments.
.RE
.TP
\f[CR]\-\-main\-class\f[R] \f[I]class\-name\f[R]
نام کامل (Qualified name) کلاس اصلی برنامه برای اجرا
.RS
.PP
این گزینه فقط در صورتی قابل استفاده است که \-\-main\-jar تعیین شده باشد.
.RE
.TP
\f[CR]\-\-main\-jar\f[R] \f[I]main\-jar\f[R]
فایل JAR اصلی برنامه؛ حاوی کلاس اصلی (به‌صورت یک مسیر نسبی نسبت به مسیر ورودی مشخص می‌شود)
.RS
.PP
تنها یکی از گزینه‌های \-\-module یا \-\-main\-jar قابل تعیین است و نمی‌توان هر دو را همزمان مشخص کرد.
.RE
.TP
\f[CR]\-\-module\f[R] یا \f[CR]\-m\f[R] \f[I]module\-name\f[R][/\f[I]main\-class\f[R]]
ماژول اصلی (و به صورت اختیاری کلاس اصلی) برنامه
.RS
.PP
این ماژول باید در مسیر ماژول (module path) قرار داشته باشد.
.PP
هنگامی که این گزینه تعیین شود، ماژول اصلی در ایمیج زمان اجرای جاوا پیوند داده خواهد شد.
تنها یکی از گزینه‌های \-\-module یا \-\-main\-jar قابل تعیین است و نمی‌توان هر دو را همزمان مشخص کرد.
.RE
.SS "گزینه‌های وابسته به پلتفرم برای ایجاد راه‌انداز برنامه:"
.SS "گزینه‌های پلتفرم ویندوز (فقط هنگام اجرا در ویندوز موجود است):"
.TP
\f[CR]\-\-win\-console\f[R]
ایجاد یک راه‌انداز کنسولی برای برنامه؛ باید برای برنامه‌ای که به تعاملات کنسول نیاز دارد تعیین شود
.SS "گزینه‌های پلتفرم macOS (فقط هنگام اجرا در macOS موجود است):"
.TP
\f[CR]\-\-mac\-package\-identifier\f[R] \f[I]identifier\f[R]
شناسه‌ای که برنامه را به طور یکتا برای macOS مشخص می‌کند
.RS
.PP
به‌طور پیش‌فرض نام کلاس اصلی است.
.PP
تنها می‌تواند از نویسه‌های حرفی-عددی (A\-Z,a\-z,0\-9)، خط تیره (\-) و نقطه (.) استفاده کند.
.RE
.TP
\f[CR]\-\-mac\-package\-name\f[R] \f[I]name\f[R]
نام برنامه به همان شکلی که در نوار منو ظاهر می‌شود
.RS
.PP
این نام می‌تواند با نام برنامه متفاوت باشد.
.PP
این نام باید کمتر از ۱۶ نویسه طول داشته باشد و برای نمایش در نوار منو و پنجره اطلاعات برنامه مناسب باشد.
به‌طور پیش‌فرض نام برنامه است.
.RE
.TP
\f[CR]\-\-mac\-package\-signing\-prefix\f[R] \f[I]prefix\f[R]
هنگام امضای بسته برنامه، این مقدار به تمام مؤلفه‌هایی که نیاز به امضا دارند و فاقد شناسه بسته موجود هستند، پیشوند می‌شود.
.TP
\f[CR]\-\-mac\-sign\f[R]
درخواست برای امضا شدن بسته یا ایمیج برنامه از پیش تعریف‌شده.
.TP
\f[CR]\-\-mac\-signing\-keychain\f[R] \f[I]keychain\-name\f[R]
نام keychain برای جستجوی هویت امضاکننده
.RS
.PP
در صورت عدم تعیین، از keychainهای استاندارد استفاده می‌شود.
.RE
.TP
\f[CR]\-\-mac\-signing\-key\-user\-name\f[R] \f[I]name\f[R]
بخش نام تیم یا نام کاربر در هویت‌های امضای اپل
.TP
\f[CR]\-\-mac\-app\-store\f[R]
نشان می‌دهد که خروجی jpackage برای Mac App Store در نظر گرفته شده است.
.TP
\f[CR]\-\-mac\-entitlements\f[R] \f[I]path\f[R]
مسیر فایل حاوی مجوزها (entitlements) برای استفاده در هنگام امضای فایل‌های اجرایی و کتابخانه‌ها در بسته
.TP
\f[CR]\-\-mac\-app\-category\f[R] \f[I]category\f[R]
رشته مورد استفاده برای ساخت LSApplicationCategoryType در plist برنامه
.RS
.PP
مقدار پیش‌فرض \(dqutilities\(dq است.
.RE
.SS "گزینه‌های ایجاد بسته برنامه:"
.TP
\f[CR]\-\-about\-url\f[R] \f[I]url\f[R]
نشانی اینترنتی (URL) صفحه اصلی برنامه
.TP
\f[CR]\-\-app\-image\f[R] \f[I]directory\f[R]
محل ایمیج از پیش تعریف‌شده برنامه که برای ساخت یک بسته قابل نصب (در همه پلتفرم‌ها) یا برای امضا شدن (در macOS) استفاده می‌شود
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.RE
.TP
\f[CR]\-\-file\-associations\f[R] \f[I]path\f[R]
مسیر یک فایل Properties که شامل فهرستی از جفت‌های کلید و مقدار است
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
کلیدهای \(dqextension\(dq, \(dqmime\-type\(dq, \(dqicon\(dq و \(dqdescription\(dq را می‌توان برای توصیف وابستگی فایل به کار برد.
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[CR]\-\-install\-dir\f[R] \f[I]path\f[R]
مسیر مطلق دایرکتوری نصب برنامه (در macOS یا لینوکس)، یا زیرمسیر نسبی دایرکتوری نصب مانند \(dqProgram Files\(dq یا \(dqAppData\(dq (در ویندوز)
.TP
\f[CR]\-\-license\-file\f[R] \f[I]path\f[R]
مسیر فایل مجوز (لایسنس)
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.RE
.TP
\f[CR]\-\-runtime\-image\f[R] \f[I]path\f[R]
مسیر ایمیج زمان اجرای از پیش تعریف‌شده برای نصب
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
هنگام ایجاد یک نصب‌کننده زمان اجرا، این گزینه الزامی است.
.RE
.TP
\f[CR]\-\-launcher\-as\-service\f[R]
درخواست ایجاد یک نصب‌کننده که راه‌انداز اصلی برنامه را به عنوان یک برنامه از نوع سرویس پس‌زمینه ثبت کند.
.SS "گزینه‌های وابسته به پلتفرم برای ایجاد بسته برنامه:"
.SS "گزینه‌های پلتفرم ویندوز (فقط هنگام اجرا در ویندوز موجود است):"
.TP
\f[CR]\-\-win\-dir\-chooser\f[R]
افزودن یک کادر محاوره‌ای برای فعال کردن امکان انتخاب دایرکتوری نصب محصول توسط کاربر.
.TP
\f[CR]\-\-win\-help\-url\f[R] \f[I]url\f[R]
نشانی اینترنتی (URL) که کاربر می‌تواند اطلاعات بیشتر یا پشتیبانی فنی دریافت کند
.TP
\f[CR]\-\-win\-menu\f[R]
درخواست افزودن میانبر منوی شروع (Start Menu) برای این برنامه
.TP
\f[CR]\-\-win\-menu\-group\f[R] \f[I]menu\-group\-name\f[R]
گروه منوی شروع که این برنامه در آن قرار می‌گیرد
.TP
\f[CR]\-\-win\-per\-user\-install\f[R]
درخواست انجام نصب بر پایه هر کاربر (per\-user)
.TP
\f[CR]\-\-win\-shortcut\f[R]
درخواست ایجاد میانبر دسکتاپ برای این برنامه
.TP
\f[CR]\-\-win\-shortcut\-prompt\f[R]
افزودن یک کادر محاوره‌ای تا کاربر بتواند انتخاب کند که آیا میانبرها توسط نصب‌کننده ایجاد شوند یا خیر
.TP
\f[CR]\-\-win\-update\-url\f[R] \f[I]url\f[R]
نشانی اینترنتی (URL) اطلاعات به‌روزرسانی موجود برای برنامه
.TP
\f[CR]\-\-win\-upgrade\-uuid\f[R] \f[I]id\f[R]
شناسه UUID مرتبط با ارتقاهای این بسته
.SS "گزینه‌های پلتفرم لینوکس (فقط هنگام اجرا در لینوکس موجود است):"
.TP
\f[CR]\-\-linux\-package\-name\f[R] \f[I]name\f[R]
نام بسته لینوکس
.RS
.PP
به‌طور پیش‌فرض نام برنامه است.
.RE
.TP
\f[CR]\-\-linux\-deb\-maintainer\f[R] \f[I]email\-address\f[R]
نگه‌دارنده بسته ‎.deb
.TP
\f[CR]\-\-linux\-menu\-group\f[R] \f[I]menu\-group\-name\f[R]
گروه منو که این برنامه در آن قرار می‌گیرد
.TP
\f[CR]\-\-linux\-package\-deps\f[R] \f[I]package\-dep\-string\f[R]
بسته‌ها یا قابلیت‌های مورد نیاز برای برنامه
.TP
\f[CR]\-\-linux\-rpm\-license\-type\f[R] \f[I]type\f[R]
نوع مجوز (مقدار \(dqLicense: \f[I]value\f[R]\(dq در فایل ‎.spec بسته RPM)
.TP
\f[CR]\-\-linux\-app\-release\f[R] \f[I]release\f[R]
مقدار انتشار در فایل <name>.spec بسته RPM یا مقدار بازنگری دبیان در فایل کنترل DEB
.TP
\f[CR]\-\-linux\-app\-category\f[R] \f[I]category\-value\f[R]
مقدار Group در فایل <name>.spec بسته RPM یا مقدار Section در فایل کنترل DEB
.TP
\f[CR]\-\-linux\-shortcut\f[R]
ایجاد یک میانبر برای برنامه.
.SS "گزینه‌های پلتفرم macOS (فقط هنگام اجرا در macOS موجود است):"
.TP
\f[CR]\-\-mac\-dmg\-content\f[R] \f[I]additional\-content\f[R] [\f[CR],\f[R]\f[I]additional\-content\f[R]...]
گنجاندن تمام محتوای ارجاع‌شده در فایل dmg.
.RS
.PP
از این گزینه می‌توان بیش از یک بار استفاده کرد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.IP
.EX
تولید یک بسته برنامه مناسب برای سیستم میزبان:
.EE
.IP
.EX
برای یک برنامه ماژولار:
    jpackage \-n name \-p modulePath \-m moduleName/className
برای یک برنامه غیرماژولار:
    jpackage \-i inputDir \-n name \(rs
        \-\-main\-class className \-\-main\-jar myJar.jar
از روی ایمیج برنامه از پیش ساخته‌شده:
    jpackage \-n name \-\-app\-image appImageDir
.EE
.IP
.EX
تولید یک ایمیج برنامه:
.EE
.IP
.EX
برای یک برنامه ماژولار:
    jpackage \-\-type app\-image \-n name \-p modulePath \(rs
        \-m moduleName/className
برای یک برنامه غیرماژولار:
    jpackage \-\-type app\-image \-i inputDir \-n name \(rs
        \-\-main\-class className \-\-main\-jar myJar.jar
برای ارسال گزینه‌های سفارشی خود به jlink، ابزار jlink را جداگانه اجرا کنید:
    jlink \-\-output appRuntimeImage \-p modulePath \(rs
        \-\-add\-modules moduleName \(rs
        \-\-no\-header\-files [<گزینه‌های اضافی jlink>...]
    jpackage \-\-type app\-image \-n name \(rs
        \-m moduleName/className \-\-runtime\-image appRuntimeImage
.EE
.IP
.EX
تولید یک بسته زمان اجرای جاوا:
.EE
.IP
.EX
jpackage \-n name \-\-runtime\-image <runtime\-image>
.EE
.IP
.EX
امضای ایمیج از پیش تعریف‌شده برنامه (در macOS):
.EE
.IP
.EX
jpackage \-\-type app\-image \-\-app\-image <app\-image> \(rs
    \-\-mac\-sign [<گزینه‌های اضافی امضا>...]

نکته: تنها گزینه‌های اضافی مجاز در این حالت عبارتند از:
      مجموعه گزینه‌های اضافی امضای مک و \-\-verbose
.EE
.SH "JPACKAGE و JLINK"
ابزار jpackage از jlink برای ایجاد زمان اجرای جاوا استفاده خواهد کرد، مگر اینکه از گزینه \f[CR]\-\-runtime\-image\f[R] استفاده شود.
ایمیج زمان اجرای جاوای ایجادشده در ویندوز شامل کتابخانه‌های زمان اجرای MS همراه با JDK خواهد بود.
اگر برای برنامه به نسخه متفاوتی از کتابخانه‌های زمان اجرای MS نیاز باشد، کاربر باید خودش آن‌ها را اضافه/جایگزین کند.
.SH "پوشه منابع JPACKAGE"
آیکون‌ها، فایل‌های الگو و سایر منابع jpackage را می‌توان با افزودن منابع جایگزین به این دایرکتوری بازنویسی کرد.
ابزار jpackage فایل‌ها را با نام‌های مشخص در دایرکتوری منابع جستجو خواهد کرد.
.SS "فایل‌های دایرکتوری منابع که فقط هنگام اجرا در لینوکس بررسی می‌شوند:"
.TP
\f[CR]<launcher\-name>.png\f[R]
آیکون راه‌انداز برنامه
.RS
.PP
منبع پیش‌فرض \f[I]JavaApp.png\f[R] است
.RE
.TP
\f[CR]<launcher\-name>.desktop\f[R]
یک فایل دسکتاپ برای استفاده با دستور \f[CR]xdg\-desktop\-menu\f[R]
.RS
.PP
برای راه‌اندازهای برنامه‌ای که برای وابستگی فایل ثبت شده‌اند و/یا آیکون دارند بررسی می‌شود
.PP
منبع پیش‌فرض \f[I]template.desktop\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام ساخت بسته‌بند DEB/RPM لینوکس بررسی می‌شوند:"
.TP
\f[CR]<package\-name>\-<launcher\-name>.service\f[R]
فایل واحد systemd برای راه‌انداز برنامه‌ای که به عنوان یک برنامه از نوع سرویس پس‌زمینه ثبت شده است
.RS
.PP
منبع پیش‌فرض \f[I]unit\-template.service\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام ساخت بسته‌بند RPM لینوکس بررسی می‌شوند:"
.TP
\f[CR]<package\-name>.spec\f[R]
فایل spec برای RPM
.RS
.PP
منبع پیش‌فرض \f[I]template.spec\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام ساخت بسته‌بند DEB لینوکس بررسی می‌شوند:"
.TP
\f[CR]control\f[R]
فایل کنترل (control)
.RS
.PP
منبع پیش‌فرض \f[I]template.control\f[R] است
.RE
.TP
\f[CR]copyright\f[R]
فایل حق نشر (copyright)
.RS
.PP
منبع پیش‌فرض \f[I]template.copyright\f[R] است
.RE
.TP
\f[CR]preinstall\f[R]
اسکریپت پوسته پیش از نصب (pre\-install)
.RS
.PP
منبع پیش‌فرض \f[I]template.preinstall\f[R] است
.RE
.TP
\f[CR]prerm\f[R]
اسکریپت پوسته پیش از حذف (pre\-remove)
.RS
.PP
منبع پیش‌فرض \f[I]template.prerm\f[R] است
.RE
.TP
\f[CR]postinstall\f[R]
اسکریپت پوسته پس از نصب (post\-install)
.RS
.PP
منبع پیش‌فرض \f[I]template.postinstall\f[R] است
.RE
.TP
\f[CR]postrm\f[R]
اسکریپت پوسته پس از حذف (post\-remove)
.RS
.PP
منبع پیش‌فرض \f[I]template.postrm\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام اجرا در ویندوز بررسی می‌شوند:"
.TP
\f[CR]<launcher\-name>.ico\f[R]
آیکون راه‌انداز برنامه
.RS
.PP
منبع پیش‌فرض \f[I]JavaApp.ico\f[R] است
.RE
.TP
\f[CR]<launcher\-name>.properties\f[R]
فایل Properties برای فایل اجرایی راه‌انداز برنامه
.RS
.PP
منبع پیش‌فرض \f[I]WinLauncher.template\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام ساخت بسته‌بند MSI/EXE ویندوز بررسی می‌شوند:"
.TP
\f[CR]<application\-name>\-post\-image.wsf\f[R]
یک فایل اسکریپت ویندوز (WSF) برای اجرا پس از ساخت ایمیج برنامه
.TP
\f[CR]main.wxs\f[R]
فایل پروژه اصلی WiX
.RS
.PP
منبع پیش‌فرض \f[I]main.wxs\f[R] است
.RE
.TP
\f[CR]overrides.wxi\f[R]
فایل پروژه WiX بازنویسی‌ها
.RS
.PP
منبع پیش‌فرض \f[I]overrides.wxi\f[R] است
.RE
.TP
\f[CR]service\-installer.exe\f[R]
فایل اجرایی نصب‌کننده سرویس
.RS
.PP
در صورتی بررسی می‌شود که برخی راه‌اندازهای برنامه به عنوان برنامه‌های از نوع سرویس پس‌زمینه ثبت شده باشند
.RE
.TP
\f[CR]<launcher\-name>\-service\-install.wxi\f[R]
فایل پروژه WiX نصب‌کننده سرویس
.RS
.PP
در صورتی بررسی می‌شود که برخی راه‌اندازهای برنامه به عنوان برنامه‌های از نوع سرویس پس‌زمینه ثبت شده باشند
.PP
منبع پیش‌فرض \f[I]service\-install.wxi\f[R] است
.RE
.TP
\f[CR]<launcher\-name>\-service\-config.wxi\f[R]
فایل پروژه WiX پیکربندی سرویس
.RS
.PP
در صورتی بررسی می‌شود که برخی راه‌اندازهای برنامه به عنوان برنامه‌های از نوع سرویس پس‌زمینه ثبت شده باشند
.PP
منبع پیش‌فرض \f[I]service\-config.wxi\f[R] است
.RE
.TP
\f[CR]InstallDirNotEmptyDlg.wxs\f[R]
فایل پروژه WiX برای کادر محاوره‌ای رابط کاربری نصب‌کننده جهت بررسی اینکه دایرکتوری نصب وجود ندارد یا خالی است
.RS
.PP
منبع پیش‌فرض \f[I]InstallDirNotEmptyDlg.wxs\f[R] است
.RE
.TP
\f[CR]ShortcutPromptDlg.wxs\f[R]
فایل پروژه WiX برای کادر محاوره‌ای رابط کاربری نصب‌کننده جهت پیکربندی میانبرها
.RS
.PP
منبع پیش‌فرض \f[I]ShortcutPromptDlg.wxs\f[R] است
.RE
.TP
\f[CR]bundle.wxf\f[R]
فایل پروژه WiX با سلسله‌مراتب مؤلفه‌های ایمیج برنامه
.TP
\f[CR]ui.wxf\f[R]
فایل پروژه WiX برای رابط کاربری نصب‌کننده
.TP
\f[CR]os\-condition.wxf\f[R]
فایل پروژه WiX با شرط مسدود کردن نصب در نسخه‌های قدیمی‌تر ویندوز
.RS
.PP
منبع پیش‌فرض \f[I]os\-condition.wxf\f[R] است
.RE
.TP
\f[CR]wix\-conv.xsl\f[R]
تبدیل‌کننده کد منبع WiX.
برای تبدیل منابع WiX از طرح‌واره نسخه ۳ به ۴ هنگام استفاده از WiX نسخه ۴ یا جدیدتر استفاده می‌شود
.RS
.PP
منبع پیش‌فرض \f[I]wix3\-to\-wix4\-conv.xsl\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام ساخت بسته‌بند EXE ویندوز بررسی می‌شوند:"
.TP
\f[CR]WinInstaller.properties\f[R]
فایل Properties برای فایل اجرایی نصب‌کننده
.RS
.PP
منبع پیش‌فرض \f[I]WinInstaller.template\f[R] است
.RE
.TP
\f[CR]<package\-name>\-post\-msi.wsf\f[R]
یک فایل اسکریپت ویندوز (WSF) برای اجرا پس از ساخت بسته‌بند تعبیه‌شده MSI برای نصب‌کننده EXE
.TP
\f[CR]installer.exe\f[R]
پوشش اجرایی (wrapper) برای نصب‌کننده MSI
.RS
.PP
منبع پیش‌فرض \f[I]msiwrapper.exe\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام اجرا در macOS بررسی می‌شوند:"
.TP
\f[CR]<launcher\-name>.icns\f[R]
آیکون راه‌انداز برنامه
.RS
.PP
منبع پیش‌فرض \f[I]JavaApp.icns\f[R] است
.RE
.TP
\f[CR]Info.plist\f[R]
فایل فهرست ویژگی‌های برنامه (Property list)
.RS
.PP
منبع پیش‌فرض \f[I]Info\-lite.plist.template\f[R] است
.RE
.TP
\f[CR]Runtime\-Info.plist\f[R]
فایل فهرست ویژگی‌های زمان اجرای جاوا
.RS
.PP
منبع پیش‌فرض \f[I]Runtime\-Info.plist.template\f[R] است
.RE
.TP
\f[CR]<application\-name>.entitlements\f[R]
فایل فهرست ویژگی‌های مجوزهای امضا (Signing entitlements)
.RS
.PP
منبع پیش‌فرض \f[I]sandbox.plist\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام ساخت بسته‌بند PKG/DMG در macOS بررسی می‌شوند:"
.TP
\f[CR]<package\-name>\-post\-image.sh\f[R]
اسکریپت پوسته برای اجرا پس از ساخت ایمیج برنامه
.SS "فایل‌های دایرکتوری منابع که فقط هنگام ساخت بسته‌بند PKG در macOS بررسی می‌شوند:"
.TP
\f[CR]uninstaller\f[R]
اسکریپت پوسته حذف‌کننده (uninstaller)
.RS
.PP
در صورتی بررسی می‌شود که برخی راه‌اندازهای برنامه به عنوان برنامه‌های از نوع سرویس پس‌زمینه ثبت شده باشند
.PP
منبع پیش‌فرض \f[I]uninstall.command.template\f[R] است
.RE
.TP
\f[CR]preinstall\f[R]
اسکریپت پوسته پیش از نصب
.RS
.PP
منبع پیش‌فرض \f[I]preinstall.template\f[R] است
.RE
.TP
\f[CR]postinstall\f[R]
اسکریپت پوسته پس از نصب
.RS
.PP
منبع پیش‌فرض \f[I]postinstall.template\f[R] است
.RE
.TP
\f[CR]services\-preinstall\f[R]
اسکریپت پوسته پیش از نصب برای بسته سرویس‌ها
.RS
.PP
در صورتی بررسی می‌شود که برخی راه‌اندازهای برنامه به عنوان برنامه‌های از نوع سرویس پس‌زمینه ثبت شده باشند
.PP
منبع پیش‌فرض \f[I]services\-preinstall.template\f[R] است
.RE
.TP
\f[CR]services\-postinstall\f[R]
اسکریپت پوسته پس از نصب برای بسته سرویس‌ها
.RS
.PP
در صورتی بررسی می‌شود که برخی راه‌اندازهای برنامه به عنوان برنامه‌های از نوع سرویس پس‌زمینه ثبت شده باشند
.PP
منبع پیش‌فرض \f[I]services\-postinstall.template\f[R] است
.RE
.TP
\f[CR]<package\-name>\-background.png\f[R]
تصویر پس‌زمینه
.RS
.PP
منبع پیش‌فرض \f[I]background_pkg.png\f[R] است
.RE
.TP
\f[CR]<package\-name>\-background\-darkAqua.png\f[R]
تصویر پس‌زمینه تیره
.RS
.PP
منبع پیش‌فرض \f[I]background_pkg.png\f[R] است
.RE
.TP
\f[CR]product\-def.plist\f[R]
فایل فهرست ویژگی‌های محصول
.RS
.PP
منبع پیش‌فرض \f[I]product\-def.plist\f[R] است
.RE
.TP
\f[CR]<package\-name>\-<launcher\-name>.plist\f[R]
فایل فهرست ویژگی‌های launchd برای راه‌انداز برنامه‌ای که به عنوان یک برنامه از نوع سرویس پس‌زمینه ثبت شده است
.RS
.PP
منبع پیش‌فرض \f[I]launchd.plist.template\f[R] است
.RE
.SS "فایل‌های دایرکتوری منابع که فقط هنگام ساخت بسته‌بند DMG در macOS بررسی می‌شوند:"
.TP
\f[CR]<package\-name>\-dmg\-setup.scpt\f[R]
اسکریپت راه‌اندازی AppleScript
.RS
.PP
منبع پیش‌فرض \f[I]DMGsetup.scpt\f[R] است
.RE
.TP
\f[CR]<package\-name>\-license.plist\f[R]
فایل فهرست ویژگی‌های مجوز (لایسنس)
.RS
.PP
منبع پیش‌فرض \f[I]lic_template.plist\f[R] است
.RE
.TP
\f[CR]<package\-name>\-background.tiff\f[R]
تصویر پس‌زمینه
.RS
.PP
منبع پیش‌فرض \f[I]background_dmg.tiff\f[R] است
.RE
.TP
\f[CR]<package\-name>\-volume.icns\f[R]
آیکون دیسک (Volume)
.RS
.PP
منبع پیش‌فرض \f[I]JavaApp.icns\f[R] است
.RE