Masaüstü Ana Birimi kullanarak test etme

Masaüstü Ana Birimi (DHU), geliştirme makinenizin Android Auto ana birimini taklit etmesini sağlayarak Android Auto uygulamalarını çalıştırmanıza ve test etmenize olanak tanır. DHU, Windows, macOS ve Linux sistemlerinde çalışır.

DHU'yu yükledikten sonra, mobil cihazınızı DHU'yu çalıştırma bölümünde açıklanan desteklenen bağlantı mekanizmalarından birini kullanarak bağlayıp Android Auto uygulamalarınızı test edebilirsiniz.

DHU ile ilgili hataları bildirmek veya özellik isteğinde bulunmak için sorun izleyiciyi kullanın.

DHU'yu yükleme

DHU'yu geliştirme makinenize yüklemek için:

1. Cihazdaki geliştirici seçeneklerini yapılandırma başlıklı makalede açıklandığı gibi, Android 9 (API seviyesi 28) veya daha yüksek bir sürümün yüklü olduğu mobil cihazda geliştirici modunu etkinleştirin.
2. Uygulamanızı derleyip cihaza yükleyin.
3. Cihaza Android Auto'yu yükleyin. Android Auto zaten yüklüyse en yeni sürümü kullandığınızdan emin olun.

4. Android Studio'da SDK Manager'ı açın ve SDK Tools sekmesine gidin, ardından Android Auto Desktop Head Unit Emulator paketini indirin.

   

   DHU, SDK_LOCATION/extras/google/auto/ dizinine yüklenir.

5. Linux veya macOS sistemlerde, DHU ikilisini yürütülebilir hale getirmek için bu dizinde aşağıdaki komutu çalıştırın:

chmod +x ./desktop-head-unit

Linux için ek adımlar

Linux sisteminde DHU 2.x sürümünü çalıştırıyorsanız bazı ek kitaplıkları yüklemeniz gerekir. DHU ikilisi, GLIBC 2.32 veya sonraki sürümlerine bağlıdır. Şu komutu çalıştırarak sisteminizin GLIBC sürümünü kontrol edebilirsiniz:

ldd --version

Sürüm 2.32'den eski ise GLIBC sürümünü 2.32 veya sonraki bir sürüme güncelleyin. Bu işlem için işletim sistemini GLIBC 2.32 veya sonraki sürümlerle uyumlu bir sürüme yükseltmeniz gerekebilir.

Ayrıca libc++1 ve libc++abi1 kitaplıklarını da yüklemeniz gerekir. Yükleme prosedürü, Linux dağıtımınıza bağlı olarak değişir. Örneğin, Debian türevi Linux dağıtımlarında kitaplıkları şu komutla yükleyebilirsiniz:

sudo apt-get install libc++1 libc++abi1

DHU'nun yayın öncesi sürümlerini yükleme

DHU'nun yayın öncesi sürümlerine erişmek için Android Studio'nun önizleme sürümünü kullanabilir veya mevcut Android Studio yüklemenizin güncelleme kanalını değiştirebilirsiniz.

DHU'yu çalıştırma

DHU'yu yükledikten sonra mobil cihazınızı ve iş istasyonunuzu USB üzerinden bağlayarak Android Auto uygulamalarınızı test edebilirsiniz. Mobil cihazınızı Accessory Mode (DHU 2.x için önerilir) veya ADB Tüneli kullanarak bir geliştirme makinesine bağlayıp DHU'yu çalıştırın.

Aksesuar Modu'nu kullanarak bağlanma

Android Auto, aşağıdaki komutu kullanarak Android Open Accessory (AOA) protokolüyle DHU 2.x sürümüne bağlanmayı destekler:

./desktop-head-unit --usb

Varsayılan olarak DHU, kullanılabilir USB cihazlarının listesini tarar ve ilk uyumlu cihaza bağlanmaya çalışır. Belirli bir cihazı hedeflemek için --usb komutuna cihaz kimliğini aşağıdaki şekilde ekleyin:

./desktop-head-unit --usb=[DEVICE_ID]

ADB tünel protokolünü kullanarak bağlanma

Bu yöntem, Android Debug Bridge (adb) üzerinden Android Auto baş birimi sunucusuna bağlantı kurulmasını gerektirir. Tünel oluşturmayı ayarlamak ve DHU'yu çalıştırmak için aşağıdaki adımları uygulayın:

1. Henüz etkinleştirilmemişse Android Auto geliştirici modunu etkinleştirin.

2. Baş ünite sunucusu henüz çalışmıyorsa taşma menüsünü açın ve Şekil 1'de gösterildiği gibi Baş ünite sunucusunu başlat'ı seçin.

   Cihazda, Şekil 2'de gösterildiği gibi, sunucunun çalıştığını belirten bir ön plan hizmeti bildirim alanında görünür.

   

   Şekil 1. Geliştirici seçeneklerini içeren bağlam menüsü.

   

   Şekil 2. Baş ünitesi sunucusunun çalıştığına dair bildirim.

3. Android Auto uygulamasında, Ayarlar'ın üst kısmına yakın bir yerde Daha önce bağlanılan arabalar'a dokunun ve Android Auto'ya yeni araç ekle'nin etkinleştirildiğini doğrulayın.

4. Mobil cihazı USB kullanarak geliştirme makinesine bağlayın.

5. DHU'nun başlatılabilmesi için mobil cihazın ekranının kilidinin açık olduğundan emin olun.

6. Geliştirme makinesinde, geliştirme makinesinin 5277 numaralı bağlantı noktasındaki soket bağlantılarını mobil cihazdaki aynı bağlantı noktası numarasına yönlendirmek için aşağıdaki adb komutunu çalıştırın. Bu yapılandırma, DHU'nun mobil cihazda çalışan ana birim sunucusuna TCP soketi üzerinden bağlanmasına olanak tanır.

   adb forward tcp:5277 tcp:5277

7. Windows'da desktop-head-unit.exe, macOS veya Linux'ta ise ./desktop-head-unit komutunu SDK_LOCATION/extras/google/auto/ dizininden çalıştırarak DHU'yu başlatın:

   cd SDK_LOCATION/extras/google/auto
   desktop-head-unit.exe # Windows
   ./desktop-head-unit # macOS or Linux

1. Mobil cihazı DHU'ya ilk kez bağlıyorsanız hizmet şartlarını kabul etmek ve izin ayarlarını gerektiği gibi düzenlemek için mobil cihazın ekranını kontrol edin.

DHU başlatıldıktan sonra, uygulamanızı çalıştırmak ve test etmek için DHU konsol komutlarını kullanabilirsiniz.

Komut satırı seçenekleri

Varsayılan olarak, araç bilgi-eğlence sistemi sunucusu 5277 numaralı bağlantı noktası üzerinden bağlanır. Ana makineyi veya bağlantı noktasını geçersiz kılmak için aşağıdaki örnekte gösterildiği gibi --adb=<[localhost:]port> işaretini kullanın:

./desktop-head-unit --adb=5999

Varsayılan olarak DHU, dokunmatik ekranlı kullanıcı arayüzüne sahip Android Auto uyumlu bir ana birimi taklit eder. Fareyle DHU'yu tıklayarak kullanıcı dokunuşlarını simüle edin. Giriş için döner kontrol cihazı kullanan araç içi bilgi-eğlence sistemlerini taklit etmek üzere aşağıdaki örnekte gösterildiği gibi -i rotary işaretini kullanabilirsiniz:

./desktop-head-unit -i controller

DHU, döner kontrol cihazı modundayken kontrol cihazı işlemlerini simüle etmek için klavye kısayollarını kullanabilirsiniz. Daha fazla bilgi için Döner kumanda bölümüne bakın. Döner kontrol cihazı modunda DHU, fare tıklamalarını yoksayar. Android Auto'yu simüle edilmiş döner kontrol işlemleriyle çalıştırmanız gerekir.

DHU'ya yönelik diğer komut satırı seçenekleri aşağıdaki tabloda listelenmiştir:

DHU kullanıcı kılavuzu

Bu bölümde, DHU tarafından desteklenen özellikler ve bunların nasıl kullanılacağı açıklanmaktadır.

Komutlar, DHU'yu başlattığınız terminal penceresine girilir. Birden fazla komut, ; ile ayrılarak aynı satırda çalıştırılabilir.

Sistem

Dokunma ve dokunmatik alan

Dokunma veya dokunmatik alan etkinleştirildiğinde, dokunma için ekran penceresinde, dokunmatik alan için dokunmatik alan penceresinde yapılan tıklamalar dokunma etkinliği olarak kaydedilir.

Dokunma için ilk parmak konumunu sağ tıklayıp ikinci parmak için sağ düğmeyi tıklayıp basılı tutarak çoklu dokunmayı simüle edin. İki parmağın merkezi sabit kalır. Fareyi hareket ettirerek parmakları merkez etrafında döndürebilir, yakınlaştırıp uzaklaştırabilir veya her ikisini de yapabilirsiniz.

Dokunmatik alanda, ekrandaki farklı arayüz öğeleri arasında gezinmek için sol düğmeyi tıklayıp basılı tutun. Sağ düğmeyi tıkladığınızda odaklanmış öğe seçilir.

Döner multimedya kontrol düğmesi

DHU, döner multimedya kontrol düğmesi desteğine sahiptir. Bu ayar etkinleştirildiğinde aşağıdaki işlemler desteklenir:

• D-pad'de yukarı, aşağı, sol ve sağ yön düğmelerini tıklama
• Saat yönünde ve saat yönünün tersine döndürme
• Döndürme hareketi yapma (beş adımı aynı anda gerçekleştirme)
• Kumandada aşağı ve geri tıklama

Komutlar ve tuş bağlamaları aşağıdaki tabloda listelenmiştir.

Farenin kaydırma tekerleği dpad rotate komutlarını, orta fare düğmesi tıklaması (genellikle kaydırma tekerleği) ise dpad click komutlarını gönderir.

Çoğu arabada dokunmatik ekran olduğunu unutmayın. Bazı araçlarda yalnızca döner kontrol cihazları, bazılarında ise hibrit dokunmatik ekran ve kontrol cihazı bulunur. Arabalar, harita kaydırma ve metin girişi için kullanılabilecek bir dokunmatik yüzeyi de destekleyebilir. Farklı araç ana birimlerini simüle ederken bu farklı yapılandırmalara dikkat edin.

Mikrofon

DHU, ses girişi için mikrofon kullanımını veya önceden kaydedilmiş bir ses parçasının çalınmasını destekler. Kolaylık sağlamak için, sık kullanılan sesli komutlara yönelik aşağıdaki ses dosyaları DHU ile birlikte verilir. Bu ses dosyaları SDK_LOCATION/extras/google/auto/voice/ dizininde bulunur.

DHU isteminde tek bir .wav dosyasını çalıştırmak için aşağıdaki komutu kullanın:

mic play /path/to/filename.wav

Aşağıdaki tabloda, mikrofonla ilgili diğer komutlar listelenmiştir:

Sensörler

DHU, aşağıdaki komutlarla aracın sensör verilerindeki değişikliklerin simüle edilmesini destekler. Sensör verilerini taklit edip Android Auto'ya göndermek için DHU başlatılırken .ini kullanılan yapılandırma dosyasıyla ilgili sensörlerin etkinleştirilmesi gerekir.

Gündüz ve gece modları

DHU, aşağıdaki komutlar ve tuş bağlamalarıyla gündüz ve gece modu arasında geçiş yapmayı simüle etmeyi destekler:

Odak yönetimi

DHU, aşağıdaki komutları kullanarak Android Auto'nun ana birimde odaklanıp odaklanmadığını simüle etmeyi destekler:

Kısıtlamalar ve sürüş durumu

DHU, araç hareket halindeyken klavyeyi devre dışı bırakma ve telefon yapılandırmalarına izin vermeme gibi belirli kısıtlamaların simülasyonunu aşağıdaki komutları kullanarak destekler:

Gösterge grubu

DHU, gösterge paneli emülasyonunu destekler. Bu küme genellikle direksiyonun arkasında bulunur ve navigasyon sırasında bir sonraki dönüşle ilgili temel bilgileri (ör. bir sonraki yolun adı veya dönüş oku), mesafeyi ya da süreyi gösterir. Devam eden telefon görüşmeleriyle ilgili bilgileri de gösterir.

Bu özellik, yapılandırma dosyasının [general] bölümündeki instrumentcluster girişi kullanılarak veya her özelliği ayrı ayrı kontrol etmek için navcluster ya da phonecluster girişleri kullanılarak etkinleştirilebilir.

[general]
...
instrumentcluster = true

Küme Ekranı

Bazı araçlarda, harita döşemeleri gibi zengin görsel bilgileri gösterebilen gösterge paneli ekranları bulunur. DHU'nun 2.1 sürümünden itibaren (şu anda Android Studio Beta güncelleme kanalı kullanılarak edinilebilir) geliştirme makinenizde bu tür bir ekranı emüle edebilirsiniz.

Bu işlem, küme [display] bölümü içeren bir yapılandırma dosyası kullanılarak yapılabilir. [display] bölümleri, dosyanın [general] bölümünde yapılandırılan ana ekranla aynı video yapılandırma seçeneklerini destekler.

...

# The display name following the colon can be whatever you like.
[display:cluster]
# Setting the displaytype as cluster is what lets the DHU know how to handle it.
displaytype = cluster
resolution = 800x480
dpi = 160
...

Bu yapılandırma doğrudan mevcut bir .ini dosyasına eklenebilir veya ayrı bir dosyaya yerleştirilip DHU başlatılırken birden fazla yapılandırma dosyası iletilerek yeniden kullanılabilir. Birden fazla yapılandırma dosyası kullanıldığında, belirli bir değerin sonraki tanımları önceki tanımları geçersiz kılar.

# Launch your landscape configuration with your cluster display configuration
./desktop-head-unit -c landscape.ini -c cluster.ini

# Launch the portait configuration with the same cluster display configuration
./desktop-head-unit -c portrait.ini -c cluster.ini

Medya Oynatma Durumu

DHU, medya oynatma durumunu (ör. hangi parçanın çaldığı) göstermek için ek bir bilgi ekranını destekler.

Bu özellik, [general] bölümündeki playbackstatus girişi kullanılarak etkinleştirilebilir.

[general]
...
playbackstatus = true

Tuş kodları

DHU, araçlarda yaygın olarak bulunan kısayol düğmelerini simüle eden bir dizi varsayılan tuş kodu sağlar. Örneğin, home tuş kodu, DHU isteminde aşağıdaki gibi tetiklenebilir:

keycode home

Aşağıdaki tabloda, kullanılabilen diğer tuş kodları listelenmiştir:

DHU'yu yapılandırma

DHU, giriş modlarını dokunma ve döner kontrol cihazı arasında değiştirmek, kare hızını, çözünürlüğü ve DPI'yı ayarlamak için bir yapılandırma .ini dosyasını destekler. Bu dosya, ana birimin telefondan istediği değerleri içerir.

Yapılandırma dosyasının varsayılan konumu ~/.android/headunit.ini'dır. Sisteminizdeki araç içi birimin yapılandırmasını değiştirmek için bu dosyayı düzenleyebilirsiniz.

-c işaretini kullanarak yüklenecek bir yapılandırma dosyası da belirtebilirsiniz:

./desktop-head-unit -c /path/to/config.ini

Aşağıdaki snippet'te örnek bir yapılandırma gösterilmektedir:

[general]
touch = true
touchpad = false
controller = false
instrumentcluster = false
resolution = 800x480
dpi = 160
framerate = 30
fueltypes = unleaded,electric,hydrogen
evconnectors = supercharger

Test edebileceğiniz farklı araç bilgi-eğlence sistemi ayarlarını gösteren örnek yapılandırma dosyaları SDK_LOCATION/extras/google/auto/config/ klasöründe yer alır. Daha gelişmiş kullanım alanları için aşağıdaki desteklenen ayarlara bakın:

Giriş yapılandırması

Aşağıdaki tabloda giriş yapılandırma seçenekleri listelenmiştir:

Video yapılandırması

Android Auto üç video çözünürlüğünü destekler:

• 480p (800x480, varsayılan)
• 720p (1280x720)
• 1080p (1920x1080)

Diğer en boy oranlarını desteklemek için ana ünite, gerektiğinde sinemaskop biçimine dönüştürmek (pillarbox) üzere bir kenar boşluğu belirtebilir. Örneğin, 1000x600 boyutunda bir ekran istiyorsanız çözünürlüğü 720p (1280x720), marginwidth değerini 280 ve marginheight değerini 120 olarak ayarlayın. Bu işlem, sol ve sağ kenarlara 140 piksel, üst ve alt kenarlara ise 60 piksel kenar boşluğu ekler.

Aşağıdaki örnek yapılandırma, tipik bir 6 inçlik ekranı (750x450) taklit eder:

[general]
...
resolution = 800x480
marginwidth = 50
marginheight = 30

Aşağıdaki örnek yapılandırma ise çok geniş bir ekranı taklit eder:

[general]
...
resolution = 1280x720
marginwidth = 0
marginheight = 220

Aşağıdaki tabloda diğer video yapılandırma seçenekleri listelenmiştir:

Sensör yapılandırması

Sensör verilerini taklit edip Android Auto'ya göndermek için ilgili sensörlerin aşağıdaki seçenekler kullanılarak etkinleştirilmesi gerekir. Bir sensör etkinleştirilmemişse DHU komutları kullanılarak bu sensör için gönderilen tüm veriler yoksayılır. Bu yapılandırma, diğer yapılandırmaların çoğu için kullanılan [general] bölümüne değil, [sensors] bölümüne yerleştirilmelidir.

[general]
touch = true
...

[sensors]
location = true
fuel = true
...

Çeşitli yapılandırma seçenekleri

Aşağıdaki tabloda diğer yapılandırma seçenekleri listelenmiştir:

Sorunu giderin

Bazen DHU ilk bağlandığında boş bir ekran gösterir. Aşağıdaki işlemleri yaparak bu sorunu çözebilirsiniz:

1. DHU'yu kapatın.
2. Baş Ünitesi Sunucusu'nu durdurup yeniden başlatmak için DHU'yu çalıştırma başlıklı makalede açıklanan 5. adımı uygulayın.
3. DHU'yu tekrar başlatın.
4. Telefon ekranında istenen ek izinleri verin. DHU bir kez daha kapanabilir.
5. Gerekirse DHU'yu yeniden başlatın.