# Install

Υποθέτοντας ότι έχετε ήδη εγκαταστήσει το Node.js (opens new window), θα χρειαστείτε το JVM. Οι απαιτήσεις είναι είτε (Java (opens new window) ή GraalVM (opens new window)).

$ java -version
openjdk version "1.8.0_265"
OpenJDK Runtime Environment (build 1.8.0_265-8u265-b01-0ubuntu2~20.04-b01)
OpenJDK 64-Bit Server VM (build 25.265-b01, mixed mode)

Εάν δείτε ένα παρόμοιο output, αυτό σημαίνει ότι το σύστημά σας διαθέτει αυτήν τη στιγμή java 8, το οποίο δεν είναι η καλύτερη επιλογή καθώς δεν θα επωφεληθεί από τις χρήσεις του κινητήρα υψηλής απόδοσης του es4x

# GraalVM/OpenJDK

Για να έχετε συμβατό runtime, συνιστάται να εγκαταστήσετε υψηλότερο runtime (for example using jabba (opens new window)). Για οδηγίες σχετικά με την εγκατάσταση jabba, ανατρέξτε στον επίσημο manual (opens new window).

TIP

Χρησιμοποιώντας το jabba μπορείτε να εγκαταστήσετε το openjdk 11 και / ή το graalvm (μία φορά) ως:

jabba install [email protected]
jabba install [email protected]

Και αργότερα μεταβείτε στο επιθυμητό runtime εκτελώντας:

jabba use [email protected] # OR jabba use [email protected]

Μόλις εγκατασταθεί ένα έγκυρο JVM, μπορείτε προαιρετικά να εγκαταστήσετε το project management utilities development tool.

# Project Tools

npm install -g @es4x/create # Ή yarn global add @es4x/create

Το πακέτο θα εγκαταστήσει μια εντολή es4x παγκοσμίως που μπορεί να χρησιμοποιηθεί για τη δημιουργία έργων και την εκτέλεση άλλων εργασιών. Για να μάθετε περισσότερα για το εργαλείο:

es4x --help

# Χρησιμοποιώντας το NPX

Το ίδιο πακέτο μπορεί να χρησιμοποιηθεί με το npx. Σε αυτήν την περίπτωση, αναφέρετέ το ως:

npx @es4x/create --help

# Πακέτο OS

Όταν εργάζεστε σε περιβάλλοντα CI όπου το ποσό των πακέτων είναι περιορισμένο, ο διαχειριστής πακέτων μπορεί να εγκατασταθεί αποσυνδέοντας το προσυσκευασμένο αρχείο tar/zip.

ES4X='0.9.0' \
  curl -sL \
  https://github.com/reactiverse/es4x/releases/download/$ES4X/es4x-pm-$ES4X-bin.tar.gz \
  | tar zx --strip-components=1 -C /usr/local

Για λειτουργικά συστήματα Windows το ίδιο μπορεί να γίνει χρησιμοποιώντας ένα αρχείο zip.

TIP

Η χρήση του «npm» θα πρέπει να είναι ο προτιμώμενος τρόπος εγκατάστασης, καθώς επιτρέπει εύκολες αναβαθμίσεις και θα πρέπει να είναι φορητός σε διαφορετικά Λειτουργικά συστήματα.

# Επαληθεύω

Θα πρέπει τώρα να έχετε μια εντολή es4x στο path σας, μπορείτε να τη δοκιμάσετε εκτελώντας:

$ es4x --help

Usage: java -jar /usr/local/bin/es4x-bin.jar [COMMAND] [OPTIONS]
            [arg...]

Commands:
    bare         Creates a bare instance of vert.x.
    dockerfile   Creates a generic Dockerfile for building and deploying the
                 current project.
    project      Initializes the 'package.json' to work with ES4X.
    install      Installs required jars from maven to 'node_modules'.
    list         List vert.x applications
    run          Runs a JS script called <main-verticle> in its own instance of
                 vert.x.
    start        Start a vert.x application in background
    stop         Stop a vert.x application
    version      Displays the version.

Run 'java -jar /usr/local/bin/es4x-bin.jar COMMAND --help' for
more information on a command.

WARNING

Για καλύτερη εμπειρία και απόδοση, εγκαταστήστε το GraalVM (opens new window). Όταν εργάζεστε σε τυπικό JDK, Η χρήση Java <11 θα εκτελεστεί σε λειτουργία Interpreted που δεν είναι απόδοση ή δεν συνιστάται για παραγωγή.