Εγκατάσταση της Unison τοπικά

Μάθε πώς να εγκαταστήσεις την Unison τοπικά για να λύνεις τις ασκήσεις του Exercism στον υπολογιστή σου.

Επιλογές εγκατάστασης

Η τρέχουσα έκδοση του Unison είναι διαθέσιμη για χρήστες Mac OS X, 64-bit Linux και Windows! Ελπίζουμε ότι αν δοκιμάζεις το Unison, θα έρθεις να μας μιλήσεις στο φόρουμ του Exercism ή στο Unison Discord. Έλα να κάνεις ερωτήσεις και να αναφέρεις προβλήματα που μπορεί να συναντήσεις! Θέλουμε να έχεις μια φιλόξενη και θετική εμπειρία όταν ξεκινάς! 😊

Το Unison μπορείς να το κατεβάσεις με homebrew, με Nix ή απευθείας μέσω έτοιμων δυαδικών αρχείων. Όλες αυτές οι επιλογές λήψης περιγράφονται στη σελίδα οδηγιών εγκατάστασης της ιστοσελίδας μας. Μόλις εγκαταστήσεις το UCM, γύρνα πάλι εδώ!

Επιλογή 1: Χρήση του Homebrew

Πρώτα εγκατέστησε το homebrew αν δεν το έχεις κάνει ήδη.

Έπειτα, από τη γραμμή εντολών, πληκτρολόγησε αυτές τις εντολές:

brew tap unisonweb/unison
brew install unison-language

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

brew upgrade unison-language.

Σημείωση: αν σε αυτό το σημείο σου ζητηθεί όνομα χρήστη και κωδικός του GitHub, βεβαιώσου ότι έγραψες σωστά το unisonweb/unison.

Επιλογή 2: Χειροκίνητη εγκατάσταση για χρήστες Mac και Linux

Οι σύνδεσμοι για χειροκίνητη εγκατάσταση σε Linux και Mac βρίσκονται εδώ στην αντίστοιχη ενότητα χειροκίνητης λήψης για Linux και Mac.

Θα εκτελέσεις στο shell σου μια εντολή που μοιάζει κάπως έτσι, αλλά ο παραπάνω σύνδεσμος θα περιέχει το πιο ενημερωμένο δυαδικό αρχείο:

mkdir unisonlanguage
curl -L https://github.com/unisonweb/unison/releases/download/release_VERSION_NAME/ucm-YOUR_PLATFORM.tar.gz --output unisonlanguage/ucm.tar.gz
tar -xzf unisonlanguage/ucm.tar.gz -C unisonlanguage
./unisonlanguage/ucm

Επιλογή 3: Χειροκίνητη εγκατάσταση για χρήστες Windows

  1. Όρισε την προεπιλεγμένη εφαρμογή τερματικού σε "Windows Terminal" για καλύτερα αποτελέσματα. Αναζήτησε το "Terminal" στις Ρυθμίσεις ή ακολούθησε αυτόν τον οδηγό.
  2. Αν δεν είσαι σίγουρος ότι το έχεις ήδη, εγκατέστησε το Git:
  • Μέσω winget: winget install --id Git.Git -e --source winget
  • Αν έχεις Windows 10 και δεν έχεις το winget, μπορείς να το εγκαταστήσεις από το Microsoft Store και μετά να εκτελέσεις την παραπάνω εντολή.
  1. Κατέβασε το UCM με τον σύνδεσμο που δίνεται εδώ και αποσυμπίεσέ το σε μια τοποθεσία της επιλογής σου.
  2. Εκτέλεσε το ucm.exe

Επιλογή 4: Εγκατάσταση με Nix

Πήγαινε στο https://github.com/ceedubs/unison-nix/#usage και ακολούθησε τις οδηγίες στο readme εκεί.

Δημιούργησε τη βάση κώδικα του Unison

Εκτέλεσε το ucm για να αρχικοποιήσεις μια βάση κώδικα του Unison στο $HOME/.unison. Εδώ θα αποθηκεύει το Unison ορισμούς συναρτήσεων, τύπους, χώρους ονομάτων και τα λοιπά. Από προεπιλογή, ο Διαχειριστής Βάσης Κώδικα του Unison (συντομογραφία "UCM") θα αρχίσει να κατεβάζει την τυπική βιβλιοθήκη, που ονομάζεται base, την οποία θα χρησιμοποιείς για να γράφεις κώδικα Unison. Μπορεί να πάρει λίγη ώρα! 🕰

Ροή εργασίας στο Unison

Όταν θέλεις να γράψεις κώδικα Unison, θα δίνεις την εντολή ucm για να ξεκινήσεις τον διαχειριστή βάσης κώδικα. Στη συνέχεια, το UCM θα παρακολουθεί αλλαγές σε οποιοδήποτε αρχείο με κατάληξη .u στον κατάλογο από τον οποίο καλείται. Για παράδειγμα, μπορεί να υλοποιείς συναρτήσεις σε ένα αρχείο με όνομα scratch.u σε έναν κατάλογο με όνομα ~/exercism/unison/my-exercise/. Θα πρέπει να κάνεις cd στο ~/exercism/unison/my-exercise/ και να εκτελέσεις το ucm. Έτσι θα διασφαλίσεις ότι το UCM παρακολουθεί το αρχείο scratch.u σου για αλλαγές.

Αν ποτέ μπερδευτείς σχετικά με το ποιον κατάλογο παρακολουθεί το ucm για αλλαγές αρχείων, αυτός εκτυπώνεται στην οθόνη καλωσορίσματος όταν ξεκινάς το πρόγραμμα γραμμής εντολών.

👀 I'm watching for changes to .u files under /Users/myUser/exercism/unison/my-exercise

Δες περισσότερες συμβουλές για τη ροή εργασίας εδώ!

Υποστήριξη επεξεργαστών

Μπορείς να χρησιμοποιήσεις οποιονδήποτε επεξεργαστή κειμένου για να γράψεις τα αρχεία .u σου. Το Unison έχει υποστήριξη LSP, οπότε το αγαπημένο σου IDE μπορεί να βοηθήσει σε πράγματα όπως τύπους όταν περνάς τον κέρσορα πάνω και αυτόματη συμπλήρωση. Παρακάτω αναφέρονται μερικοί δημοφιλείς επεξεργαστές με υποστήριξη Unison:

Vim

Χρησιμοποιώντας το vim-plug:

  1. Εγκατέστησε το vim-plug αν δεν το έχεις κάνει ήδη.
  2. Πρόσθεσε τα παρακάτω στο .vimrc σου: Plug 'unisonweb/unison', { 'branch': 'trunk', 'rtp': 'editor-support/vim' }
  3. Δώσε την εντολή vim :PlugInstall.

Για περισσότερες πληροφορίες, εκτέλεσε :help unison μέσα από το vim ή δες το διαδικτυακό έγγραφο βοήθειας.

Atom

Από την κονσόλα, εκτέλεσε:

apm install unisonweb/atom-unison

VS Code

  1. Άνοιξε την προβολή Extensions κάνοντας κλικ στο εικονίδιο Extensions στη γραμμή Activity Bar στο πλάι του VS Code ή με ⇧⌘X.
  2. Αναζήτησε το "unison"
  3. Εγκατέστησε την επέκταση Unison για το VS Code

Emacs

Εγκατέστησε το unison-mode.