Przegląd interfejsu wiersza poleceń Androida

Interfejs wiersza poleceń Androida to interfejs wiersza poleceń, który umożliwia wydajniejsze tworzenie aplikacji na Androida za pomocą dowolnego narzędzia. Ujednolica podstawowe kompetencje programistyczne w przypadku przepływów pracy opartych na agentach, zapewniając punkt wyjścia do oficjalnych narzędzi, umiejętności i wiedzy potrzebnych do skuteczniejszego programowania. Może też usprawnić CI, konserwację i inne skryptowe automatyzacje w coraz bardziej rozproszonym środowisku programowania na Androida.

Na przykład agent lub skrypt może używać interfejsu wiersza poleceń do wykonywania takich zadań jak:

  • Automatyzacja konfiguracji środowiska i pakietu SDK Androida
  • Tworzenie nowych projektów na podstawie szablonów
  • Zarządzaj urządzeniami wirtualnymi, instaluj pliki APK i sprawdzaj ekrany urządzeń na żywo oraz hierarchie interfejsu bezpośrednio z terminala.
  • łączenie się z uruchomionymi instancjami Android Studio w celu przeprowadzenia semantycznej analizy kodu, renderowania podglądu kompozycji i wyszukiwania wersji zależności;
  • Testowanie aplikacji za pomocą serii czynności

Interfejs wiersza poleceń Androida zapewnia też agentom dostęp do umiejętności Androida i specjalistycznej bazy wiedzy o Androidzie, co pomaga zapewnić, że w Twoich projektach są stosowane wzorce i sprawdzone metody zalecane przez Androida.

Pełny opis poleceń i opcji interfejsu wiersza poleceń Androida znajdziesz w dokumentacji poleceń interfejsu wiersza poleceń Androida.

Instalowanie interfejsu wiersza poleceń Androida

Aby zainstalować interfejs wiersza poleceń Androida, wykonaj te czynności:

  1. Pobierz interfejs wiersza poleceń Androida

  2. Aby mieć pewność, że używasz najnowszej wersji, zaktualizuj interfejs wiersza poleceń Androida:

    android update

Aby sprawdzić, czy interfejs wiersza poleceń Androida jest już zainstalowany na Twoim komputerze, uruchom polecenie which android lub command -v android: jeśli zwróci ścieżkę, oznacza to, że jest zainstalowany.

Konfigurowanie dla agentów

Aby pomóc agentom w zrozumieniu i korzystaniu z interfejsu wiersza poleceń Androida, uruchom polecenie android init, aby zainstalować android-cli.

Zebrane dane

Interfejs wiersza poleceń Androida zbiera dane o podstawowym korzystaniu z narzędzia. Oto dane, które zbieramy:

  • Wywołania polecenia android i jego poleceń podrzędnych, np. android run i android create.
  • Nazwy argumentów lub opcji niepozycyjnych, np. --sdk lub --version.
  • Argumenty pozycyjne i wartości flag, które są mapowane na stały, predefiniowany zestaw opcji systemowych zarządzanych przez interfejs wiersza poleceń Androida. Zbieramy na przykład nazwy szablonów emulatora, takie jak medium_phone i large_desktop, oraz nazwy agentów, takie jak GEMINI, CLAUDE i CODEX.
  • ślady stosu i komunikaty o wyjątkach, w których informacje umożliwiające identyfikację są anonimizowane przed zebraniem, aby zapewnić prywatność;

Oto kilka przykładów danych, których nie zbieramy:

  • Nie zbieramy odpowiedzi interfejsu wiersza poleceń, gdy polecenie jest uruchamiane.
  • Nie zbieramy danych wejściowych utworzonych przez użytkownika ani zewnętrznych identyfikatorów przekazywanych do interfejsu wiersza poleceń, takich jak konkretne współrzędne Maven, lokalne ścieżki do plików czy niestandardowe nazwy projektów. Jeśli na przykład zostanie wykonane polecenie android create --name=com.company.internal.app, zarejestrujemy, że polecenie android create zostało wykonane z argumentem --name, ale nie będziemy przechowywać wartości com.company.internal.app.

Aby wyłączyć zbieranie danych, podczas uruchamiania polecenia w interfejsie wiersza poleceń Androida użyj flagi --no-metrics.

Opinie i problemy

Jeśli napotkasz jakieś problemy lub chcesz przesłać opinię, zgłoś błąd.

Znane problemy

  • Polecenie android emulator w systemie Windows jest obecnie wyłączone.
  • Pobieranie interfejsu wiersza poleceń Androida z Windows PowerShell nie jest obecnie obsługiwane.

Konfigurowanie interfejsu wiersza poleceń Androida

Utwórz plik .androidrc, aby automatycznie stosować flagi i opcje za każdym razem, gdy wywołujesz interfejs wiersza poleceń Androida. Zapisz plik w tej lokalizacji, w zależności od systemu operacyjnego:

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

Dodaj flagi, które chcesz automatycznie zastosować do pliku (po jednej w wierszu).

Jeśli na przykład chcesz, aby interfejs wiersza poleceń Androida domyślnie używał określonego pakietu Android SDK, dodaj do pliku flagę --sdk:

--sdk=<path-to-sdk>

Opcje globalne

Są to opcjonalne flagi, których możesz używać z innymi poleceniami interfejsu wiersza poleceń Androida.

-h, --help

Użycie: android <command> -h

Opis: wyświetla instrukcję obsługi narzędzia lub konkretnego polecenia.

Przykłady:

  • android -h
  • android create -h

--sdk

Użycie: android --sdk=<path-to-sdk> <command>

Opis: ścieżka do pakietu Android SDK, którego chcesz użyć w przypadku następującego polecenia. Możesz użyć ustawienia --sdk, aby tymczasowo zastąpić domyślny pakiet Android SDK zamiast zmieniać globalne zmienne środowiskowe za każdym razem, gdy chcesz się przełączyć. Aby sprawdzić, którego pakietu SDK na Androida używasz domyślnie, uruchom polecenie android info.

Przykład: android --sdk=<path/to/sdk> sdk list

-v, --verbose

Użycie: android -v <command>

Opis: włącza szczegółowe dane wyjściowe. Określ wiele opcji -v, aby zwiększyć szczegółowość (np. -v, -vv lub -vvv).

-V, --version

Użycie: android -V

Opis: wyświetla informacje o wersji i kończy działanie.

Polecenia

Pełny opis poleceń i opcji interfejsu wiersza poleceń Androida znajdziesz w dokumentacji poleceń interfejsu wiersza poleceń Androida.