Ruffle - Adobe Flash Player Emülatörü

Ruffle, eski Flash içeriğini (oyunlar, animasyonlar, uygulamalar ve SWF banner'ları) çalıştırmak için gerekli olan bir Adobe Flash Player emülatörüdür. Tüm işletim sistemlerinde (Windows, macOS ve Linux dahil) bağımsız bir uygulama olarak çalışır ve WebAssembly aracılığıyla tarayıcılara entegre olur.

Ruffle, Windows, macOS ve Linux için normal programlar gibi çalışan ayrı derlemeler sunar: sadece yürütülebilir dosyayı çalıştırın ve istediğiniz SWF dosyasını içinde açın.

Ruffle, Rust dilinin bellek güvenliğinden ve modern tarayıcının korumalı alanından yararlanır. Bu, potansiyel olarak riskli eski içeriğin, sistem enfeksiyonu veya veri sızıntısı riski olmadan çalışmasına olanak tanır.

Emülatör, hem eski AVM1 (2006'ya kadar kullanılan ActionScript 1 ve 2) hem de daha karmaşık AVM2 (ActionScript 3) desteğini birleştirir. Bu, 2000'lerin başındaki animasyonlardan, teknolojinin durdurulmasından hemen önce yayınlanmış karmaşık oyunlara ve uygulamalara kadar neredeyse tüm Flash içeriğinin doğru çalışması için gereklidir.

İndirme bağlantıları:

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

Tüm bağlantılar resmi kaynaklara yönlendirir: Windows (x86_64), macOS (Intel ve Apple Silicon için evrensel), Linux (Raspberry Pi ve ARM cihazları için x86_64 ve ARM64) derlemeleri Ruffle projesinin GitHub deposu aracılığıyla dağıtılırken, Flatpak formatındaki Linux sürümü dijital imzalar ve uygulama izolasyonu ile resmi Flathub kataloğu üzerinden temin edilebilir.

İçindekiler:

Ruffle'ın Temel Özellikleri

WebAssembly ile Entegrasyon. Tarayıcıda çalışmak için Ruffle, WebAssembly (Wasm) formatına derlenir — bu, tarayıcının izole edilmiş korumalı alanı içinde neredeyse yerel performansla yürütülen düşük seviyeli bir bayt kodudur. Bu, emülatörün güncel olmayan ve güvensiz NPAPI/PPAPI eklentilerini kurmaya gerek kalmadan karmaşık Flash grafiklerini ve mantığını yüklemesine ve işlemesine olanak tanır.

Flash İçeriğinin Otomatik Algılanması ve Polyfill ile Değiştirilmesi. Ruffle'ın web sürümü, sayfanın DOM yapısını object, embed ve applet öğeleri ile .swf uzantılı dosyalar için tarayan bir JavaScript algılayıcı içerir. Bu tür içeriği algıladığında, Ruffle bunu otomatik olarak kendi oynatıcısıyla değiştirir, sayfayı kullanıcı için sorunsuz bir şekilde düzeltir ve Flash öğelerinin işlevselliğini geri kazandırır.

İkili Çalışma Modu (Masaüstü Uygulaması ve Web Eklentisi). Ruffle, kullanıcılara esneklik sunar: yerel SWF oynatımı için bağımsız bir masaüstü uygulaması olarak (dosyaları Ruffle yürütülebilir dosyasıyla ilişkilendirmeniz yeterlidir) veya web'de gezinme ortamına entegre olan ve her sitede Flash desteği sağlayan bir tarayıcı eklentisi olarak kullanılabilir.

ActionScript 1.0 ve 2.0 (AVM1) Desteği. Ruffle, AVM1 sanal makinesini uygulayarak 2006 öncesi ve 2013'e kadar oluşturulmuş geniş içerik yelpazesiyle uyumluluk sağlar. AVM1 dil yapıları için mevcut uyumluluk seviyesi %99'a, API'ler için ise %81'e ulaşarak erken dönem Flash oyunlarının ve animasyonlarının büyük çoğunluğunun doğru çalışmasını garanti eder.

ActionScript 3.0 (AVM2) Desteği. 2006 sonrası oluşturulan içerik için Ruffle, AVM2'nin bir uygulamasını içerir. Uyumluluk üzerindeki çalışmalar aktif olarak devam etse de emülatör, ActionScript 3 ile yazılmış birçok karmaşık oyunu ve uygulamayı çalıştırmak için şimdiden yeterli düzeyde destek sağlamakta, API kapsamını ve dil yeteneklerini sürekli olarak genişletmektedir.

Rust Dili Seviyesinde Güvenlik. Ruffle'ın ana mimari avantajlarından biri Rust dilini kullanmasıdır. Rust, derleme zamanında bellek güvenliğini garanti ederek, orijinal Adobe Flash Player'da bulunan arabellek taşmaları, çift boşaltmalar ve kullanımdan sonra boşaltma hataları gibi tüm güvenlik açığı sınıflarını tamamen ortadan kaldırır.

Tarayıcı Korumalı Alanı İçinde İzolasyon. Web ortamında çalışırken Ruffle (WebAssembly aracılığıyla), tarayıcının güvenlik politikasına tamamen uyar. Bu, ek bir izolasyon katmanı ekler: emülatörün kullanıcının dosya sistemine veya diğer sistem süreçlerine doğrudan erişimi yoktur, bu da klasik Flash eklentisine kıyasla istismar edilmesini son derece zorlaştırır.

Verimli Bellek Yönetimi. Belirleyici olmayan duraklamalara sahip çöp toplama kullanan orijinal Flash Player'ın aksine, Ruffle, Rust'ın katı sahiplik modelini devralır. Bu, daha öngörülebilir bellek kullanımı sağlar, parçalanmayı azaltır ve genellikle kararsız tarayıcı davranışına yol açan bellek sızıntılarını ortadan kaldırır.

Komut Satırı Desteği. Ruffle'ın masaüstü sürümü, tam işlevli bir komut satırı arayüzü sunar. Kullanıcılar emülatörü parametrelerle çalıştırabilir, örneğin: yerel bir dosya için ruffle dosyaadi.swf veya bir URL'den SWF oynatmak için ruffle https://example.com/dosyaadi.swf. ruffle --help komutu, mevcut tüm argümanların ve ayarların kapsamlı bir listesini görüntüler.

Açık Kaynak Kod ve Geliştirme Şeffaflığı. Ruffle, Apache 2.0 ve MIT lisansları altında dağıtılır. Kaynak kodun tamamen açık olması, herhangi bir geliştiricinin emülatörün güvenliğini denetleyebileceği, düzeltmeler ekleyebileceği ve geliştirmeye katılabileceği anlamına gelir; bu, kurumsal geliştiriciler tarafından eklenebilecek gizli özellikler veya güvenlik açıkları olasılığını ortadan kaldırır.

Geniş Tarayıcı Yelpazesiyle Uyumluluk. WebAssembly teknolojisi sayesinde Ruffle, Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave ve Vivaldi dahil tüm modern tarayıcılar tarafından desteklenir. Bu, kullanıcıların tarayıcı motoru tercihlerinden (Chromium, Gecko veya WebKit) bağımsız olarak Flash içeriğiyle tutarlı bir deneyim sağlar.

Mobil Tarayıcı Desteği (iOS ve Android). Orijinal Adobe Flash Player'ın iOS'ta hiçbir zaman resmi olarak desteklenmediği ve Android'de sınırlı desteğe sahip olduğu durumun aksine, Ruffle mobil platformlarda çalışır. Bu, Flash oyunlarının ve animasyonlarının akıllı telefonlar ve tabletlerde doğrudan mobil tarayıcı aracılığıyla çalışmasına olanak tanıyarak arşivlenmiş içeriğe mobil kitleler için erişim sağlar.

Yapılandırma Gerektirmez. Ruffle, "kur ve unut" prensibiyle tasarlanmıştır. Eklentiyi kurduktan veya masaüstü uygulamasını başlattıktan sonra, emülatör karmaşık bir yapılandırma gerektirmez. Sahne boyutu, kare hızı ve etkileşim türü gibi oynatım parametrelerini otomatik olarak algılar ve kullanıcı müdahalesi olmadan optimal ayarları uygular.

Sıfır Gün Güvenlik Açıklarına Karşı Koruma. Ruffle bir eklenti olmadığından, güncel olmayan API'ler kullanmadığından ve kodu güvenliğe odaklanarak Rust ile yazıldığından, Adobe Flash Player'ın karakteristik özelliği olan saldırılara karşı bağışıktır. Bu, onu eski içeriğe erişimi sürdürmesi gereken ancak sistemin tehlikeye atılması riskini göze alamayan kuruluşlar için ideal bir çözüm haline getirir.

Çeşitli Kurulum Yöntemleriyle Uyumluluk. Ruffle çeşitli dağıtım yöntemleri sunar. Web geliştiricileri, onu Chromium tabanlı tarayıcılara (geliştirici modu aracılığıyla) statik bir eklenti olarak veya Firefox'ta (about:debugging aracılığıyla) geçici bir eklenti olarak kurabilirler. Sunucu tarafında basit JavaScript kodu eklemesi yoluyla entegrasyon da mevcuttur.

Hem Çevrimiçi Hem Çevrimdışı İçerik Oynatımı. Ruffle'ın masaüstü sürümü, bilgisayarda yerel olarak kaydedilmiş SWF dosyalarını açmaya ve oynatmaya olanak tanır. Bu, emülatörü yerel Flash oyun ve animasyon arşivleriyle çalışan koleksiyoncular, arşivciler ve araştırmacılar için vazgeçilmez bir araç haline getirir.

Yüksek İşleme Performansı. Ruffle, platformlar arası kütüphaneler aracılığıyla modern grafik API'lerini (OpenGL, Vulkan, DirectX veya WebGL gibi) kullanır. Bu, vektör ve raster grafiklerin işlenmesi için donanım hızlandırması sağlayarak, orijinal Flash Player'ın yavaşlayabileceği daha zayıf cihazlarda bile sorunsuz oynatım sağlar.

Aktif Geliştirme ve Sık Güncellemeler. Proje aktif geliştirme aşamasındadır. Sürümler düzenli olarak çıkar ve hem kritik hata düzeltmelerini hem de genişletilmiş ActionScript API desteğini içerir. Örneğin, son sürümler String.indexOf ve lastIndexOf yöntemlerindeki sınır durumları düzeltmiş ve Array.indexOf'daki negatif indeksleri doğru şekilde işlemiştir.

Büyük Arşivler ve Platformlarla Entegrasyon. Ruffle, Flash içeriği oynatımı için resmi oynatıcı olarak Internet Archive, Newgrounds, Coolmath Games ve Armor Games gibi devler tarafından seçilmiştir. Bu, emülatörün yüksek derecede güvenilirliğini ve uyumluluğunu, ayrıca gerçek dünya koşullarında yüksek yük altında çalışabilme yeteneğini doğrular.

Oyun Kayıtları ve Durum Desteği. Orijinal Flash Player gibi Ruffle da birçok oyunun ilerlemeyi kaydetmek için kullandığı Yerel Paylaşılan Nesneleri (LSO) destekler. Emülatör, bu depolama alanına veri okuma ve yazma mekanizmalarını doğru bir şekilde taklit ederek uygulamanın çalışma süresi içinde kayıt bütünlüğünü sağlar.

Zamanlamaların ve Kare Hızının Doğru Taklidi. Ruffle, Flash Player'ın dahili zamanlayıcısını doğru bir şekilde taklit eder; bu, oyun ve animasyon mantığı için kritik öneme sahiptir. Bu, olayların, sesin ve nesne hareketlerinin uygun şekilde senkronize edilmesini sağlayarak bir oyunun orijinalinden daha yavaş veya daha hızlı çalıştığı durumları önler.

DOM ve JavaScript Etkileşimi Desteği (ExternalInterface). ActionScript ile JavaScript arasında veri alışverişi için ExternalInterface API'sini kullanan karmaşık web uygulamaları için Ruffle uyumlu bir köprü uygular. Bu, emülatörün işlev çağrılarını ve veri aktarımını doğru şekilde ele almasına olanak tanıyarak içeriğin çevreleyen web sayfasıyla etkileşimini korur.

Otomatik Ölçekleme ve Çözünürlük Uyarlaması. Belirli bir çözünürlük için oluşturulmuş Flash içeriğini (örneğin 800x600) oynatırken Ruffle, tarayıcının veya masaüstü uygulamasının mevcut pencere boyutuna uyum sağlamak için otomatik olarak ölçekleme algoritmaları uygular. Oranları ve görüntü kalitesini korur ve fare etkileşim alanlarını doğru şekilde işler.

Çeşitli Medya Formatları Desteği. Emülatör, SWF dosyalarına gömülebilecek çeşitli medya formatlarının kod çözümünü destekler; buna ses için MP3 ve Flash'ın sonraki sürümlerinde kullanılan video sıkıştırma dahildir. Kod çözme, Rust ile yazılmış yüksek performanslı kütüphaneler aracılığıyla gerçekleştirilir ve sistem yükünü azaltır.

Gelişmiş Hata Ayıklama ve Günlük Kaydı. Geliştiriciler ve ileri düzey kullanıcılar için Ruffle, AVM1/AVM2 sanal makine işlemlerinin ayrıntılı günlüklerini etkinleştirme olanağı sağlar. Bu, uyumluluk sorunlarını teşhis etmeye, ActionScript kodundaki hataları izlemeye ve daha hassas ayarlama için emülasyonun iç süreçlerini anlamaya olanak tanır.

İmleç ve Etkileşimli Öğe Taklidi. Ruffle, Flash içeriği tarafından belirtilen imleç stili değişikliklerini doğru şekilde işler. Örneğin, LoaderDisplay gibi etkileşimli öğeler için emülatör, standart imleci otomatik olarak bir işaretçiye değiştirerek orijinal Flash oynatıcının davranışını taklit eder ve kullanıcıya tanıdık bir gezinme sağlar.

Erken Erişim için Nightly Derlemeleri Desteği. Kararlı sürümlere ek olarak, Ruffle ekibi günlük deneysel Nightly derlemelerine erişim sağlar. Bu derlemeler, kararlı sürüme henüz dahil edilmemiş en son düzeltmeleri ve yenilikleri içerir.

Dijital Kültürel Mirası Koruma. Bu sadece teknik bir işlev değil, aynı zamanda projenin temel bir hedefidir. Ruffle, tarihi internet içeriğini korumak için bir araç olarak oluşturulmuştur. Modern tarayıcılarda güvenlikten ödün vermeden çalışabilme yeteneği sayesinde, Adobe Flash Player'ın durdurulmasından sonra kalıcı olarak kaybolacak olan milyonlarca Flash oyunu, animasyonu ve uygulaması gelecek nesiller için erişilebilir durumda kalır.

Ruffle'ın 12 Daha Az Bilinen Teknik Yeteneği

  1. Birincil İşleme Arka Ucu Olarak WGPU Kullanımı. Eski OpenGL'e güvenen birçok emülatörün aksine, Ruffle modern, güvenli ve platformlar arası bir grafik API'si olan WGPU kütüphanesini kullanır. Masaüstünde WGPU, en uygun düşük seviyeli arka ucu otomatik olarak seçer: Vulkan, DirectX 12 veya Metal. Tarayıcıda, WebGPU (mevcutsa) aracılığıyla çalışabilir veya minimum performans kaybıyla WebGL üzerinden çalışmayı taklit edebilir.

  2. Maksimum Performans için Tarayıcıda WebGPU Desteği. Modern tarayıcıların kullanıcıları (örneğin, Chrome ve Edge'in en son sürümleri) için Ruffle, son teknoloji WebGPU API'sini kullanabilir. Bu, standart WebGL arka ucuna kıyasla önemli ölçüde azaltılmış gölgelendirici derleme süresi ve daha düşük ek yük sağlar; bu, karmaşık 3D grafikler ve Stage3D uygulamaları için kritik öneme sahiptir.

  3. İnce Ayar Yapılabilen İşleme Arka Ucu (canvas, webgl, wgpu-webgl). Çok az kişi işleme davranışının manuel olarak kontrol edilebileceğini bilir. Standart wgpu-webgl'e ek olarak, zorla etkinleştirme seçeneği vardır:

    • webgl — daha hızlı başlatılan ve karmaşık bitmap efektleri gerektirmeyen basit içerik için yararlı olabilecek klasik bir arka uç.

    • canvas — en yavaş ancak en doğru arka uç. Donanım hızlandırma kullanıldığında çok kalın görünebilecek vektör grafiklerindeki ince çizgileri doğru şekilde ölçekleyen tek arka uçtur.

  4. Stage3D Taklidi ve AGAL'in WGSL'ye Derlenmesi. Ruffle yalnızca 2D grafikleri değil, aynı zamanda Stage3D (Context3D) API'si aracılığıyla 3D hızlandırmayı da destekler. AGAL (Adobe Graphics Assembly Language) ile yazılmış gölgelendiriciler, modern WGSL (WebGPU Shading Language) veya GLSL'ye "anında" derlenir. Bu, Flash Player 11 ve üzeri için oluşturulmuş, programlanabilir gölgelendiricilerin tam hattını kullanan karmaşık 3D oyunların ve uygulamaların çalışmasına olanak tanır.

  5. Geriye Dönük Uyumluluk için fscommand Desteği. Ruffle, eski ancak önemli fscommand mekanizması desteğini korumuştur. Bu, (ExternalInterface'den önce oluşturulmuş) eski Flash filmlerinin JavaScript ile etkileşime girmesine, sayfaya rastgele komutlar ve argümanlar göndermesine olanak tanır. Ruffle'ın modern uygulamasında, bu komutlar onFSCommand aracılığıyla işlenir ve çok eski web içeriği için bile işlevsellik sağlar.

  6. Context3D için Çift Arabelleğe Alma. 3D içerikle çalışırken Ruffle, karmaşık bir çift arabelleğe alma mekanizması (arka arabellek / ön arabellek) kullanır. Bu, standart ancak kritik derecede önemli bir performans tekniğidir ve bir sonraki karenin arka plan arabelleğinde işlenmesine izin verirken mevcut karenin ekranda görüntülenmesini sağlayarak dinamik oyunlarda görsel yırtılmaları (frame tearing) ortadan kaldırır.

  7. Kıyaslama Araçları: ruffle_scanner ve exporter. Ruffle deposu içinde, standart derlemeye dahil olmayan ancak geliştiricilere sunulan yardımcı araçlar vardır:

    • ruffle_scanner — emülatörün bir klasördeki tüm SWF dosyalarıyla uyumluluğunu test etmeye, ayrıştırma başarısı hakkında bir CSV raporu oluşturmaya olanak tanır.

    • exporter — SWF dosyalarından toplu olarak PNG ekran görüntüleri oluşturmak için bir araçtır; GUI olmadan (başsız modda) çalışabilir, bu da otomatik test ve önizleme oluşturma için kullanışlıdır.

  8. Flatpak Sandbox ile Tam İzolasyon. Linux kullanıcıları için resmi bir Ruffle derlemesi Flatpak formatında mevcuttur. Bu sadece bir kurulum yöntemi değil, aynı zamanda ek bir güvenlik katmanıdır: uygulama, tüm kayıtların, yapılandırmaların ve günlüklerin Flatpak ana dizini (~/.var/app/rs.ruffle.Ruffle/) içinde sıkı bir şekilde saklandığı ve sistemin geri kalanına erişimi olmayan izole bir ortamda çalışır.

  9. Homebrew ve Scoop ile Entegrasyon Desteği. Deneyimli kullanıcılar için Ruffle, manuel indirmenin ötesinde gelişmiş kurulum yöntemleri sunar. macOS'ta Homebrew aracılığıyla kurulabilir (brew install --HEAD ruffle-rs/ruffle/ruffle), bu da en son nightly derlemesine otomatik güncellemelere olanak tanır. Windows'ta Scoop paket yöneticisi benzer bir işlev görür.

  10. Şeffaf Veri Depolama Sistemi (SharedObjects). Ruffle, Flash yerel depolama sistemini (LSO — Yerel Paylaşılan Nesneler) doğru bir şekilde taklit eder. Ancak, tescilli oynatıcıdan farklı olarak, bu dosyaların konumu standartlaştırılmıştır ve kullanıcı için şeffaftır. Windows'ta %AppData%\Local\Ruffle\SharedObjects\ konumunda, Linux'ta ise ~/.local/share/ruffle/SharedObjects/ konumunda bulunurlar. Bu, eski oyunlardan kayıtların manuel olarak yedeklenmesine olanak tanır.

  11. JavaScript API ve Genel Ayarlar ile Yapılandırma. Web geliştiricileri için Ruffle, oynatıcıyı yalnızca gömmekle kalmayıp aynı zamanda durumunu kontrol etmeye olanak tanıyan güçlü bir JavaScript API'si sunar. SWF'yi programlı olarak yüklemek (load), ses seviyesini kontrol etmek (volume), duraklatmak (suspend/resume) ve hata ayıklama için traceObserver aracılığıyla ActionScript'ten trace() çıktılarını yakalamak için yöntemler mevcuttur.

  12. macOS Derlemelerinin Otomatik İmzalanması ve Noter Onayı. CI/CD sürecinde, macOS için tüm nightly Ruffle derlemeleri, Apple tarafından kod imzalaması ve noter onayından geçer. Bu, emülatörün kararsız sürümlerinin bile Gatekeeper tarafından güvenli olmayan yazılım olarak engellenmeyeceği ve güvenlik gereksinimlerinin katı olduğu en son macOS sürümlerinde sorunsuz çalışmanın sağlanacağı anlamına gelir.

Ruffle Masaüstü Sürümünü Kurma

Ruffle'ın masaüstü sürümü, bir tarayıcıya ihtiyaç duymadan SWF dosyalarını doğrudan bilgisayarınızda açmanıza ve oynatmanıza olanak tanıyan yerel bir uygulamadır. Bu, yerel Flash oyun ve animasyon arşivlerini görüntülemek için ideal bir seçimdir.

Windows (10, 11)

Yöntem 1: Grafik Arayüz (önerilir)

  1. ruffle-windows-x86_64.zip (64-bit sistemler için) veya ruffle-windows-x86.zip (32-bit sistemler için) adlı dosyayı indirin.

  2. Arşiv içeriğini uygun herhangi bir klasöre çıkarın (örneğin, C:\Program Files\Ruffle veya C:\Users\[Kullanıcı_Adınız]\Documents\Ruffle).

  3. Çalıştırmak için ruffle.exe yürütülebilir dosyasına çift tıklayın. Uygulamanın grafik arayüzü açılacaktır.

  4. Bir SWF dosyasını açmak için arayüzdeki Open File düğmesine tıklayın veya SWF dosyasını doğrudan uygulama penceresine sürükleyip bırakın.

  5. Alternatif yöntem: Dosya ilişkilendirmesini ayarlayın. Herhangi bir .swf dosyasına sağ tıklayın, Open with → Choose another app seçeneğini belirleyin, ruffle.exe dosyasını bulun ve Always use this app to open .swf files seçeneğini işaretleyin.

Yöntem 2: Komut Satırı

Deneyimli kullanıcılar için bir komut satırı arayüzü mevcuttur:

  1. Komut İstemi'ni (CMD) veya PowerShell'i açın.

  2. ruffle.exe dosyasını içeren klasöre gidin veya bu klasörü PATH ortam değişkeninize ekleyin.

  3. Yerel bir dosyayı çalıştırmak için komutu yürütün:

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

  4. Bir URL'den SWF dosyasını çalıştırmak için:

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

  5. Mevcut tüm komut satırı parametrelerini görüntülemek için:

    ruffle.exe --help

Yöntem 3: Scoop Paket Yöneticisi ile Kurulum

Otomatik kurulumu tercih edenler için:

scoop bucket add extras
scoop install ruffle

macOS

Yöntem 1: Grafik Arayüz (önerilir)

  1. Sürümler sayfasından ruffle-macos-x86_64.dmg veya ruffle-macos-aarch64.dmg (Apple Silicon M1/M2/M3 için) dosyasını indirin.

  2. İndirilen .dmg dosyasını açın.

  3. Ruffle simgesini Applications klasörüne sürükleyin.

  4. Ruffle'ı Uygulamalar klasöründen başlatın. İlk başlatışta sistem onay isteyebilir — Open'a tıklayın.

  5. Uygulama başladıktan sonra, Open File düğmesini kullanın veya bir SWF dosyasını pencereye sürükleyip bırakın.

Yöntem 2: Homebrew ile Kurulum

İleri düzey kullanıcılar için:

# En son kararlı sürümü yükleyin (mevcutsa)
brew install ruffle

# Veya kaynaktan en son nightly derlemesini yükleyin
brew install --HEAD ruffle-rs/ruffle/ruffle

Yöntem 3: Komut Satırı

Homebrew ile kurulumdan sonra veya ruffle dosyasını manuel olarak /usr/local/bin konumuna yerleştirdikten sonra:

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

Linux

Yöntem 1: Flatpak ile Kurulum (izolasyon için önerilir)

Flatpak, Ruffle'ı izole bir korumalı alanda çalıştırarak maksimum güvenlik sağlar:

# Flathub deposunu ekleyin
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Ruffle'ı yükleyin
flatpak install flathub rs.ruffle.Ruffle

# Çalıştırın
flatpak run rs.ruffle.Ruffle

Yöntem 2: AppImage ile Kurulum (kurulum gerektirmez)

  1. Sürümler sayfasından ruffle-x86_64.AppImage dosyasını indirin.

  2. Dosyayı yürütülebilir yapın:

    chmod +x ruffle-x86_64.AppImage

  3. Çift tıklayarak veya terminal üzerinden çalıştırın:

    ./ruffle-x86_64.AppImage

Yöntem 3: Manuel Kurulum (Debian/Ubuntu tabanlı dağıtımlar için)

  1. ruffle-linux-x86_64.tar.gz (veya Raspberry Pi gibi ARM cihazlar için ruffle-linux-armv7.tar.gz) dosyasını indirin.

  2. Arşivi çıkarın:

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

  3. Yürütülebilir dosyayı sistem dizinine kopyalayın:

    sudo cp ruffle /usr/local/bin/

  4. Terminalden çalıştırın:

    ruffle

Ruffle'ı Tarayıcı Eklentisi Olarak Kurma

Ruffle eklentisi, herhangi bir web sayfasındaki Flash içeriğini otomatik olarak algılar ve emülatörle değiştirir.

Önemli Not

Şu anda eklenti resmi eklenti mağazalarında (Chrome Web Store, Firefox Eklentileri) barındırılmamaktadır ve aktif geliştirme aşamasındadır. Kurulum, tarayıcının geliştirici modu aracılığıyla manuel olarak yapılır.

Google Chrome ve Chromium Tabanlı Tarayıcılarda Kurulum

Desteklenen tarayıcılar: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc ve Chromium tabanlı diğerleri.

Adım adım talimatlar:

  1. GitHub'daki Ruffle sürümler sayfasına gidin.

  2. ruffle-chromium.zip (veya chromium içeren benzeri) adlı arşivi indirin.

  3. Arşivi bilgisayarınızda kalıcı bir klasöre çıkarın. Önemli: Kurulumdan sonra bu klasörü silmeyin, çünkü tarayıcı eklentinin çalışması için bu klasöre erişecektir. Önerilen konumlar:

    • Windows: C:\Users\[Kullanıcı_Adınız]\AppData\Local\Ruffle\

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

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

  4. Tarayıcınızı açın ve adres çubuğuna aşağıdakini yazın:

    chrome://extensions/

  5. Sayfanın sağ üst köşesinde Geliştirici modu'nu etkinleştirin.

  6. Paketlenmemiş öğe yükle düğmesine tıklayın.

  7. Açılan iletişim kutusunda, ruffle-chromium.zip arşivini çıkardığınız klasörü seçin ve Klasör Seç'e tıklayın.

  8. Eklenti kuruldu. Artık Flash içeriği olan siteleri ziyaret ettiğinizde Ruffle otomatik olarak etkinleşecektir.

Microsoft Edge (Chromium) için: İşlem Chrome ile aynıdır. chrome://extensions/ yerine edge://extensions/ adresini kullanın ve geliştirici modunu etkinleştirin.

Mozilla Firefox'ta Kurulum

Önemli: Firefox'ta eklenti yalnızca geçici olarak kurulur ve tarayıcı yeniden başlatıldığında kaldırılır. Bu, Firefox'un imzalanmamış eklentiler için bir sınırlamasıdır. Kalıcı kullanım için masaüstü sürümünün kullanılması veya resmi mağazada yayınlanmasının beklenmesi önerilir.

Adım adım talimatlar:

  1. GitHub'daki Ruffle sürümler sayfasına gidin.

  2. ruffle-firefox.xpi adlı dosyayı indirin. İndirirken Dosyayı Kaydet'i seçin.

  3. Firefox'ta adres çubuğuna aşağıdakini yazın:

    about:debugging

  4. Sol kenar çubuğunda Bu Firefox'u seçin.

  5. Geçici Eklenti Yükle… düğmesine tıklayın.

  6. Dosya iletişim kutusunda indirilen ruffle-firefox.xpi dosyasını seçin ve Aç'a tıklayın.

  7. Eklenti yüklenecek ve etkinleştirilecektir. Tarayıcıyı kapatana kadar çalışacaktır.

İpucu: Firefox Nightly veya Developer Edition kullanıyorsanız, about:config üzerinden eklenti imza doğrulamasını devre dışı bırakabilirsiniz, bu kalıcı kuruluma izin verir, ancak güvenlik nedenleriyle günlük kullanım için önerilmez.

Safari'de Kurulum (macOS)

Ruffle eklentisini Safari'ye kurmak, Apple'ın güvenlik politikası nedeniyle ek adımlar gerektirir.

  1. Sürümler sayfasından ruffle-safari.zip dosyasını indirin.

  2. Arşivi çıkarın.

  3. Çıkarılan klasörden Ruffle.app dosyasını çalıştırın. Bu, eklentiyi sisteminize kuracaktır.

  4. Safari'yi açın, Safari → Ayarlar → Eklentiler sekmesine gidin.

  5. Ruffle yanındaki anahtarın Açık konumunda olduğundan emin olun.

  6. Eklenti etkinleştirilir ve web sayfalarındaki Flash içeriğiyle çalışacaktır.

Bir Web Sitesine Ruffle Kurulumu (Web Yöneticileri için)

Flash içeriği barındıran bir web siteniz varsa, Ruffle'ı doğrudan sayfa kodunuza entegre edebilirsiniz. Bu, site ziyaretçilerinizin herhangi bir eklenti kurmadan Flash içeriğini otomatik olarak oynatmasına olanak tanır.

En Basit Yöntem: JavaScript Oynatıcıyı Kullanma

  1. Sürümler sayfasından ruffle.js dosyasını ve ruffle kaynak klasörünü indirin.

  2. Bu dosyaları sunucunuza yükleyin (örneğin, /js/ruffle/ gibi bir klasöre).

  3. Flash içeriğinin bulunduğu her sayfanın <head> bölümüne aşağıdaki kodu ekleyin:

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Oynatıcı ayarları
        autoplay: "auto", // "on", "off" veya "auto"
        splashScreen: false, // Başlangıç ekranını devre dışı bırak
    };
</script>

  1. Ruffle, sayfadaki tüm object, embed ve applet öğelerini otomatik olarak algılayacak ve bunları kendi oynatıcısıyla değiştirecektir.

CDN ile Gelişmiş Kurulum (dosya indirmeden)

Hızlı test için bir CDN kullanabilirsiniz:

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

Dinamik Olarak Yüklenen İçerik için Manuel Başlatma:

SWF dosyaları sayfaya dinamik olarak (JavaScript ile) ekleniyorsa, oynatıcıyı manuel olarak başlatabilirsiniz:

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);

İşlevselliği Doğrulama

Ruffle'ı herhangi bir yöntemle kurduktan sonra çalışmasını kontrol edebilirsiniz:

  1. Masaüstü sürümü: Herhangi bir SWF dosyasını açmanız yeterlidir.

  2. Tarayıcı eklentisi: Internet Archive Flash oyunları koleksiyonunu veya bilinen Flash içeriği olan herhangi bir siteyi ziyaret edin. Flash öğesi görüntüleniyor ve oynatılıyorsa, Ruffle doğru çalışıyordur.

  3. Tanılama: Tarayıcınızda geliştirici araçlarını açmak için F12 tuşuna basın. Konsolda, Ruffle'ın etkinleştirildiğini doğrulayan mesajları göreceksiniz.

Yaygın Sorunları Giderme

Sorun Olası Çözüm
Eklenti sitede etkinleşmiyor Eklenti ayarlarında sitenin engellenmediğinden emin olun. chrome://extensions/ adresinde geliştirici modunun etkin olduğunu doğrulayın.
SWF dosyası oynatılmıyor veya beyaz ekran gösteriyor Ruffle'ın mevcut sürümü bu belirli SWF dosyasını desteklemiyor olabilir. İçeriğin AVM2 (ActionScript 3) olup olmadığını kontrol edin, bu desteğin üzerinde hala çalışılmaktadır.
Masaüstü sürümünde dosya açılamıyor Dosyanın bozuk olmadığından emin olun. Ayrıntılı hata günlükleri almak için komut satırından --verbose bayrağı ile açmayı deneyin.
Firefox'u yeniden başlattıktan sonra eklenti kayboldu Bu, geçici eklentiler için normal bir davranıştır. Masaüstü sürümünü kullanın veya eklenti mağazasında resmi yayınlanmayı bekleyin.
Tarayıcıda düşük performans Eklenti ayarlarında işleme arka ucunu değiştirmeyi deneyin. Chromium tarayıcılar için tarayıcı ayarlarında donanım hızlandırmanın etkin olup olmadığını da kontrol edin.