Android KSA'ya genel bakış

Android CLI, istediğiniz aracı kullanarak Android için daha kolay ve verimli bir şekilde geliştirme yapmanızı sağlayan bir komut satırı arayüzüdür. Bu sertifika, aracı öncelikli iş akışları için temel geliştirme yeterliliklerini standartlaştırır. Daha etkili bir şekilde geliştirme yapmak için ihtiyaç duyduğunuz resmi araçlara, becerilere ve bilgilere erişebileceğiniz bir giriş noktası sağlar. Ayrıca, Android geliştirmenin giderek daha fazla dağıtılmış yapısı için CI, bakım ve diğer tüm komut dosyası oluşturma otomasyonlarını kolaylaştırabilir.

Örneğin, bir aracı veya komut dosyası, KSA'yı kullanarak aşağıdaki gibi görevleri gerçekleştirebilir:

  • Ortam kurulumunu otomatikleştirme
  • Şablonlardan yeni projeler oluşturma
  • Sanal cihazları doğrudan terminalinizden yönetme
  • Uygulamanızı Arama Yolculukları ile test etme

Android CLI, projelerinizin Android'in önerdiği kalıpları ve en iyi uygulamaları kullandığından emin olmanıza yardımcı olmak için aracılarınıza Android becerilerine ve özel Android Bilgi Bankası'na erişim de sağlar.

Android KSA'yı yükleme

Android CLI'yı yüklemek için aşağıdaki adımları uygulayın:

  1. Android KSA'yı indirin.

  2. En yeni sürümü kullandığınızdan emin olmak için Android KSA'yı güncelleyin:

    android update

Android CLI'nın makinenizde yüklü olup olmadığını kontrol etmek için which android veya command -v android komutunu çalıştırın. Bir yol döndürülürse Android CLI yüklüdür.

Temsilciler için kurulum

Temsilcilerin Android CLI'yı anlamasına ve kullanmasına yardımcı olmak için init komutunu çalıştırarak android-cli becerisini yükleyin:

android init

Toplanan veriler

Android CLI, aracın temel kullanımıyla ilgili veriler toplar. Topladığımız veriler şunlardır:

  • android komutunun ve alt komutlarının (ör. android run ve android create) çağrılması.
  • Kullanılan konumsal olmayan bağımsız değişkenlerin veya seçeneklerin adları (ör. --sdk veya --version).
  • Android CLI tarafından yönetilen sabit ve önceden tanımlanmış bir sistem seçenekleri grubuyla eşlenen konumsal bağımsız değişkenler ve işaret değerleri. Örneğin, medium_phone ve large_desktop gibi emülatör şablonu adlarını ve GEMINI, CLAUDE veya CODEX gibi aracı adlarını toplarız.
  • Gizliliği sağlamak için toplama işleminden önce kişisel verilerin anonimleştirildiği yığın izleri ve istisna mesajları.

Toplamadığımız verilere bazı örnekler:

  • Bir komut çalıştırıldığında CLI'nın yanıtlarını toplamayız.
  • Kullanıcı tarafından oluşturulan girişleri veya KSA'ya iletilen harici tanımlayıcıları (ör. belirli Maven koordinatları, yerel dosya yolları veya özel proje adları) toplamayız. Örneğin, android create --name=com.company.internal.app komutu yürütülürse android create öğesinin --name bağımsız değişkeni kullanılarak yürütüldüğünü kaydederiz ancak com.company.internal.app değerini depolamayız.

Bilinen sorunlar

  • Windows için android emulator komutu şu anda devre dışı.
  • Android KSA'nın Windows PowerShell'den indirilmesi şu anda desteklenmemektedir.

Herhangi bir sorunla karşılaşırsanız veya geri bildirimde bulunmak isterseniz lütfen hata bildirin.

Android KSA'yı yapılandırma

Android CLI'yı her çağırdığınızda işaretleri ve seçenekleri otomatik olarak uygulamak için .androidrc dosyası oluşturun. Dosyayı işletim sisteminize bağlı olarak aşağıdaki konuma kaydedin:

  • macOS ve Linux: ~/.androidrc
  • Windows: %USERPROFILE%\.androidrc

Dosyaya otomatik olarak uygulamak istediğiniz işaretleri her satıra bir tane gelecek şekilde ekleyin.

Örneğin, Android CLI'nın her seferinde varsayılan olarak belirli bir Android SDK'yı kullanmasını sağlamak için dosyanıza --sdk işaretini ekleyin:

--sdk=<path-to-sdk>

Genel seçenekler

Bunlar, diğer Android CLI komutlarıyla kullanabileceğiniz isteğe bağlı işaretlerdir.

-h, --help

Kullanım: android <command> -h

Açıklama: Söz konusu araç veya komutla ilgili yardım kılavuzunu gösterir.

Örnekler:

  • android -h
  • android create -h

--sdk

Kullanım: android --sdk=<path-to-sdk> <command>

Açıklama: Aşağıdaki komut için kullanmak istediğiniz Android SDK'sının yolu. Geçiş yapmak istediğiniz her seferde global ortam değişkenlerinizi değiştirmek yerine --sdk ayarını kullanarak varsayılan Android SDK'yı geçici olarak geçersiz kılabilirsiniz. Varsayılan olarak hangi Android SDK'sını kullandığınızı kontrol etmek için android info komutunu çalıştırın.

Örnek: android --sdk=<path/to/sdk> sdk list

Komutlar

Bu bölümde, tüm Android CLI komutları listelenir ve ne yaptıkları açıklanır. Bu komutların tümünün önüne android eklenmelidir. Örneğin android create, android run vb. İsteğe bağlı değiştiriciler köşeli parantez [] içine alınır, zorunlu bağımsız değişkenler ise alınmaz.

create

Kullanım: android create [--dry-run] [--verbose] [--name=<application-name>] [--output=<dest-path>] [<template-name>]

Açıklama: Şablondan yeni bir proje başlatın. Şablon seçeneklerini görmek için android create -h komutunu çalıştırın.

Arguments (zorunlu):

  • -o, --output - Hedef proje dizini yolu.

Seçenekler:

  • --dry-run - Herhangi bir dosyayı kaydetmeden proje oluşturma sürecinin tamamını simüle eder. Örneğin, bir şablonu kullanmaya karar vermeden önce farklı şablonların ne yaptığını görmek için deneme çalışması yapabilirsiniz.
  • --verbose: Hangi dosyaların şablondan kopyalandığı gibi bilgileri içeren ayrıntılı çıkışı etkinleştirir.
  • --name=<application-name> - Proje dizininin adı. Boş bırakılırsa çıkış dizini kullanılır.
  • <template-name>: Yeni bir proje oluşturmak için kullanılacak şablonun adı. Boş bırakılırsa empty-activity-agp-9 kullanılır.

Örnek: android create --dry-run --verbose empty-activity-agp-9

create list

Kullanım: android create list

Açıklama: Yeni bir proje oluşturmak için kullanılabilecek tüm şablonları listeleyin.

describe

Kullanım: android describe [--project_dir=<project-directory>]

Açıklama: Açıklayıcı meta veriler oluşturmak için bir Android projesini analiz eder. Bu komut, derleme hedefleri ve bunlara karşılık gelen çıkış yapısı konumları (ör. APK dosyaları) dahil olmak üzere projenin yapısını ayrıntılı olarak açıklayan JSON dosyalarının yollarını tanımlar ve çıkarır. Bu bilgiler, diğer araçların ve komutların derleme yapılarını verimli bir şekilde bulmasını sağlar.

Seçenekler:

  • --project_dir - Açıklanacak proje dizini. Boş bırakılırsa geçerli dizin kullanılır.

Örnek: android describe --project_dir=/path/to/your/project

docs

Kullanım:

  • android docs search <query>
  • android docs fetch <kb-url>

Açıklama: android docs komutu, Android Bilgi Bankası'na doğrudan KSA'dan erişmek için iki adımlı bir işlemdir. Öncelikle, search komutunu kullanarak sorgunuzla ilgili dokümanları arayın. Arama sonuçlarında kb:// ile başlayan özel URL'ler yer alır. Bu URL'leri daha sonra fetch komutuyla kullanarak doküman komutlarını terminale aktarabilirsiniz.

Örnekler:

  • android docs search 'How do I improve my app performance?'
  • android docs fetch kb://android/topic/performance/overview

emulator create

Kullanım: android emulator create [--list-profiles] [--profile=<profile-name>]

Açıklama: Sanal cihaz oluşturun.

Seçenekler:

  • --list-profiles - Cihaz oluşturmak için kullanılabilecek cihaz profillerini listeleyin.
  • --profile=<profile-name> - Belirtilen profille bir cihaz oluşturun. Bu parametre atlanırsa medium_phone profili oluşturulur.

emulator list

Kullanım: android emulator list

Açıklama: Kullanılabilir sanal cihazları listeleyin.

emulator start

Kullanım: android emulator start <device-name>

Açıklama: Belirtilen sanal cihazı başlatır.

Arguments (zorunlu):

  • <device-name>: Başlatılacak cihaz adı (ör. medium_phone). Kullanılabilir cihazları görmek için android emulator list komutunu kullanın.

Örnek: android emulator start medium_phone

emulator stop

Kullanım: android emulator stop <device-serial-number>

Açıklama: Belirtilen sanal cihazı durdurur.

Arguments (zorunlu):

  • <device-serial-number> - Durdurulacak cihazın seri numarası.

Örnek: android emulator stop emulator-5554

info

Kullanım: android info

Açıklama: Kullanılan varsayılan Android SDK'sının yolunu gösterir. Kullanılan Android SDK'yı değiştirmek için --sdk simgesini kullanın.

init

Kullanım: android init

Açıklama: android-cli becerisini yükleyerek ortamınızı aracılar için ayarlayın.

layout

Kullanım: android layout [--pretty] [--output] [--diff]

Açıklama: Etkin Android uygulamasının (fiziksel bir cihaz veya emülatör aracılığıyla bağlanmış) kullanıcı arayüzü yerleşimini JSON biçiminde döndürür.

Seçenekler:

  • -p, --pretty - JSON çıkışını girintiler ve satır sonlarıyla biçimlendirerek okunabilir hale getirir.
  • -o, --output: Düzen ağacının kaydedileceği dosya konumunu belirtir. Atlanırsa JSON doğrudan stdout'a yazdırılır.
  • -d, --diff - Tam düzen ağacı yerine, yalnızca son dahili anlık görüntü alındığından (düzenin son çalıştırıldığı zaman) beri değişen düzen öğelerinin listesini döndürür.

Örnek:: android layout --output=./hierarchy.json

run

Kullanım: android run [--debug] [--activity=<activity-name>] [--device=<serial-number>] [--type=<param>] --apks=<apk-paths>

Açıklama: Bağlı bir cihaza veya emülatöre Android uygulaması dağıtın. Herhangi bir derleme adımı gerçekleştirmez. Yüklemek istediğiniz APK dosyalarının yollarını sağlamanız gerekir.

Arguments (zorunlu):

  • --apks - Yüklemek istediğiniz APK dosyalarının virgülle ayrılmış yol listesi. Yol, dosya sisteminde bulunduğunuz konuma göre belirlenir.

Seçenekler:

  • --activity: APK yüklendikten sonra başlatılacak etkinliğin adı. Birden fazla etkinlik varsa başlangıçta başlatılacak bir etkinlik belirtmeniz gerekir.
  • --debug - Uygulamayı hata ayıklama modunda dağıtır. Uygulamayı hata ayıklama modunda çalıştırdıktan sonra hata ayıklamaya başlamak için Android Studio gibi bir IDE'den veya bir komut satırı aracından hata ayıklayıcınızı bağlamanız gerekir.
  • --device - Hedef cihazın veya emülatörün seri numarası. Yalnızca birden fazla cihaz bağlıysa gereklidir. Cihaz seri numaralarını bulmak için adb devices komutunu çalıştırın.
  • --type: Başlatılacak bileşen türü. Bir kullanıcı arayüzü etkinliği yerine doğrudan bir arka plan hizmeti başlatmak istiyorsanız bunu kullanın. Desteklenen türler:
    • ACTIVITY
    • WATCH_FACE
    • TILE
    • COMPLICATION
    • DECLARATIVE_WATCH_FACE

Örnekler:

  • android run --apks=app/build/outputs/apk/debug/app-debug.apk - Varsayılan cihaza tek bir APK dağıtır.
  • android run --apks=base.apk,density-hdpi.apk,lang-en.apk - Varsayılan cihaza birden fazla APK dağıtır.
  • android run --apks=app-debug.apk --type=SERVICE --activity=.sync.DataSyncService - Bir hizmeti etkinlik olmadan test etme.
  • android run --apks=app-debug.apk --device=emulator-5554 - APK'yı belirli bir cihaza dağıtır.

screen capture

Kullanım: android screen capture [--output] [--annotate]

Açıklama: Bağlı cihazın ekran görüntüsünü alır.

Seçenekler:

  • -o, --output: Ekran görüntüsünün kaydedileceği dosya konumunu belirtir. Atlanırsa ham PNG verileri doğrudan stdout'a yazdırılır.
  • -a, --annotate - resolve komutuyla kullanılmak üzere, resimde algılanan tüm kullanıcı arayüzü öğelerinin etrafına etiketli sınırlayıcı kutular çizer.

Örnek: android screen capture --output=ui.png

screen resolve

Kullanım: android screen resolve --screenshot=<path> --string=<string>

Açıklama: screen capture kullanılarak çekilen ve ek açıklama eklenmiş bir ekran görüntüsündeki görsel etiketleri gerçek ekran koordinatlarına (x, y) çevirir. Konumlarını manuel olarak hesaplamaya gerek kalmadan öğelerdeki tıklamaları komut dosyası oluşturmak için kullanışlıdır.

İşaretler:

  • --screenshot - Açıklama eklenmiş ekran görüntüsünün yolu.
  • --string: #<number> biçiminde bir kullanıcı arayüzü öğesi etiketine karşılık gelen en az bir yer tutucu içeren dize. #<number> kısmı, ekran koordinatlarıyla değiştirilir.

Örnek:

5 etiketi (500, 1000) koordinatlarındaysa komut

android screen resolve --screenshot=ui.png --string="input tap #5"

çıkışı döndürür

input tap 500 1000

sdk install

Kullanım: android sdk install <package[@version]> [--beta] [--canary] [--force]

Açıklama: Belirtilen SDK paketlerini yükler.

Arguments (zorunlu):

  • package[@version]: Yüklenecek paketlerin boşlukla ayrılmış listesi. Sürüm belirtilmezse kanaldaki paketin en son sürümü (varsayılan olarak kararlı kanal) yüklenir.

Seçenekler:

  • --beta - Beta paketlerini dahil edin.
  • --canary - Canary paketlerini dahil edin.
  • --force: Daha eski bir sürüme geçişi zorlar.

Örnekler:

  • android sdk install platforms/android-34 build-tools/34.0.0 - Kararlı kanaldan Android SDK Platform 34 ve SDK Built Tools 34.0.0 paketlerinin en son sürümlerini yükleyin.
  • android sdk install platforms/android-34@2 - Android SDK Platform 34 paketinin 2. sürümünü yükleyin.
  • android sdk install --canary system-images/android-35/google_apis/x86_6 - Android 35 sistem görüntüsünün en yeni sürümünü canary kanalından yükleyin.
  • android sdk install --force platforms/android-33@1 - Kararlı kanaldan Android SDK Platform 33 paketinin 1. sürümüne geri dönün.

sdk list

Kullanım: android sdk list <package-pattern>

Açıklama: Yüklü ve kullanılabilir SDK paketlerini listeleyin.

Arguments (zorunlu):

  • <package-pattern>: Paketleri desene göre filtreleyin. Normal ifadeleri destekler.

Seçenekler:

  • --all: Yüklü ve kullanılabilir tüm paketleri gösterir.
  • --all-versions: Her paketin tüm sürümlerini gösterir.
  • --beta - Beta paketlerini dahil edin.
  • --canary - Canary paketlerini dahil edin.

sdk remove

Kullanım: android sdk remove <package-name>

Açıklama: SDK'dan bir paketi kaldırma.

Arguments (zorunlu):

  • <package-name> - Kaldırılacak paketin adı.

Örnek: android sdk remove build-tools/36.1.0

sdk update

Kullanım: android sdk update [--beta] [--canary] [<package-name>]

Açıklama: Bir veya tüm paketleri kanaldaki (varsayılan olarak kararlı kanal) en son sürüme güncelleyin. Paket belirtmezseniz tüm paketler güncellenir.

Seçenekler:

  • <package-name> - Güncellenecek paketin adı.
  • --beta - Beta paketlerini dahil edin.
  • --canary - Canary paketlerini dahil edin.
  • --force: Daha eski bir sürüme geçişi zorlar.

Örnekler:

  • android sdk update - SDK'nızdaki her şey için güncellemeleri kontrol edin ve yükleyin.
  • android sdk update build-tools/34.0.0 - Android SDK Build Tools 34.0.0 paketini kararlı kanaldaki en son sürüme güncelleyin.
  • android sdk update --canary platforms/android-35 - Android SDK Platforms 35 paketini canary kanalındaki en son sürüme güncelleyin.

skills add

Android becerileri, temsilcilerin Android geliştirmeyle ilgili en iyi uygulamaları ve rehberliği takip eden belirli kalıpları daha iyi anlamasına ve uygulamasına yardımcı olmak için tasarlanmış özel talimatlardır. Daha fazla bilgi edinmek için Android becerilerine giriş başlıklı makaleyi inceleyin.

Kullanım: android skills add [--all] [--agent=<agent-name>] [--skill=<skill-name>]

Açıklama: Algılanan tüm ajanlar için beceri dizinlerine Android becerilerini yükleyin. Mevcut bir aracı dizininiz yoksa ve belirli aracıları belirtmezseniz beceriler Gemini ve Antigravity için ~/.gemini/antigravity/skills konumuna yüklenir. Android Skills zaten yüklüyse skills add, becerileri en son sürüme günceller.

Seçenekler:

  • --all - Tüm Android becerilerini aynı anda yükleyin veya güncelleyin. Atlanırsa (ve --skill belirtilmezse) yalnızca android-cli becerisi yüklenir.
  • --agent: Beceri yüklenirken veya güncellenirken kullanılacak aracıların virgülle ayrılmış listesi. Atlanırsa beceri, algılanan tüm temsilciler için yüklenir.
  • --skill - Yüklemek veya güncellemek istediğiniz beceri adı. Atlanırsa (ve --all belirtilmezse) yalnızca android-cli becerisi yüklenir veya güncellenir.

Örnek: android skills add --agent='gemini' edge-to-edge

skills find

Kullanım: android skills find <string>

Açıklama: Belirli bir dizeyle eşleşen becerileri bulur.

Arguments (zorunlu):

  • string - Beceri açıklamasıyla eşleşen dize.

Örnek: android skills find 'performance'

skills list

Kullanım: android skills list [--long]

Açıklama: Kullanılabilir becerileri listeleyin.

Seçenekler:

  • --long - Her beceri için ek bilgiler (becerinin açıklaması ve hangi aracılarda yüklü olduğu dahil) çıkışı yapın.

skills remove

Kullanım: android skills remove [--agent] --skill=<skill-name>

Açıklama: Beceriyi kaldırma. Belirli aracıları belirtmezseniz beceri tüm aracılar için kaldırılır.

Arguments (zorunlu):

  • --skill: Kaldırılacak becerinin adı.

Seçenekler:

  • --agent: Beceri özelliğinin kaldırılacağı aracıların virgülle ayrılmış listesi. Atlanırsa beceri tüm temsilciler için kaldırılır.

Örnek: android skills remove --agent='gemini' --skill=edge-to-edge

studio check

studio komutları, sizin veya yapay zeka aracınızın Android Studio'nun etkin örnekleriyle etkileşim kurmasını sağlar. Çalışan bir örneğe bağlanarak dosyaları analiz etmek, sembol bildirimlerini ve kullanımlarını bulmak, Compose önizlemelerini oluşturmak ve bağımlılık sürümlerini aramak için IDE'nin özelliklerini kullanabilirsiniz.

Kullanım: android studio check

Açıklama: Çalışan Android Studio örneklerinin durumunu kontrol eder ve açık projeleri listeler. CLI ile IDE arasındaki bağlantıyı doğrulamak ve birden fazla varsa bağlanmak istediğiniz PID ile projeyi seçmek için önce bu komutu çalıştırın.

Çıkış örneği:

Bağlantı kurulduysa çıktı, çalışan Android Studio örneğinin PID'sini, sürümünü ve açık projelerin durumunu listeler:

pid: 32942
version: Android Studio Quail
Projects:
    READY     MyApplication /Users/username/AndroidStudioProjects/MyApplication

studio analyze-file

Kullanım: android studio analyze-file [--pid=<pid>] [--project=<project>] <path>

Açıklama: IDE'nin yerleşik inceleme motorunu kullanarak Android Studio'daki bir dosyayı hatalar, uyarılar ve hata analizleri açısından inceler.

Arguments (zorunlu):

  • <path> - Analiz edilecek Kotlin veya Java dosyasının yolu.

Seçenekler:

  • --pid=<pid> - Bağlanılacak belirli Android Studio örneğinin PID'si (birden fazla örnek varsa).
  • --project=<project> - Birden fazla varsa sorgulanacak Android Studio'da açık olan projenin adı. analyze-file komutunu bir proje dizininden çalıştırırsanız varsayılan olarak bu proje kullanılır.

Örnek:

android studio analyze-file \
  --project=MyApplication \
  /Users/username/AndroidStudioProjects/MyApplication/app/src/main/java/com/example/myapp/MainActivity.kt

studio find-declaration

Kullanım: android studio find-declaration [--short] [--context-file=<path>] [--pid=<pid>] [--project=<project>] <symbol>

Açıklama: Semantik çözümlemeyi kullanarak proje genelinde bir sembolün (sınıf, yöntem, değişken, alan, sabit veya Android kaynağı) tam olarak tanımlandığı yeri bulur.

Arguments (zorunlu):

  • <symbol> - Beyanı bulunacak kod sembolünün adı.

Seçenekler:

  • --context-file=<path>: Sembole referans içeren bir dosyanın isteğe bağlı yolu. Bağlam dosyası sağlama, içe aktarmalar ve kapsam sağlayarak belirsiz veya aşırı yüklenmiş sembollerin çözülmesine yardımcı olur.
  • --short: Çıkışı yalnızca dosya konumunu ve satır eşleşmesini gösterecek şekilde basitleştirir.
  • --pid=<pid> - Bağlanılacak belirli Android Studio örneğinin PID'si (birden fazla örnek varsa).
  • --project=<project> - Birden fazla varsa sorgulanacak Android Studio'da açık olan projenin adı. find-declaration komutunu bir proje dizininden çalıştırırsanız varsayılan olarak bu proje kullanılır.

Örnek:

android studio find-declaration --short HotelDetailScreen

studio find-usages

Kullanım: android studio find-usages [--short] [--pid=<pid>] [--project=<project>] <symbol>

Açıklama: Semantik analiz kullanarak bir sembolün tüm proje genelindeki tüm referanslarını ve kullanımlarını bulur.

Arguments (zorunlu):

  • <symbol>: Kullanım alanları bulunacak sembolün adı.

Seçenekler:

  • --short: Çıkışı yalnızca eşleşen dosya konumlarını gösterecek şekilde basitleştirir.
  • --pid=<pid> - Bağlanılacak belirli Android Studio örneğinin PID'si (birden fazla örnek varsa).
  • --project=<project> - Birden fazla varsa sorgulanacak Android Studio'da açık olan projenin adı. Bu komutu bir proje dizininden çalıştırırsanız varsayılan olarak söz konusu proje kullanılır.

Örnek:

android studio find-usages --short HotelDetailScreen

studio open-file

Kullanım: android studio open-file [--pid=<pid>] [--project=<project>] <path>

Açıklama: Bir dosyayı doğrudan Android Studio'nun etkin düzenleyici penceresinde açar.

Arguments (zorunlu):

  • <path>: Açılacak dosyanın yolu. Proje kök dizinine göre veya mutlak yol olarak belirtilebilir.

Seçenekler:

  • --pid=<pid> - Bağlanılacak belirli Android Studio örneğinin PID'si (birden fazla örnek varsa).
  • --project=<project> - Birden fazla varsa sorgulanacak Android Studio'da açık olan projenin adı. open-file komutunu bir proje dizininden çalıştırırsanız varsayılan olarak bu proje kullanılır.

Örnek:

android studio open-file app/src/main/java/com/example/myapp/ui/DetailScreen.kt

studio render-compose-preview

Kullanım: android studio render-compose-preview [--print-semantics] [--output-image-file=<filename>] [--pid=<pid>] [--project=<project>] <path> <composable>

Açıklama: Bir Jetpack Compose kullanıcı arayüzü önizlemesi oluşturur ve isteğe bağlı olarak düzen anlamsal yapı ağacını döndürür. Bu özellik, görsel testler için veya yapay zeka aracıların kullanıcı arayüzü yerleşimiyle çalışmasını sağlamak için kullanışlıdır.

Arguments (zorunlu):

  • <path> - Compose önizlemesini içeren Kotlin dosyasının yolu.
  • <composable> - Composable önizleme işlevinin adı (@Preview ile işaretlenir).

Seçenekler:

  • --output-image-file=<filename>: Oluşturulan PNG resminin yazılacağı dosya adını belirtir. Atlanırsa geçici bir dosya oluşturulur.
  • --print-semantics - Doğruysa oluşturulan Compose önizlemesinin erişilebilirlik semantiği ağacını JSON biçiminde yazdırır. Bu sayede temsilciler, kullanıcı arayüzünün yapısını ve etkileşimli öğelerini ayrıştırabilir.
  • --pid=<pid> - Bağlanılacak belirli Android Studio örneğinin PID'si (birden fazla örnek varsa).
  • --project=<project> - Birden fazla varsa sorgulanacak Android Studio'da açık olan projenin adı. render-compose-preview komutunu bir proje dizininden çalıştırırsanız varsayılan olarak bu proje kullanılır.

Örnek:

android studio render-compose-preview \
  --output-image-file=preview_hotel.png \
  --print-semantics \
  app/src/main/java/com/example/myapp/ui/DetailScreen.kt \
  HotelDetailScreenPreview

studio version-lookup

Kullanım: android studio version-lookup [--pid=<pid>] [--project=<project>] <artifacts...>

Açıklama: Google Maven gibi depolarda yaygın bağımlılıkların, Android platformlarının ve SDK araçlarının mevcut en son sürümlerini arar. Bu, manuel bağımlılık sürümü kontrolüne programatik bir alternatif sunar.

Arguments (zorunlu):

  • <artifacts...>: Boşlukla ayrılmış tanımlayıcı listesi. Tek bir komutla birden fazla yapıyı sorgulayabilirsiniz. Desteklenen tanımlayıcılar şunlardır:
    • Maven kitaplıkları: groupId:artifactId gösterimi (örneğin, androidx.window:window).
    • Gradle eklentileri: Eklenti kimliği (örneğin, com.android.application).
    • Anahtar kelimeler:
      • gradle (Gradle derleme aracı)
      • studio (Android Studio)
      • agp (Android Gradle eklentisi)
      • ndk (Android NDK)
      • sdk (Android SDK)
      • emulator (Android emülatörü)
      • adb (Android Debug Bridge)
      • compose (Jetpack Compose BOM)
      • kotlin (Kotlin çalışma zamanı ve derleyici)
      • android (Android OS sürümleri)
      • platform-tools (Android SDK Platform-Tools)
      • cmdline-tools (Android SDK Command-line Tools)
      • build-tools (Android SDK Build-Tools)

Seçenekler:

  • --pid=<pid> - Bağlanılacak belirli Android Studio örneğinin PID'si (birden fazla örnek varsa).
  • --project=<project> - Birden fazla varsa sorgulanacak Android Studio'da açık olan projenin adı. version-lookup komutunu bir proje dizininden çalıştırırsanız varsayılan olarak bu proje kullanılır.

Örnek:

android studio version-lookup \
  androidx.compose.ui:ui \
  com.android.application \
  agp \
  kotlin

update

Kullanım: android update

Açıklama: Android CLI'yı güncelleyin.

-V, --version

Açıklama: Android KSA'nın mevcut sürümünü gösterir.