Web uygulamalarını uçtan uca (E2E) test etmek için Playwright son yıllarda oldukça popüler hale geldi. Chromium, Firefox ve WebKit gibi farklı tarayıcıları tek bir API ile test edebilmek büyük kolaylık sağlıyor. Ancak iş Arch Linux üzerinde Playwright kurmaya gelince işler her zaman pürüzsüz ilerlemeyebiliyor. Çeşitli bağımlılıklar, eksik kütüphaneler ve AUR üzerinde sık sık yaşanan paket değişiklikleri kurulum sürecini uzatabiliyor.
Bu yazıda, kendi yaşadığım deneyimlerden ve topluluk çözümlerinden yola çıkarak Arch Linux üzerinde Playwright kurulumunu adım adım anlatacağım. 🎯
1. Playwright Nedir ve Neden Kullanılır?
Öncelikle kısa bir özetle başlayalım. Playwright, Microsoft tarafından geliştirilen açık kaynaklı bir test otomasyon aracıdır. Sunduğu başlıca özellikler:
- 🌐 Chromium, Firefox ve WebKit desteği
- 🖥️ Headless (görünmez) ve headed (görünür) mod desteği
- 📱 Mobil cihaz simülasyonu
- ⚡ Hızlı ve güvenilir test otomasyonu
Eğer bir web geliştiriciyseniz veya CI/CD süreçlerinizi otomatize etmek istiyorsanız Playwright oldukça işinize yarayacaktır.
2. İlk Adım: Gerekli Bağımlılıkların Kurulumu
Arch Linux üzerinde Playwright’ı doğrudan kurmaya kalkarsanız büyük ihtimalle bazı kütüphanelerin eksik olduğuna dair hata mesajlarıyla karşılaşacaksınız. Bu yüzden önce şu bağımlılıkları kurmamız gerekiyor:
sudo pacman -S --needed core/nss core/nspr extra/at-spi2-core extra/libcups extra/libdrm \
core/dbus extra/libxcb extra/libxkbcommon extra/libx11 extra/libxcomposite \
extra/libxdamage extra/libxext extra/libxfixes extra/libxrandr extra/mesa \
extra/pango extra/cairo extra/alsa-lib extra/xorg-server-xvfb
Bu paketlerin çoğu tarayıcıların GUI ile ilgili ihtiyaçlarını karşılar. Özellikle headless modda bile çalışmak için bu bağımlılıklar gereklidir.
3. AUR Üzerinden Playwright Kurulumu
Temel bağımlılıkları yükledikten sonra sıra Playwright’ı kurmaya geliyor. Arch Linux kullanıcıları için en pratik yol AUR üzerinden kurulum yapmak:
yay -S playwright
Kurulum tamamlandığında Playwright’ı kullanabilir hale geleceksiniz. Ancak gerçek dünya tecrübesi gösteriyor ki, çoğu zaman hâlâ bazı kütüphaneler eksik kalabiliyor. 😅
4. Eksik Kütüphaneler ve Çözümleri
Kurulumdan sonra karşılaşabileceğiniz en yaygın hataları ve çözümlerini aşağıda topladım.
🔹 libffi.so.7
ve libpcre.so.3
Hataları
yay -S libffi7
sudo ln -s /usr/lib/libpcre.so /usr/lib/libpcre.so.3
🔹 icu66
ve enchant
yay -S icu66 enchant libffi7
sudo pacman -S woff2 hyphen
🔹 libwebp.so.6
Eksikliği
Eski libwebp sürümü artık AUR’da mevcut değil. İki çözüm var:
- Kaynağından Derlemek
git clone https://chromium.googlesource.com/webm/libwebp
cd libwebp
git checkout v0.5.2-rc2
./autogen.sh
./configure
make
sudo make install
sudo cp src/.libs/libwebp.so.6.0.2 /usr/lib/libwebp.so.6
- Yeni libwebp Paketini Kullanmak
yay -S libwebp
sudo ln -s /usr/lib/libwebp.so.7 /usr/lib/libwebp.so.6
🔹 flite
Bağımlılığı
git clone https://github.com/festvox/flite.git
cd flite
./configure --enable-shared
make
make get_voices
sudo cp build/x86_64-linux-gnu/lib/*.so* /usr/lib
AUR’daki flite1
paketi eksik kütüphanelerle geldiği için genellikle elle derlemek daha sağlıklıdır.
🔹 libxml2
Bağlantı Sorunları
yay -S libxml2
cd /usr/lib
sudo ln -s libxml2.so.16.0.5 libxml2.so.2
5. Playwright’ı Pip ile Kurmak İsteyenlere 👩💻
Eğer AUR ile uğraşmak istemezseniz Playwright’ı pip
üzerinden de kurabilirsiniz:
pip install playwright
python -m playwright install
Ancak bu yöntemle de bağımlılık sorunlarıyla karşılaşabilirsiniz. Debian/Ubuntu için verilen komutlar Arch’ta geçerli değildir. Yine de eksik kütüphaneleri yukarıdaki adımlar ile tamamlayabilirsiniz.
6. ImportError: sync_playwright
Hatası
Bir başka yaygın sorun, aşağıdaki gibi bir import hatası:
from playwright import sync_playwright
Bu yöntem artık eskidi. Doğrusu şu şekilde olmalı:
from playwright.sync_api import sync_playwright
Playwright sürüm notlarını takip edin. Import yolları sık sık değişebiliyor.
7. Sonuç
Arch Linux üzerinde Playwright kurulumu, diğer dağıtımlara göre biraz daha zahmetli olsa da doğru bağımlılıkları yükledikten sonra sorunsuz şekilde çalışıyor. Bu rehberde paylaştığım adımlar ile:
- Gerekli bağımlılıkları kurdunuz ✅
- AUR üzerinden Playwright yüklediniz ✅
- Eksik kütüphaneleri giderdiniz ✅
- Yaygın hatalara çözümler buldunuz ✅
Artık web uygulamalarınızı gönül rahatlığıyla Playwright kullanarak test edebilirsiniz. 🚀
Peki siz Arch Linux üzerinde Playwright kurarken hangi sorunlarla karşılaştınız? Yorumlarda paylaşmayı unutmayın! 😊
Fediverse Yorumları
Mastodon'da Görüntüle