FLATPAK CREATE-USB(1) flatpak create-usb FLATPAK CREATE-USB(1)

flatpak-create-usb - کپی کردن برنامه‌ها یا زمان‌های اجرا بر روی حافظه‌های جداشدنی

flatpak create-usb [گزینه‌ها...] MOUNT-PATH REF...

برنامه‌ها یا زمان‌های اجرای (runtimes) مشخص‌شده توسط شناسه‌های REF را به همراه تمامی وابستگی‌ها و متاداده‌های لازم برای نصب آن‌ها، بر روی حافظهٔ جداشدنی سوارشده (مانت‌شده) در مسیر MOUNT-PATH کپی می‌کند. این روش یکی از راه‌های انتقال برنامه‌های فلت‌پک بین رایانه‌ها بدون نیاز به اتصال اینترنت است. پس از اجرای این دستور، درایو USB را می‌توان به رایانه دیگری که مخزن‌های راه دور (remote) مربوطه روی آن از پیش پیکربندی شده‌اند متصل کرد و فلت‌پک برنامه‌ها را به صورت آفلاین از روی درایو نصب یا به‌روزرسانی می‌کند (به بخش زیر مراجعه کنید). در صورت متصل بودن به اینترنت، درایو به عنوان حافظهٔ موقت (کش) استفاده می‌شود، بدین معنی که برخی اشیاء از روی درایو و مابقی از اینترنت بارگیری می‌شوند. برای کارکرد صحیح این فرآیند، باید شناسهٔ مجموعه (collection ID) روی مخازن مربوطه در هر دو رایانهٔ مبدأ و مقصد و همچنین بر روی سرور راه دور پیکربندی شده باشد.

روی رایانهٔ مقصد می‌توان با استفاده از گزینهٔ --sideload-repo همراه با دستور flatpak install عملیات نصب را از روی درایو USB (یا هر سیستم‌فایل مانت‌شدهٔ دیگری) انجام داد. همچنین امکان پیکربندی مسیرهای بارگذاری جانبی (sideload) با استفاده از پیوندهای نمادین (symlinks) وجود دارد؛ به flatpak(1) مراجعه کنید. فلت‌پک همچنین دارای واحدهای systemd برای سایدلود خودکار از حافظه‌های USB متصل‌شده در لحظه (hot-plugged) است، اما فعال بودن یا نبودن آن‌ها به توزیع لینوکس شما بستگی دارد.

هر آرگومان REF یک شناسهٔ کامل یا جزئی در قالب ref فلت‌پک است که به صورت "(app|runtime)/ID/ARCH/BRANCH" می‌باشد. تمامی عناصر به جز ID اختیاری بوده و می‌توان آن‌ها را به همراه اسلش‌ها حذف کرد، بنابراین در بیشتر موارد تنها کافی است ID را مشخص کنید. هر بخش حذف‌شده با موارد نصب‌شده تطبیق داده می‌شود و در صورت وجود چندین مورد منطبق، پیامی حاوی گزینه‌های جایگزین نمایش داده خواهد شد.

به طور پیش‌فرض، این دستور هم برنامه‌ها و هم زمان‌های اجرای نصب‌شده را با شناسهٔ REF داده‌شده جستجو می‌کند، اما می‌توان این جستجو را با گزینهٔ --app یا --runtime محدود کرد.

تمامی شناسه‌های REF باید در یک محل نصب یکسان (کاربر، سیستم، یا موارد دیگر) قرار داشته باشند. در غیر این صورت مشخص نخواهد بود که متاداده‌های کدام مخزن باید روی درایو USB قرار گیرند.

به طور پیش‌فرض، flatpak create-usb از مسیر .ostree/repo به عنوان دایرکتوری مقصد در زیرمسیر MOUNT-PATH استفاده می‌کند؛ اما اگر با استفاده از --destination-repo مکان دیگری را مشخص کنید، یک پیوند نمادین در .ostree/repos.d برای شما ایجاد می‌شود. این کار تضمین می‌کند که مخزن در هر دو حالت توسط فلت‌پک (و سایر برنامه‌های استفاده‌کننده از libostree) برای عملیات نصب یا به‌روزرسانی پیدا شود.

این دستور شناسهٔ REF را هم در سطح نصب سیستمی و هم در سطح هر کاربر جستجو می‌کند و اگر در بیش از یک مکان وجود داشته باشد، با خطا متوقف می‌شود؛ مگر اینکه با گزینه‌های --system، --user، یا --installation بازنویسی شود.

گزینه‌های زیر پشتیبانی می‌شوند:

-h, --help

نمایش گزینه‌های راهنما و خروج.

-u, --user

کپی کردن مراجع (refs) از محل نصب اختصاصی کاربر.

--system

کپی کردن مراجع (refs) از محل نصب پیش‌فرض سرتاسر سیستم.

--installation=NAME

کپی کردن مراجع از یک محل نصب سیستمی مشخص‌شده توسط NAME از میان موارد تعریف‌شده در /etc/flatpak/installations.d/. استفاده از --installation=default معادل استفاده از --system است.

--app

فرض می‌کند تمام مراجع (REFs) برنامه هستند، مگر اینکه صراحتاً خلاف آن مشخص شده باشد.

--runtime

فرض می‌کند تمام مراجع (REFs) زمان اجرا (runtime) هستند، مگر اینکه صراحتاً خلاف آن مشخص شده باشد.

--destination-repo=DEST

ایجاد مخزن در مسیر DEST زیر MOUNT-PATH، به جای مکان پیش‌فرض.

--allow-partial

عدم چاپ هشدار هنگام برون‌بری کامیت‌های ناقص نصب‌شده؛ برای مثال افزونه‌های محلی‌سازی (locale) که فاقد تمام زبان‌ها هستند. این موارد ممکن است هنگام نصب آن‌ها مشکلاتی ایجاد کنند، به عنوان نمونه اگر پیکربندی زبان در سمت نصب‌کننده متفاوت باشد.

-v, --verbose

چاپ اطلاعات اشکال‌زدایی در طول پردازش دستور.

--ostree-verbose

چاپ اطلاعات اشکال‌زدایی OSTree در طول پردازش دستور.

$ flatpak create-usb /run/media/mwleeds/1a9b4cb2-a7ef-4d9b-91a5-6eaf8fdd2bf6/ com.endlessm.wiki_art.en

flatpak(1), flatpak remote-modify(1), flatpak-install(1), flatpak-list(1), ostree-create-usb(1)

flatpak