.\" Copyright (c) 2018, 2022, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\" Automatically generated by Pandoc 2.19.2
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[R]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "JPACKAGE" "1" "2023" "JDK 21" "JDK Commands"
.hy
.SH "نام (NAME)"
jpackage-openjdk21 \- ابزار بسته‌بندی برنامه‌های خودکفای جاوا در قالب بسته‌های نصبی سیستم در OpenJDK 21
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[V]jpackage\f[R] [\f[I]گزینه‌ها\f[R]]
.TP
\f[I]گزینه‌ها\f[R]
گزینه‌های خط فرمان که با فاصله از یکدیگر جدا می‌شوند.
بخش \f[B]گزینه‌های jpackage (JPACKAGE OPTIONS)\f[R] را ببینید.
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار \f[V]jpackage\f[R] یک برنامهٔ جاوا و یک ایمیج زمان اجرای جاوا را به عنوان ورودی دریافت کرده و یک ایمیج برنامهٔ جاوا تولید می‌کند که شامل تمام وابستگی‌های لازم است.
این ابزار قادر است یک بستهٔ بومی (native) در قالب‌های ویژهٔ هر پلتفرم، مانند exe در ویندوز یا dmg در macOS تولید کند.
هر قالب باید روی همان پلتفرمی ساخته شود که قرار است روی آن اجرا شود؛ هیچ پشتیبانی چندپلتفرمی (cross-platform) وجود ندارد.
این ابزار دارای گزینه‌هایی است که امکان سفارشی‌سازی برنامه‌های بسته‌بندی‌شده را به روش‌های گوناگون فراهم می‌کند.
.SH "گزینه‌های JPACKAGE (JPACKAGE OPTIONS)"
.SS گزینه‌های عمومی (Generic Options):
.TP
\f[V]\[at]\f[R]\f[I]filename\f[R]
خواندن گزینه‌ها از یک فایل.
.RS
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[V]--type\f[R] یا \f[V]-t\f[R] \f[I]type\f[R]
نوع بسته‌ای که باید ایجاد شود.
.RS
.PP
مقادیر معتبر عبارتند از: {\[dq]app-image\[dq]، \[dq]exe\[dq]، \[dq]msi\[dq]،
\[dq]rpm\[dq]، \[dq]deb\[dq]، \[dq]pkg\[dq]، \[dq]dmg\[dq]}
.PP
اگر این گزینه مشخص نشود، نوع پیش‌فرض وابسته به پلتفرم ایجاد خواهد شد.
.RE
.TP
\f[V]--app-version\f[R] \f[I]version\f[R]
نسخهٔ برنامه و/یا بسته.
.TP
\f[V]--copyright\f[R] \f[I]copyright\f[R]
حق نشر (کپی‌رایت) برنامه.
.TP
\f[V]--description\f[R] \f[I]description\f[R]
توضیحات برنامه.
.TP
\f[V]--help\f[R] یا \f[V]-h\f[R]
چاپ متن راهنمای استفاده همراه با فهرست و شرح هر یک از گزینه‌های معتبر برای پلتفرم جاری در جریان خروجی، و سپس خروج.
.TP
\f[V]--icon\f[R] \f[I]path\f[R]
مسیر آیکون بستهٔ برنامه.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.RE
.TP
\f[V]--name\f[R] یا \f[V]-n\f[R] \f[I]name\f[R]
نام برنامه و/یا بسته.
.TP
\f[V]--dest\f[R] یا \f[V]-d\f[R] \f[I]destination\f[R]
مسیری که فایل خروجی تولیدشده در آن قرار می‌گیرد.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری).
.PP
به‌طور پیش‌فرض دایرکتوری کاری جاری است.
.RE
.TP
\f[V]--temp\f[R] \f[I]directory\f[R]
مسیر یک دایرکتوری جدید یا خالی که برای ایجاد فایل‌های موقت استفاده می‌شود.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
در صورت مشخص شدن، دایرکتوری موقت پس از اتمام کار حذف نخواهد شد و باید به صورت دستی حذف گردد.
.PP
در صورت مشخص نشدن، یک دایرکتوری موقت ایجاد شده و پس از اتمام کار حذف می‌شود.
.RE
.TP
\f[V]--vendor\f[R] \f[I]vendor\f[R]
سازنده یا ارائه‌دهندهٔ (Vendor) برنامه.
.TP
\f[V]--verbose\f[R]
فعال‌سازی خروجی با جزئیات کامل (verbose).
.TP
\f[V]--version\f[R]
چاپ نسخهٔ محصول در جریان خروجی و سپس خروج.
.SS گزینه‌های ایجاد ایمیج زمان اجرا (Runtime Image):
.TP
\f[V]--add-modules\f[R] \f[I]module-name\f[R] [\f[V],\f[R]\f[I]module-name\f[R]...]
فهرستی از ماژول‌ها که با کاما (\[dq],\[dq]) از هم جدا شده‌اند تا اضافه شوند.
.RS
.PP
این فهرست ماژول‌ها، همراه با ماژول اصلی (در صورت تعیین)، به عنوان آرگومان \f[V]--add-module\f[R] به \f[V]jlink\f[R] ارسال خواهد شد.
اگر مشخص نشود، یا فقط ماژول اصلی (در صورتی که \f[V]--module\f[R] مشخص شده باشد)، یا مجموعه پیش‌فرض ماژول‌ها (در صورتی که \f[V]--main-jar\f[R] مشخص شده باشد) استفاده می‌شود.
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[V]--module-path\f[R] یا \f[V]-p\f[R] \f[I]module-path\f[R] [\f[V],\f[R]\f[I]module-path\f[R]...]
فهرستی از مسیرها که با File.pathSeparator از یکدیگر جدا شده‌اند.
.RS
.PP
هر مسیر یا دایرکتوری ماژول‌ها است یا مسیر یک فایل jar ماژولار، و به صورت مطلق یا نسبی نسبت به دایرکتوری جاری می‌باشد.
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[V]--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[V]--runtime-image\f[R] \f[I]directory\f[R]
مسیر ایمیج زمان اجرای از پیش تعریف‌شده که در ایمیج برنامه کپی خواهد شد.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
اگر \f[V]--runtime-image\f[R] مشخص نشود، \f[V]jpackage\f[R] دستور \f[V]jlink\f[R] را اجرا می‌کند تا با استفاده از گزینه‌های تعیین‌شده در \f[V]--jlink-options\f[R] ایمیج زمان اجرا را ایجاد کند.
.RE
.SS گزینه‌های ایجاد ایمیج برنامه:
.TP
\f[V]--input\f[R] یا \f[V]-i\f[R] \f[I]directory\f[R]
مسیر دایرکتوری ورودی که حاوی فایل‌های مورد نظر برای بسته‌بندی است.
.RS
.PP
تمام فایل‌های موجود در دایرکتوری ورودی در ایمیج برنامه بسته‌بندی خواهند شد.
.RE
.TP
\f[V]--app-content\f[R] \f[I]additional-content\f[R][,\f[I]additional-content\f[R]...]
فهرستی از مسیرهای فایل‌ها و/یا دایرکتوری‌ها که با کاما از هم جدا شده‌اند تا به بار دادهٔ (payload) برنامه اضافه شوند.
.RS
.PP
از این گزینه می‌توان بیش از یک بار استفاده کرد.
.RE
.SS گزینه‌های ایجاد اجراکننده(های) برنامه (Launchers):
.TP
\f[V]--add-launcher\f[R] \f[I]name\f[R]=\f[I]path\f[R]
نام اجراکننده، و مسیری به یک فایل Properties که حاوی فهرستی از جفت‌های کلید، مقدار است.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
کلیدهای \[dq]module\[dq]، \[dq]main-jar\[dq]، \[dq]main-class\[dq]،
\[dq]description\[dq]، \[dq]arguments\[dq]، \[dq]java-options\[dq]،
\[dq]app-version\[dq]، \[dq]icon\[dq]، \[dq]launcher-as-service\[dq]،
\[dq]win-console\[dq]، \[dq]win-shortcut\[dq]، \[dq]win-menu\[dq]،
\[dq]linux-app-category\[dq] و \[dq]linux-shortcut\[dq] قابل استفاده هستند.
.PP
این گزینه‌ها به گزینه‌های اصلی خط فرمان اضافه می‌شوند یا برای رونویسی آن‌ها استفاده می‌شوند تا یک اجراکنندهٔ جایگزین اضافی ساخته شود.
اجراکنندهٔ اصلی برنامه از روی گزینه‌های خط فرمان ساخته خواهد شد.
با استفاده از این گزینه می‌توان اجراکننده‌های جایگزین اضافی ساخت، و از این گزینه می‌توان چندین بار برای ساخت چندین اجراکنندهٔ اضافی استفاده کرد.
.RE
.TP
\f[V]--arguments\f[R] \f[I]arguments\f[R]
آرگومان‌های خط فرمان که در صورت عدم ارائه آرگومان به اجراکننده، به کلاس اصلی ارسال می‌شوند.
.RS
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[V]--java-options\f[R] \f[I]options\f[R]
گزینه‌هایی که باید به زمان اجرای جاوا ارسال شوند.
.RS
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[V]--main-class\f[R] \f[I]class-name\f[R]
نام کامل (Qualified name) کلاس اصلی برنامه برای اجرا.
.RS
.PP
از این گزینه فقط در صورتی می‌توان استفاده کرد که \f[V]--main-jar\f[R] مشخص شده باشد.
.RE
.TP
\f[V]--main-jar\f[R] \f[I]main-jar\f[R]
فایل JAR اصلی برنامه؛ حاوی کلاس اصلی (به عنوان مسیری نسبی نسبت به مسیر ورودی مشخص می‌شود).
.RS
.PP
تنها یکی از گزینه‌های \f[V]--module\f[R] یا \f[V]--main-jar\f[R] می‌تواند مشخص شود و نه هر دو.
.RE
.TP
\f[V]--module\f[R] یا \f[V]-m\f[R] \f[I]module-name\f[R][/\f[I]main-class\f[R]]
ماژول اصلی (و به صورت اختیاری کلاس اصلی) برنامه.
.RS
.PP
این ماژول باید در مسیر ماژول‌ها (module path) قرار داشته باشد.
.PP
هنگامی که این گزینه مشخص شود، ماژول اصلی در ایمیج زمان اجرای جاوا پیوند داده خواهد شد.
تنها یکی از گزینه‌های \f[V]--module\f[R] یا \f[V]--main-jar\f[R] می‌تواند مشخص شود و نه هر دو.
.RE
.SS گزینهٔ وابسته به پلتفرم برای ایجاد اجراکنندهٔ برنامه:
.SS گزینه‌های پلتفرم ویندوز (تنها هنگام اجرا روی ویندوز در دسترس است):
.TP
\f[V]--win-console\f[R]
ایجاد یک اجراکنندهٔ کنسولی برای برنامه؛ باید برای برنامه‌هایی که نیاز به تعاملات کنسولی دارند مشخص شود.
.SS گزینه‌های پلتفرم macOS (تنها هنگام اجرا روی macOS در دسترس است):
.TP
\f[V]--mac-package-identifier\f[R] \f[I]identifier\f[R]
شناسه‌ای که برنامه را به طور یکتا برای macOS مشخص می‌کند.
.RS
.PP
به‌طور پیش‌فرض همان نام کلاس اصلی است.
.PP
تنها می‌تواند از نویسه‌های حرفی-عددی (A-Z, a-z, 0-9)، خط پیوند (-) و نقطه (.) استفاده کند.
.RE
.TP
\f[V]--mac-package-name\f[R] \f[I]name\f[R]
نام برنامه به همان صورتی که در نوار منو (Menu Bar) ظاهر می‌شود.
.RS
.PP
این نام می‌تواند با نام برنامه متفاوت باشد.
.PP
طول این نام باید کمتر از ۱۶ نویسه باشد و برای نمایش در نوار منو و پنجرهٔ اطلاعات (Info) برنامه مناسب باشد.
به‌طور پیش‌فرض همان نام برنامه است.
.RE
.TP
\f[V]--mac-package-signing-prefix\f[R] \f[I]prefix\f[R]
هنگام امضای بستهٔ برنامه، این مقدار به ابتدای نام تمام مؤلفه‌هایی که نیاز به امضا دارند و فاقد شناسهٔ بستهٔ موجود هستند اضافه می‌شود.
.TP
\f[V]--mac-sign\f[R]
درخواست برای امضای بسته یا ایمیج از پیش تعریف‌شدهٔ برنامه.
.TP
\f[V]--mac-signing-keychain\f[R] \f[I]keychain-name\f[R]
نام دسته‌کلید (keychain) برای جستجوی هویت امضاکننده.
.RS
.PP
اگر مشخص نشود، از دسته‌کلیدهای استاندارد استفاده می‌شود.
.RE
.TP
\f[V]--mac-signing-key-user-name\f[R] \f[I]name\f[R]
بخش نام تیم یا کاربر در هویت‌های امضای اپل (Apple).
.TP
\f[V]--mac-app-store\f[R]
نشان می‌دهد که خروجی jpackage برای فروشگاه اپ استور مک (Mac App Store) در نظر گرفته شده است.
.TP
\f[V]--mac-entitlements\f[R] \f[I]path\f[R]
مسیر فایل حاوی مجوزها (entitlements) برای استفاده هنگام امضای فایل‌های اجرایی و کتابخانه‌ها در بسته.
.TP
\f[V]--mac-app-category\f[R] \f[I]category\f[R]
رشته‌ای که برای ساخت LSApplicationCategoryType در plist برنامه استفاده می‌شود.
.RS
.PP
مقدار پیش‌فرض \[dq]utilities\[dq] است.
.RE
.SS گزینه‌های ایجاد بستهٔ برنامه:
.TP
\f[V]--about-url\f[R] \f[I]url\f[R]
نشانی اینترنتی (URL) صفحهٔ اصلی برنامه.
.TP
\f[V]--app-image\f[R] \f[I]directory\f[R]
محل ایمیج از پیش تعریف‌شدهٔ برنامه که برای ساخت یک بستهٔ قابل نصب (روی همهٔ پلتفرم‌ها) یا برای امضا شدن (روی macOS) استفاده می‌شود.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.RE
.TP
\f[V]--file-associations\f[R] \f[I]path\f[R]
مسیر یک فایل Properties که حاوی فهرستی از جفت‌های کلید، مقدار است.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
کلیدهای \[dq]extension\[dq]، \[dq]mime-type\[dq]، \[dq]icon\[dq] و
\[dq]description\[dq] می‌توانند برای توصیف وابستگی فایل (association) استفاده شوند.
.PP
از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.TP
\f[V]--install-dir\f[R] \f[I]path\f[R]
مسیر مطلق دایرکتوری نصب برنامه (روی macOS یا لینوکس)، یا زیرمسیر نسبی دایرکتوری نصب مانند \[dq]Program Files\[dq] یا \[dq]AppData\[dq] (روی ویندوز).
.TP
\f[V]--license-file\f[R] \f[I]path\f[R]
مسیر فایل پروانه (مجوز).
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.RE
.TP
\f[V]--resource-dir\f[R] \f[I]path\f[R]
مسیر بازنویسی منابع jpackage.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
آیکون‌ها، فایل‌های الگو و سایر منابع jpackage را می‌توان با افزودن منابع جایگزین به این دایرکتوری بازنویسی کرد.
.RE
.TP
\f[V]--runtime-image\f[R] \f[I]path\f[R]
مسیر ایمیج زمان اجرای از پیش تعریف‌شده برای نصب.
.RS
.PP
(مسیر مطلق یا نسبی نسبت به دایرکتوری جاری)
.PP
هنگام ایجاد یک نصاب زمان اجرا، این گزینه الزامی است.
.RE
.TP
\f[V]--launcher-as-service\f[R]
درخواست برای ایجاد نصابی که اجراکنندهٔ اصلی برنامه را به عنوان یک برنامهٔ خدمات پس‌زمینه (service-type) ثبت کند.
.SS گزینه‌های وابسته به پلتفرم برای ایجاد بستهٔ برنامه:
.SS گزینه‌های پلتفرم ویندوز (تنها هنگام اجرا روی ویندوز در دسترس است):
.TP
\f[V]--win-dir-chooser\f[R]
افزودن یک کادر محاوره‌ای تا به کاربر امکان دهد دایرکتوری نصب محصول را انتخاب کند.
.TP
\f[V]--win-help-url\f[R] \f[I]url\f[R]
نشانی اینترنتی (URL) که کاربر می‌تواند اطلاعات بیشتر یا پشتیبانی فنی را از آن دریافت کند.
.TP
\f[V]--win-menu\f[R]
درخواست برای افزودن میانبر منوی شروع (Start Menu) برای این برنامه.
.TP
\f[V]--win-menu-group\f[R] \f[I]menu-group-name\f[R]
گروه منوی شروع که این برنامه در آن قرار می‌گیرد.
.TP
\f[V]--win-per-user-install\f[R]
درخواست برای انجام نصب به صورت مجزا برای هر کاربر (per-user).
.TP
\f[V]--win-shortcut\f[R]
درخواست برای ایجاد میانبر دسکتاپ برای این برنامه.
.TP
\f[V]--win-shortcut-prompt\f[R]
افزودن یک کادر محاوره‌ای تا کاربر انتخاب کند که آیا میانبرها توسط نصاب ایجاد شوند یا خیر.
.TP
\f[V]--win-update-url\f[R] \f[I]url\f[R]
نشانی اینترنتی (URL) اطلاعات به‌روزرسانی‌های موجود برنامه.
.TP
\f[V]--win-upgrade-uuid\f[R] \f[I]id\f[R]
شناسهٔ یکتا (UUID) مرتبط با ارتقاهای این بسته.
.SS گزینه‌های پلتفرم لینوکس (تنها هنگام اجرا روی لینوکس در دسترس است):
.TP
\f[V]--linux-package-name\f[R] \f[I]name\f[R]
نام بستهٔ لینوکس.
.RS
.PP
به‌طور پیش‌فرض همان نام برنامه است.
.RE
.TP
\f[V]--linux-deb-maintainer\f[R] \f[I]email-address\f[R]
نگه‌دارنده (Maintainer) برای بستهٔ .deb.
.TP
\f[V]--linux-menu-group\f[R] \f[I]menu-group-name\f[R]
گروه منویی که این برنامه در آن قرار می‌گیرد.
.TP
\f[V]--linux-package-deps\f[R]
بسته‌ها یا قابلیت‌های مورد نیاز برای برنامه.
.TP
\f[V]--linux-rpm-license-type\f[R] \f[I]type\f[R]
نوع پروانه (\[dq]License: \f[I]value\f[R]\[dq] در فایل ‎.spec مربوط به RPM).
.TP
\f[V]--linux-app-release\f[R] \f[I]release\f[R]
مقدار انتشار (Release) در فایل ‎<name>.spec مربوط به RPM یا مقدار بازنگری (Debian revision) در فایل کنترل DEB.
.TP
\f[V]--linux-app-category\f[R] \f[I]category-value\f[R]
مقدار گروه (Group) در فایل ‎.spec مربوط به RPM یا مقدار بخش (Section) در فایل کنترل DEB.
.TP
\f[V]--linux-shortcut\f[R]
ایجاد میانبر برای برنامه.
.SS گزینه‌های پلتفرم macOS (تنها هنگام اجرا روی macOS در دسترس است):
.TP
\f[V]--mac-dmg-content\f[R] \f[I]additional-content\f[R][,\f[I]additional-content\f[R]...]
گنجاندن تمام محتوای ارجاع‌شده در فایل dmg.
.RS
.PP
از این گزینه می‌توان بیش از یک بار استفاده کرد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.IP
.nf
\f[CB]
تولید یک بستهٔ برنامه مناسب برای سیستم میزبان:
\f[R]
.fi
.IP
.nf
\f[CB]
برای یک برنامهٔ ماژولار:
    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
\f[R]
.fi
.IP
.nf
\f[CB]
تولید یک ایمیج برنامه:
\f[R]
.fi
.IP
.nf
\f[CB]
برای یک برنامهٔ ماژولار:
    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 [<additional jlink options>...]
    jpackage --type app-image -n name \[rs]
        -m moduleName/className --runtime-image appRuntimeImage
\f[R]
.fi
.IP
.nf
\f[CB]
تولید یک بستهٔ زمان اجرای جاوا:
\f[R]
.fi
.IP
.nf
\f[CB]
jpackage -n name --runtime-image <runtime-image>
\f[R]
.fi
.IP
.nf
\f[CB]
امضای ایمیج از پیش تعریف‌شدهٔ برنامه (در macOS):
\f[R]
.fi
.IP
.nf
\f[CB]
jpackage --type app-image --app-image <app-image> \[rs]
    --mac-sign [<additional signing options>...]

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