Ortam değişkenleri

Android Studio'nun ve komut satırı araçlarının davranışını değişkenlerine odaklanmalıdır. Ayarlanacak en kullanışlı ortam değişkenlerinden biri ANDROID_HOME: Birçok aracın okuması Android SDK yükleme dizinini belirler. Yürütülebilir dosyanın tam yolunu eklemeden araçları komut satırından çalıştırmak için komutunuzu ayarlayın dahil edilecek arama yolu ortam değişkeni ANDROID_HOME/tools, ANDROID_HOME/tools/bin ve ANDROID_HOME/platform-tools.

Ortam değişkenlerini ayarlama

Aşağıdaki örneklerde, ortam değişkenlerinin bir terminal penceresinde ve işletim sistemleri için bir kabuk komut dosyasıdır. Terminal pencerelerindeki değişken ayarları en son yalnızca pencere açık olduğu sürecektir. macOS ve Linux'ta, her yeni kabuk başlatıldığında değişken ayarlar yapıldı kabuk içinde başlatma komut dosyalarıdır. Windows'da, değişken ayarları sistem ayarlarından yapabilirsiniz.

Windows: Bir terminal penceresine aşağıdakileri yazın:

set HTTP_PROXY=myserver:1981

Alternatif olarak, Windows kullanıcı arayüzünden ekleyin. Windows sürümünüze ilişkin dokümanlara bakın inceleyebilirsiniz.

macOS ve Linux: Ortam değişkenlerini ayarlamanın kesin yöntemi daha iyi olur. Hangi kabuk türünün çalıştığını belirlemek için aşağıdakileri yazın:

echo $0

Örneğin, Gnu Bash veya Zsh, değişkenler aşağıdaki kullanılarak ayarlanır söz dizimi:

export VARIABLE_NAME=<new-value>

Örneğin, TCSH, değişkenler şu söz dizimi:

setenv VARIABLE_NAME <new-value>

Bu komutlar, çalıştırıldığında değişkenleri ayarlamak için kabuk başlatma komut dosyasına eklenebilir. yeni kabuk örneği çalıştırılıyor.

Kabuk başlatma komut dosyasının konumu, kullanılan kabuğa bağlıdır. Gnu Bash için konum ~/.bash_profile olabilir. Örneğin, Zsh, konum ~/.zprofile olabilir. TCSH için konum şöyle olabilir: ~/.cshrc Kontrol et emin olmak için kullandığınız kabuğun dokümanlarına bakın.

Ayrıca, PATH ortam değişkenini araç konumlarını içerecek şekilde güncelleyebilirsiniz.

Gnu Bash veya Zsh için:

export ANDROID_HOME=~/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools
  

TCSH için:

setenv ANDROID_HOME ~/Library/Android/sdk
setenv PATH $PATH\:$ANDROID_HOME/tools\:$ANDROID_HOME/tools/bin\:$ANDROID_HOME/platform-tools
  

Değişkenler referansı

Aşağıdaki tabloda, Android SDK araçları için yaygın olarak kullanılan ortam değişkenleri açıklanmaktadır.

Tablo 1. Ortam değişkenleri

Android SDK ortam değişkenleri
ANDROID_HOME SDK yükleme dizininin yolunu belirler. Ayarlandıktan sonra, Değer genellikle değişmez ve aynı makinede birden fazla kullanıcı tarafından paylaşılabilir. ANDROID_SDK_ROOT, SDK yükleme dizinini de gösterir. desteği sonlandırıldı. Kullanmaya devam ederseniz Android Studio ve Android Gradle eklentisi eski ve yeni değişkenlerin tutarlı olup olmadığını kontrol etmek.
ANDROID_USER_HOME Android SDK'nın parçası olan araçların kullanıcı tercihleri dizininin yolunu belirler. Varsayılan olarak $HOME/.android/ değerine ayarlanır.

Android Studio 4.3 ve önceki sürümleri gibi bazı eski araçlar ANDROID_USER_HOME Bu eski araçlarda kullanıcı tercihleri konumunu geçersiz kılmak için URL'sini istediğiniz üst dizine ANDROID_SDK_HOME .android dizini oluşturulacak.

REPO_OS_OVERRIDE Aşağıdaki durumlarda bu değişkeni windows, macosx veya linux olarak ayarlayın sdkmanager kullanıyorsunuz mevcut makineden farklı bir işletim sistemi için paket indirin.
Android Studio yapılandırma ortamı değişkenleri
Android Studio yapılandırma değişkenleri, JDK'yı bulun. Android Studio başlangıçta aşağıdaki değişkenleri kontrol eder Ayarlar'a gidin. Daha fazla bilgi için bkz. Android Studio'yu yapılandırın.
STUDIO_VM_OPTIONS studio.vmoptions dosyasının konumunu ayarlar. Bu dosya, Java HotSpot'un performans özelliklerini etkileyen ayarları içerir Sanal Makine. Bu dosyaya Android Studio'dan da erişilebilir. Görüntüleyin Sanal makine seçeneklerinizi özelleştirin.
STUDIO_PROPERTIES idea.properties öğesinin konumunu ayarlar dosyası olarak kaydedebilirsiniz. Bu dosya, Android Studio IDE özelliklerini özelleştirmenizi sağlar (örneğin, kullanıcı tarafından yüklenen eklentiler ve IDE'nin desteklediği maksimum dosya boyutu. Görüntüleyin IDE özelliklerinizi özelleştirin.
STUDIO_JDK Android Studio'nun çalıştığı JDK'nın konumunu ayarlar. IDE'yi başlattığınızda STUDIO_JDK, JDK_HOME ve JAVA_HOME kontrol ediliyor göre sıralar.
STUDIO_GRADLE_JDK Android Studio'nun Gradle arka plan programını başlatmak için kullandığı JDK'nın konumunu ayarlar. Google Takvim widget'ını ilk olarak STUDIO_GRADLE_JDK'i kontrol eder. Eğer STUDIO_GRADLE_JDK tanımlı değil. IDE, şurada ayarlanan değeri kullanır: proje yapısı ayarlarını değiştirin.
Emülatör ortam değişkenleri
Varsayılan olarak emülatör, yapılandırma dosyalarını $HOME/.android/avd/ altındaki $HOME/.android/ ve ortalama görüntüleme süresi verileri. Şunları yapabilirsiniz: Aşağıdaki ortam değişkenlerini ayarlayarak varsayılanları geçersiz kılabilirsiniz. emulator -avd <avd_name> komutu, avd üzerinde arama yapar. dizinini $ANDROID_AVD_HOME içindeki değerlere göre sıralayın $ANDROID_USER_HOME/avd/ ve $HOME/.android/avd/.

Emülatör ortam değişkeni yardımı için şunu yazın: emulator -help-environment tuşlarına basın. Daha fazla bilgi için emulator komut satırı seçeneği için bkz. Emülatörü komut satırından başlatın.

ANDROID_EMULATOR_HOME Kullanıcıya özel emülatör yapılandırmasının yolunu belirler dizin. Varsayılan olarak $ANDROID_USER_HOME değerine ayarlanır.

Android Studio 4.3 ve önceki sürümleri gibi eski araçlar okumaz ANDROID_USER_HOME Bu araçlarda varsayılan değer $ANDROID_SDK_HOME/.android

ANDROID_AVD_HOME VD'ye özel tüm öğeleri içeren dizinin yolunu ayarlar içeren dosyalar oluşturabilirsiniz. Varsayılan konum $ANDROID_EMULATOR_HOME/avd/ Şu durumlarda yeni bir konum belirtmek isteyebilirsiniz: varsayılan konumun disk alanı az.
Android emülatörü, başlatıldığında aşağıdaki ortam değişkenlerini sorgular:
ANDROID_LOG_TAGS ANDROID_LOG_TAGS başlıklı makaleyi inceleyin.
HTTP_PROXY

HTTP/HTTPS proxy'sini içerir ayarını değiştirebilirsiniz. Ana makine ile bağlantı noktası arasında iki nokta işareti (:) ayırıcısı kullanır. Örneğin, örnek, set HTTP_PROXY=myserver:1981.

Bu, Emülatör komut satırından çalıştırılırken -http-proxy proxy bağımsız değişkeni.

ANDROID_VERBOSE ANDROID_VERBOSE başlıklı makaleyi inceleyin.
ANDROID_HOME ANDROID_HOME başlıklı makaleyi inceleyin.
ANDROID_EMULATOR_USE_SYSTEM_LIBS 0 (varsayılan) veya 1 değerini içerir. 1 değeri, sistemin Emülatörle birlikte gelen dosya yerine libstdc++.so dosyası kullanılır. Bu ortam değişkenini yalnızca emülatör, Linux sisteminizde başlamadığında ayarlayın çünkü sistem kitaplığıyla ilgili bir sorun var. Örneğin, bazı Linux Radeon GL sürücü kitaplıkları, daha yeni bir libstdc++.so dosyası gerektirir.
Hızlı emülatör (QEMU) sesi
QEMU_AUDIO_DRV QEMU_AUDIO_OUT_DRV QEMU_AUDIO_IN_DRV Linux'ta varsayılan sesi değiştirebilirsiniz. QEMU_AUDIO_DRV ortam değişkenini ayarlayarak emülatörün arka ucu şu değerlerden birine uyar:
  • alsa: Gelişmiş Linux Ses Mimarisi (ALSA) arka ucunu kullanma
  • esd: Enlightened Sound Daemon (EsounD) arka ucunu kullan
  • sdl: Basit DirectMedia Katman (SDL) ses arka ucunu kullan (ses girişi yok) desteklenir)
  • oss:: Açık Ses Sistemi (OSS) arka ucunu kullanma
  • none:: Sesi destekleme
set QEMU_AUDIO_DRV=alsa

Ayrıca, aşağıdakilerden birini seçerek ses girişi ve ses çıkışları için ayrı arka uçlar da kullanabilirsiniz: QEMU_AUDIO_OUT_DRV ve QEMU_AUDIO_IN_DRV için QEMU değerleri ortam değişkenleri:

set QEMU_AUDIO_OUT=esd
set QEMU_AUDIO_IN=oss

Ses desteğini devre dışı bırakmak için emulator -no-audio seçeneğini kullanın veya QEMU_AUDIO_DRV öğesini none olarak ayarla. Aşağıdaki durumlarda sesi devre dışı bırakmanız gerekebilir:

  • Nadiren de olsa ses sürücüleri, emülatör çalışırken Windows'un yeniden başlatılmasına neden olabilir.
  • Bazı Linux makinelerde ses desteği etkinken emülatör, başlatma sırasında takılabilir.
adb ortamı değişkenleri
ANDROID_SERIAL Bir emülatör seri numarası sağlamak için bu değişkeni kullanın. Örneğin: biçiminde bir adb komutuna dönüştürebilirsiniz. Bu değişkeni ayarlayıp -s kullanırsanız komut satırından bir seri numarası belirtme seçeneği sunulursa komut satırı girişi, ANDROID_SERIAL içindeki değer.

Aşağıdaki örnekte ANDROID_SERIAL ve çağrılar için ayarlar adb install helloworld.apk, ardından Android uygulamasını yükler paketinden çıkış yapacaktır.

set ANDROID_SERIAL=emulator-555
adb install helloWorld.apk
adb logcat ortam değişkenleri
ANDROID_LOG_TAGS Varsayılan filtre ayarlamak için bu ortam değişkenini kullanın ifadesini içeren bir ifade kullanabilirsiniz.logcat Örnek:
set ANDROID_LOG_TAGS=ActivityManager:I MyApp:D *:.

Bu, -logcat tags bağımsız değişkeninin komut satırından çalıştırılması gerekir.

Günlük çıkışını filtreleme başlıklı makaleyi inceleyin. daha fazla bilgi ve örnek bulabilirsiniz.

ADB_TRACE Günlüğe kaydedilecek hata ayıklama bilgilerinin virgülle ayrılmış bir listesini içerir. Değerler şunlar olabilir: all, adb, sockets, packets, rwx, usb, sync, sysdeps, transport ve jdwp.

adb istemcileri ve adb sunucusuna ilişkin adb günlüklerini görüntülemek için ADB_TRACE değerini ayarlayın. all değerine ayarlayın ve ardından aşağıdaki gibi adb logcat komutunu çağırın:

set ADB_TRACE=all
adb logcat
ANDROID_VERBOSE Ayrıntılı çıkış seçeneklerinin virgülle ayrılmış bir listesini içerir (hata ayıklama etiketleri) almanız gerekir. Aşağıdaki örnekte ANDROID_VERBOSE gösterilmektedir debug-socket ve debug-radio hata ayıklama etiketleriyle tanımlanmıştır:
set ANDROID_VERBOSE=socket,radio

Bu, -verbose -verbose-socket -verbose-radio belirtmekle aynıdır bağımsız değişkenlerin birlikte çalıştırılmasına olanak tanır.

Desteklenmeyen hata ayıklama etiketleri yoksayılır. Daha fazla hata ayıklama etiketleri hakkında bilgi için emulator -help-debug-tags kullanın.