Sanal cihazlar oluşturma ve yönetme

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 edilmiş 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 ile 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ı saklar. 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:

1. Cihaz Yöneticisi'ni açın.
2. 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.

3. 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.

   
4. Belirli bir API düzeyi için sistem görüntüsünü seçin ve Sonraki'yi tıklayın.

Yapılandırmayı Doğrula penceresi açılır.


5. Gerekirse 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.

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:

1. Cihaz Yöneticisi'nin Sanal sekmesinde Menü'yü tıklayın ve Kopyala'yı seçin.

   Yapılandırmayı Doğrula penceresi açılır.

2. Sistem Görüntüsü veya Donanım Seç pencerelerinde değişiklik yapmanız gerekiyorsa Önceki'yi tıklayın.
3. 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:

1. Donanım Seç penceresinde Yeni Donanım Profili'ni tıklayın.

2. Donanım Profili Yapılandır penceresinde, donanım profili özelliklerini gerektiği gibi değiştirin.

   
3. 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:

1. 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.

2. Donanım Profili Yapılandır penceresinde, donanım profili özelliklerini gerektiği gibi değiştirin.
3. 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ü'yü tıklayın ve Ayrıntıları Göster'i 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

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. Ayrıca, 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ışı bırakılmıştır. Örneğin, "Yuvarlak" özelliği yalnızca Wear OS cihazlarda kullanılabilir.

Tablo 2. Donanım profili yapılandırma özellikleri

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.ini dosyası
• 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:

1. Tema yapılandırma dosyalarınızı kaydedebileceğiniz bir dizin oluşturun.
2. layout adlı bir metin dosyasında temanın 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. Örneğin:

   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
               }
           }
       }
       ...
   }
   

3. Cihaz resimlerinin bitmap dosyalarını aynı dizine ekleyin.
4. Cihaz ayarlarıyla ilgili bir INI dosyasında hw.keyboard ve hw.lcd.density gibi donanıma özel ek cihaz yapılandırmaları belirtin.
5. Kaplama klasöründeki dosyaları 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.