Mobil emülasyon

Chrome, Chrome Geliştirici Araçları ile cihaz modunu etkinleştirerek kullanıcıların, Chrome'un masaüstü sürümünden Chrome'u bir mobil cihazda emüle etmesine olanak tanır. Bu özellik web geliştirmeyi hızlandırır ve geliştiricilerin, gerçek bir cihaz gerekmeden bir web sitesinin mobil cihazda nasıl oluşturulduğunu hızlı bir şekilde test etmesine olanak tanır. ChromeDriver, sözlük değeriyle belirtilen "mobileEmulation" özelliğine sahip cihazları da taklit edebilir.

DevTools'ta olduğu gibi, ChromeDriver'da da mobil emülasyonu etkinleştirmenin iki yolu vardır:

• Bilinen bir cihazı belirtme
• Cihaz özelliklerini tek tek belirtme

"mobileEmulation" sözlüğünün biçimi, hangi yönteme ihtiyaç duyulduğuna bağlıdır.

Bilinen bir mobil cihazı belirtme

Belirli bir cihazla cihaz emülasyonunu etkinleştirmek için "mobileEmulation" sözlüğünde "deviceName" bulunmalıdır. "deviceName" için değer olarak DevTools taklit cihaz ayarlarından geçerli bir cihaz adı kullanın.

Java

Map<String, String> mobileEmulation = new HashMap<>();
mobileEmulation.put("deviceName", "Nexus 5");
ChromeOptions chromeOptions = new ChromeOptions();
chromeOptions.setExperimentalOption("mobileEmulation", mobileEmulation);
WebDriver driver = new ChromeDriver(chromeOptions);

Ruby

mobile_emulation = { "deviceName" => "Nexus 5" }
caps = Selenium::WebDriver::Remote::Capabilities.chrome(
   "chromeOptions" => { "mobileEmulation" => mobile_emulation })
driver = Selenium::WebDriver.for :remote, url: 'http://localhost:4444/wd/hub',
desired_capabilities: caps

Python

from selenium import webdriver
mobile_emulation = { "deviceName": "Nexus 5" }
chrome_options = webdriver.ChromeOptions()
chrome_options.add_experimental_option("mobileEmulation", mobile_emulation)
driver = webdriver.Remote(command_executor='http://127.0.0.1:4444/wd/hub',
desired_capabilities = chrome_options.to_capabilities())

Not: ChromeDriver'ın bilinen cihazlar listesi, DevTools Emülasyon panelinde bulunan cihazlardan oluşturulur. Ancak ChromeDriver'ın bir sürümünü, Chrome'un daha yeni veya daha eski bir cihaz listesine sahip sürümüyle kullanmak mümkündür. ChromeDriver'ın tanımadığı bir cihaz adını kullanmaya çalışırsanız "<your device name> geçerli bir cihaz olmalıdır." hatası alırsınız. ChromeDriver'ın bilmediği bir cihazı taklit etmek için ayrı cihaz metriklerini kullanarak mobil emülasyonu etkinleştirin.

Cihaz özelliklerini tek tek belirtme

Mobil emülasyonu, tek tek özellikleri belirterek etkinleştirebilirsiniz. "mobileEmulation" sözlüğü deviceMetrics, clientHints sözlükleri ve bir userAgent dizesi içerebilir.

"deviceMetrics" sözlüğünde aşağıdaki cihaz metrikleri belirtilmelidir:

• "width": Cihaz ekranının piksel cinsinden genişliği
• "height": Cihaz ekranının piksel cinsinden yüksekliği
• "pixelRatio": Cihazın piksel oranı
• "touch": Dokunma etkinliklerinin taklit edilip edilmeyeceğini belirtir. Değer varsayılan olarak doğrudur ve genellikle atlanabilir.
• "mobile": Tarayıcının mobil kullanıcı aracısı gibi davranması gerekip gerekmediği (kaydırma çubuklarını yer paylaşımı, yön etkinlikleri yayınlama, içeriği görüntü alanına sığacak şekilde küçültme vb.). Değer varsayılan olarak doğrudur ve genellikle atlanabilir.

"clientHints" sözlüğü aşağıdaki girişleri içerebilir:

• "platform" - işletim sistemi. Belirli bir platformda çalışan Chrome tarafından döndürülen değerle tam olarak eşleşen bilinen bir değer ("Android", "Chrome OS", "Chromium OS", "Fuchsia", "Linux", "macOS", "Windows") veya kullanıcı tanımlı bir değer olabilir. Bu değer zorunludur.
• "mobil" - tarayıcının mobil kaynak mı yoksa masaüstü kaynak sürümü mü istemesi gerektiği. Android yüklü bir cep telefonunda çalışan Chrome genellikle bu değeri true olarak ayarlar. Android tablet cihazdaki Chrome bu değeri false olarak ayarlar. Masaüstü cihazlardaki Chrome da bu değeri false olarak ayarlar. Gerçekçi bir emülasyon belirtmek için bu bilgileri kullanabilirsiniz. Bu değer zorunludur.
• Kalan girişler isteğe bağlıdır ve testle alakalı olmadıkları sürece atlanabilir:
  • "brands": Marka / büyük sürüm çiftlerinin listesi. Atlanırsa tarayıcı kendi değerlerini kullanır.
  • "fullVersionList": marka / sürüm çiftlerinin listesi. Tarayıcının kendi değerlerini kullanması atlanmıştır.
  • "platformVersion": OS sürümü. Varsayılan olarak boş dizedir.
  • "model": cihaz modeli. Varsayılan olarak boş dizedir.
  • "architecture": CPU mimarisi. Bilinen değerler "x86" ve "arm"dır. Kullanıcı herhangi bir dize değeri sağlayabilir. Varsayılan olarak boş dize kullanılır.
  • "bitness": Platform bitliği. Bilinen değerler "32" ve "64"tür. Kullanıcı istediği dize değerini sağlayabilir. Varsayılan olarak boş dize kullanılır.
  • "wow64": Windows 64'te Windows 32 emülasyonu. Varsayılan olarak yanlış olan bir boole değeri.

ChromeDriver, aşağıdaki platformlarda "clientHints" değerinden "userAgent" değerini tahmin edebilir: "Android", "Chrome OS", "Chromium OS", "Fuchsia", "Linux", "macOS", "Windows". Dolayısıyla bu değer atlanabilir.

"clientHints" sözlüğü atlanırsa (eski mod), ChromeDriver, "userAgent"tan "clientHints" değerini tahmin etmek için elinden geleni yapar. "userAgent" değer biçiminin şirket içi belirsizlikleri nedeniyle bu özellik güvenilir değildir.

Mobil Emülasyon panelinde bulunan telefon ve tabletler Geliştirici Araçları kaynak kodunda bulunabilir.

Java

Map<String, Object> deviceMetrics = new HashMap<>();
deviceMetrics.put("width", 360);
deviceMetrics.put("height", 640);
deviceMetrics.put("pixelRatio", 3.0);
Map<String, Object> mobileEmulation = new HashMap<>();
mobileEmulation.put("deviceMetrics", deviceMetrics);
mobileEmulation.put("userAgent", "Mozilla/5.0 (Linux; Android 4.2.1; en-us; Nexus 5 Build/JOP40D) AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.166 Mobile Safari/535.19");
Map<String, Object> clientHints = new HashMap<>();
clientHints.put("platform", "Android");
clientHints.put("mobile", true);
mobileEmulation.put("clientHints", clientHints);
ChromeOptions chromeOptions = new ChromeOptions(); chromeOptions.setExperimentalOption("mobileEmulation", mobileEmulation); WebDriver driver = new ChromeDriver(chromeOptions);

Ruby

mobile_emulation = {
   "deviceMetrics" => { "width" => 360, "height" => 640, "pixelRatio" => 3.0 },
   "userAgent" => "Mozilla/5.0 (Linux; Android 4.2.1; en-us; Nexus 5 Build/JOP40D) AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.166 Mobile Safari/535.19",
   "clientHints" => { "platform" => "Android", "mobile" => true}
}
caps = Selenium::WebDriver::Remote::Capabilities.chrome("chromeOptions" => mobile_emulation)
driver = Selenium::WebDriver.for :remote, url: 'http://localhost:4444/wd/hub', desired_capabilities: caps

Python

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
mobile_emulation = {
   "deviceMetrics": { "width": 360, "height": 640, "pixelRatio": 3.0 },
   "userAgent": "Mozilla/5.0 (Linux; Android 4.2.1; en-us; Nexus 5 Build/JOP40D) AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.166 Mobile Safari/535.19",
   "clientHints": {"platform": "Android", "mobile": True} }
chrome_options = Options()
chrome_options.add_experimental_option("mobileEmulation", mobile_emulation)
driver = webdriver.Chrome(chrome_options = chrome_options)

Tam mobil emülasyon yapılandırması örneği:

JSON

"mobileEmulation": {
  "userAgent": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko)
Chrome/111.0.0.0 Mobile Safari/537.36",
  "deviceMetrics": {
     "mobile": true,
     "touch": true,
     "width": 412,
     "height": 823,
     "pixelRatio": 1.75
  },
  "clientHints": {
     "brands": [
        {"brand": "Google Chrome", "version": "111"},
        {"brand": "Chromium", "version": "111"}
     ],
     "fullVersionList": [
        {"brand": "Google Chrome", "version": "111.0.5563.64"},
        {"brand": "Chromium", "version": "111.0.5563.64"}
     ],
     "platform": "Android",
     "platformVersion": "11",
     "architecture": "arm",
     "model": "lorem ipsum (2022)"
     "mobile": true,
     "bitness": "32",
     "wow64": false
  }
}

Mobil emülasyon ile gerçek cihazlar arasındaki fark

Web sitelerini mobil emülasyon ile bir masaüstünde test etmek yararlı olsa da, gerçek cihazda testin mükemmel bir replikası değildir. Aşağıdakiler gibi bazı önemli farklar vardır:

• Mobil cihazlar genellikle farklı bir GPU'ya sahiptir. Bu durum büyük performans değişikliklerine neden olabilir.
• Mobil kullanıcı arayüzü taklit edilmez (özellikle adres çubuğunun gizlenmesi sayfa yüksekliğini etkiler).
• Anlam karmaşasını giderme pop-up'ları (birkaç dokunma hedefinden birini seçtiğiniz) desteklenmez.
• Birçok donanım API'si (ör. orientationchange etkinliği) kullanılamaz.