Εγχειρίδια για τη γραμμή εντολών

Man » Flatpak Manual online - λεπτομερής διαδικτυακή τεκμηρίωση για τη σελίδα man του flatpak

🌍
flatpak - Δημιουργία, εγκατάσταση και εκτέλεση εφαρμογών και περιβαλλόντων εκτέλεσης

ΣΥΝΟΨΗ

flatpak [ΕΠΙΛΟΓΗ...] {ΕΝΤΟΛΗ}

ΠΕΡΙΓΡΑΦΗ

Το Flatpak είναι ένα εργαλείο για τη διαχείριση εφαρμογών και των περιβαλλόντων εκτέλεσης που χρησιμοποιούν. Στο μοντέλο Flatpak, οι εφαρμογές μπορούν να δημιουργηθούν και να διανεμηθούν ανεξάρτητα από το σύστημα υποδοχής στο οποίο χρησιμοποιούνται, και είναι απομονωμένες από το σύστημα υποδοχής («με περιορισμένες δυνατότητες») σε κάποιο βαθμό, κατά την εκτέλεση.

Το Flatpak μπορεί να λειτουργεί σε λειτουργία για όλο το σύστημα ή ανά χρήστη. Τα δεδομένα για όλο το σύστημα (περιβάλλοντα εκτέλεσης, εφαρμογές και διαμόρφωση) βρίσκονται στο $prefix/var/lib/flatpak/ και τα δεδομένα ανά χρήστη βρίσκονται στο $HOME/.local/share/flatpak/. Κάτω από αυτές τις τοποθεσίες, υπάρχει ένα τοπικό αποθετήριο στον υποκατάλογο repo/ και τα εγκατεστημένα περιβάλλοντα εκτέλεσης και οι εφαρμογές βρίσκονται στους αντίστοιχους υποκαταλόγους runtime/ και app/.

Τα αποθετήρια για όλο το σύστημα μπορούν να διαμορφωθούν στατικά, τοποθετώντας αρχεία flatpakrepo(5) στον κατάλογο /usr/share/flatpak/remotes.d/ και /etc/flatpak/remotes.d/. Εάν υπάρχει ένα αρχείο με το ίδιο όνομα και στους δύο καταλόγους, το αρχείο στον κατάλογο /etc θα έχει προτεραιότητα.

Εκτός από την εγκατάσταση για όλο το σύστημα στο $prefix/var/lib/flatpak/, η οποία θεωρείται πάντα η προεπιλεγμένη, μπορούν να οριστούν περισσότερες εγκαταστάσεις για όλο το σύστημα μέσω αρχείων διαμόρφωσης στον κατάλογο /etc/flatpak/installations.d/, που πρέπει να ορίζουν τουλάχιστον το αναγνωριστικό της εγκατάστασης και την απόλυτη διαδρομή προς αυτήν. Υποστηρίζονται επίσης άλλες προαιρετικές παράμετροι, όπως DisplayName, Priority ή StorageType.

Το Flatpak χρησιμοποιεί το OSTree για τη διανομή και την ανάπτυξη δεδομένων. Τα αποθετήρια που χρησιμοποιεί είναι αποθετήρια OSTree και μπορούν να διαχειριστούν με το βοηθητικό πρόγραμμα ostree. Τα εγκατεστημένα περιβάλλοντα εκτέλεσης και οι εφαρμογές είναι εξαγωγές OSTree.

Οι βασικές εντολές για τη δημιουργία πακέτων flatpak, όπως build-init, build και build-finish, περιλαμβάνονται στο βοηθητικό πρόγραμμα flatpak. Για υποστήριξη δημιουργίας υψηλότερου επιπέδου, ανατρέξτε στο ξεχωριστό βοηθητικό πρόγραμμα flatpak-builder(1).

Το Flatpak υποστηρίζει την εγκατάσταση από συμπληρωματικά αποθετήρια. Αυτά είναι μερικά αντίγραφα ενός αποθετηρίου (που δημιουργούνται από το flatpak create-usb) που χρησιμοποιούνται ως πηγή εγκατάστασης όταν δεν υπάρχει σύνδεση στο διαδίκτυο (και όταν υπάρχει σύνδεση στο διαδίκτυο, ως βελτίωση της απόδοσης). Αυτά τα αποθετήρια διαμορφώνονται δημιουργώντας συνδέσμους προς τις πηγές στον υποκατάλογο sideload-repos του καταλόγου εγκατάστασης (π.χ. συνήθως /var/lib/flatpak/sideload-repos ή ~/.local/share/flatpak/sideload-repos). Επιπλέον, μπορούν να δημιουργηθούν σύνδεσμοι στον κατάλογο /run/flatpak/sideload-repos, ο οποίος είναι μια καλύτερη τοποθεσία για μη μόνιμες πηγές (καθώς διαγράφεται κατά την επανεκκίνηση). Αυτοί οι σύνδεσμοι μπορούν να δείχνουν είτε στον κατάλογο που δίνεται στο flatpak create-usb, ο οποίος γράφει από προεπιλογή στον υποκατάλογο .ostree/repo, είτε απευθείας σε ένα αποθετήριο ostree.


ΕΠΙΛΟΓΕΣ

Οι ακόλουθες παγκόσμιες επιλογές υποστηρίζονται. Οι μεμονωμένες εντολές έχουν τις δικές τους επιλογές.

-h, --help

Εμφάνιση επιλογών βοήθειας και έξοδος.

-v, --verbose

Εμφάνιση πληροφοριών αποσφαλμάτωσης κατά την επεξεργασία των εντολών. Χρησιμοποιήστε το -vv για περισσότερες λεπτομέρειες.

--ostree-verbose

Εμφάνιση πληροφοριών αποσφαλμάτωσης OSTree κατά την επεξεργασία των εντολών.

--version

Εκτύπωση πληροφοριών έκδοσης και έξοδος.

--default-arch

Εκτύπωση της προεπιλεγμένης αρχιτεκτονικής και έξοδος.

--supported-arches

Εκτύπωση των υποστηριζόμενων αρχιτεκτονικών με σειρά προτεραιότητας και έξοδος.

--gl-drivers

Εκτύπωση της λίστας των ενεργών οδηγών gl και έξοδος.

--installations

Εκτύπωση των διαδρομών των εγκαταστάσεων του συστήματος και έξοδος.

--print-system-only

Όταν εκτελείται η εντολή flatpak --print-updated-env, εκτυπώστε μόνο τις μεταβλητές περιβάλλοντος για τις εγκαταστάσεις του συστήματος flatpak, χωρίς να συμπεριλαμβάνεται η εγκατάσταση στην αρχική σελίδα του χρήστη.

--print-updated-env

Εκτύπωση του συνόλου των μεταβλητών περιβάλλοντος που απαιτούνται για τη χρήση των flatpak, τροποποιώντας το τρέχον σύνολο των μεταβλητών περιβάλλοντος. Αυτό προορίζεται για χρήση σε μια γεννήτρια περιβάλλοντος systemd και δεν θα πρέπει να εκτελείται χειροκίνητα.

ΕΝΤΟΛΕΣ

Εντολές για τη διαχείριση των εγκατεστημένων εφαρμογών και των χρόνων εκτέλεσης:

flatpak-install(1)

Εγκατάσταση μιας εφαρμογής ή ενός χρόνου εκτέλεσης από μια απομακρυσμένη τοποθεσία ή μια δέσμη.

flatpak-update(1)

Ενημέρωση μιας εγκατεστημένης εφαρμογής ή χρόνου εκτέλεσης.

flatpak-uninstall(1)

Απεγκατάσταση μιας εγκατεστημένης εφαρμογής ή χρόνου εκτέλεσης.

flatpak-mask(1)

Απόκρυψη ενημερώσεων και αυτόματης εγκατάστασης.

flatpak-pin(1)

Στερέωση χρόνων εκτέλεσης για αποτροπή αυτόματης κατάργησης.

flatpak-list(1)

Λίστα εγκατεστημένων εφαρμογών και/ή χρόνων εκτέλεσης.

flatpak-info(1)

Εμφάνιση πληροφοριών για μια εγκατεστημένη εφαρμογή ή χρόνο εκτέλεσης.

flatpak-history(1)

Εμφάνιση ιστορικού.

flatpak-config(1)

Διαχείριση διαμόρφωσης flatpak.

flatpak-repair(1)

Επιδιόρθωση της εγκατάστασης flatpak.

flatpak-create-usb(1)

Αντιγραφή εφαρμογών και/ή χρόνων εκτέλεσης σε αφαιρούμενα μέσα.

Εντολές για την εύρεση εφαρμογών και χρόνων εκτέλεσης:

flatpak-search(1)

Αναζήτηση εφαρμογών και χρόνων εκτέλεσης.

Εντολές για τη διαχείριση των εκτελούμενων εφαρμογών:

flatpak-run(1)

Εκτέλεση μιας εφαρμογής.

flatpak-kill(1)

Διακοπή μιας εκτελούμενης εφαρμογής.

flatpak-override(1)

Παράκαμψη αδειών για μια εφαρμογή.

flatpak-make-current(1)

Καθορισμός της προεπιλεγμένης έκδοσης για εκτέλεση.

flatpak-enter(1)

Εισαγωγή στον χώρο ονομάτων μιας εκτελούμενης εφαρμογής.

Εντολές για τη διαχείριση της πρόσβασης σε αρχεία:

flatpak-document-export(1)

Παροχή πρόσβασης σε μια συγκεκριμένη εφαρμογή σε ένα συγκεκριμένο αρχείο.

flatpak-document-unexport(1)

Ανάκληση της πρόσβασης σε ένα συγκεκριμένο αρχείο.

flatpak-document-info(1)

Εμφάνιση πληροφοριών σχετικά με ένα συγκεκριμένο αρχείο.

flatpak-documents(1)

Λίστα εξαγόμενων αρχείων.

Εντολές για τη διαχείριση της δυναμικής αποθήκευσης αδειών:

flatpak-permission-remove(1)

Κατάργηση στοιχείου από την αποθήκη αδειών.

flatpak-permissions(1)

Λίστα αδειών.

flatpak-permission-show(1)

Εμφάνιση αδειών εφαρμογής.

flatpak-permission-reset(1)

Επαναφορά αδειών εφαρμογής.

flatpak-permission-set(1)

Ορισμός αδειών εφαρμογής.

Εντολές για τη διαχείριση των απομακρυσμένων αποθετηρίων:

flatpak-remotes(1)

Λίστα όλων των διαμορφωμένων απομακρυσμένων αποθετηρίων.


flatpak-remote-add(1)

Προσθέτει ένα νέο απομακρυσμένο αποθετήριο.

flatpak-remote-modify(1)

Τροποποιεί τις ιδιότητες ενός διαμορφωμένου απομακρυσμένου αποθετηρίου.

flatpak-remote-delete(1)

Διαγράφει ένα διαμορφωμένο απομακρυσμένο αποθετήριο.

flatpak-remote-ls(1)

Εμφανίζει τα περιεχόμενα ενός διαμορφωμένου απομακρυσμένου αποθετηρίου.

flatpak-remote-info(1)

Εμφανίζει πληροφορίες σχετικά με μια αναφορά σε ένα διαμορφωμένο απομακρυσμένο αποθετήριο.

Εντολές για τη δημιουργία εφαρμογών:

flatpak-build-init(1)

Αρχικοποιεί έναν κατάλογο δημιουργίας.

flatpak-build(1)

Εκτελεί μια εντολή δημιουργίας σε έναν κατάλογο δημιουργίας.

flatpak-build-finish(1)

Ολοκληρώνει έναν κατάλογο δημιουργίας για εξαγωγή.

flatpak-build-export(1)

Εξάγει έναν κατάλογο δημιουργίας σε ένα αποθετήριο.

flatpak-build-bundle(1)

Δημιουργεί ένα αρχείο πακέτου από μια αναφορά σε ένα τοπικό αποθετήριο.

flatpak-build-import-bundle(1)

Εισάγει ένα αρχείο πακέτου σε ένα τοπικό αποθετήριο.

flatpak-build-sign(1)

Υπογράφει μια εφαρμογή ή ένα περιβάλλον εκτέλεσης μετά την εξαγωγή του.

flatpak-build-update-repo(1)

Ενημερώνει το αρχείο περίληψης σε ένα αποθετήριο.

flatpak-build-commit-from(1)

Δημιουργεί μια νέα δέσμη ενεργειών βάσει μιας υπάρχουσας αναφοράς.

flatpak-repo(1)

Εκτυπώνει πληροφορίες σχετικά με ένα αποθετήριο.

Εντολές που είναι διαθέσιμες μέσα στο sandbox:

flatpak-spawn(1)

Εκτελεί μια εντολή σε ένα άλλο sandbox.

ΜΟΡΦΕΣ ΑΡΧΕΙΩΝ

Μορφές αρχείων που χρησιμοποιούνται από τις εντολές Flatpak:

flatpakref(5)

Αναφορά σε ένα απομακρυσμένο αποθετήριο για μια εφαρμογή ή ένα περιβάλλον εκτέλεσης

flatpakrepo(5)

Αναφορά σε ένα απομακρυσμένο αποθετήριο

flatpak-remote(5)

Διαμόρφωση για ένα απομακρυσμένο αποθετήριο

flatpak-installation(5)

Διαμόρφωση για μια θέση εγκατάστασης

flatpak-metadata(5)

Πληροφορίες σχετικά με μια εφαρμογή ή ένα περιβάλλον εκτέλεσης

ΠΕΡΙΒΑΛΛΟΝ

Εκτός από τις τυπικές μεταβλητές περιβάλλοντος, όπως οι XDG_DATA_DIRS και XDG_DATA_HOME, το Flatpak συμβουλεύεται επίσης μερικές από τις δικές του μεταβλητές.

FLATPAK_BINARY

Διαδρομή προς το εκτελέσιμο αρχείο flatpak που θα γραφτεί στα αρχεία .desktop και στα σενάρια που εξάγονται όταν μια εφαρμογή εγκατασταθεί. Η προεπιλογή είναι /usr/bin/flatpak, εκτός εάν αντικατασταθεί κατά τη διάρκεια της δημιουργίας με την επιλογή --bindir.

FLATPAK_BWRAP

Διαδρομή προς το εκτελέσιμο αρχείο bwrap(1) που θα χρησιμοποιηθεί για τη δημιουργία του sandbox. Ανάλογα με τον τρόπο με τον οποίο το Flatpak διαμορφώθηκε κατά τη διάρκεια της δημιουργίας, η προεπιλογή είναι είτε η αναζήτηση στην PATH, είτε η χρήση ενός παρεχόμενου αντίγραφου, το οποίο συνήθως εγκαθίσταται ως /usr/libexec/flatpak-bwrap.

FLATPAK_CONFIG_DIR

Η θέση της διαμόρφωσης του Flatpak σε επίπεδο συστήματος. Εάν δεν έχει οριστεί, χρησιμοποιείται η /etc/flatpak (εκτός εάν αντικατασταθεί κατά τη διάρκεια της δημιουργίας με την επιλογή --sysconfdir).

FLATPAK_DATA_DIR

Η θέση των προεπιλογών του Flatpak σε επίπεδο λειτουργικού συστήματος και των ενσωματωμένων βοηθημάτων. Εάν δεν έχει οριστεί, χρησιμοποιείται η /usr/share/flatpak, εκτός εάν αντικατασταθεί κατά τη διάρκεια της δημιουργίας με την επιλογή --datadir.

FLATPAK_DBUSPROXY

Διαδρομή προς το εκτελέσιμο αρχείο xdg-dbus-proxy(1) που θα χρησιμοποιηθεί για τον φιλτράρισμα της κίνησης D-Bus μεταξύ του sandbox και του συστήματος υποδοχής. Ανάλογα με τον τρόπο με τον οποίο το Flatpak διαμορφώθηκε κατά τη διάρκεια της δημιουργίας, η προεπιλογή είναι είτε η αναζήτηση στην PATH, είτε η χρήση ενός παρεχόμενου αντίγραφου, το οποίο συνήθως εγκαθίσταται ως /usr/libexec/flatpak-dbus-proxy.

FLATPAK_DOWNLOAD_TMPDIR

Διαδρομή προς έναν κατάλογο που θα χρησιμοποιηθεί προσωρινά κατά τη λήψη στρωμάτων OCI, και πιθανώς και για άλλες λήψεις στο μέλλον. Δεν χρησιμοποιείται ο τυπικός κατάλογος TMPDIR για αυτό, επειδή οι εφαρμογές Flatpak είναι συχνά πολύ μεγάλες για να χωρέσουν σε ένα tmpfs.


FLATPAK_FANCY_OUTPUT
Μπορεί να οριστεί σε 0 για να αποφευχθεί η περίτεχνη μορφοποίηση κατά την έξοδο σε ένα τερματικό. Αυτή η λειτουργία απενεργοποιείται επίσης αυτόματα όταν η τυπική έξοδος δεν είναι τερματικό ή όταν έχει οριστεί το G_MESSAGES_DEBUG.

FLATPAK_FORCE_TEXT_AUTH
Μπορεί να οριστεί σε 1 για να επιβληθεί η χρήση ενός απλού, ενσωματωμένου πράκτορα polkit(8) όταν απαιτείται έλεγχος ταυτότητας για την τροποποίηση της εγκατάστασης σε όλο το σύστημα. Από προεπιλογή, χρησιμοποιείται ο πράκτορας polkit του περιβάλλοντος εργασίας, εάν είναι διαθέσιμος, με αποτέλεσμα συνήθως μια γραφική προτροπή.

FLATPAK_GL_DRIVERS
Μια λίστα με τελείες που διαχωρίζουν τις επεκτάσεις προγραμμάτων οδήγησης γραφικών που θα δοκιμαστούν για χρήση για το OpenGL, το Vulkan και παρόμοια API, με την πιο προτιμώμενη να είναι πρώτη. Από προεπιλογή, το πρόγραμμα επιλέγει αυτόματα ένα πρόγραμμα οδήγησης γραφικών. Οι τιμές σε αυτήν τη λίστα αντιστοιχούν στο τελευταίο τμήμα που διαχωρίζεται με τελείες των ονομάτων των επεκτάσεων με την κατάσταση active-gl-driver. Τυπικές τιμές είναι οι default, mesa-git ή nvidia-550-120 (αντικαθιστώντας τον αριθμό έκδοσης με την κύρια και δευτερεύουσα έκδοση του kernel module της nvidia).

FLATPAK_RUN_DIR
Η θέση των παγκόσμιων αρχείων χρόνου εκτέλεσης flatpak. Εάν αυτό δεν έχει οριστεί, χρησιμοποιείται το /run/flatpak.

FLATPAK_SYSTEM_CACHE_DIR
Η θέση όπου θα δημιουργηθούν προσωρινά αποθετήρια κατά τη διάρκεια των λήψεων στην εγκατάσταση σε όλο το σύστημα. Εάν αυτό δεν έχει οριστεί, χρησιμοποιείται ένας κατάλογος στο /var/tmp/. Αυτό είναι χρήσιμο επειδή είναι πιο πιθανό να βρίσκεται στο ίδιο σύστημα αρχείων με το αποθετήριο του συστήματος (επομένως αυξάνοντας τις πιθανότητες για π.χ. αντιγραφή με τη χρήση reflink) και μπορούμε να αποφύγουμε τη γέμιση του καταλόγου του χρήστη με προσωρινά δεδομένα.

FLATPAK_SYSTEM_DIR
Η θέση της προεπιλεγμένης εγκατάστασης σε όλο το σύστημα. Εάν αυτό δεν έχει οριστεί, χρησιμοποιείται το /var/lib/flatpak (εκτός εάν αντικατασταθεί κατά τη διάρκεια της δημιουργίας με το --localstatedir ή το -Dsystem_install_dir).

FLATPAK_TTY_PROGRESS
Μπορεί να οριστεί σε 1 για να ενεργοποιηθεί η αναφορά μηχανικά αναγνώσιμης προόδου στο τερματικό. Αυτή η λειτουργία δεν είναι ενεργοποιημένη από προεπιλογή επειδή χρησιμοποιεί την ακολουθία OSC 9;4, την οποία ορισμένα προγράμματα εξομοίωσης τερματικού ερμηνεύουν ως αναδυόμενη ειδοποίηση.

FLATPAK_USER_DIR
Η θέση της εγκατάστασης ανά χρήστη. Εάν αυτό δεν έχει οριστεί, χρησιμοποιείται το $XDG_DATA_HOME/flatpak.

ΔΕΣ ΕΠΙΣΗΣ

ostree(1), ostree.repo(5), flatpak-remote(5), flatpak-installation(5), https://www.flatpak.org