Android KSA, istediğiniz aracı kullanarak Android için daha verimli bir şekilde uygulama geliştirmenize olanak tanıyan bir komut satırı arayüzüdür. Temsilci öncelikli iş akışları için temel geliştirme yetkinliklerini standartlaştırarak daha etkili bir şekilde geliştirme yapmak için ihtiyaç duyduğunuz resmi araçlara, becerilere ve bilgilere erişim sağlar. Ayrıca, Android geliştiriciliğinin giderek daha fazla dağıtılan yapısı için CI, bakım ve diğer komut dosyası tabanlı otomasyonları kolaylaştırabilir.
Android KSA, proje oluşturma ve cihazda test etmeden performans profili oluşturmaya ve sahada nasıl davrandığını incelemeye kadar tüm geliştirme yaşam döngüsünü kapsar. Örneğin, bir temsilci veya komut dosyası, CLI'yı kullanarak aşağıdaki gibi görevleri gerçekleştirebilir:
- Ortamı ve Android SDK kurulumunu otomatik hale getirme
- Şablonlardan yeni projeler oluşturma
- Uygulamanızı bağlı bir cihazda veya emülatörde derleyin, yükleyin ve çalıştırın.
- Sanal cihazları yönetin, bağlı cihazları masaüstü penceresinde yansıtıp kontrol edin ve doğrudan terminalinizden canlı cihaz ekranlarını ve kullanıcı arayüzü hiyerarşilerini inceleyip bunlarla etkileşim kurun.
- Cihaz veya Android Studio gerekmeden makinenizdeki resimlere Jetpack Compose önizlemelerini oluşturun.
- Anlamsal 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ı Yolculuklar ile test etme
- Bağlı bir cihazda veya emülatörde sistem izlerini kaydedip yığın dökümlerini yakalayarak uygulamanızın profilini oluşturun.
- APK'ları, uygulama paketlerini ve kitaplıkları analiz ederek boyutlarını, R8 küçültme ve optimizasyon metriklerini ve saklama kuralı uyarılarını raporlama
- Firebase Crashlytics'in uygulamanız için sahada bildirdiği kilitlenmeleri, ANR'leri ve önemli olmayan sorunları (Crashlytics'in yetersiz bellek kilitlenmeleriyle ilgili topladığı yığın dökümleri dahil) inceleyin.
Android KSA, temsilcilerinizin Android becerilerine ve özel Android Bilgi Bankası'na erişmesini de sağlar. Böylece projelerinizde Android tarafından önerilen kalıpların ve en iyi uygulamaların kullanıldığından emin olabilirsiniz.
Android KSA komutlarının ve seçeneklerinin tam açıklaması için Android KSA komut referansı sayfasına bakın.
Android KSA'yı yükleme
Android KSA'yı yüklemek için aşağıdaki adımları uygulayın:
En yeni sürümü kullandığınızdan emin olmak için Android KSA'yı güncelleyin:
android update
Android KSA'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 yüklü demektir.
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.
Android becerileri
GitHub'da gösterAndroid KSA
android initToplanan veriler
Android KSA, aracın temel kullanımıyla ilgili verileri toplar. Topladığımız veriler şunlardır:
androidkomutunun ve alt komutlarının (ör.android runveandroid create) çağrıları.- Kullanılan konumsal olmayan bağımsız değişkenlerin veya seçeneklerin adları (ör.
--sdkveya--version). - Android KSA tarafından yönetilen sabit, ö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_phonevelarge_desktopgibi emülatör şablonu adlarını veGEMINI,CLAUDEveyaCODEXgibi temsilci adlarını toplarız. - Gizliliğin korunmasına yardımcı olmak için, toplanmadan önce kişisel verilerin anonimleştirildiği yığın izlemeleri ve istisna mesajları.
Toplamadığımız verilere dair bazı örnekler:
- Bir komut çalıştırıldığında CLI'nin 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.appkomutu yürütülürseandroid createkomutunun--namebağımsız değişkeni kullanılarak yürütüldüğünü kaydederiz ancakcom.company.internal.appdeğerini saklamayız.
Veri toplamayı devre dışı bırakmak için Android KSA ile bir komut çalıştırırken --no-metrics işaretini kullanın.
Geri bildirim ve sorunlar
Herhangi bir sorunla karşılaşırsanız veya geri bildirim göndermek isterseniz hata bildirin.
Android KSA'yı yapılandırma
Android KSA'yı her çağırdığınızda işaretleri ve seçenekleri otomatik olarak uygulamak için bir .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 zaman 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 belirli bir komut için yardım kılavuzunu gösterir.
Örnekler:
android -handroid 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 genel ortam değişkenlerinizi değiştirmek yerine, varsayılan Android SDK'yı geçici olarak geçersiz kılmak için --sdk ayarını kullanabilirsiniz. Varsayılan olarak hangi Android SDK'yı 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ştirir. 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ıp çıkın.
Komutlar
Android KSA komutlarının ve seçeneklerinin tam açıklaması için Android KSA komut referansı sayfasına bakın.