.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GAPPLICATION" "1" "سپتامبر ۲۰۲۶" "glib2" "دستورهای کاربری"
.SH "نام (NAME)"
gapplication \- کنترل و مدیریت برنامههای دارای پشتیبانی از GApplication
.\" This has to be duplicated from above to make it machine-readable by `reuse`:
.\" SPDX-FileCopyrightText: 2013 Allison Karlitskaya
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBgapplication\fP help [COMMAND]
\fBgapplication\fP version
\fBgapplication\fP list\-apps
\fBgapplication\fP launch <APP\-ID>
\fBgapplication\fP launch <APP\-ID> [FILE…]
\fBgapplication\fP list\-actions <APP\-ID>
\fBgapplication\fP action <APP\-ID> <ACTION> [PARAMETER]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgapplication\fP یک پیاده‌سازی خط فرمانی از سمت کلاینت رابط
\fBorg.freedesktop.Application\fP
بر پایه مشخصات ورودی رومیزی (Desktop Entry Specification) مربوط به freedesktop.org است.
.sp
می‌توان از \fBgapplication\fP برای آغاز برنامه‌هایی که در فایل‌های
\fB\&.desktop\fP
خود مقدار
\fBDBusActivatable\fP
را برابر با
\fBtrue\fP
تنظیم کرده‌اند استفاده کرد، و همچنین می‌توان از آن برای ارسال پیام‌ها به نمونه‌های در حال اجرای دیگر برنامه‌ها بهره برد.
.sp
این امکان برای برنامه‌ها وجود دارد که در سطر
\fBExec\fP
فایل‌های
\fB\&.desktop\fP
خود به
\fBgapplication\fP
ارجاع دهند تا سازگاری عقبرو با پیاده‌سازی‌هایی که مستقیماً از
\fBDBusActivatable\fP
پشتیبانی نمی‌کنند حفظ شود.
.sp
ابزار \fBgapplication\fP به عنوان بخشی از GLib عرضه می‌شود.
.SH "دستورها (COMMANDS)"
.sp
\fBhelp [COMMAND]\fP
.INDENT 0.0
.INDENT 3.5
نمایش خلاصه کوتاهی از دستورهای موجود یا ارائه راهنمای با جزئیات درباره یک دستور خاص.
.UNINDENT
.UNINDENT
.sp
\fBversion\fP
.INDENT 0.0
.INDENT 3.5
چاپ نسخه GLib که \fBgapplication\fP همراه با آن ارائه شده است.
.UNINDENT
.UNINDENT
.sp
\fBlist\-apps\fP
.INDENT 0.0
.INDENT 3.5
فهرستی از تمام شناسه‌های برنامه‌هایی که مشخص شده از فعال‌سازی با D\-Bus پشتیبانی می‌کنند را چاپ می‌کند. این فهرست با پویش فایل‌های \fB\&.desktop\fP بر پایه مقدار فعلی \fBXDG_DATA_DIRS\fP تولید می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBlaunch <APP\-ID> [FILE…]\fP
.INDENT 0.0
.INDENT 3.5
یک برنامه را اجرا و راه‌اندازی می‌کند.
.sp
نخستین پارامتر، شناسه برنامه (application ID) با سبک آشنای «DNS معکوس» (مانند \fBorg.gnome.app\fP) و بدون پسوند \fB\&.desktop\fP است.
.sp
در صورت مشخص شدن پارامترهای دیگر به صورت اختیاری، با آن‌ها به عنوان نام فایل‌هایی که باید باز شوند برخورد می‌شود که می‌توانند نام فایل یا نشانی اینترنتی (URI) باشند. اگر هیچ فایلی مشخص نشود، برنامه تنها فعال‌سازی می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBlist\-actions <APP\-ID>\fP
.INDENT 0.0
.INDENT 3.5
فهرست کردن کنش‌های اعلان‌شده در فایل \fB\&.desktop\fP برنامه. این پارامتر همان شناسه برنامه مطابق بالا است.
.UNINDENT
.UNINDENT
.sp
\fBaction <APP\-ID> <ACTION> [PARAMETER]\fP
.INDENT 0.0
.INDENT 3.5
کنش نام‌برده را فراخوانی می‌کند (به همان شیوه‌ای که هنگام فعال‌سازی کنش مشخص‌شده در فایل \fB\&.desktop\fP رخ می‌دهد).
.sp
شناسه برنامه (مانند بالا) نخستین پارامتر است. سپس نام کنش به دنبال آن می‌آید.
.sp
به صورت اختیاری، به دنبال نام کنش می‌تواند یک پارامتر در قالب GVariant قرار گیرد که به شکل یک تک‌آرگومان داده می‌شود. اطمینان حاصل کنید که از نقل‌قول‌ها (Quoting) به اندازه کافی استفاده شود.
.UNINDENT
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.SS "از طریق خط فرمان"
.sp
راه‌اندازی یک برنامه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gapplication launch org.example.fooview
.EE
.UNINDENT
.UNINDENT
.sp
باز کردن یک فایل با یک برنامه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gapplication launch org.example.fooview ~/file.foo
.EE
.UNINDENT
.UNINDENT
.sp
باز کردن چند فایل با یک برنامه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gapplication launch org.example.fooview ~/foos/*.foo
.EE
.UNINDENT
.UNINDENT
.sp
فراخوانی یک کنش روی یک برنامه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gapplication action org.example.fooview create
.EE
.UNINDENT
.UNINDENT
.sp
فراخوانی یک کنش روی یک برنامه، به همراه پارامتر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gapplication action org.example.fooview show\-item \(aq\(dqitem_id_828739\(dq\(aq
.EE
.UNINDENT
.UNINDENT
.SS "از طریق خطوط \fBExec\fP در فایل‌های \fB\&.desktop\fP"
.sp
رابط خط فرمانی \fBgapplication\fP به گونه‌ای طراحی شده است که بتوان آن را مستقیماً از خط \fBExec\fP یک فایل \fB\&.desktop\fP استفاده کرد.
.sp
ممکن است بخواهید این کار را برای برقراری سازگاری عقبرو با پیاده‌سازی‌هایی از مشخصات که روش فعال‌سازی با D\-Bus را نمی‌دانند انجام دهید، بدون این که نیاز به نصب یک برنامه کمکی مجزا باشد.
.sp
مثال زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[Desktop Entry]
Version=1.1
Type=Application
Name=Foo Viewer
DBusActivatable=true
MimeType=image/x\-foo;
Exec=gapplication launch org.example.fooview %F
Actions=gallery;create;

[Desktop Action gallery]
Name=Browse Gallery
Exec=gapplication action org.example.fooview gallery

[Desktop Action create]
Name=Create a new Foo!
Exec=gapplication action org.example.fooview create
.EE
.UNINDENT
.UNINDENT
.SS "از طریق یک اسکریپت"
.sp
هنگام نصب برنامه‌ای که از فعال‌سازی با D\-Bus پشتیبانی می‌کند، ممکن است همچنان بخواهید فایلی را در \fB/usr/bin\fP قرار دهید تا برنامه‌تان از درون یک پایانه قابل اجرا باشد.
.sp
امکان دارد که این فایل یک اسکریپت شل باشد. این اسکریپت می‌تواند آرگومان‌هایی مانند \fB\-\-help\fP و \fB\-\-version\fP را مستقیماً مدیریت کند. همچنین می‌تواند دیگر آرگومان‌های خط فرمان را پردازش کرده و آن‌ها را به استفاده از \fBgapplication\fP برای فعال‌سازی برنامه، باز کردن فایل‌ها، یا فراخوانی کنش‌ها تبدیل نماید.
.sp
در اینجا یک مثال ساده‌شده آورده شده است، مانند آنچه ممکن است در \fB/usr/bin/fooview\fP نصب شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
#!/bin/sh

case \(dq$1\(dq in
  \-\-help)
    echo \(dqsee ‘man fooview’ for more information\(dq
    ;;

  \-\-version)
    echo \(dqfooview 1.2\(dq
    ;;

  \-\-gallery)
    gapplication action org.example.fooview gallery
    ;;

  \-\-create)
    gapplication action org.example.fooview create
    ;;

  \-*)
    echo \(dqunrecognized commandline argument\(dq
    exit 1
    ;;

  *)
    gapplication launch org.example.fooview \(dq$@\(dq
    ;;
esac
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
Desktop Entry Specification \%<https://specifications.freedesktop.org/desktop-entry-spec/latest>،
\fBgdbus\fP(1) \%<man:gdbus(1)>،
\fBxdg\-open\fP(1) \%<man:xdg-open(1)>،
\fBdesktop\-file\-validate\fP(1) \%<man:desktop-file-validate(1)>
.\" End of generated man page.