Mastering Android CLI: A Complete Guide for Developers

Why Android CLI Matters

Modern software development increasingly relies on terminal tools such as Git, Docker, AI assistants, CI/CD pipelines, remote environments, and SSH sessions. Android development has lagged because many tasks still require Android Studio. Android CLI fills this gap by exposing Studio capabilities directly in the terminal, reducing context‑switching and enabling automation.

Installation and Initialization

Install the CLI from the official page (https://developer.android.com/tools/agents?hl=zh-cn). After installation, run: android init This prepares the environment and installs the Android CLI Skill that AI agents can query.

Creating an Android Project

To create a project: android create Use --dry-run to preview actions without creating files, and --list to view available project templates.

Searching Official Documentation

Search docs from the terminal, for example: android docs search "Compose Styles" The first run downloads a knowledge base, then you can fetch the document with the returned kb:// URL: android docs fetch kb://... This lets both developers and AI agents retrieve official Android documentation without opening a browser.

Managing Android Emulators

List available emulators: android emulator list Create a new emulator: android emulator create Start or stop an emulator:

android emulator start medium_phone

android emulator stop emulator-5554

These commands are script‑friendly and work in headless CI environments.

Deploying APKs Quickly

Deploy a compiled APK: android run --apks=app-debug.apk Additional options include --device to target a specific device, --activity to launch an activity, --type=SERVICE to start a service, and --apks=PARAM[,PARAM...] to install multiple split APKs in one command.

Managing the Android SDK

List SDK packages: android sdk list Install a platform and build‑tools version:

android sdk install platforms/android-34 build-tools/34.0.0

Update all packages: android sdk update Remove a package: android sdk remove Embedding these commands in scripts makes SDK setup reproducible for CI builds.

Capturing and Annotating Screenshots

Capture a device screen: android screen capture Annotate the screenshot with UI element labels: android screen capture --annotate Annotated images help AI agents understand UI layout.

Inspecting UI Hierarchy

Show the current UI hierarchy: android layout Pretty‑print the hierarchy: android layout --pretty Export it as JSON: android layout --output hierarchy.json Use cases include UI debugging, accessibility testing, automation, and providing structured UI data to AI.

Android Skills

Skills are plug‑ins that give AI agents concrete Android knowledge. List available skills: android skills list Sample output includes wear-compose-m3, navigation-3, styles, and many others.

Search for a skill: android skills find performance Install a skill or all skills:

android skills add

android skills add --all

Skills ensure AI agents use up‑to‑date APIs and follow official best practices, avoiding outdated or incorrect code suggestions.

Connecting to Android Studio

Check the Studio connection: android studio check Analyze a file for errors: android studio analyze-file Find a symbol declaration or its usages:

android studio find-declaration

android studio find-usages

Open a file in Studio, render a Compose preview, or look up dependency versions:

android studio open-file

android studio render-compose-preview

android studio version-lookup

These operations, previously manual in the IDE, can now be scripted or invoked by AI agents.

Implications for AI

Because Android CLI provides structured access to project files, emulator control, documentation, and Studio features, AI assistants can answer queries such as:

Find all usages of this Composable in the project.

Render this Compose preview.

Search the official Android documentation for Navigation Compose.

Check whether project dependencies are outdated.

This reduces the chance of AI hallucinations, supplies complete project context, and makes Android‑related answers more reliable and faster.

First Steps for New Users

Try these common commands to experience the CLI’s value:

android docs search
android emulator start
android layout
android run
android studio check
android studio find-usages
android studio render-compose-preview
android skills add

Future Outlook

Android CLI is laying the groundwork for an AI‑augmented Android development workflow. As AI becomes a regular part of developers’ toolchains, the CLI’s structured, programmatic interface will enable tighter integration between terminals, AI assistants, and Android Studio, making the command line the primary entry point for Android development.