نام (NAME)

flatpakref - ارجاع به یک مخزن دوردست برای برنامه یا محیط زمان اجرا

توضیحات (DESCRIPTION)

فلت‌پک (Flatpak) از پرونده‌های flatpakref برای به‌اشتراک‌گذاری اطلاعات یک مخزن دوردست (remote) برای یک برنامه مشخص استفاده می‌کند. پرونده flatpakref حاوی اطلاعات کافی برای افزودن مخزن دوردست و نصب برنامه است. برای انجام این کار از دستور flatpak install --from استفاده کنید.

پرونده‌های flatpakref همچنین ممکن است حاوی اطلاعات بیشتری باشند که هنگام نمایش برنامه به کاربر، برای مثال در یک فروشگاه برنامه (App Store)، کاربرد دارد.

پسوند نام پرونده که معمولاً برای پرونده‌های flatpakref به کار می‌رود .flatpakref. است.

یک پرونده flatpakref می‌تواند به یک مخزن دوردست برای یک محیط زمان اجرا (runtime) نیز ارجاع دهد.

قالب فایل (FILE FORMAT)

پرونده flatpakref از همان قالب پرونده‌های .ini استفاده می‌کند که در پرونده‌های واحد systemd یا پرونده‌های .desktop برنامه‌ها به کار می‌رود.

[Flatpak Ref]

تمام اطلاعات درون گروه [Flatpak Ref] قرار دارد.

کلیدهای زیر می‌توانند در این گروه حضور داشته باشند:

Version (uint64)

نسخه قالب پرونده؛ در صورت وجود باید برابر با 1 باشد.

Name (string)

نام کامل و واجد شرایط (FQDN) محیط زمان اجرا یا برنامه. این کلید اجباری است.

Url (string)

نشانی اینترنتی (URL) مخزن دوردست. این کلید اجباری است.

Branch (string)

نام شاخه‌ای که برنامه یا زمان اجرا باید از آن نصب شود. اگر این کلید مشخص نشود، شاخه "master" استفاده می‌شود.

Title (string)

عنوان برنامه یا محیط زمان اجرا. این مقدار باید یک نام کاربرپسند باشد که بتوان آن را مثلاً در فروشگاه برنامه نمایش داد.

Comment (string)

خلاصه‌ای کوتاه از برنامه یا زمان اجرا، برای نمایش مثلاً در فروشگاه برنامه.

Description (string)

توضیحات طولانی‌تر درباره برنامه یا زمان اجرا، برای نمایش مثلاً در فروشگاه برنامه.

Icon (string)

نشانی URL یک نماد (آیکون) که می‌تواند برای نمایش برنامه یا زمان اجرا استفاده شود.

Homepage (string)

نشانی URL صفحه وبی که برنامه یا زمان اجرا را توصیف می‌کند.

DeploySideloadCollectionID (string)

شناسه مجموعه (collection ID) مخزن دوردست، در صورت وجود. این شناسه به صورت یکتا مجموعه برنامه‌های موجود در مخزن دوردست را برای امکان بازتوزیع همتا‌به‌همتا (نگاه کنید به flatpak(1)) مشخص می‌کند. توصیه می‌شود به جای DeployCollectionID یا CollectionID از این کلید استفاده شود، زیرا فقط کلاینت‌های جدیدتر (فلت‌پک 1.12.8 یا بالاتر) به آن توجه می‌کنند (و کلاینت‌های قدیمی‌تر شناسه‌های مجموعه را به درستی پردازش نمی‌کنند).

DeployCollectionID (string)

این گزینه منسوخ شده است اما همچنان برای سازگاری رو به عقب پشتیبانی می‌شود. به جای آن از DeploySideloadCollectionID استفاده کنید.

CollectionID (string)

IsRuntime (boolean)

مشخص می‌کند که آیا این پرونده به یک محیط زمان اجرا ارجاع دارد یا خیر. اگر این کلید تعیین نشود، فرض می‌شود که پرونده به یک برنامه اشاره دارد.

GPGKey (string)

کلید GPG انکودشده با base64 برای مخزن دوردست.

SignatureLookaside (string)

نشانی URL مورد استفاده برای یافتن و اعتبارسنجی امضاها (فقط برای مخازن OCI)

RuntimeRepo (string)

نشانی URL یک پرونده .flatpakrepo برای مخزن دوردستی که محیط زمان اجرا در آن یافت می‌شود. توجه داشته باشید که اگر محیط زمان اجرا در مخزن ارائه‌دهنده برنامه موجود باشد، ممکن است به جای آن از همان مخزن استفاده شود، اما مخزنی که با این گزینه تعیین شده نیز اضافه خواهد شد.

SuggestRemoteName (string)

یک نام پیشنهادی برای مخزن دوردست.

مثال (EXAMPLE)

[Flatpak Ref]
Title=gedit
Name=org.gnome.gedit
Branch=stable
Url=http://sdk.gnome.org/repo-apps/
IsRuntime=false
GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
DeployCollectionID=org.gnome.Apps

همچنین ببینید (SEE ALSO)

flatpak(1), flatpak-install(1), flatpakrepo(5)

flatpak