Android KSA'ya genel bakış

Android CLI, istediğiniz aracı kullanarak Android için daha verimli bir şekilde geliştirme yapmanızı sağlayan bir komut satırı arayüzüdür. Aracı öncelikli iş akışları için temel geliştirme yeterliliklerini standartlaştırır. Bu sayede, daha etkili bir şekilde geliştirme yapmak için ihtiyaç duyduğunuz resmi araçlara, becerilere ve bilgilere erişebilirsiniz. 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 ve Android SDK kurulumunu otomatikleştirme
  • Şablonlardan yeni projeler oluşturma
  • Sanal cihazları yönetme, APK'ları yükleme ve canlı cihaz ekranlarını ile kullanıcı arayüzü hiyerarşilerini doğrudan terminalinizden inceleme
  • Semantik kod analizi, Compose önizleme oluşturma ve bağımlılık sürümü aramaları için çalışan Android Studio örneklerine bağlanma
  • Uygulamanızı Arama Yolculukları ile test etme

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

Android CLI komutları ve seçeneklerinin tam açıklaması için Android CLI komut referansına bakın.

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 CLI'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 ayarlama

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

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 (örneğin, android run ve android create) çağrılması.
  • Konumla ilgili olmayan bağımsız değişkenlerin veya seçeneklerin adları (ör. --sdk veya --version).
  • Android KSA tarafından yönetilen sabit ve önceden tanımlanmış bir sistem seçenekleri kümesiyle 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 ilişkin bazı örnekleri aşağıda bulabilirsiniz:

  • 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 aktarılan 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.

Veri toplamayı devre dışı bırakmak için Android CLI ile komut çalıştırırken --no-metrics işaretini kullanın.

Geri bildirim ve sorunlar

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

Bilinen sorunlar

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

Android CLI'yı yapılandırma

Android KSA'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 KSA'nın her seferinde varsayılan olarak belirli bir Android SDK'sını kullanmasını sağlamak için dosyanıza --sdk işaretini ekleyin:

--sdk=<path-to-sdk>

Genel seçenekler

Bunlar, diğer Android KSA 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

-v, --verbose

Kullanım: android -v <command>

Açıklama: Ayrıntılı çıkışı etkinleştirin. Ayrıntı düzeyini artırmak için birden fazla -v seçeneği belirtin (örneğin, -v, -vv veya -vvv).

-V, --version

Kullanım: android -V

Açıklama: Sürüm bilgilerini yazdırır ve çıkar.

Komutlar

Android CLI komutları ve seçeneklerinin tam açıklaması için Android CLI komut referansına bakın.