Android sanal cihaz (AVD), Android Emulator'da simüle etmek istediğiniz bir Android telefon, tablet, Wear OS, Android TV veya Automotive OS cihazının özelliklerini tanımlayan bir yapılandırmadır. Cihaz Yöneticisi, Android Studio'dan başlatabileceğiniz ve AVD oluşturmanıza ve yönetmenize yardımcı olan bir araçtır.
Yeni Cihaz Yöneticisi'ni açmak için aşağıdakilerden birini yapın:
- Android Studio karşılama ekranında Diğer İşlemler > Sanal Cihaz Yöneticisi'ni seçin.
- Bir projeyi açtıktan sonra ana menü çubuğundan Görünüm > Araç Pencereleri > Cihaz Yöneticisi'ni seçin, ardından + simgesini ve Sanal Cihaz Oluştur'u tıklayın.
Cihazlarınızı oluşturduktan sonra cihaz yöneticisi panelinde tüm cihazların listesini görebilirsiniz.
Otomatik enstrümante testlerinizi ölçeklenebilir ve kendi kendini yöneten bir şekilde çalıştırmak için sanal cihazlar kullanmak istiyorsanız Gradle Managed Devices'i kullanabilirsiniz.
AVD'ler hakkında
AVD'ler donanım profili, sistem görüntüsü, depolama alanı, tema ve diğer özellikleri içerir.
Uygulamanızın, manifest dosyanızdaki
<uses-sdk> ayarına göre destekleyebileceği her sistem resmi için bir AVD oluşturmanızı öneririz.
Donanım profili
Donanım profili, bir cihazın fabrikadan gönderildiği haldeki özelliklerini tanımlar. Cihaz Yöneticisi, Pixel cihazlar gibi belirli donanım profilleriyle önceden yüklenmiş olarak gelir. Donanım profillerini gerektiği gibi tanımlayabilir veya özelleştirebilirsiniz.
Play Store sütununda Google Play logosuyla etiketlenmiş cihaz tanımı, hem Google Play Store uygulamasını hem de Google Play Hizmetleri'ne erişimi içerir. Buna, cihazdaki Google Play Hizmetleri'ni güncellemek için kullanışlı bir düğme sağlayan Genişletilmiş kontroller iletişim kutusunda bir Google Play sekmesi de dahildir.
Bu logoya ve "Telefon" cihaz türüne sahip cihazlar da CTS uyumludur ve Play Store uygulamasını içeren sistem resimleri kullanabilir.
Sistem resimleri
Google API'leri etiketli bir sistem resmi, Google Play hizmetlerine erişim içerir.
Önerilen sekmesinde, önerilen sistem resimleri listelenir. Diğer sekmeler daha kapsamlı bir liste içerir. Sağ bölmede, seçili sistem resmi açıklanır.
Bir sistem resminin yanında indirme simgesi görürseniz bu resim şu anda geliştirme makinenizde yüklü değildir. Sistem görüntüsünü indirmek için simgeyi tıklayın. Sistem resimlerini indirmek için internete bağlı olmanız gerekir.
Uygulamanız, uygulama manifest dosyasında
minSdk özelliğinde belirtildiği gibi, uygulamanızın gerektirdiğinden daha düşük API düzeyine sahip bir sistem görüntüsünde çalışmadığından hedef cihazın API düzeyi önemlidir. Sistem API düzeyi ile minSdk arasındaki ilişki hakkında daha fazla bilgi için Uygulamanız için sürüm oluşturma başlıklı makaleyi inceleyin.
Uygulamanız manifest dosyasında
<uses-library> öğesi beyan ediyorsa bu harici kitaplığı içeren bir sistem resmi gerekir.
Uygulamanızı bir emülatörde çalıştırmak için gerekli kitaplığı içeren bir AVD oluşturun. Bunu yapmak için AVD platformu için bir eklenti bileşeni kullanmanız gerekebilir. Örneğin, Google API'leri eklentisi Google Haritalar kitaplığını içerir.
Uygulama güvenliğini ve fiziksel cihazlarda tutarlı bir deneyimi sağlamak için Google Play Store'un dahil edildiği sistem resimleri bir sürüm anahtarıyla imzalanır. Bu, bu resimlerle yükseltilmiş ayrıcalıklar (root) elde edemeyeceğiniz anlamına gelir.
Uygulamayla ilgili sorunları gidermek için üst düzey ayrıcalıklara (root) ihtiyacınız varsa Google uygulamalarını veya hizmetlerini içermeyen Android Open Source Project (AOSP) sistem resimlerini kullanabilirsiniz. Ardından, normal ve yükseltilmiş ayrıcalıklar arasında geçiş yapmak için adb root ve adb unroot komutlarını kullanabilirsiniz:
% adb shell emu64a:/ $ emu64a:/ $ exit % adb root restarting adbd as root % adb shell emu64a:/ # emu64a:/ # exit % adb unroot restarting adbd as non root % adb shell emu64a:/ $ emu64a:/ $ exit %
Depolama alanı
AVD, geliştirme makinenizde özel bir depolama alanına sahiptir. Yüklü uygulamalar ve ayarlar gibi cihaz kullanıcı verilerini ve taklit edilmiş bir SD kartı depolar. Gerekirse Cihaz Yöneticisi'ni kullanarak kullanıcı verilerini silebilir ve böylece cihazın yeniymiş gibi aynı verilere sahip olmasını sağlayabilirsiniz.
Cilt
Emülatör görünümü, cihazın görünümünü belirtir. Cihaz Yöneticisi, önceden tanımlanmış bazı kaplamalar sunar. Ayrıca kendi temanızı tanımlayabilir veya üçüncü taraflarca sağlanan temaları kullanabilirsiniz.
AVD ve uygulama özellikleri
AVD tanımınızın, uygulamanızın bağlı olduğu cihaz özelliklerini içerdiğinden emin olun. AVD'lerinizde tanımlayabileceğiniz özelliklerin listeleri için donanım profili özellikleri ve AVD özellikleri ile ilgili bölümlere bakın.
AVD oluşturma
Yeni bir AVD oluşturmak için:
- Cihaz Yöneticisi'ni açın.
- Cihaz Oluştur'u tıklayın.
Donanım Seçin penceresi görünür.
Play Store yalnızca bazı donanım profillerinde bulunur. Bu profiller tamamen CTS uyumludur ve Play Store uygulamasını içeren sistem resimleri kullanabilir.
- Bir donanım profili seçip Sonraki'yi tıklayın.
İstediğiniz donanım profilini görmüyorsanız bu sayfanın diğer bölümlerinde açıklandığı gibi bir donanım profili oluşturabilir veya içe aktarabilirsiniz.
Sistem Görüntüsü penceresi görünür.
- Belirli bir API düzeyi için sistem görüntüsünü seçin ve Sonraki'yi tıklayın.
- Gerektiği şekilde AVD özelliklerini değiştirin ve ardından Son'u tıklayın.
Cilt gibi daha fazla ayarı göstermek için Gelişmiş Ayarları Göster'i tıklayın.
Yapılandırmayı Doğrula penceresi görünür.
Yeni AVD, Cihaz Yöneticisi'nin Sanal sekmesinde ve hedef cihaz menüsünde görünür.
Bir kopyayla başlayan bir AVD oluşturmak için:
- Cihaz Yöneticisi'nin Sanal sekmesinde Menü'yü
tıklayın ve Kopyala'yı seçin.
Yapılandırmayı Doğrula penceresi görünür.
- Sistem Görüntüsü veya Donanım Seç pencerelerinde değişiklik yapmanız gerekiyorsa Önceki'yi tıklayın.
- Gerekli değişiklikleri yapın ve Bitir'i tıklayın.
AVD, Cihaz Yöneticisi'nin Sanal sekmesinde görünür.
Donanım profili oluşturma
Cihaz Yöneticisi, yaygın cihazlar için önceden tanımlanmış donanım profilleri sağlar. Böylece, bunları AVD tanımlarınıza kolayca ekleyebilirsiniz. Farklı bir cihaz tanımlamanız gerekiyorsa yeni bir donanım profili oluşturabilirsiniz.
Baştan yeni bir donanım profili tanımlayabilir veya başlangıç noktası olarak bir donanım profilini kopyalayabilirsiniz. Önceden yüklenmiş donanım profilleri düzenlenemez.
Baştan yeni bir donanım profili oluşturmak için:
- Donanım Seç penceresinde Yeni Donanım Profili'ni tıklayın.
Donanım Profili Yapılandır penceresinde, donanım profili özelliklerini gerektiği gibi değiştirin.
- Son'u tıklayın.
Yeni donanım profiliniz Donanım Seç penceresinde görünür. İleri'yi tıklayarak donanım profilini kullanan bir AVD oluşturabilir veya Sanal sekmesine ya da hedef cihaz menüsüne dönmek için İptal'i tıklayabilirsiniz.
Başlangıç noktası olarak bir kopya kullanarak donanım profili oluşturmak için:
- Donanım Seç penceresinde bir donanım profili seçip Cihazı Klonla'yı tıklayın veya bir donanım profilini sağ tıklayıp Klonla'yı seçin.
- Donanım Profili Yapılandır penceresinde, donanım profili özelliklerini gerektiği gibi değiştirin.
- Son'u tıklayın.
Yeni donanım profiliniz Donanım Seç penceresinde görünür. İleri'yi tıklayarak donanım profilini kullanan bir AVD oluşturabilir veya Sanal sekmesine ya da hedef cihaz menüsüne dönmek için İptal'i tıklayabilirsiniz.
Mevcut AVD'leri düzenleme
Cihaz Yöneticisi'nin Sanal sekmesinden bir AVD'de aşağıdaki işlemleri yapabilirsiniz:
- Bir AVD'yi düzenlemek için Bu AVD'yi düzenle'yi
tıklayın ve gerekli gördüğünüz değişiklikleri yapın. - Bir AVD'yi silmek için Menü'yü tıklayın
Sil'i seçin.
- İlişkili AVD INI ve IMG dosyalarını diskte göstermek için Menü'yü tıklayın ve Diskte Göster'i seçin.
- Android Studio ekibine göndereceğiniz hata raporlarına ekleyebileceğiniz AVD yapılandırma ayrıntılarını görüntülemek için Menü
simgesini tıklayıp Ayrıntıları Görüntüle'yi seçin.
Mevcut donanım profillerini düzenleme
Önceden yüklenmiş donanım profillerini düzenleyemez veya silemezsiniz ancak Donanım Seç penceresinden diğer donanım profillerinde aşağıdaki işlemleri yapabilirsiniz:
- Bir donanım profilini düzenlemek için ilgili profili seçip Cihazı Düzenle'yi tıklayın. Ayrıca, bir donanım profilini sağ tıklayıp Düzenle'yi de seçebilirsiniz. Ardından, değişikliklerinizi yapın.
- Bir donanım profilini silmek için sağ tıklayıp Sil'i seçin.
Emülatör çalıştırma, durdurma ve verileri temizleme
Sanal sekmesinden bir emülatörde aşağıdaki işlemleri yapabilirsiniz:
- AVD kullanan bir emülatör çalıştırmak için Başlat'ı
tıklayın. - Çalışan bir emülatörü durdurmak için Menü'yü tıklayın
Durdur'u seçin.
- Bir emülatördeki verileri temizlemek için Menü'yü tıklayın
Verileri Sil'i seçin.
Donanım profillerini içe ve dışa aktarma
Donanım Seç penceresinden donanım profillerini aşağıdaki gibi içe ve dışa aktarabilirsiniz:
- Donanım profili içe aktarmak için Donanım Profillerini İçe Aktar'ı tıklayın ve bilgisayarınızda tanımı içeren XML dosyasını seçin.
- Bir donanım profilini dışa aktarmak için sağ tıklayın ve Dışa aktar'ı seçin. Tanım içeren XML dosyasını kaydetmek istediğiniz konumu belirtin.
AVD özellikleri
AVD yapılandırması, geliştirme bilgisayarı ile emülatör arasındaki etkileşimin yanı sıra donanım profilinde geçersiz kılmak istediğiniz özellikleri belirtir. Yapılandırmayı Doğrula penceresinde AVD yapılandırmaları için aşağıdaki özellikleri belirtebilirsiniz. (Gelişmiş) etiketli mülkler yalnızca Gelişmiş Ayarları Göster'i tıkladığınızda gösterilir.
AVD yapılandırma özellikleri, donanım profili özelliklerini geçersiz kılar ve emülatör çalışırken ayarladığınız emülatör özellikleri her ikisini de geçersiz kılar.
Tablo 1. AVD yapılandırma özellikleri
| AVD mülkü | Açıklama |
|---|---|
| AVD Adı | AVD için bir ad girin. Adda büyük veya küçük harf, sayı, nokta, alt çizgi, parantez, tire ve boşluk bulunabilir. AVD yapılandırmasını depolayan dosyanın adı, AVD adından türetilir. |
| AVD kimliği (Gelişmiş) | AVD kimliğini görüntüleyin. AVD kimliği, AVD adından türetilir. Komut satırından AVD'ye atıfta bulunmak için kimliği kullanabilirsiniz. |
| Donanım Profili | Donanım Seç penceresinden farklı bir donanım profili seçmek için Değiştir'i tıklayın. |
| Sistem Görüntüsü | Sistem Görüntüsü penceresinden farklı bir sistem görüntüsü seçmek için Değiştir'i tıklayın. Yeni bir resim indirmek için etkin bir internet bağlantısı gerekir. |
| Startup oryantasyonu | İlk emülatör yönü için bir seçenek belirleyin:
Bir seçenek yalnızca donanım profilinde destekleniyorsa etkinleştirilir. AVD'yi emülatörde çalıştırırken, donanım profilinde hem dikey hem de yatay yön destekleniyorsa yönü değiştirebilirsiniz. |
| Kamera (Gelişmiş) | Etkin kameralar için bir seçenek belirleyin. Emulated ve VirtualScene ayarları yazılım tarafından oluşturulan bir resim oluştururken Web Kamerası ayarı, geliştirme bilgisayarınızın web kamerasını kullanarak resim çeker. Kamera seçenekleri yalnızca donanım profilinde kamera destekliyorsa kullanılabilir. Bu uygulamalar Wear OS, Android TV veya Google TV'de kullanılamaz. |
| Ağ: Hız (Gelişmiş) | Veri aktarımının hızını belirlemek için bir ağ protokolü seçin:
|
| Ağ: Gecikme (İleri Düzey) | Protokolün bir veri paketini bir noktadan diğerine aktarmasının ne kadar süreceğini ayarlamak için bir ağ protokolü seçin. |
| Taklit Edilen Performans: Grafikler | Grafiklerin emülatörde nasıl oluşturulacağını seçin:
|
| Taklit Edilen Performans: Başlatma seçeneği (Gelişmiş) |
AVD'nin nasıl başlatılacağını seçin: |
| Taklit Edilen Performans: Çok Çekirdekli CPU (Gelişmiş) | Bilgisayarınızdaki emülatör için kullanmak istediğiniz işlemci çekirdek sayısını seçin. Daha fazla işlemci çekirdeği kullanmak emülatörü hızlandırır. |
| Bellek ve Depolama: RAM (Gelişmiş) | Donanım üreticisi tarafından ayarlanan cihazdaki RAM miktarını geçersiz kılabilirsiniz. Boyutu artırmak bilgisayarınızda daha fazla kaynak kullanır ancak daha hızlı emülatör çalışmasını destekler. RAM boyutu girin ve B (bayt), KB (kilobayt), MB (megabayt), GB (gigabayt) veya TB (terabayt) ölçü birimlerinden birini seçin. |
| Bellek ve Depolama: Sanal Makine Yığını (Gelişmiş) | Donanım üreticisi tarafından ayarlanan sanal makine yığın boyutunu geçersiz kılın. Bir yığın boyutu girin ve B (bayt), KB (kilobayt), MB (megabayt), GB (gigabayt) veya TB (terabayt) birimlerinden birini seçin. |
| Bellek ve Depolama: Dahili Depolama (Gelişmiş) | Donanım üreticisi tarafından ayarlanan, cihazda bulunan çıkarılamayan bellek alanını geçersiz kılabilir. Bir boyut girin ve B (bayt), KB (kilobayt), MB (megabayt), GB (gigabayt) veya TB (terabayt) birimlerinden birini seçin. |
| Bellek ve Depolama: SD Kart (Gelişmiş) | Cihazda veri depolamak için kullanılabilen çıkarılabilir bellek alanını belirtin. Android Studio tarafından yönetilen sanal bir SD kart kullanmak için Studio tarafından yönetilen'i seçin, bir boyut girin ve B (bayt), KB (kilobayt), MB (megabayt), GB (gigabayt) veya TB (terabayt) birimlerinden birini seçin. Kamerayı kullanmak için en az 100 MB boş alan olması önerilir. Bir dosyadaki alanı yönetmek için Harici dosya'yı seçin ve dosyayı ile konumu belirtmek için ... simgesini tıklayın. Daha fazla bilgi için |
| Cihaz Çerçevesi: Cihaz Çerçevesini Etkinleştirme | Emülatör penceresinin etrafında gerçek bir cihazın görünümünü taklit eden bir çerçeve etkinleştirmeyi seçin. |
| Özel Cilt Tanımı (Gelişmiş) | Emülatörde gösterilen cihazın görünümünü kontrol eden bir kaplama seçin. Cilt için çok büyük bir ekran boyutu belirtmek, ekranın kesilmesi Daha fazla bilgi için Emülatör kaplaması oluşturma bölümünü inceleyin. |
| Klavye: Klavye Girişini Etkinleştir (Gelişmiş) | Donanım klavyenizi kullanarak emülatörle etkileşime geçmek için bu seçeneği belirleyin. Bu seçenek Wear OS ve Android TV için devre dışıdır. |
Donanım profili özellikleri
Donanım Profili Yapılandır penceresinde donanım profilleri için aşağıdaki özellikleri belirtebilirsiniz. AVD yapılandırma özellikleri, donanım profili özelliklerini geçersiz kılar. Emülatör çalışırken ayarladığınız emülatör özellikleri de her ikisini de geçersiz kılar.
Aygıt Yöneticisi'ne dahil edilen önceden tanımlanmış donanım profilleri düzenlenemez. Ancak profilleri kopyalayıp düzenleyebilirsiniz.
Bazı özellikler bazı cihaz türleri için devre dışıdır. Örneğin, "Yuvarlak" özelliği yalnızca Wear OS cihazlarda kullanılabilir.
Tablo 2. Donanım profili yapılandırma özellikleri
| Donanım profili mülkü | Açıklama |
|---|---|
| Cihaz Adı | Donanım profili için bir ad girin. Adda büyük veya küçük harf, rakam, nokta, alt çizgi, parantez ve boşluk bulunabilir. Donanım profilini depolayan dosyanın adı, donanım profili adından türetilir. |
| Cihazın Türü | Aşağıdakilerden birini seçin:
|
| Ekran: Ekran Boyutu | Ekranın fiziksel boyutunu, köşeden köşeye ölçülen inç cinsinden belirtin. Boyut bilgisayar ekranınızdan büyükse başlatıldığında boyutu küçültülür. |
| Ekran: Ekran Çözünürlüğü | Simüle edilen ekrandaki toplam piksel sayısını belirtmek için piksel cinsinden bir genişlik ve yükseklik girin. |
| Ekran: Yuvarlak | Cihazın yuvarlak ekranı varsa (ör. bazı Wear OS cihazları) bu seçeneği belirleyin. |
| Bellek: RAM | Cihazın RAM boyutunu girin ve B (bayt), KB (kilobayt), MB (megabayt), GB (gigabayt) veya TB (terabayt) birimlerinden birini seçin. |
| Giriş: Donanım düğmeleri (Geri/Ana Sayfa/Menü) var | Cihazınızda donanım gezinme düğmeleri varsa bu seçeneği belirleyin. Bu düğmeler yalnızca yazılımda uygulanıyorsa seçimini kaldırın. Bu seçeneği belirlerseniz düğmeler ekranda görünmez. Her iki durumda da, düğmelere basmayı simüle etmek için emülatör yan panelini kullanabilirsiniz. |
| Giriş: Donanım Klavyesi Var | Cihazınızda donanım klavyesi varsa bu seçeneği belirleyin. Aksi takdirde seçimini kaldırın. Bu seçeneği belirlerseniz ekranda klavye görünmez. Her iki durumda da, bilgisayar klavyenizi kullanarak emülatöre tuş vuruşları gönderebilirsiniz. |
| Giriş: Gezinme Stili | Aşağıdakilerden birini seçin:
Bu seçenekler, cihazın üzerindeki donanım kontrolleri içindir. Ancak harici bir denetleyici tarafından cihaza gönderilen etkinlikler aynıdır. |
| Desteklenen cihaz durumları | Aşağıdaki seçeneklerden birini veya ikisini birden belirleyin:
En az bir seçenek seçmeniz gerekir. Her iki seçeneği de belirlerseniz emülatörde yönler arasında geçiş yapabilirsiniz. |
| Kameralar | Kamerayı etkinleştirmek için aşağıdaki seçeneklerden birini veya ikisini birden belirleyin:
Kamera etkinse AVD yapılandırmasında seçtiğiniz seçeneklere bağlı olarak, geliştirme makinenizin web kamerasını veya emülatör tarafından sağlanan bir fotoğrafı kullanarak fotoğraf çekmeyi simüle edebilirsiniz. |
| Sensörler: İvme ölçer | Cihazın yönünü belirlemesine yardımcı olan donanım varsa bu seçeneği belirleyin. |
| Sensörler: Jiroskop | Cihazınızda dönme veya bükülme algılayan donanım varsa bu seçeneği belirleyin. Jiroskop, ivme ölçerle birlikte kullanıldığında daha sorunsuz bir yön algılama sağlayabilir ve altı eksenli bir yön sistemini destekleyebilir. |
| Sensörler: GPS | Cihazınızda, Küresel Konum Belirleme Sistemi (GPS) uydu tabanlı navigasyon sistemini destekleyen donanım varsa bu seçeneği belirleyin. |
| Sensörler: Yakınlık Sensörü | Telefon görüşmesi sırasında cihazın kullanıcının yüzüne yakın olup olmadığını algılayan bir donanım varsa ekrandan gelen girişi devre dışı bırakmak için bu seçeneği belirleyin. |
| Varsayılan Cilt | Emülatörde gösterilen cihazın görünümünü kontrol eden bir kaplama seçin. Çözünürlük için çok büyük bir ekran boyutu belirtmek, ekranın kesilmesi Daha fazla bilgi için emülatör kaplaması oluşturma ile ilgili sonraki bölüme bakın. |
Emülatör görünümü oluşturma
Android emülatör görünümü, bir emülatör ekranının görsel ve kontrol öğelerini tanımlayan bir dosya koleksiyonudur. AVD ayarlarında bulunan kabuk tanımları gereksinimlerinizi karşılamıyorsa kendi özel kabuk tanımınızı oluşturabilir ve ardından AVD'nize uygulayabilirsiniz.
Her emülatör görünümü şunları içerir:
hardware.inidosyası- Desteklenen yönler ve fiziksel yapılandırmalar için düzen dosyaları
- Arka plan, tuşlar ve düğmeler gibi görüntü öğeleri için resim dosyaları
Özel bir kaplama oluşturmak ve kullanmak için:
- Tema yapılandırma dosyalarınızı kaydedebileceğiniz bir dizin oluşturun.
layoutadlı bir metin dosyasında derinin görsel görünümünü tanımlayın. Bu dosya, belirli düğmelerin boyutu ve resim öğeleri gibi temanın birçok özelliğini tanımlar. Örnek:parts { device { display { width 320 height 480 x 0 y 0 } } portrait { background { image background_port.png } buttons { power { image button_vertical.png x 1229 y 616 } } } ... }- Cihaz resimlerinin bitmap dosyalarını aynı dizine ekleyin.
- Cihaz ayarlarına yönelik bir INI dosyasında
hw.keyboardvehw.lcd.densitygibi donanıma özel ek cihaz yapılandırmaları belirtin. - Dosyaları, kaplama klasöründe arşivleyin ve arşiv dosyasını özel kaplama olarak seçin.
Emülatör kaplamaları oluşturma hakkında daha ayrıntılı bilgi için araç kaynak kodundaki Android Emülatör Kaplama Dosyası Spesifikasyonu'na bakın.