Interfejs wiersza poleceń Androida to interfejs wiersza poleceń, który umożliwia wydajniejsze tworzenie aplikacji na Androida przy użyciu dowolnego narzędzia. Ujednolica podstawowe kompetencje programistyczne w zakresie przepływów pracy opartych na agentach, zapewniając dostęp do oficjalnych narzędzi, umiejętności i wiedzy, które są potrzebne do skuteczniejszego tworzenia aplikacji. Może też usprawnić CI, konserwację i inne skryptowe automatyzacje w coraz bardziej rozproszonym środowisku programowania aplikacji na Androida.
Interfejs wiersza poleceń Androida obejmuje cały cykl tworzenia aplikacji – od utworzenia projektu i przetestowania go na urządzeniu po profilowanie wydajności i badanie zachowania w praktyce. Na przykład agent lub skrypt może używać interfejsu wiersza poleceń do wykonywania takich zadań jak:
- Zautomatyzuj konfigurację środowiska i pakietu Android SDK.
- tworzyć nowe projekty na podstawie szablonów,
- Skompiluj, zainstaluj i uruchom aplikację na połączonym urządzeniu lub emulatorze.
- Zarządzaj urządzeniami wirtualnymi, wyświetlaj i kontroluj połączone urządzenia w oknie na pulpicie oraz sprawdzaj i wchodź w interakcje z ekranami urządzeń i hierarchiami interfejsu bezpośrednio z terminala.
- Renderuj podglądy Jetpack Compose do obrazów na komputerze bez konieczności używania urządzenia czy Android Studio.
- Łączenie z uruchomionymi instancjami Android Studio na potrzeby semantycznej analizy kodu, renderowania podglądu Compose i wyszukiwania wersji zależności.
- Testowanie aplikacji za pomocą serii czynności
- Profiluj aplikację, rejestrując śledzenie systemu i zrzuty stosu na połączonym urządzeniu lub emulatorze.
- analizować pliki APK, pakiety aplikacji i biblioteki, aby raportować ich rozmiary, dane dotyczące zmniejszania i optymalizacji R8 oraz ostrzeżenia dotyczące reguł zachowywania;
- Analizuj awarie, błędy ANR i niekrytyczne problemy, które Firebase Crashlytics zgłasza w przypadku Twojej aplikacji w terenie, w tym zrzuty stosu, które Crashlytics zbiera w przypadku awarii związanych z brakiem pamięci.
Interfejs wiersza poleceń Androida zapewnia też agentom dostęp do umiejętności Androida i specjalistycznej bazy wiedzy o Androidzie, dzięki czemu Twoje projekty będą stosować zalecane wzorce i sprawdzone metody dotyczące 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:
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 komputerze, uruchom polecenie which android lub command -v android. Jeśli zwróci ścieżkę, oznacza to, że jest zainstalowany.
Konfiguracja dla agentów
Aby pomóc agentom zrozumieć i używać interfejsu wiersza poleceń Androida, uruchom android init, aby zainstalować umiejętność android-cli.
Umiejętności związane z Androidem
Wyświetl na GitHubieInterfejs wiersza poleceń Androida
android initZebrane dane
Interfejs wiersza poleceń Androida zbiera dane o podstawowym korzystaniu z narzędzia. Oto dane, które zbieramy:
- Wywołania polecenia
androidi podpoleceń, na przykładandroid runiandroid create. - Nazwy użytych argumentów lub opcji niepozycyjnych, na przykład
--sdklub--version. - Argumenty pozycyjne i wartości flag, które są mapowane na stały, wstępnie zdefiniowany zestaw opcji systemowych zarządzanych przez interfejs wiersza poleceń Androida. Zbieramy na przykład nazwy szablonów emulatorów, takie jak
medium_phoneilarge_desktop, oraz nazwy agentów, takie jakGEMINI,CLAUDElubCODEX. - Zrzuty 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ń po uruchomieniu polecenia.
- 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, ścieżki plików lokalnych czy niestandardowe nazwy projektów. Jeśli na przykład zostanie wykonane polecenie
android create --name=com.company.internal.app, zarejestrujemy, że polecenieandroid createzostało wykonane z argumentem--name, ale nie zapiszemy wartościcom.company.internal.app.
Aby wyłączyć zbieranie danych, użyj flagi --no-metrics podczas uruchamiania polecenia za pomocą interfejsu wiersza poleceń Androida.
Opinie i problemy
Jeśli napotkasz jakieś problemy lub chcesz podzielić się opinią, zgłoś błąd.
Konfigurowanie interfejsu wiersza poleceń Androida
Utwórz plik .androidrc, aby automatycznie stosować flagi i opcje przy każdym wywołaniu interfejsu wiersza poleceń Androida. Zapisz plik w jednej z tych lokalizacji, w zależności od systemu operacyjnego:
- macOS i Linux:
~/.androidrc - Windows:
%USERPROFILE%\.androidrc
Dodaj flagi, które chcesz automatycznie stosować 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
Wykorzystanie: android <command> -h
Opis: wyświetla instrukcję pomocy dotyczącą narzędzia lub konkretnego polecenia.
Przykłady:
android -handroid create -h
--sdk
Wykorzystanie: android --sdk=<path-to-sdk> <command>
Opis: ścieżka do pakietu Android SDK, którego chcesz użyć w następnym poleceniu. 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 Android SDK używasz domyślnie, uruchom android info.
Przykład: android --sdk=<path/to/sdk> sdk list
-v, --verbose
Wykorzystanie: android -v <command>
Opis: włącza szczegółowe dane wyjściowe. Aby zwiększyć szczegółowość, podaj kilka opcji -v (np. -v, -vv lub -vvv).
-V, --version
Wykorzystanie: 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.