MercuryDevice Farm

Self-hosted real-device lab

Mercury
Device Farm

Android, iOS ve Tizen cihazlarınızı tek tarayıcıdan yönetin.

Gerçek cihazları ekibinizle paylaşın, canlı kontrol edin ve Appium ya da Automation API üzerinden paralel test akışlarına bağlayın.

Kurulumu başlat Demoyu izle
  • Checksum doğrulama
  • Digest ile sabitlenen imaj
  • Otomatik rollback
Android + iOSCanlı ekran ve uzaktan kontrol
Appium + APIProgramatik otomasyon yüzeyi
macOS hostiOS için yerel Xcode araçları
EN + TRÇift dilli operasyon rehberleri

Ürün deneyimi

Cihaz envanterinden canlı kontrole, tek çalışma alanı.

Ekibiniz bağlı cihazları ortak bir envanterde görür, uygun cihazı açar ve fiziksel olarak başında olmadan gerçek ekranla etkileşir.

Mercury Device Farm cihaz envanteri ekranı
Tek merkezden cihaz görünürlüğüDurum, platform ve erişim bilgileri aynı görünümde
Mercury Android uzaktan kontrol ekranı
01

Android kontrol yüzeyi

Bağlı Android cihazın canlı ekranını tarayıcıya taşıyın; ekiplerin uzaktan inceleme ve manuel test akışlarını tek oturumdan yürütmesini sağlayın.

Mercury iOS uzaktan kontrol ekranı
02

iOS kontrol yüzeyi

macOS üzerindeki yerel iOS provider ve WebDriverAgent ile iPhone ve iPad cihazlarını aynı tarayıcı deneyimine dahil edin.

Yetenekler

Manuel kontrolden CI otomasyonuna uzanan tek altyapı.

Mercury yalnızca ekran yayınlamaz. Cihaz erişimini, test otomasyonunu ve sürüm operasyonlarını aynı self-hosted sistemde birleştirir.

01

Gerçek cihaz erişimi

Android ve iOS cihazlarını tarayıcıdan görüntüleyin ve uzaktan yönetin. Tizen tabanlı Smart TV cihazlarını ayrıntılı sağlayıcı rehberiyle laboratuvara ekleyin.

  • Android
  • iOS
  • Tizen
  • Canlı kontrol
02

Test otomasyonu

Mevcut Appium testlerinizi Mercury cihazlarına yönlendirin veya Automation API üzerinden cihazları programatik kullanın. Birden fazla cihazda paralel yürütme akışları kurun.

  • Appium
  • Automation API
  • Parallel execution
03

Self-hosted operasyon

Backend servisleri ve derlenmiş web arayüzü Docker üzerinde çalışır; iOS provider Xcode araçlarına erişebilmek için macOS host üzerinde kalır. Dinamik domain algılama yerel ağ erişimini sadeleştirir.

  • Docker Compose
  • macOS provider
  • Dynamic domain
  • Logs
04

Kontrollü sürüm yaşam döngüsü

Kurucu release arşivini checksum ile doğrular ve Docker imajını değişmez digest ile sabitler. Güncelleme sonrası servis ve UI sağlık kontrolleri başarısız olursa önceki host sürümü ve stack otomatik geri yüklenir.

  • Checksum
  • Digest pinning
  • Health checks
  • Rollback
İstemci

Tarayıcı

Cihaz envanteri, canlı kontrol ve yönetim ekranları.

Kontrol düzlemi

Mercury servisleri

API, kullanıcı erişimi, cihaz durumu ve iş akışları.

Sağlayıcı katmanı

Android / iOS provider

ADB, usbmuxd, Xcode ve WebDriverAgent bağlantıları.

Laboratuvar

Fiziksel cihazlar

Android, iPhone, iPad ve Tizen Smart TV cihazları.

Ürün demosu

Mercury'yi gerçek bir akışta izleyin.

Cihaz listesinden uzaktan kontrol deneyimine kadar temel kullanım yolculuğunu kısa ürün demosunda görün.

Mercury Device Farm demo videosu önizleme görseli

Dokümantasyon

Kurulumdan otomasyona, operasyon rehberleri hazır.

Başlangıç, mimari, Appium, API, iOS ve sorun giderme dokümanları İngilizce ve Türkçe içeriklerle GitHub'da sürümle birlikte tutulur.

README BAŞLANGIÇ

Projenin genel tanıtımı ve hızlı başlangıç.

Dokümantasyon İndeksi

Tüm rehberlerin listelendiği başlangıç noktası.

Getting Started

İlk kurulum ve temel kullanım adımları.

iOS Setup

iOS cihaz sağlayıcı kurulumu ve gereksinimler.

Parallel Execution

Çoklu cihazda paralel test çalıştırma rehberi.

Appium Setup

Appium kurulumu ve yapılandırma adımları.

Appium Integration

Appium ile entegrasyon senaryoları.

Automation API

Otomasyon API'si ile programatik kullanım.

API Reference

Uç noktalar ve istek/yanıt detayları.

Smart TV (Tizen)

Tizen tabanlı Smart TV detaylı rehberi.

Architecture MİMARİ

Sistem mimarisi (EN). TR için: mimari.md.

Troubleshooting

Sık karşılaşılan sorunlar ve çözümleri.
Tüm dokümanları aç

GitHub Release kurulumu

Repoyu klonlamadan dakikalar içinde başlayın.

Public kurulum, host araçlarını release paketinden getirir ve aynı sürüme ait derlenmiş backend ile web UI imajını GHCR üzerinden kullanır.

  • Release arşivi indirilmeden önce checksum ile doğrulanır.
  • Docker imajı değişmez release digest'ine sabitlenir.
  • Android-only kurulumda Node, Xcode ve iOS araçları gerekmez.
# 1) macOS gereksinimleri
brew install --cask docker
brew install --cask android-platform-tools
brew install node
brew install libimobiledevice usbmuxd
xcode-select --install

# 2) Son kararlı release'i kur ve başlat
curl -fsSL https://github.com/erdncyz/mercury-farm/releases/latest/download/install.sh | bash
~/.mercury-farm/mercury up

# 3) iOS için WDA'yı bir kez imzala ve provider'ı kur
open ~/.mercury-farm/current/WebDriverAgent/WebDriverAgent.xcodeproj
~/.mercury-farm/mercury ios-auto
~/.mercury-farm/mercury status
Host uygulamalarını hazırlayın

Docker Desktop'i açıp tamamen başlamasını bekleyin. iOS kullanıyorsanız Xcode'u da en az bir kez açıp ilk kurulumu tamamlayın.

WDA imzasını tamamlayın

WebDriverAgentRunner target'ında Automatically manage signing seçeneğini açıp Team belirleyin. Her zaman ~/.mercury-farm/current altındaki projeyi düzenleyin.

Yerel domain üzerinden bağlanın

mercury status çıktısındaki domain veya IP ile https://<MERCURY_DOMAIN> adresini açın.

Güncelle

mercury update

Host araçlarını, backend'i ve UI'yi birlikte yeniler; ayarlar ile MongoDB volume korunur.

Geri dön

--version vX.Y.Z

Kurucuyu belirli bir release sürümüyle çalıştırıp kontrollü şekilde önceki pakete dönün.

Gözlemle

status / logs

Servis sağlığını doğrulayın veya merkezi log akışını doğrudan CLI üzerinden izleyin.

Kendi altyapın, gerçek cihazların

Gerçek cihaz laboratuvarını kendi ağınızda çalıştırın.

Backend ve CLI Apache 2.0 lisanslıdır. Derlenmiş web arayüzü release imajıyla gelir; UI kaynak kodu özel ve yetkili erişime açıktır.

Son release'i aç Destek / Issues