Android SDK'da, bilgisayarınızda çalışan sanal bir cihaz olan Android cihaz emülatörü bulunur. Android Emulator, fiziksel bir cihaz kullanmadan Android uygulamaları geliştirmenize ve test etmenize olanak tanır.
Bu sayfada, Android Emulator ile kullanabileceğiniz komut satırı özellikleri açıklanmaktadır. Android Emulator kullanıcı arayüzünü kullanma hakkında bilgi için Android Emulator'da uygulamaları çalıştırma başlıklı makaleyi inceleyin.
Emülatörü başlatma
Projenizi çalıştırmak veya AVD Yöneticisi üzerinden başlatmak yerine emülatörü başlatmak için emulator komutunu kullanın.
Bir sanal cihazı terminal isteminden başlatmak için temel komut satırı söz dizimi aşağıda verilmiştir:
emulator -avd avd_name [ {-option [value]} … ]
Alternatif seçenek:
emulator @avd_name [ {-option [value]} … ]
Örneğin, emülatörü Mac'te çalışan Android Studio'dan başlatırsanız varsayılan komut satırı aşağıdakine benzer:
/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout
-qt-hide-window -grpc-use-token -idle-grpc-timeout bağımsız değişkenlerinin yalnızca Android Studio'da emülatör penceresini çalıştırmak için kullanıldığını lütfen unutmayın. Emülatörü kendi penceresinde çalıştırmak istiyorsanız bu ek parametreleri kullanmamalısınız.
Emülatörü başlatırken başlangıç seçeneklerini belirtebilirsiniz ancak emülatör başlatıldıktan sonra bu seçenekleri belirleyemezsiniz.
AVD adlarının listesi için aşağıdaki komutu girin:
emulator -list-avds
Android ana dizininizdeki AVD adlarının listesini göstermek için bu seçeneği kullanın.
ANDROID_SDK_HOME ortam değişkenini ayarlayarak varsayılan ana dizini geçersiz kılabilirsiniz. Bu değişken, tüm yapılandırma ve AVD içeriklerinin depolandığı kullanıcıya özel dizinin kökünü belirtir.
Ortam değişkenini, sanal cihazı başlatmadan önce terminal penceresinde veya işletim sistemindeki kullanıcı ayarlarınız aracılığıyla ayarlayabilirsiniz. Örneğin, Linux'taki .bashrc dosyanızda.
Android Emülatör'ü durdurmak için emülatör penceresini kapatın.
Uygulama yükleme
Android Studio veya emülatör
kullanıcı arayüzü üzerinden uygulama yüklemenin yanı sıra adb yardımcı programını kullanarak da uygulamanızı sanal cihaza yükleyebilirsiniz.
Uygulamanızı yüklemek, çalıştırmak ve test etmek için adb'ı kullanmak üzere aşağıdaki genel adımları uygulayın:
- Uygulamanızı Uygulamanızı derleyip çalıştırma bölümünde açıklandığı gibi derleyip APK olarak paketleyin.
- Önceki bölümde açıklandığı gibi, gerekli başlangıç seçeneklerini kullanarak emülatörü komut satırından başlatın.
- Uygulamanızı
adbkullanarak yükleyin. - Uygulamanızı emülatörde çalıştırıp test edin.
Emülatör çalışırken gerektiğinde komut vermek için Emülatör konsolunu kullanabilirsiniz.
Bir uygulamayı kaldırmak için Android cihazda yaptığınız gibi işlemi gerçekleştirin.
Sanal cihaz, uygulama ve durum verilerini yeniden başlatma işlemleri sırasında kullanıcı verileri disk bölümünde (userdata-qemu.img) korur. Bu verileri temizlemek için emülatörü -wipe-data seçeneğiyle başlatın veya AVD Manager'da verileri silin. Kullanıcı verileri bölümü ve diğer depolama alanları hakkında daha fazla bilgi için aşağıdaki bölüme bakın.
Not: adb yardımcı programı, sanal cihazı gerçek bir fiziksel cihaz olarak görür. Bu nedenle, bazı yaygın adb komutlarla (ör. install) birlikte -d işaretini kullanmanız gerekebilir. -d işareti, komutun hedefi olarak kullanılacak bağlı cihazlardan hangisinin belirtilmesine olanak tanır. Belirtmezseniz
-d, emülatör listedeki ilk cihazı hedefler.
Varsayılan dizinleri ve dosyaları anlama
Emülatör, ilişkili dosyaları kullanır. Bu dosyalar arasında en önemlileri AVD sistem ve veri dizinleridir. Komut satırı seçeneklerini belirtirken genellikle varsayılan dizinleri veya dosyaları değiştirmeniz gerekmez ancak emülatör dizin yapısını ve dosyalarını anlamak faydalıdır.
Android Emülatörü, (QEMU) hipervizörünü kullanır.
AVD sistem dizini
Sistem dizini, emülatörün işletim sistemini simüle etmek için kullandığı Android sistem görüntülerini içerir. Bu dizinde, API düzeyi, CPU mimarisi ve Android varyantı dahil olmak üzere aynı türdeki tüm AVD'ler tarafından paylaşılan platforma özgü, salt okunur dosyalar bulunur. Varsayılan konumlar şunlardır:
- macOS ve Linux -
~/Library/Android/sdk/system-images/android-apiLevel/variant/arch/ - Windows -
C:\Users\user\Library\Android\sdk\system-images\android-apiLevel\variant\arch\
Nerede:
apiLevel, sayısal bir API düzeyi veya önizleme sürümleri için bir harftir. Örneğin,android-V, Android VanillaIceCream önizlemesini gösterir. Android 15, yayınlandığındaandroid-35ile belirtilen API düzeyi 35 oldu.variant, sistem görüntüsü tarafından uygulanan belirli özelliklere karşılık gelen bir addır. Örneğin,google_apisveyaandroid-wear.archhedef CPU mimarisidir. Örneğin,x86.
AVD için farklı bir sistem dizini belirtmek üzere -sysdir seçeneğini kullanın.
Emülatör, sistem dizininden aşağıdaki dosyaları okur:
Tablo 1. Android Emulator tarafından okunan sistem dizini dosyaları
| Dosya | Açıklama | Farklı bir dosya belirtme seçeneği |
|---|---|---|
kernel-qemu veya kernel-ranchu
|
AVD için ikili çekirdek görüntüsü. kernel-ranchu, QEMU emülatörüne dayanır.
|
-kernel
|
ramdisk.img
|
Başlatma bölümü görüntüsü. Bu, sistem görüntüsü monte edilmeden önce çekirdek tarafından başlangıçta yüklenen system.img alt kümesidir. Genellikle yalnızca birkaç ikili dosya ve başlatma komut dosyası içerir.
|
-ramdisk
|
system.img
|
Sistem görüntüsünün salt okunur olan ilk sürümü. Özellikle, sistem kitaplıklarını ve API düzeyine ve varyanta karşılık gelen verileri içeren bölüm. | -system
|
userdata.img
|
Veri bölümünün ilk sürümü, emüle edilmiş sistemde data/ olarak görünür ve AVD'nin tüm yazılabilir verilerini içerir. Emülatör, yeni bir AVD oluşturduğunuzda veya ‑wipe-data seçeneğini kullandığınızda bu dosyayı kullanır. Daha fazla bilgi için aşağıdaki bölümdeki userdata-qemu.img dosya açıklamasına bakın.
|
-initdata
-init-data
|
AVD veri dizini
İçerik dizini olarak da adlandırılan AVD veri dizini, tek bir AVD örneğine özeldir ve AVD'deki tüm değiştirilebilir verileri içerir.
Varsayılan konum şöyledir. Burada name, AVD adıdır:
- macOS ve Linux -
~/.android/avd/name.avd/ - Windows 10 ve sonraki sürümler -
C:\Users\user\.android\name.avd\
Farklı bir AVD veri dizini belirtmek için -datadir seçeneğini kullanın.
Aşağıdaki tabloda, bu dizinde bulunan en önemli dosyalar listelenmiştir:
Tablo 2. AVD veri dizinindeki önemli dosyalar
| Dosya | Açıklama | Farklı bir dosya belirtme seçeneği |
|---|---|---|
userdata-qemu.img
|
Veri bölümünün içeriği, emüle edilen sistemde
Her sanal cihaz örneği, kullanıcıya ve oturuma özel verileri depolamak için yazılabilir bir kullanıcı verileri resmi kullanır. Örneğin, benzersiz bir kullanıcının yüklü uygulama verilerini, ayarlarını, veritabanlarını ve dosyalarını depolamak için bu resmi kullanır. Her kullanıcının, bu kullanıcı tarafından oluşturulan AVD'lerin veri dizinlerini depolayan farklı bir |
-data
|
cache.img
|
Önbellek bölümü resmi, emüle edilmiş sistemde cache/ olarak görünür. AVD'yi ilk kez oluşturduğunuzda veya -wipe-data seçeneğini kullandığınızda bu alan boştur. Geçici indirme dosyalarını depolar ve indirme yöneticisi, bazen de sistem tarafından doldurulur. Örneğin, tarayıcı, indirilen web sayfalarını ve resimleri öykünücü çalışırken önbelleğe almak için bu alanı kullanır. Sanal cihazı kapattığınızda dosya silinir. -cache seçeneğini kullanarak dosyayı kalıcı hale getirebilirsiniz.
|
-cache
|
sdcard.img
|
(İsteğe bağlı) Sanal cihazda SD kartı simüle etmenize olanak tanıyan bir SD kart bölümü resmi. AVD
Manager'da veya
AVD Yöneticisi'nde bir AVD tanımlarken otomatik olarak yönetilen bir SD kart dosyası veya
Sanal cihaz çalışırken emülatör kullanıcı arayüzünü veya
Yüklemeden önce dosyaları SD kart dosyasına kopyalamak için görüntü dosyasını döngü cihazı olarak bağlayın ve ardından dosyaları kopyalayın. Alternatif olarak, dosyaları doğrudan görüntüye kopyalamak için Emülatör, dosyayı bayt havuzu olarak işlediği için SD kart biçimi önemli değildir.
|
-sdcard
|
Emülatör tarafından kullanılan dizinleri ve dosyaları listeleme
Dosyaların nerede bulunduğunu iki şekilde öğrenebilirsiniz:
- Emülatörü komut satırından başlatırken
-verboseveya-debug initseçeneğini kullanın. Çıkışa bakın. - Varsayılan bir dizini listelemek için
emulator-help-optionkomutunu kullanın. Örneğin:emulator -help-datadir
Use '-datadir <dir>' to specify a directory where writable image files will be searched. On this system, the default directory is: /Users/me/.android See '-help-disk-images' for more information about disk image files.
Komut satırı başlangıç seçenekleri
Bu bölümde, emülatörü başlattığınızda komut satırında sağlayabileceğiniz seçenekler listelenir.
Not: Android Emulator, daha güvenilir hale getirmek için sürekli olarak geliştirilmektedir. Çeşitli komut satırı seçeneklerine karşı bildirilen sorunların durumu ve hataları bildirmek için Android Sorun İzleyici'yi inceleyin.
Sık kullanılan seçenekler
Aşağıdaki tabloda, daha sık kullanabileceğiniz komut satırı başlangıç seçenekleri listelenmiştir:
Tablo 3. Sık kullanılan komut satırı seçenekleri
| Komut satırı seçeneği | Açıklama |
|---|---|
| Hızlı Başlatma | |
-no-snapshot-load
|
Soğuk başlatma gerçekleştirir ve çıkışta emülatör durumunu kaydeder. |
-no-snapshot-save
|
Mümkünse hızlı başlatma işlemi gerçekleştirir ancak çıkışta emülatör durumunu kaydetmez. |
-no-snapshot
|
Hızlı başlatma özelliğini tamamen devre dışı bırakır ve emülatör durumunu yüklemez veya kaydetmez. |
| Cihaz Donanımı | |
-camera-back mode-camera-front mode
|
Arka veya ön kameranın emülasyon modunu ayarlar. Bu, AVD'deki tüm kamera ayarlarını geçersiz kılar.
Örneğin: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list
|
Geliştirme bilgisayarınızda emülasyon için kullanılabilen web kameralarını listeler. Örneğin:emulator @Pixel8_API_34 -webcam-list
List of web cameras connected to the computer:
Camera 'webcam0' is connected to device 'webcam0'
on channel 0 using pixel format 'UYVY'Örnekte, ilk SDK Tools 25.2.4 sürümünden itibaren AVD adı gereklidir. |
| Disk görüntüleri ve bellek | |
-memory size
|
Fiziksel RAM boyutunu 1536 MB ile 8192 MB arasında belirtir. Örneğin: emulator @Pixel8_API_34 -memory 2048 Bu değer, AVD ayarını geçersiz kılar. |
-sdcard filepath
|
SD kart bölümü görüntü dosyasının dosya adını ve yolunu belirtir. Örneğin:
emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img Dosya bulunamazsa emülatör yine başlatılır ancak SD kart olmadan. Komut, SD kart resmi yok uyarısını döndürüyor.
Bu seçeneği belirtmezseniz AVD farklı bir şey belirtmediği sürece veri dizininde varsayılan olarak |
-wipe-data
|
Kullanıcı verilerini siler ve ilk veri dosyasındaki verileri kopyalar. Bu seçenek, sanal cihazın verilerini temizler ve ilk tanımlandığı duruma geri döndürür. Yüklü tüm uygulamalar ve ayarlar kaldırılır. Örneğin:
emulator @Pixel8_API_34 -wipe-data
Varsayılan olarak, kullanıcı verileri dosyası |
| Hata ayıklama | |
-debug tags
|
Bir veya daha fazla etiket için hata ayıklama mesajlarının gösterilmesini etkinleştirir veya devre dışı bırakır.
Birden fazla etiketi boşluk, virgül veya sütunla ayırın. Örneğin:
$ emulator @Pixel8_API_34 -debug init,metrics Bir etiketi devre dışı bırakmak için önüne tire (-) işareti koyun. Örneğin, aşağıdaki seçenek, ağ soketleri ve metriklerle ilgili olanlar hariç tüm hata ayıklama mesajlarını gösterir:
Etiket ve açıklamaların listesi için
emulator -help-debug-tags
Varsayılan hata ayıklama etiketlerini
ANDROID_VERBOSE=socket,gles Aşağıdakileri kullanmaya eşdeğerdir:
veya
|
-debug-tag-debug-no-tag
|
Belirli bir hata ayıklama mesajı türünü etkinleştirir. Bir hata ayıklama mesajı türünü devre dışı bırakmak için no formunu kullanın. Örneğin:
emulator @Pixel8_API_34 -debug-all -debug-no-metrics
Etiketlerin listesi için |
-logcat logtags
|
Bir veya daha fazla etiket için Logcat mesajlarının görüntülenmesini sağlar ve bunları terminal penceresine yazar. Örneğin, aşağıdaki komut tüm bileşenlerden gelen hata mesajlarını etkinleştirir:
emulator @Pixel8_API_34 -logcat *:e
Aşağıdaki örnekte, GSM bileşen mesajları bilgilendirici günlük düzeyinde gösterilmektedir:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
Komut satırında Logcat ve |
-show-kernel
|
Terminal penceresinde çekirdek hata ayıklama mesajlarını gösterir. Örneğin:
emulator @Pixel8_API_34 -show-kernel Bu seçeneğin kullanım alanlarından biri, başlatma işleminin doğru şekilde çalıştığını kontrol etmektir. |
-verbose
|
Emülatör başlatma mesajlarını terminal penceresine yazdırır. Örneğin:
emulator @Pixel8_API_34 -verbose
AVD'de tanımlanan bir sanal cihaz başlatılırken hangi dosya ve ayarların seçildiğini gösterir. Bu seçenek, |
| Ağ | |
-dns-server servers
|
Belirtilen DNS sunucularını kullanır. servers, en fazla dört DNS sunucusu adının veya IP adresinin virgülle ayrılmış listesidir. Örneğin:
emulator @Pixel8_API_34 -dns-server 192.0.2.0,
Emülatör, varsayılan olarak kullandığınız DNS sunucularını algılamaya çalışır ve Android sisteminin sunuculara doğrudan bağlanmasına izin vermek için emüle edilmiş güvenlik duvarı ağında özel takma adlar oluşturur. Farklı bir DNS sunucuları listesi belirtmek için |
-http-proxy proxy
|
Belirtilen bir HTTP/HTTPS proxy'si üzerinden tüm TCP bağlantılarını yapar. Emülatörünüzün internete bir proxy sunucu üzerinden erişmesi gerekiyorsa uygun yönlendirmeyi ayarlamak için bu seçeneği veya http_proxy ortam değişkenini kullanabilirsiniz. Örneğin:
emulator @Pixel8_API_34 -http-proxy myserver:1981
Bu seçenek sağlanmazsa emülatör, |
-netdelay delay
|
Ağ gecikmesi emülasyonunu aşağıdaki
Örneğin: emulator @Pixel8_API_34 -netdelay gsm
Emülatör, ağ sınırlamasının yanı sıra daha yüksek bağlantı gecikmelerini de destekler.
Bu ayarı, tema yapılandırması veya |
-netfast
|
Ağ sınırlamayı devre dışı bırakır. Örneğin:
emulator @Pixel8_API_34 -netfast
Bu seçenek, |
-netspeed speed
|
Ağ hızı emülasyonunu ayarlar. Maksimum ağ yükleme ve indirme hızlarını kb/sn cinsinden aşağıdaki
Örneğin: emulator @Pixel8_API_34 -netspeed edge
Emülatör, ağ sınırlamasının yanı sıra daha yüksek bağlantı gecikmelerini de destekler.
Bu ayarı, tema yapılandırması veya |
-port port
|
Konsol ve adb için kullanılan TCP bağlantı noktası numarasını ayarlar. Örneğin:
emulator @Pixel8_API_34 -port 5556
Makinenizde çalışan ilk sanal cihaz örneği için varsayılan değer 5554'tür. Sanal cihazlar normalde bir çift bitişik bağlantı noktasını kullanır: bir konsol bağlantı noktası ve bir
Bağlantı noktası atamaları genellikle
|
-ports
|
Konsol ve adb için kullanılan TCP bağlantı noktalarını ayarlar. Örneğin:
emulator @Pixel8_API_34 -ports 5556,5559
Geçerli bağlantı noktası aralığı 5554 ile 5682 arasındadır ve 64 eşzamanlı sanal cihaza izin verir.
Mümkünse bunun yerine
Konsol ve |
-tcpdump filepath
|
Ağ paketlerini yakalar ve bir dosyada saklar. Örneğin:
emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap Emülatörün sanal Ethernet LAN'ı üzerinden gönderilen tüm ağ paketlerini yakalamaya başlamak için bu seçeneği kullanın. Ardından, trafiği analiz etmek için Wireshark gibi bir araç kullanabilirsiniz. Bu seçeneğin tüm Ethernet paketlerini yakaladığını ve TCP bağlantılarıyla sınırlı olmadığını unutmayın. |
| Sistem | |
-accel mode
|
Emülatör sanal makine hızlandırmasını yapılandırır. Örneğin:
emulator @Pixel8_API_34 -accel auto Hızlandırılmış emülasyon yalnızca x86 ve x86_64 sistem görüntülerinde çalışır. Linux'ta KVM'yi kullanır. Windows ve Mac'te Intel CPU ve Intel HAXM sürücüsü kullanılır. x86 veya x86_64 cihazı taklit etmiyorsanız bu seçenek yok sayılır.
Daha fazla bilgi için Android Emulator için donanım hızlandırmayı yapılandırma başlıklı makaleyi inceleyin. |
-accel-check
|
Emülatör VM hızlandırması için gerekli bir hipervizörün (HAXM veya KVM) yüklü olup olmadığını kontrol eder. Örneğin:
emulator -accel-check Daha fazla bilgi için Hipervizörün yüklü olup olmadığını kontrol etme başlıklı makaleyi inceleyin. |
-engine engine
|
Emülatör motorunu belirtir:
Örneğin:
emulator @Pixel8_API_34 -engine auto
Otomatik algılama, belirli bir AVD'yi taklit ederken en iyi performansı sağlayan değeri seçmelidir. |
-gpu mode
|
GPU emülasyon modunu seçer. Örneğin:
emulator @Pixel8_API_34 -gpu swiftshader_indirect Daha fazla bilgi için Grafik hızlandırmayı yapılandırma başlıklı makaleyi inceleyin. |
-no-accel
|
x86 veya x86_64 sistem görüntüsü kullanılırken emülatör sanal makine hızlandırmasını devre dışı bırakır. Yalnızca hata ayıklama için kullanışlıdır ve -accel
off belirtmekle aynıdır. Örneğin:
emulator @Pixel8_API_34 -no-accel Daha fazla bilgi için Android Emulator için donanım hızlandırmayı yapılandırma başlıklı makaleyi inceleyin. |
-nojni
-no-jni
|
Android Dalvik veya ART çalışma zamanında genişletilmiş Java Native Interface (JNI) denetimlerini devre dışı bırakır. Örneğin:
emulator @Pixel8_API_34 -nojni Sanal cihazı başlattığınızda, genişletilmiş JNI kontrolleri varsayılan olarak etkinleştirilir. Daha fazla bilgi için JNI ipuçları konusuna bakın. |
-selinux {disabled|permissive}
|
Linux işletim sisteminde Security-Enhanced Linux (SELinux) güvenlik modülünü disabled veya permissive moduna ayarlar. Örneğin:
me-linux$ emulator @Pixel8_API_34 -selinux permissive
SELinux varsayılan olarak |
-timezone timezone
|
Sanal cihazın saat dilimini ana makinenin saat dilimi yerine emulator @Pixel8_API_34 -timezone Europe/Paris
Emülatör varsayılan olarak geliştirme bilgisayarınızın saat dilimini kullanır. Farklı bir saat dilimi belirtmek veya otomatik algılama doğru çalışmıyorsa bu seçeneği kullanın.
Belirtilen saat dilimi zoneinfo veritabanında olmalıdır. |
-version
|
Emülatörün sürüm numarasını gösterir. Örneğin:
emulator @Pixel8_API_34 -version Alternatif seçenek:
emulator -version |
| UI | |
-no-boot-anim
|
Daha hızlı başlatma için emülatör başlatılırken açılış animasyonunu devre dışı bırakır.
Örneğin:
emulator @Pixel8_API_34 -no-boot-anim Bu seçenek, daha yavaş bilgisayarlarda başlatma sırasını önemli ölçüde hızlandırabilir. |
-screen mode
|
Emüle edilmiş dokunmatik ekran modunu ayarlar. Örneğin:
emulator @Pixel8_API_34 -screen no-touch
|
Gelişmiş seçenekler
Aşağıdaki tablodaki komut satırı başlangıç seçenekleri kullanılabilir ancak ortalama bir uygulama geliştirici tarafından yaygın olarak kullanılmaz.
Açıklamalarda, çalışma dizini, komutları girdiğiniz terminaldeki geçerli dizindir. AVD sistem dizini, veri dizini ve bu dizinlerde depolanan dosyalar hakkında bilgi edinmek için varsayılan dizinler ve dosyalar bölümüne bakın.
Bu seçeneklerden bazıları harici uygulama geliştiriciler için uygundur. Bazıları ise öncelikle platform geliştiriciler tarafından kullanılır. Uygulama geliştiriciler, Android uygulamaları oluşturur ve bunları belirli AVD'lerde çalıştırır. Platform geliştiriciler, Android sistemi üzerinde çalışır ve önceden oluşturulmuş AVD olmadan emülatörde çalıştırır.
Tablo 4. Gelişmiş komut satırı seçenekleri
| Gelişmiş seçenek | Kısa açıklama |
|---|---|
-bootchart timeout
|
Saniye cinsinden zaman aşımıyla önyükleme grafiği oluşturmayı etkinleştirir. Bazı Android sistem görüntülerinde, önyükleme grafiği oluşturma özelliği entegre edilmiş değiştirilmiş bir başlatma sistemi bulunur. Bu seçenekle sisteme bir önyükleme grafiği oluşturma zaman aşımı süresi iletebilirsiniz. Başlatma sisteminizde bootcharting etkinleştirilmemişse bu seçenek hiçbir işe yaramaz. Bu seçenek, harici uygulama geliştiriciler için değil, öncelikle platform geliştiriciler için yararlıdır. Örneğin: emulator @Pixel8_API_34 -bootchart 120 |
-cache filepath
|
Önbellek bölümü görüntü dosyasını belirtir. Kalıcı bir önbellek dosyası oluşturmak için dosya adı ve mutlak yol ya da veri dizinine göreli yol sağlar. Dosya mevcut değilse emülatör, dosyayı boş olarak oluşturur. Örneğin: emulator @Pixel8_API_34 -cache ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img Bu seçeneği kullanmazsanız varsayılan olarak |
-cache-size size
|
Önbellek bölümü boyutunu MB cinsinden ayarlar. Örneğin: emulator @Pixel8_API_34 -cache-size 1000 Bu seçeneği belirtmezseniz varsayılan değer 66 MB olur. Normalde, çoğu uygulama geliştiricinin bu seçeneğe ihtiyacı yoktur. Ancak varsayılan önbellekten daha büyük olan çok büyük dosyaları indirmeleri gerekiyorsa bu seçeneği kullanabilirler. Önbellek dosyası hakkında daha fazla bilgi için AVD veri dizini başlıklı makaleyi inceleyin. |
-data filepath
|
Kullanıcı verileri bölümü resim dosyasını ayarlar. Kalıcı kullanıcı verileri dosyası oluşturmak için dosya adı ve mutlak yol ya da çalışma dizinine göreli yol sağlar. Dosya yoksa emülatör, varsayılan Örneğin: emulator @Pixel8_API_34 -data ~/.android/avd/Pixel8_API_34.avd/userdata-test.img Bu seçeneği kullanmazsanız varsayılan olarak |
-datadir dir
|
Mutlak yol kullanarak bir veri dizini belirtir. Daha fazla bilgi için AVD veri dizini başlıklı makaleyi inceleyin. Örneğin: emulator @Pixel8_API_34 -datadir ~/.android/avd/Pixel8_API_34.avd/mytest |
-force-32bit
|
64 bit platformlarda 32 bit emülatörünü kullanır. Bu seçenek bazen test veya hata ayıklama için yararlı olabilir. Örneğin, 64 bit Windows'ta bazen çalışmayan ancak 32 bit Windows'ta çalışan bir emülatör sorunu vardı. Bu seçenek, sorunda hata ayıklamak için karşılaştırma yapmaya yardımcı oldu. Örnek: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images
|
Disk görüntüleri hakkında yardım alır. Bu seçenek, hem uygulama hem de platform geliştiricilerle ilgili bilgiler sağlar. Örneğin: emulator -help-disk-images |
-help-char-devices
|
emulator -help-char-devices |
-help-sdk-images
|
Uygulama geliştiricilerle alakalı disk görüntüleri hakkında yardım alma Bu seçenek, SDK araçlarıyla oluşturulan bir AVD'nin resim dosyalarının bulunduğu yerle ilgili bilgileri alır. Örneğin: emulator -help-sdk-images |
-help-build-images
|
Platform geliştiricileriyle ilgili disk görüntüleri hakkında yardım alma Örneğin: emulator -help-build-images |
-initdata filepath-init-data
filepath
|
Veri bölümünün ilk sürümünü belirtir. Emülatör, kullanıcı verilerini sildikten sonra başlangıç sürümü olarak varsayılan Örneğin: emulator @Pixel8_API_34 -initdata ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/userdata-test.img Yol belirtmezseniz dosya sistem dizinine yerleştirilir. Daha fazla bilgi için AVD sistem dizini başlıklı makaleyi inceleyin. |
-kernel filepath
|
Belirli bir emüle edilmiş çekirdek kullanır. Bir yol belirtmezseniz emülatör sistem dizininde arama yapar. Çekirdek hata ayıklama mesajlarını görüntülemek için‑show‑kernel seçeneğini kullanın.
Örneğin: emulator @Pixel8_API_34 -kernel ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/kernel-test.img -show-kernel Bu seçeneği belirtmezseniz varsayılan değer |
-noaudio
-no-audio
|
Bu sanal cihaz için ses desteğini devre dışı bırakır. Bazı Linux ve Windows bilgisayarlarda, emülatörün başlatılmasını engelleme gibi farklı sorunlara neden olan hatalı ses sürücüleri bulunur. Bu durumda, sorunu gidermek için bu seçeneği kullanın. Alternatif olarak, ses arka ucunu değiştirmek için Örneğin: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
Emülatörü önbellek bölümü olmadan başlatır. Bu seçeneği kullanmazsanız varsayılan olarak Örneğin: emulator @Pixel8_API_34 -nocache |
-no-snapshot
|
Hem otomatik yükleme hem de kaydetme işlemlerini engeller. Bu nedenle, kapatıldığında emülatörün tam başlatma sırası yürütülür ve durumu kaybolur. Bu seçenek, Örneğin: emulator @Pixel8_API_34 -no-snapshot |
-no-snapshot-load
|
Emülatörün, anlık görüntü depolama alanından AVD durumunu yüklemesini engeller. Tam başlatma işlemi gerçekleştirir. Örneğin: emulator @Pixel8_API_34 -no-snapshot-load |
-no-snapshot-save
|
Emülatörün AVD durumunu çıkışta anlık görüntü depolama alanına kaydetmesini engeller. Bu durumda tüm değişiklikler kaybolur. Örneğin: emulator @Pixel8_API_34 -no-snapshot-save |
-no-snapshot-update-time
|
Anlık görüntü geri yüklenirken AVD saatini hemen düzeltmeye çalışmaz. Bu seçenek, ani bir zaman atlamasını önlediği için test sırasında faydalı olabilir. Saat güncellemeleri, AVD'ye yaklaşık 15 saniyede bir gönderilmeye devam eder. Örneğin: emulator @Pixel8_API_34 -no-snapshot-update-time |
-no-snapstorage
|
Durum anlık görüntülerini depolamak veya yüklemek için dosya bağlamadan emülatörü başlatır. Bu işlem, tam başlatmayı zorlar ve durum anlık görüntüsü işlevini devre dışı bırakır. Bu seçenek, Örneğin: emulator @Pixel8_API_34 -no-snapstorage |
-no-window
|
Emülatörde grafik pencere görüntülemeyi devre dışı bırakır. Bu seçenek, emülatörü ekranı olmayan sunucularda çalıştırırken kullanışlıdır. Emülatöre emulator @Pixel8_API_34 -no-window |
-partition-size size
|
Sistem verileri bölüm boyutunu MB cinsinden belirtir. Örneğin: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name=value
|
Öykünücü başlatıldığında öykünücüde bir Android sistem özelliği ayarlar.
emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
QEMU emülatör yazılımına bağımsız değişkenler aktarır. Bu seçeneği kullanırken, kendisinden sonraki tüm seçenekler QEMU'ya özgü seçenekler olarak yorumlandığından, bu seçeneğin belirtilen son seçenek olduğundan emin olun. Bu seçenek oldukça gelişmiştir ve yalnızca QEMU ve Android emülasyonu konusunda çok bilgili olan geliştiriciler tarafından kullanılmalıdır. |
-qemu -h
|
emulator -qemu -h |
-ramdisk filepath
|
Bir ramdisk önyükleme görüntüsü belirtir. Dosya adını ve mutlak yolu veya çalışma dizinine göreli yolu belirtir. Örneğin: emulator @Pixel8_API_34 -ramdisk ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/ramdisk-test.img Bu seçeneği kullanmazsanız varsayılan olarak sistem dizinindeki |
-report-console socket
|
Emülasyonu başlatmadan önce konsol bağlantı noktasını uzak bir üçüncü tarafa bildirir. Otomatik test komut dosyası için yararlı olabilir.
Daha fazla bilgi için belirli seçeneklerle ilgili yardım bölümünde açıklandığı gibi |
-shell
|
Mevcut terminalde bir kök kabuk konsolu oluşturur. Bu seçenek,
Örneğin: emulator @Pixel8_API_34 -shell |
-snapshot name
|
Otomatik başlatma ve kaydetme işlemleri için anlık görüntü depolama dosyasındaki bir anlık görüntünün adını belirtir. Tam bir başlatma sırası yürütmek yerine, emülatör yürütmeye önceki bir durum anlık görüntüsünden devam edebilir. Bu işlem genellikle çok daha hızlıdır. Bu seçeneği sağladığınızda, emülatör bu ada sahip anlık görüntüyü anlık görüntü resminden yükler ve çıkışta aynı adla geri kaydeder. Bu seçeneği kullanmazsanız varsayılan olarak tam başlatma sırası uygulanır. Belirtilen anlık görüntü yoksa emülatör bunun yerine tam bir başlatma sırası gerçekleştirir ve kaydetme işlemi yapar. Anlık görüntü depolama dosyası ve varsayılan dosya belirtme hakkında bilgi edinmek için emulator @Pixel8_API_34 -snapshot snapshot2 Anlık görüntü yükleme işlemi sırasında sistemin tüm içeriklerinin, kullanıcı verilerinin ve SD kart görüntülerinin, anlık görüntü oluşturulduğundaki içeriklerle üzerine yazılacağını unutmayın. Bu bilgileri farklı bir anlık görüntüye kaydetmediğiniz sürece, o zamandan beri yapılan tüm değişiklikler kaybolur. Ayrıca, |
-snapshot-list
|
Kullanılabilir anlık görüntülerin listesini gösterir. Bu komut, emülatörün başlatıldığı anlık görüntü depolama dosyasında depolanan anlık görüntülerin tablosunu yazdırır ve ardından çıkar. Örneğin: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Çıkışta, ID ve TAG sütun değerlerini |
-snapstorage filepath
|
Tüm durum anlık görüntülerini içeren bir depo dosyası belirtir. Yürütme sırasında oluşturulan tüm anlık görüntüler bu dosyaya kaydedilir. Yalnızca bu dosyada bulunan anlık görüntüler, emülatör çalıştırılırken geri yüklenebilir. Örneğin: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Bu seçeneği belirtmezseniz varsayılan olarak veri dizinindeki |
-sysdir dir
|
Mutlak yol kullanarak bir sistem dizini belirtir. Daha fazla bilgi için AVD sistem dizini başlıklı makaleyi inceleyin. Örneğin: emulator @Pixel8_API_34 -sysdir ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/test |
-system filepath
|
Başlangıç sistem dosyasını belirtir. Dosya adını ve mutlak yolu veya çalışma dizinine göreli yolu sağlar. Örneğin: emulator @Pixel8_API_34 -system ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/system-test.img Bu seçeneği kullanmazsanız varsayılan olarak sistem dizinindeki |
-writable-system
|
Emülasyon oturumunuz sırasında yazılabilir bir sistem görüntüsüne sahip olmak için bu seçeneği kullanın. Bunu yapmak için:
Bu işaretin kullanılması, sistem görüntüsünün geçici bir kopyasını oluşturur. Bu kopya, birkaç yüz MB'a kadar çok büyük olabilir ancak emülatörden çıkıldığında silinir. |
Kullanımdan kaldırılan seçenekler
Aşağıdaki komut satırı seçeneklerinin desteği sonlandırıldı:
-audio-in-audio-out-charmap-code-profile-cpu-delay-dpi-device-dynamic_skin-enable-kvm-gps-image-keyset-help-keys-help-keyset-file-nand-limits-noskin-no-skin-onion-onion-alpha-onion-rotation-radio-ranchu-raw-keys-scale-shared-net-id-shell-serial-skin-skindir-trace-useaudio
Komut satırı seçenekleri hakkında yardım alma
Bu bölümde, komut satırı seçenekleriyle ilgili nasıl yardım alabileceğiniz açıklanmaktadır. Emülatörü başlattığınızda kullanılabilen, yaygın olarak kullanılan emülatör komut satırı seçenekleri hakkında daha ayrıntılı bilgi sağlar.
Tüm emülatör seçeneklerini listeleme
Kısa açıklama da dahil olmak üzere tüm emülatör seçeneklerinin listesini yazdırmak için aşağıdaki komutu girin:
emulator -help
Belirli bir seçenekle ilgili ayrıntılı yardım alma
Belirli bir başlangıç seçeneğiyle ilgili yardım içeriğini yazdırmak için aşağıdaki komutu girin:
emulator -help-option
Örneğin:
emulator -help-netspeed
Bu yardım, -help seçeneğinin sağladığı açıklamadan daha ayrıntılıdır.
Tüm seçenekler için ayrıntılı yardım alma
Tüm emülatör seçenekleriyle ilgili ayrıntılı yardım almak için aşağıdaki komutu girin:
emulator -help-all
Emülatör ortamı değişkenlerini listeleme
Emülatör ortam değişkenlerinin listesini almak için aşağıdaki komutu girin:
emulator -help-environment
Sanal cihazı başlatmadan önce terminal penceresinde ortam değişkenlerini ayarlayabilir veya işletim sistemindeki kullanıcı ayarlarınızdan bu değişkenleri belirleyebilirsiniz. Örneğin, Linux'taki .bashrc dosyanızda ayarlayın.
Hata ayıklama etiketlerini listeleme
-debug seçenekleriyle ilgili etiketlerin listesini yazdırmak için aşağıdaki komutu girin:
emulator -help-debug-tags
-debug seçenekleri, etiketlerde belirtildiği gibi belirli emülatör bileşenlerinden gelen hata ayıklama mesajlarını etkinleştirmenize veya devre dışı bırakmanıza olanak tanır.