Ruffle - Εξομοιωτής Adobe Flash Player

Το Ruffle είναι ένας εξομοιωτής Adobe Flash Player απαραίτητος για την εκτέλεση παλαιού περιεχομένου Flash (παιχνίδια, κινούμενα σχέδια, εφαρμογές και banners SWF). Λειτουργεί ως αυτόνομη εφαρμογή σε όλα τα λειτουργικά συστήματα (συμπεριλαμβανομένων των Windows, macOS και Linux) και ενσωματώνεται σε προγράμματα περιήγησης μέσω WebAssembly.

Το Ruffle παρέχει ξεχωριστές εκδόσεις για Windows, macOS και Linux που λειτουργούν όπως τα κανονικά προγράμματα: απλά εκτελέστε το εκτελέσιμο αρχείο και ανοίξτε το επιθυμητό αρχείο SWF μέσα σε αυτό.

Το Ruffle αξιοποιεί την ασφάλεια μνήμης της γλώσσας Rust και το sandbox του σύγχρονου προγράμματος περιήγησης. Αυτό επιτρέπει την εκτέλεση δυνητικά επικίνδυνου παλαιού περιεχομένου χωρίς τον κίνδυνο μόλυνσης του συστήματος ή διαρροής δεδομένων.

Ο εξομοιωτής συνδυάζει υποστήριξη τόσο για το παλαιότερο AVM1 (ActionScript 1 και 2, που χρησιμοποιήθηκε μέχρι το 2006) όσο και για το πιο σύνθετο AVM2 (ActionScript 3). Αυτό είναι απαραίτητο για τη σωστή λειτουργία σχεδόν οποιουδήποτε περιεχομένου Flash, από κινούμενα σχέδια των αρχών της δεκαετίας του 2000 έως σύνθετα παιχνίδια και εφαρμογές που κυκλοφόρησαν λίγο πριν την διακοπή της τεχνολογίας.

Σύνδεσμοι λήψης:

Windows (64-bit) macOS Linux (x86_64) Linux (ARM64) Flatpak

Όλοι οι σύνδεσμοι οδηγούν σε επίσημες πηγές: οι εκδόσεις για Windows (x86_64), macOS (universal για Intel και Apple Silicon), Linux (x86_64 και ARM64 για Raspberry Pi και συσκευές ARM) διανέμονται μέσω του αποθετηρίου GitHub του έργου Ruffle, ενώ η έκδοση Linux σε μορφή Flatpak είναι διαθέσιμη μέσω του επίσημου καταλόγου Flathub με ψηφιακές υπογραφές και απομόνωση εφαρμογής.

Περιεχόμενα:

Βασικά Χαρακτηριστικά του Ruffle

Ενσωμάτωση μέσω WebAssembly. Για τη λειτουργία σε πρόγραμμα περιήγησης, το Ruffle μεταγλωττίζεται σε WebAssembly (Wasm) — ένα bytecode χαμηλού επιπέδου που εκτελείται μέσα στο απομονωμένο sandbox του προγράμματος περιήγησης με απόδοση σχεδόν εγγενή. Αυτό επιτρέπει στον εξομοιωτή να φορτώνει και να επεξεργάζεται σύνθετα γραφικά και λογική Flash χωρίς την ανάγκη εγκατάστασης ξεπερασμένων και μη ασφαλών πρόσθετων NPAPI/PPAPI.

Αυτόματη Ανίχνευση και Polyfilling Περιεχομένου Flash. Η διαδικτυακή έκδοση του Ruffle περιλαμβάνει έναν ανιχνευτή JavaScript που σαρώνει τη δομή DOM της σελίδας για στοιχεία object, embed και applet, καθώς και για αρχεία με επέκταση .swf. Κατά την ανίχνευση τέτοιου περιεχομένου, το Ruffle το αντικαθιστά αυτόματα με το δικό του πρόγραμμα αναπαραγωγής, διορθώνοντας διαφανώς τη σελίδα για τον χρήστη και αποκαθιστώντας τη λειτουργικότητα των στοιχείων Flash.

Διπλή Λειτουργία Λειτουργίας (Εφαρμογή Επιφάνειας Εργασίας και Επέκταση Ιστού). Το Ruffle προσφέρει ευελιξία στους χρήστες: μπορεί να χρησιμοποιηθεί ως αυτόνομη εφαρμογή επιφάνειας εργασίας για αναπαραγωγή τοπικών SWF (απλά συσχετίστε αρχεία με το εκτελέσιμο Ruffle) ή ως επέκταση προγράμματος περιήγησης που ενσωματώνεται στο περιβάλλον περιήγησης ιστού, παρέχοντας υποστήριξη Flash σε οποιαδήποτε ιστοσελίδα.

Υποστήριξη για ActionScript 1.0 και 2.0 (AVM1). Το Ruffle υλοποιεί την εικονική μηχανή AVM1, εξασφαλίζοντας συμβατότητα με ένα τεράστιο όγκο περιεχομένου που δημιουργήθηκε πριν από το 2006 και μέχρι το 2013. Το τρέχον επίπεδο συμβατότητας για τις δομές της γλώσσας AVM1 φτάνει το 99%, και για τα API — 81%, εγγυώμενο τη σωστή λειτουργία της συντριπτικής πλειοψηφίας των πρώιμων παιχνιδιών και κινουμένων σχεδίων Flash.

Υποστήριξη για ActionScript 3.0 (AVM2). Για περιεχόμενο που δημιουργήθηκε μετά το 2006, το Ruffle περιλαμβάνει μια υλοποίηση του AVM2. Αν και η εργασία για τη συμβατότητα βρίσκεται σε ενεργή εξέλιξη, ο εξομοιωτής παρέχει ήδη επαρκές επίπεδο υποστήριξης για την εκτέλεση πολλών σύνθετων παιχνιδιών και εφαρμογών γραμμένων σε ActionScript 3, επεκτείνοντας συνεχώς την κάλυψη API και τις γλωσσικές δυνατότητες.

Ασφάλεια σε Επίπεδο Γλώσσας Rust. Ένα από τα κύρια αρχιτεκτονικά πλεονεκτήματα του Ruffle είναι η χρήση της γλώσσας Rust. Η Rust εγγυάται την ασφάλεια μνήμης κατά τη διάρκεια της μεταγλώττισης, εξαλείφοντας πλήρως ολόκληρες κατηγορίες τρωτών σημείων που μάστιζαν τον αρχικό Adobe Flash Player, όπως υπερχειλίσεις buffer, διπλές ελευθερώσεις μνήμης και σφάλματα χρήσης μετά από ελευθέρωση.

Απομόνωση εντός του Sandbox του Προγράμματος Περιήγησης. Όταν λειτουργεί σε διαδικτυακό περιβάλλον, το Ruffle (μέσω WebAssembly) συμμορφώνεται πλήρως με την πολιτική ασφαλείας του προγράμματος περιήγησης. Αυτό προσθέτει ένα επιπλέον επίπεδο απομόνωσης: ο εξομοιωτής δεν έχει άμεση πρόσβαση στο σύστημα αρχείων του χρήστη ή σε άλλες διεργασίες συστήματος, καθιστώντας την εκμετάλλευσή του εξαιρετικά δύσκολη σε σύγκριση με το κλασικό πρόσθετο Flash.

Αποδοτική Διαχείριση Μνήμης. Σε αντίθεση με τον αρχικό Flash Player, που χρησιμοποιούσε συλλογή σκουπιδιών με μη ντετερμινιστικές παύσεις, το Ruffle κληρονομεί το αυστηρό μοντέλο ιδιοκτησίας της Rust. Αυτό επιτρέπει πιο προβλέψιμη χρήση μνήμης, μειώνοντας τον κατακερματισμό και εξαλείφοντας διαρροές μνήμης που συχνά οδηγούσαν σε ασταθή συμπεριφορά του προγράμματος περιήγησης.

Υποστήριξη Γραμμής Εντολών. Η έκδοση επιφάνειας εργασίας του Ruffle προσφέρει μια πλήρως λειτουργική διεπαφή γραμμής εντολών. Οι χρήστες μπορούν να εκτελέσουν τον εξομοιωτή με παραμέτρους, για παράδειγμα: ruffle filename.swf για ένα τοπικό αρχείο, ή ruffle https://example.com/filename.swf για αναπαραγωγή SWF από μια διεύθυνση URL. Η εντολή ruffle --help εμφανίζει μια πλήρη λίστα όλων των διαθέσιμων ορισμάτων και ρυθμίσεων.

Ανοιχτός Κώδικας και Διαφάνεια Ανάπτυξης. Το Ruffle διανέμεται υπό τις άδειες Apache 2.0 και MIT. Η πλήρης ανοιχτότητα του πηγαίου κώδικα σημαίνει ότι οποιοσδήποτε προγραμματιστής μπορεί να ελέγξει την ασφάλεια του εξομοιωτή, να συνεισφέρει διορθώσεις και να συμμετάσχει στην ανάπτυξή του, εξαλείφοντας την πιθανότητα κρυφών λειτουργιών ή τρωτών σημείων που θα μπορούσαν να εισαχθούν από εταιρικούς προγραμματιστές.

Συμβατότητα με ένα Ευρύ Φάσμα Προγραμμάτων Περιήγησης. Χάρη στην τεχνολογία WebAssembly, το Ruffle υποστηρίζεται από όλα τα σύγχρονα προγράμματα περιήγησης, συμπεριλαμβανομένων των Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave και Vivaldi. Αυτό εξασφαλίζει μια συνεπή εμπειρία με περιεχόμενο Flash ανεξάρτητα από τις προτιμήσεις του χρήστη για μηχανές προγράμματος περιήγησης (Chromium, Gecko ή WebKit).

Υποστήριξη για Προγράμματα Περιήγησης Κινητών (iOS και Android). Σε αντίθεση με τον αρχικό Adobe Flash Player, ο οποίος δεν υποστηρίχθηκε ποτέ επίσημα σε iOS και είχε περιορισμένη υποστήριξη σε Android, το Ruffle λειτουργεί σε πλατφόρμες κινητών. Αυτό επιτρέπει την εκτέλεση παιχνιδιών και κινουμένων σχεδίων Flash σε smartphone και tablet απευθείας μέσω του προγράμματος περιήγησης κινητού, ανοίγοντας την πρόσβαση σε αρχειοθετημένο περιεχόμενο για το κοινό κινητής τηλεφωνίας.

Δεν Απαιτείται Διαμόρφωση. Το Ruffle έχει σχεδιαστεί με την αρχή "ρύθμισε και ξέχνα". Μετά την εγκατάσταση της επέκτασης ή την εκκίνηση της εφαρμογής επιφάνειας εργασίας, ο εξομοιωτής δεν απαιτεί πολύπλοκη διαμόρφωση. Ανιχνεύει αυτόματα παραμέτρους αναπαραγωγής όπως το μέγεθος σκηνής, τον ρυθμό καρέ και τον τύπο αλληλεπίδρασης, εφαρμόζοντας βέλτιστες ρυθμίσεις χωρίς παρέμβαση του χρήστη.

Προστασία Ενάντια σε Τρωτά Σημεία Μηδενικής Ημέρας. Επειδή το Ruffle δεν είναι πρόσθετο, δεν χρησιμοποιεί ξεπερασμένα API και ο κώδικάς του είναι γραμμένος σε Rust με έμφαση στην ασφάλεια, είναι απρόσβλητο σε επιθέσεις που ήταν χαρακτηριστικές του Adobe Flash Player. Αυτό το καθιστά μια ιδανική λύση για οργανισμούς που πρέπει να διατηρήσουν πρόσβαση σε παλαιό περιεχόμενο αλλά δεν μπορούν να διακινδυνεύσουν τον συμβιβασμό του συστήματος.

Συμβατότητα με Διάφορες Μεθόδους Εγκατάστασης. Το Ruffle προσφέρει διάφορες μεθόδους ανάπτυξης. Οι προγραμματιστές ιστού μπορούν να το εγκαταστήσουν ως στατική επέκταση σε προγράμματα περιήγησης που βασίζονται σε Chromium (μέσω λειτουργίας προγραμματιστή) ή ως προσωρινό πρόσθετο στον Firefox (μέσω about:debugging). Είναι επίσης διαθέσιμη η ενσωμάτωση μέσω απλής εισαγωγής κώδικα JavaScript στην πλευρά του διακομιστή.

Αναπαραγωγή Περιεχομένου Τόσο Συνδεδεμένου όσο και Μη Συνδεδεμένου. Η έκδοση επιφάνειας εργασίας του Ruffle επιτρέπει το άνοιγμα και την αναπαραγωγή αρχείων SWF που είναι αποθηκευμένα τοπικά στον υπολογιστή. Αυτό καθιστά τον εξομοιωτή ένα απαραίτητο εργαλείο για συλλέκτες, αρχειοθέτες και ερευνητές που εργάζονται με τοπικά αρχεία παιχνιδιών και κινουμένων σχεδίων Flash.

Υψηλή Απόδοση Απόδοσης Γραφικών. Το Ruffle χρησιμοποιεί σύγχρονα API γραφικών (όπως OpenGL, Vulkan, DirectX ή WebGL) μέσω βιβλιοθηκών πολλαπλών πλατφορμών. Αυτό παρέχει επιτάχυνση υλικού για την απόδοση διανυσματικών και ψηφιδωτών γραφικών, επιτρέποντας ομαλή αναπαραγωγή ακόμα και σε πιο αδύναμες συσκευές όπου ο αρχικός Flash Player ενδέχεται να παρουσίαζε καθυστερήσεις.

Ενεργή Ανάπτυξη και Συχνές Ενημερώσεις. Το έργο βρίσκεται σε ενεργή ανάπτυξη. Οι εκδόσεις κυκλοφορούν τακτικά και περιλαμβάνουν τόσο κρίσιμες διορθώσεις σφαλμάτων όσο και διευρυμένη υποστήριξη API ActionScript. Για παράδειγμα, πρόσφατες εκδόσεις έχουν διορθώσει οριακές περιπτώσεις στις μεθόδους String.indexOf και lastIndexOf, και χειρίζονται σωστά αρνητικούς δείκτες στο Array.indexOf.

Ενσωμάτωση με Μεγάλα Αρχεία και Πλατφόρμες. Το Ruffle έχει επιλεγεί ως ο επίσημος προγραμματιστής αναπαραγωγής περιεχομένου Flash από γίγαντες όπως το Internet Archive, το Newgrounds, το Coolmath Games και το Armor Games. Αυτό επιβεβαιώνει τον υψηλό βαθμό αξιοπιστίας και συμβατότητας του εξομοιωτή, καθώς και την ικανότητά του να λειτουργεί υπό υψηλά φορτία σε πραγματικές συνθήκες.

Υποστήριξη για Αποθήκευση και Κατάσταση Παιχνιδιών. Όπως και ο αρχικός Flash Player, το Ruffle υποστηρίζει Local Shared Objects (LSO), τα οποία πολλά παιχνίδια χρησιμοποιούν για να αποθηκεύουν την πρόοδο. Ο εξομοιωτής εξομοιώνει σωστά τους μηχανισμούς ανάγνωσης και εγγραφής δεδομένων σε αυτήν την αποθήκευση, διασφαλίζοντας την ακεραιότητα της αποθήκευσης κατά τη διάρκεια εκτέλεσης της εφαρμογής.

Ακριβής Εξομοίωση Χρονισμών και Ρυθμού Καρέ. Το Ruffle εξομοιώνει με ακρίβεια τον εσωτερικό χρονομετρητή του Flash Player, ο οποίος είναι κρίσιμος για τη λογική παιχνιδιών και κινουμένων σχεδίων. Αυτό εξασφαλίζει τη σωστή συγχρονισμό γεγονότων, ήχου και κίνησης αντικειμένων, αποτρέποντας καταστάσεις όπου ένα παιχνίδι τρέχει πιο αργά ή πιο γρήγορα από το πρωτότυπο.

Υποστήριξη για Αλληλεπίδραση DOM και JavaScript (ExternalInterface). Για σύνθετες διαδικτυακές εφαρμογές που χρησιμοποιούσαν το API ExternalInterface για ανταλλαγή δεδομένων μεταξύ ActionScript και JavaScript, το Ruffle υλοποιεί μια συμβατή γέφυρα. Αυτό επιτρέπει στον εξομοιωτή να χειρίζεται σωστά τις κλήσεις συναρτήσεων και τη μεταφορά δεδομένων, διατηρώντας τη διαδραστικότητα του περιεχομένου με την περιβάλλουσα ιστοσελίδα.

Αυτόματη Κλιμάκωση και Προσαρμογή Ανάλυσης. Κατά την αναπαραγωγή περιεχομένου Flash που δημιουργήθηκε για μια συγκεκριμένη ανάλυση (π.χ., 800x600), το Ruffle εφαρμόζει αυτόματα αλγόριθμους κλιμάκωσης για να προσαρμοστεί στο τρέχον μέγεθος παραθύρου του προγράμματος περιήγησης ή της εφαρμογής επιφάνειας εργασίας. Διατηρεί τις αναλογίες και την ποιότητα εικόνας, και χειρίζεται σωστά τις περιοχές αλληλεπίδρασης του ποντικιού.

Υποστήριξη για Διάφορες Μορφές Πολυμέσων. Ο εξομοιωτής υποστηρίζει την αποκωδικοποίηση διαφόρων μορφών πολυμέσων που μπορεί να είναι ενσωματωμένες σε αρχεία SWF, συμπεριλαμβανομένων των MP3 για ήχο και συμπίεση βίντεο που χρησιμοποιήθηκε σε μεταγενέστερες εκδόσεις του Flash. Η αποκωδικοποίηση εκτελείται μέσω βιβλιοθηκών υψηλής απόδοσης γραμμένων σε Rust, μειώνοντας το φορτίο του συστήματος.

Προηγμένος Εντοπισμός Σφαλμάτων και Καταγραφή. Για προγραμματιστές και προχωρημένους χρήστες, το Ruffle παρέχει τη δυνατότητα ενεργοποίησης λεπτομερών αρχείων καταγραφής των λειτουργιών της εικονικής μηχανής AVM1/AVM2. Αυτό επιτρέπει τη διάγνωση ζητημάτων συμβατότητας, τον εντοπισμό σφαλμάτων στον κώδικα ActionScript και την κατανόηση των εσωτερικών διαδικασιών εξομοίωσης για πιο ακριβή ρύθμιση.

Εξομοίωση Δρομέα και Διαδραστικών Στοιχείων. Το Ruffle χειρίζεται σωστά τις αλλαγές στυλ δρομέα που καθορίζονται από το περιεχόμενο Flash. Για παράδειγμα, για διαδραστικά στοιχεία όπως το LoaderDisplay, ο εξομοιωτής αλλάζει αυτόματα τον τυπικό δρομέα σε δείκτη, μιμούμενος τη συμπεριφορά του αρχικού Flash player και παρέχοντας οικεία πλοήγηση για τον χρήστη.

Υποστήριξη για Nightly Builds για Πρόωρη Πρόσβαση. Εκτός από τις σταθερές εκδόσεις, η ομάδα Ruffle παρέχει πρόσβαση σε καθημερινές πειραματικές Nightly εκδόσεις. Αυτές οι εκδόσεις περιέχουν τις τελευταίες διορθώσεις και καινοτομίες που δεν έχουν ακόμα συμπεριληφθεί στη σταθερή έκδοση.

Διατήρηση της Ψηφιακής Πολιτιστικής Κληρονομιάς. Αυτή δεν είναι απλώς μια τεχνική λειτουργία, αλλά ένας θεμελιώδης στόχος του έργου. Το Ruffle δημιουργήθηκε ως ένα εργαλείο για τη διατήρηση του ιστορικού περιεχομένου του διαδικτύου. Χάρη στην ικανότητά του να λειτουργεί σε σύγχρονα προγράμματα περιήγησης χωρίς να διακυβεύεται η ασφάλεια, εκατομμύρια παιχνίδια Flash, κινούμενα σχέδια και εφαρμογές που θα είχαν χαθεί οριστικά μετά τη διακοπή του Adobe Flash Player παραμένουν προσβάσιμα για τις επόμενες γενιές.

12 Λιγότερο Γνωστές Τεχνικές Δυνατότητες του Ruffle

  1. Χρήση του WGPU ως Κύριου Backend Απόδοσης. Σε αντίθεση με πολλούς εξομοιωτές που βασίζονται σε παλαιότερο OpenGL, το Ruffle χρησιμοποιεί τη βιβλιοθήκη WGPU — ένα σύγχρονο, ασφαλές και πολλαπλών πλατφορμών API γραφικών. Στην επιφάνεια εργασίας, το WGPU επιλέγει αυτόματα το πιο βέλτιστο backend χαμηλού επιπέδου: Vulkan, DirectX 12 ή Metal. Στο πρόγραμμα περιήγησης, μπορεί να λειτουργήσει μέσω WebGPU (όπου είναι διαθέσιμο) ή να εξομοιώσει λειτουργία μέσω WebGL με ελάχιστη απώλεια απόδοσης.

  2. Υποστήριξη WebGPU στο Πρόγραμμα Περιήγησης για Μέγιστη Απόδοση. Για χρήστες σύγχρονων προγραμμάτων περιήγησης (π.χ., τελευταίες εκδόσεις Chrome και Edge), το Ruffle μπορεί να χρησιμοποιήσει το πρωτοποριακό API WebGPU. Αυτό παρέχει σημαντικά μειωμένο χρόνο μεταγλώττισης shader και χαμηλότερη επιβάρυνση σε σύγκριση με το τυπικό backend WebGL, το οποίο είναι κρίσιμο για σύνθετα 3D γραφικά και εφαρμογές Stage3D.

  3. Λεπτομερής Ρύθμιση Backend Απόδοσης (canvas, webgl, wgpu-webgl). Λίγοι γνωρίζουν ότι η συμπεριφορά απόδοσης μπορεί να ελεγχθεί χειροκίνητα. Εκτός από το τυπικό wgpu-webgl, υπάρχει η επιλογή για υποχρεωτική ενεργοποίηση:

    • webgl — ένα κλασικό backend που αρχικοποιείται γρηγορότερα και μπορεί να είναι χρήσιμο για απλό περιεχόμενο που δεν απαιτεί σύνθετα εφέ ψηφίδων.

    • canvas — το πιο αργό, αλλά πιο ακριβές backend. Είναι το μόνο που κλιμακώνει σωστά τις λεπτές γραμμές σε διανυσματικά γραφικά, οι οποίες μπορεί να εμφανίζονται πολύ παχιές όταν χρησιμοποιείται επιτάχυνση υλικού.

  4. Εξομοίωση Stage3D και Μεταγλώττιση AGAL σε WGSL. Το Ruffle υποστηρίζει όχι μόνο 2D γραφικά αλλά και 3D επιτάχυνση μέσω του API Stage3D (Context3D). Οι shaders γραμμένοι σε AGAL (Adobe Graphics Assembly Language) μεταγλωττίζονται "εν κινήσει" σε σύγχρονο WGSL (WebGPU Shading Language) ή GLSL. Αυτό επιτρέπει την εκτέλεση σύνθετων 3D παιχνιδιών και εφαρμογών που δημιουργήθηκαν για Flash Player 11 και άνω, αξιοποιώντας ένα πλήρες pipeline προγραμματιζόμενων shaders.

  5. Υποστήριξη για fscommand για Συμβατότητα προς τα Πίσω. Το Ruffle διατήρησε υποστήριξη για τον παλαιό αλλά σημαντικό μηχανισμό fscommand. Αυτό επιτρέπει σε παλιές ταινίες Flash (που δημιουργήθηκαν πριν από το ExternalInterface) να αλληλεπιδρούν με JavaScript στη σελίδα, στέλνοντας αυθαίρετες εντολές και ορίσματα. Στη σύγχρονη υλοποίηση του Ruffle, αυτές οι εντολές επεξεργάζονται μέσω onFSCommand, επιτρέποντας λειτουργικότητα ακόμα και για πολύ παλαιό διαδικτυακό περιεχόμενο.

  6. Διπλή Αντιμετώπιση Buffer για Context3D. Κατά την εργασία με 3D περιεχόμενο, το Ruffle χρησιμοποιεί έναν εξελιγμένο μηχανισμό διπλής αντιμετώπισης buffer (back buffer / front buffer). Αυτή είναι μια τυπική αλλά κρίσιμα σημαντική τεχνική απόδοσης, που επιτρέπει την απόδοση του επόμενου καρέ στο παρασκηνιακό buffer ενώ το τρέχον εμφανίζεται στην οθόνη, εξαλείφοντας οπτικά τεχνουργήματα (σχίσιμο καρέ) σε δυναμικά παιχνίδια.

  7. Εργαλεία Συγκριτικής Αξιολόγησης: ruffle_scanner και exporter. Μέσα στο αποθετήριο του Ruffle, υπάρχουν βοηθητικά εργαλεία που δεν περιλαμβάνονται στην τυπική έκδοση αλλά είναι διαθέσιμα σε προγραμματιστές:

    • ruffle_scanner — επιτρέπει τον έλεγχο συμβατότητας του εξομοιωτή με έναν ολόκληρο φάκελο αρχείων SWF, δημιουργώντας μια αναφορά CSV σχετικά με την επιτυχία ανάλυσης.

    • exporter — ένα εργαλείο για μαζική δημιουργία στιγμιότυπων οθόνης PNG από αρχεία SWF, το οποίο μπορεί να εκτελεστεί σε λειτουργία χωρίς γραφική διεπαφή (headless), χρήσιμο για αυτοματοποιημένες δοκιμές και δημιουργία προεπισκοπήσεων.

  8. Πλήρης Απομόνωση μέσω Sandbox Flatpak. Για χρήστες Linux, υπάρχει μια επίσημη έκδοση του Ruffle σε μορφή Flatpak. Αυτή δεν είναι απλώς μια μέθοδος εγκατάστασης, αλλά ένα επιπλέον επίπεδο ασφαλείας: η εφαρμογή εκτελείται σε ένα απομονωμένο περιβάλλον όπου όλες οι αποθηκεύσεις, οι ρυθμίσεις και τα αρχεία καταγραφής αποθηκεύονται αυστηρά εντός του καταλόγου home του Flatpak (~/.var/app/rs.ruffle.Ruffle/), χωρίς πρόσβαση στο υπόλοιπο σύστημα.

  9. Υποστήριξη Ενσωμάτωσης μέσω Homebrew και Scoop. Για προχωρημένους χρήστες, το Ruffle προσφέρει προηγμένες μεθόδους εγκατάστασης πέρα από τη μη αυτόματη λήψη. Σε macOS, μπορεί να εγκατασταθεί μέσω Homebrew (brew install --HEAD ruffle-rs/ruffle/ruffle), επιτρέποντας αυτόματες ενημερώσεις στην πιο πρόσφατη nightly έκδοση. Στα Windows, ο διαχειριστής πακέτων Scoop εξυπηρετεί παρόμοια λειτουργία.

  10. Διαφανές Σύστημα Αποθήκευσης Δεδομένων (SharedObjects). Το Ruffle εξομοιώνει με ακρίβεια το σύστημα τοπικής αποθήκευσης Flash (LSO — Local Shared Objects). Ωστόσο, σε αντίθεση με τον ιδιόκτητο προγραμματιστή, η θέση αυτών των αρχείων είναι τυποποιημένη και διαφανής για τον χρήστη. Στα Windows, βρίσκονται στο %AppData%\Local\Ruffle\SharedObjects\, σε Linux — στο ~/.local/share/ruffle/SharedObjects/. Αυτό επιτρέπει τη μη αυτόματη δημιουργία αντιγράφων ασφαλείας αποθηκεύσεων από παλιά παιχνίδια.

  11. Ρύθμιση μέσω JavaScript API και Καθολικών Ρυθμίσεων. Για προγραμματιστές ιστού, το Ruffle παρέχει ένα ισχυρό JavaScript API, που επιτρέπει όχι μόνο την ενσωμάτωση του προγράμματος αναπαραγωγής αλλά και τον έλεγχο της κατάστασής του. Διατίθενται μέθοδοι για προγραμματική φόρτωση SWF (load), έλεγχο έντασης ήχου (volume), παύση (suspend/resume) και παρεμβολή εξόδων trace() από ActionScript για εντοπισμό σφαλμάτων μέσω traceObserver.

  12. Αυτόματη Υπογραφή και Συμβολαιοποίηση Εκδόσεων macOS. Στη διαδικασία CI/CD, όλες οι nightly εκδόσεις του Ruffle για macOS υποβάλλονται σε υπογραφή κώδικα και συμβολαιοποίηση από την Apple. Αυτό σημαίνει ότι ακόμη και οι μη σταθερές εκδόσεις του εξομοιωτή δεν θα αποκλείονται από το Gatekeeper ως μη ασφαλές λογισμικό, εξασφαλίζοντας απρόσκοπτη λειτουργία στις πιο πρόσφατες εκδόσεις macOS όπου οι απαιτήσεις ασφαλείας είναι αυστηρές.

Εγκατάσταση της Έκδοσης Επιφάνειας Εργασίας του Ruffle

Η έκδοση επιφάνειας εργασίας του Ruffle είναι μια εγγενής εφαρμογή που σας επιτρέπει να ανοίγετε και να αναπαράγετε αρχεία SWF απευθείας στον υπολογιστή σας, χωρίς να χρειάζεστε πρόγραμμα περιήγησης. Αυτή είναι μια ιδανική επιλογή για προβολή τοπικών αρχείων παιχνιδιών και κινουμένων σχεδίων Flash.

Windows (10, 11)

Μέθοδος 1: Γραφική Διεπαφή (συνιστάται)

  1. Κατεβάστε το αρχείο με όνομα ruffle-windows-x86_64.zip (για συστήματα 64-bit) ή ruffle-windows-x86.zip (για συστήματα 32-bit).

  2. Εξάγετε τα περιεχόμενα του αρχείου σε οποιονδήποτε βολικό φάκελο (π.χ., C:\Program Files\Ruffle ή C:\Users\[Το_Όνομά_Σας]\Documents\Ruffle).

  3. Για εκτέλεση, κάντε διπλό κλικ στο εκτελέσιμο αρχείο ruffle.exe. Η γραφική διεπαφή της εφαρμογής θα ανοίξει.

  4. Για να ανοίξετε ένα αρχείο SWF, κάντε κλικ στο κουμπί Open File στη διεπαφή ή απλά σύρετε και αποθέστε το αρχείο SWF στο παράθυρο της εφαρμογής.

  5. Εναλλακτική μέθοδος: Ρυθμίστε τη συσχέτιση αρχείων. Κάντε δεξί κλικ σε οποιοδήποτε αρχείο .swf, επιλέξτε Άνοιγμα με → Επιλογή άλλης εφαρμογής, εντοπίστε το ruffle.exe και επιλέξτε την επιλογή Να χρησιμοποιείται πάντα αυτή η εφαρμογή για άνοιγμα αρχείων .swf.

Μέθοδος 2: Γραμμή Εντολών

Για προχωρημένους χρήστες, είναι διαθέσιμη μια διεπαφή γραμμής εντολών:

  1. Ανοίξτε τη Γραμμή Εντολών (CMD) ή το PowerShell.

  2. Μεταβείτε στο φάκελο που περιέχει το ruffle.exe ή προσθέστε αυτόν τον φάκελο στη μεταβλητή περιβάλλοντος PATH.

  3. Για εκτέλεση ενός τοπικού αρχείου, εκτελέστε την εντολή:

    ruffle.exe C:\path\to\your\file.swf

  4. Για εκτέλεση ενός αρχείου SWF από μια διεύθυνση URL:

    ruffle.exe https://example.com/animation.swf

  5. Για προβολή όλων των διαθέσιμων παραμέτρων γραμμής εντολών:

    ruffle.exe --help

Μέθοδος 3: Εγκατάσταση μέσω του Διαχειριστή Πακέτων Scoop

Για όσους προτιμούν την αυτοματοποιημένη εγκατάσταση:

scoop bucket add extras
scoop install ruffle

macOS

Μέθοδος 1: Γραφική Διεπαφή (συνιστάται)

  1. Κατεβάστε το αρχείο ruffle-macos-x86_64.dmg ή ruffle-macos-aarch64.dmg (για Apple Silicon M1/M2/M3) από τη σελίδα εκδόσεων.

  2. Ανοίξτε το ληφθέν αρχείο .dmg.

  3. Σύρετε το εικονίδιο Ruffle στο φάκελο Applications.

  4. Εκκινήστε το Ruffle από το φάκελο Applications. Κατά την πρώτη εκκίνηση, το σύστημα μπορεί να ζητήσει επιβεβαίωση — κάντε κλικ στο Άνοιγμα.

  5. Αφού εκκινηθεί η εφαρμογή, χρησιμοποιήστε το κουμπί Open File ή σύρετε και αποθέστε ένα αρχείο SWF στο παράθυρο.

Μέθοδος 2: Εγκατάσταση μέσω Homebrew

Για προχωρημένους χρήστες:

# Εγκατάσταση της πιο πρόσφατης σταθερής έκδοσης (αν είναι διαθέσιμη)
brew install ruffle

# Ή εγκατάσταση της πιο πρόσφατης nightly έκδοσης από τον πηγαίο κώδικα
brew install --HEAD ruffle-rs/ruffle/ruffle

Μέθοδος 3: Γραμμή Εντολών

Μετά την εγκατάσταση μέσω Homebrew ή τη μη αυτόματη τοποθέτηση του ruffle στο /usr/local/bin:

ruffle ~/Downloads/game.swf
ruffle https://example.com/game.swf

Linux

Μέθοδος 1: Εγκατάσταση μέσω Flatpak (συνιστάται για απομόνωση)

Το Flatpak παρέχει μέγιστη ασφάλεια εκτελώντας το Ruffle σε ένα απομονωμένο sandbox:

# Προσθήκη του αποθετηρίου Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Εγκατάσταση του Ruffle
flatpak install flathub rs.ruffle.Ruffle

# Εκτέλεση
flatpak run rs.ruffle.Ruffle

Μέθοδος 2: Εγκατάσταση μέσω AppImage (δεν απαιτεί εγκατάσταση)

  1. Κατεβάστε το αρχείο ruffle-x86_64.AppImage από τη σελίδα εκδόσεων.

  2. Κάντε το αρχείο εκτελέσιμο:

    chmod +x ruffle-x86_64.AppImage

  3. Εκτελέστε το κάνοντας διπλό κλικ ή μέσω τερματικού:

    ./ruffle-x86_64.AppImage

Μέθοδος 3: Μη αυτόματη Εγκατάσταση (για διανομές που βασίζονται σε Debian/Ubuntu)

  1. Κατεβάστε το ruffle-linux-x86_64.tar.gz (ή ruffle-linux-armv7.tar.gz για συσκευές ARM όπως το Raspberry Pi).

  2. Εξάγετε το αρχείο:

    tar -xzf ruffle-linux-x86_64.tar.gz

  3. Αντιγράψτε το εκτελέσιμο αρχείο σε έναν κατάλογο συστήματος:

    sudo cp ruffle /usr/local/bin/

  4. Εκτελέστε από το τερματικό:

    ruffle

Εγκατάσταση του Ruffle ως Επέκταση Προγράμματος Περιήγησης

Η επέκταση Ruffle ανιχνεύει αυτόματα περιεχόμενο Flash σε οποιαδήποτε ιστοσελίδα και το αντικαθιστά με τον εξομοιωτή.

Σημαντική Σημείωση

Επί του παρόντος, η επέκταση δεν φιλοξενείται σε επίσημα καταστήματα επεκτάσεων (Chrome Web Store, Firefox Add-ons) και βρίσκεται υπό ενεργή ανάπτυξη. Η εγκατάσταση γίνεται χειροκίνητα, μέσω της λειτουργίας προγραμματιστή του προγράμματος περιήγησης.

Εγκατάσταση σε Google Chrome και Προγράμματα Περιήγησης που βασίζονται σε Chromium

Υποστηριζόμενα προγράμματα περιήγησης: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc και άλλα που βασίζονται σε Chromium.

Οδηγίες βήμα προς βήμα:

  1. Μεταβείτε στη σελίδα εκδόσεων του Ruffle στο GitHub.

  2. Κατεβάστε το αρχείο με όνομα ruffle-chromium.zip (ή παρόμοιο που περιέχει chromium).

  3. Εξάγετε το αρχείο σε έναν μόνιμο φάκελο στον υπολογιστή σας. Σημαντικό: Μην διαγράψετε αυτόν τον φάκελο μετά την εγκατάσταση, καθώς το πρόγραμμα περιήγησης θα έχει πρόσβαση σε αυτόν για τη λειτουργία της επέκτασης. Συνιστώμενες θέσεις:

    • Windows: C:\Users\[Το_Όνομά_Σας]\AppData\Local\Ruffle\

    • macOS: ~/Library/Application Support/Ruffle/

    • Linux: ~/.local/share/ruffle/

  4. Ανοίξτε το πρόγραμμα περιήγησής σας και πληκτρολογήστε την ακόλουθη διεύθυνση στη γραμμή διευθύνσεων:

    chrome://extensions/

  5. Στην επάνω δεξιά γωνία της σελίδας, ενεργοποιήστε τη Λειτουργία προγραμματιστή.

  6. Κάντε κλικ στο κουμπί Φόρτωση μη συσκευασμένης επέκτασης.

  7. Στο παράθυρο διαλόγου που ανοίγει, επιλέξτε το φάκελο όπου εξάγατε το αρχείο ruffle-chromium.zip και κάντε κλικ στο Επιλογή φακέλου.

  8. Η επέκταση είναι εγκατεστημένη. Τώρα, όταν επισκέπτεστε ιστότοπους με περιεχόμενο Flash, το Ruffle θα ενεργοποιείται αυτόματα.

Για το Microsoft Edge (Chromium): Η διαδικασία είναι ίδια με το Chrome. Χρησιμοποιήστε edge://extensions/ αντί για chrome://extensions/ και ενεργοποιήστε τη λειτουργία προγραμματιστή.

Εγκατάσταση σε Mozilla Firefox

Σημαντικό: Στον Firefox, η επέκταση εγκαθίσταται μόνο προσωρινά και θα αφαιρεθεί μετά την επανεκκίνηση του προγράμματος περιήγησης. Αυτός είναι ένας περιορισμός του Firefox για μη υπογεγραμμένες επεκτάσεις. Για μόνιμη χρήση, συνιστάται η χρήση της έκδοσης επιφάνειας εργασίας ή η αναμονή για δημοσίευση στο επίσημο κατάστημα.

Οδηγίες βήμα προς βήμα:

  1. Μεταβείτε στη σελίδα εκδόσεων του Ruffle στο GitHub.

  2. Κατεβάστε το αρχείο με όνομα ruffle-firefox.xpi. Κατά τη λήψη, επιλέξτε Αποθήκευση αρχείου.

  3. Στον Firefox, πληκτρολογήστε την ακόλουθη διεύθυνση στη γραμμή διευθύνσεων:

    about:debugging

  4. Στην πλαϊνή γραμμή στα αριστερά, επιλέξτε Αυτός ο Firefox.

  5. Κάντε κλικ στο κουμπί Φόρτωση Προσωρινού Πρόσθετου….

  6. Στο παράθυρο διαλόγου αρχείων, επιλέξτε το ληφθέν αρχείο ruffle-firefox.xpi και κάντε κλικ στο Άνοιγμα.

  7. Η επέκταση θα φορτωθεί και θα ενεργοποιηθεί. Θα λειτουργεί μέχρι να κλείσετε το πρόγραμμα περιήγησης.

Συμβουλή: Εάν χρησιμοποιείτε το Firefox Nightly ή την Developer Edition, μπορείτε να απενεργοποιήσετε την επαλήθευση υπογραφής επεκτάσεων μέσω του about:config, το οποίο επιτρέπει τη μόνιμη εγκατάσταση, αλλά αυτό δεν συνιστάται για καθημερινή χρήση για λόγους ασφαλείας.

Εγκατάσταση σε Safari (macOS)

Η εγκατάσταση της επέκτασης Ruffle στο Safari απαιτεί πρόσθετα βήματα λόγω της πολιτικής ασφαλείας της Apple.

  1. Κατεβάστε το αρχείο ruffle-safari.zip από τη σελίδα εκδόσεων.

  2. Εξάγετε το αρχείο.

  3. Εκτελέστε το αρχείο Ruffle.app από τον εξαγόμενο φάκελο. Αυτό θα εγκαταστήσει την επέκταση στο σύστημά σας.

  4. Ανοίξτε το Safari, μεταβείτε στο Safari → Ρυθμίσεις → στην καρτέλα Επεκτάσεις.

  5. Βεβαιωθείτε ότι ο διακόπτης δίπλα στο Ruffle είναι Ενεργός.

  6. Η επέκταση είναι ενεργοποιημένη και θα λειτουργεί με περιεχόμενο Flash σε ιστοσελίδες.

Εγκατάσταση του Ruffle σε Ιστότοπο (για Διαχειριστές Ιστοσελίδων)

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

Η Απλούστερη Μέθοδος: Χρήση του Προγράμματος Αναπαραγωγής JavaScript

  1. Κατεβάστε το αρχείο ruffle.js και το φάκελο πόρων ruffle από τη σελίδα εκδόσεων.

  2. Μεταφορτώστε αυτά τα αρχεία στο διακομιστή σας (π.χ., σε ένα φάκελο όπως /js/ruffle/).

  3. Προσθέστε τον ακόλουθο κώδικα στην ενότητα <head> κάθε σελίδας όπου υπάρχει περιεχόμενο Flash:

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Ρυθμίσεις προγράμματος αναπαραγωγής
        autoplay: "auto", // "on", "off" ή "auto"
        splashScreen: false, // Απενεργοποίηση οθόνης έναρξης
    };
</script>

  1. Το Ruffle θα ανιχνεύσει αυτόματα όλα τα στοιχεία object, embed και applet στη σελίδα και θα τα αντικαταστήσει με το πρόγραμμα αναπαραγωγής του.

Προηγμένη Ρύθμιση μέσω CDN (χωρίς λήψη αρχείων)

Γρήγορη δοκιμή, μπορείτε να χρησιμοποιήσετε ένα CDN:

<script src="https://unpkg.com/@ruffle-rs/ruffle"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        autoplay: "on",
    };
</script>

Χειροκίνητη Αρχικοποίηση για Δυναμικά Φορτωμένο Περιεχόμενο:

Εάν τα αρχεία SWF προστίθενται στη σελίδα δυναμικά (μέσω JavaScript), μπορείτε να αρχικοποιήσετε χειροκίνητα το πρόγραμμα αναπαραγωγής:

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("path/to/your/file.swf");
document.body.appendChild(player);

Επαλήθευση Λειτουργικότητας

Μετά την εγκατάσταση του Ruffle με οποιαδήποτε μέθοδο, μπορείτε να ελέγξετε τη λειτουργία του:

  1. Έκδοση επιφάνειας εργασίας: Απλά ανοίξτε οποιοδήποτε αρχείο SWF.

  2. Επέκταση προγράμματος περιήγησης: Επισκεφθείτε τη συλλογή παιχνιδιών Flash του Internet Archive ή οποιονδήποτε ιστότοπο με γνωστό περιεχόμενο Flash. Εάν το στοιχείο Flash εμφανίζεται και αναπαράγεται, το Ruffle λειτουργεί σωστά.

  3. Διάγνωση: Στο πρόγραμμα περιήγησής σας, πατήστε F12 για να ανοίξετε τα εργαλεία προγραμματιστή. Στην κονσόλα, θα δείτε μηνύματα από το Ruffle που επιβεβαιώνουν την ενεργοποίησή του.

Αντιμετώπιση Κοινών Προβλημάτων

Πρόβλημα Πιθανή Λύση
Η επέκταση δεν ενεργοποιείται σε έναν ιστότοπο Βεβαιωθείτε ότι ο ιστότοπος δεν είναι αποκλεισμένος στις ρυθμίσεις επέκτασης. Επαληθεύστε ότι η λειτουργία προγραμματιστή είναι ενεργοποιημένη στο chrome://extensions/.
Το αρχείο SWF δεν αναπαράγεται ή εμφανίζει λευκή οθόνη Η τρέχουσα έκδοση του Ruffle ενδέχεται να μην υποστηρίζει αυτό το συγκεκριμένο αρχείο SWF. Ελέγξτε εάν το περιεχόμενο είναι AVM2 (ActionScript 3), η υποστήριξη του οποίου εξακολουθεί να βελτιώνεται.
Δεν είναι δυνατό το άνοιγμα αρχείου στην έκδοση επιφάνειας εργασίας Βεβαιωθείτε ότι το αρχείο δεν είναι κατεστραμμένο. Δοκιμάστε να το ανοίξετε από τη γραμμή εντολών με την επιλογή --verbose για να λάβετε λεπτομερή αρχεία καταγραφής σφαλμάτων.
Η επέκταση εξαφανίστηκε μετά την επανεκκίνηση του Firefox Αυτή είναι φυσιολογική συμπεριφορά για προσωρινές επεκτάσεις. Χρησιμοποιήστε την έκδοση επιφάνειας εργασίας ή περιμένετε την επίσημη δημοσίευση στο κατάστημα πρόσθετων.
Χαμηλή απόδοση στο πρόγραμμα περιήγησης Δοκιμάστε να αλλάξετε το backend απόδοσης στις ρυθμίσεις επέκτασης. Για προγράμματα περιήγησης Chromium, ελέγξτε επίσης εάν η επιτάχυνση υλικού είναι ενεργοποιημένη στις ρυθμίσεις του προγράμματος περιήγησης.