Pardus 25’e Waydroid Kurulum Rehberi
Hazırlayan: Pardus Topluluğu
Tarih: Mart 2026
Test Ortamı: Pardus 25 (Debian Trixie tabanlı), GNOME, Kernel 6.12.74
Giriş
Waydroid, Android’i Linux üzerinde konteyner tabanlı çalıştıran bir uyumluluk katmanıdır. Bu rehber, Pardus 25’e Waydroid kurulumu sırasında karşılaşılan tüm sorunları ve çözümlerini adım adım anlatmaktadır.
Önemli Uyarılar
- Waydroid yalnızca Wayland oturumunda çalışır. Xfce masaüstü desteklenmez, GNOME (Wayland) oturumu gereklidir.
- NVIDIA ekran kartlarında Waydroid genellikle çalışmaz. AMD veya Intel iGPU önerilir.
Aşama 1: Waydroid Deposunu Ekle ve Kur
Pardus 25, Debian Trixie tabanlıdır. Eski rehberlerde bookworm veya bullseye yazıyor olabilir — bunlar çalışmaz.
bash
export distro=trixie
sudo curl https://repo.waydro.id/waydroid.gpg \
--output /usr/share/keyrings/waydroid.gpg
echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/ ${distro} main" | \
sudo tee /etc/apt/sources.list.d/waydroid.list
sudo apt update
Bu aşamada
sudo apt install waydroidçalışmaz. Pardus 25’teki Python 3.13 ilepython3-gbinderbağımlılığı uyumsuzdur. Waydroid kaynaktan kurulacak.
Aşama 2: Binder Kernel Modülünü Yükle
bash
sudo apt install -y build-essential dkms linux-headers-$(uname -r)
sudo modprobe binder_linux devices=binder,hwbinder,vndbinder
Modülün yüklendiğini doğrula:
bash
lsmod | grep binder
Çıktıda binder_linux görünüyorsa devam edebilirsin.
linux-modules-extrapaketi Pardus 25’te mevcut değildir, bu normal.
Aşama 3: Binder’ın Kalıcı Yüklenmesini Sağla
Sistem yeniden başlatıldığında binder modülünün otomatik yüklenmesi için:
bash
echo "binder_linux" | sudo tee /etc/modules-load.d/waydroid.conf
echo "options binder_linux devices=binder,hwbinder,vndbinder" | sudo tee /etc/modprobe.d/waydroid.conf
Aşama 4: gbinder-python’u Kaynaktan Derle
Pardus 25’te Python 3.13 gelir. Resmi python3-gbinder paketi Python < 3.12 gerektirir, bu yüzden kaynaktan derleme zorunludur.
bash
# Gerekli derleme bağımlılıklarını kur
sudo apt install -y \
python3.13-dev \
libgbinder-dev \
libglibutil-dev \
libglib2.0-dev \
python3-setuptools \
cython3
# gutil header'larını erişilebilir yap
sudo ln -sf /usr/include/gutil/gutil*.h /usr/include/
# gbinder-python'u indir ve derle
cd ~
wget https://github.com/waydroid/gbinder-python/archive/refs/heads/main.tar.gz \
-O gbinder-python.tar.gz
tar -xzf gbinder-python.tar.gz
cd gbinder-python-main
sudo python3 setup.py install
Aşama 5: Waydroid’i Kaynaktan Kur
bash
cd ~
wget https://github.com/waydroid/waydroid/archive/refs/heads/main.tar.gz \
-O waydroid.tar.gz
tar -xzf waydroid.tar.gz
cd waydroid-main
sudo make install
Aşama 6: dbus Python Modülünü Bağla
Waydroid, python3-dbus modülüne ihtiyaç duyar. Sistemde pyenv kuruluysa Python path çakışması olur. Şu komutlarla bağlantıyı kur:
bash
sudo apt install -y python3-dbus
sudo ln -sf /usr/lib/python3/dist-packages/dbus \
/usr/local/lib/python3.13/dist-packages/dbus
sudo ln -sf /usr/lib/python3/dist-packages/_dbus_bindings.cpython-313-x86_64-linux-gnu.so \
/usr/local/lib/python3.13/dist-packages/
sudo ln -sf /usr/lib/python3/dist-packages/_dbus_glib_bindings.cpython-313-x86_64-linux-gnu.so \
/usr/local/lib/python3.13/dist-packages/ 2>/dev/null || true
Waydroid binary’sinin sistem Python’unu kullanmasını sağla:
bash
sudo sed -i 's|#!/usr/bin/env python3|#!/usr/bin/python3|' /usr/bin/waydroid
Aşama 7: Systemd Servisini Yapılandır
Waydroid container servisi için PYTHONPATH’i ayarla:
bash
sudo systemctl edit waydroid-container.service --force
Açılan editöre şunu yaz ve kaydet:
[Service]
Environment="PYTHONPATH=/usr/lib/waydroid"
Aşama 8: LXC’yi Kur ve Android İmajını İndir
bash
sudo apt install -y lxc
sudo waydroid init
Bu işlem ~1 GB dosya indirir, internet hızına göre birkaç dakika sürebilir.
Aşama 9: Waydroid’i Başlat
bash
sudo systemctl daemon-reload
sudo systemctl start waydroid-container
waydroid session start &
waydroid show-full-ui
Aşama 10 (İsteğe Bağlı): Google Play Store Kurulumu
bash
# Gerekli bağımlılıklar
sudo apt install -y lzip
# waydroid_script'i indir
cd ~
wget https://github.com/casualsnek/waydroid_script/archive/refs/heads/main.tar.gz \
-O waydroid_script.tar.gz
tar -xzf waydroid_script.tar.gz
cd waydroid_script-main
# Bağımlılıkları sistem Python'una kur
sudo /usr/bin/python3 -m pip install -r requirements.txt --break-system-packages
# Çalıştır
cd ~/waydroid_script-main
sudo PYTHONPATH=/home/KULLANICI_ADI/waydroid_script-main /usr/bin/python3 main.py
KULLANICI_ADIkısmını kendi kullanıcı adınla değiştir.
Menüden sırayla:
- Android 13 seç
- Install seç
- GApps seç
Kurulum bitince:
bash
sudo waydroid session stop
sudo systemctl restart waydroid-container
waydroid session start &
waydroid show-full-ui
APK Yükleme
bash
waydroid app install /yol/uygulama.apk
waydroid app list
waydroid app remove com.paket.adi
Sık Karşılaşılan Hatalar ve Çözümleri
| Hata | Neden | Çözüm |
|---|---|---|
binder_linux not found |
Kernel modülü yüklenmemiş | sudo modprobe binder_linux devices=binder,hwbinder,vndbinder |
python3-gbinder bağımlılık hatası |
Python 3.13 uyumsuzluğu | Aşama 4’teki kaynaktan derleme adımları |
No module named 'tools' |
Python path çakışması | PYTHONPATH=/usr/lib/waydroid ayarla |
No module named 'dbus' |
pyenv ile path çakışması | Aşama 6’daki symlink komutları |
LXC is not installed |
lxc kurulu değil | sudo apt install -y lxc |
| Servis başlamıyor | PYTHONPATH eksik | Aşama 7’deki systemd override |
| GitHub kimlik soruyor | HTTPS auth değişikliği | wget ile tarball indir |
Notlar
- Bu rehber Pardus 25 + GNOME + Wayland kombinasyonu için test edilmiştir.
- Sisteminizde pyenv kuruluysa Python path çakışmaları yaşanabilir; rehberdeki symlink adımlarına dikkat edin.
- Waydroid oturumu her sistem açılışında manuel başlatılması gerekebilir (
waydroid session start). - Google Play Store kurulumu isteğe bağlıdır; APK dosyaları ile de uygulama yüklenebilir.
