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, ortalama görüntüleme süresi (AVD) oluşturup yönetmenize yardımcı olan, Android Studio'dan başlatabileceğiniz 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.

Ortalama görüntüleme süresi hakkında

AVD; donanım profili, sistem görüntüsü, depolama alanı, dış görünüm ve başka özellikler içerir.

Manifest dosyanızdaki <uses-sdk> ayarına göre uygulamanızın destekleyebileceği her sistem görüntüsü için bir ortalama görüntüleme süresi (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'nde Pixel cihazlar gibi belirli donanım profilleri önceden yüklü 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 görüntüsü, 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 görüntüsünün yanında indir simgesi görürseniz bu görüntü ş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ışmaz. Bu nedenle, 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 üst düzey 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 görüntülerini 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 ardından Sonraki'yi tıklayın.

Yapılandırmayı Doğrula penceresi görünür.


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

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 görünür.

2. Sistem Görüntüsü veya Donanım Seç pencerelerinde değişiklik yapmanız gerekiyorsa Önceki'yi tıklayın.
3. Gereksinim duyduğunuz değişiklikleri yapın ve Son'u tıklayın.

   AVD, Cihaz Yöneticisi'nin Sanal sekmesinde görünür.

Donanım profili oluşturma

Cihaz Yöneticisi, yaygın olarak kullanılan cihazlar için önceden tanımlanmış donanım profilleri sağlar. Böylece bu cihazları 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çin 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çin penceresinde bir donanım profili seçin ve 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 ortalama görüntüleme süresi üzerinde aşağıdaki işlemleri gerçekleştirebilirsiniz:

• Bir ortalama görüntüleme süresini düzenlemek için Bu ortalama süreyi düzenle'yi tıklayın ve değişikliklerinizi 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önderilen 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üzenleyin

Ö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ırıp durdurma ve verileri temizleme

Virtual (Sanal) sekmesinden, bir emülatör üzerinde aşağıdaki işlemleri gerçekleştirebilirsiniz:

• 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şimi ve donanım profilinde geçersiz kılmak istediğiniz özellikleri belirtir. Verify Configuration (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. Emülatör çalışırken ayarladığınız emülatör özellikleri ise bunların 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 dış görünümü, 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ülü reklam öğ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 dış görünümü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. Ö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
               }
           }
       }
       ...
   }
   

3. Cihaz resimlerinin bit eşlem dosyalarını aynı dizine ekleyin.
4. Cihaz ayarlarına yönelik bir INI dosyasında hw.keyboard ve hw.lcd.density gibi donanıma özel ek cihaz yapılandırmaları belirtin.
5. 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.