Androidアプリ開発といえばAndroid Studioが一般的だが、IDEはかなり重い。
今回、独自Felicaカードの残高を読み取るだけのアプリを作りたいと考えたが、重たいIDEをインストールしたくない。
単純なアプリや実験用途であれば、Android Studioを使わずにCLIベースの軽量環境で開発することもできる。

この記事では

  • VS Code
  • Android SDK Command-line Tools
  • Gradle

を使った最小構成のAndroid開発環境を構築する。

開発環境

  • macOS
  • VS Code
  • JDK
  • Android SDK Command-line Tools
  • Gradle

Javaのインストール

AndroidビルドにはJavaが必要なので、 Temurin をインストールする。

自分のPCにはすでにTemurinを入れていた。

確認:

java -version

Output:

openjdk version "25.0.2" 2026-01-20 LTS
OpenJDK Runtime Environment Temurin-25.0.2+10 (build 25.0.2+10-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.2+10 (build 25.0.2+10-LTS, mixed mode, sharing)

Android SDK Command-line Tools

Android Studioを入れず、SDKだけをインストールする。

brew install --cask android-commandlinetools

インストール先:

/opt/homebrew/share/android-commandlinetools

環境変数の設定

export ANDROID_SDK_ROOT="/opt/homebrew/share/android-commandlinetools"
export ANDROID_HOME="$ANDROID_SDK_ROOT"

export PATH="$ANDROID_SDK_ROOT/platform-tools:$PATH"
export PATH="$ANDROID_SDK_ROOT/cmdline-tools/latest/bin:$PATH"

永続化する場合は .zshrc等に追加する。

Android SDKパッケージのインストール

sdkmanager --licenses

sdkmanager \
  "platform-tools" \
  "platforms;android-34" \
  "build-tools;34.0.0"

プロジェクト設定

GradleがSDKを見つけられるように プロジェクトルートに local.properties を作る。

sdk.dir=/opt/homebrew/share/android-commandlinetools

Gradle Wrapper

Android Studio無しでビルドするため、Gradle Wrapperを生成する。 Gradleはbrewでインストールした。

brew install gradle
gradle wrapper --gradle-version 8.7

gradle wrapper

APKビルド

./gradlew :app:assembleDebug

ビルド成功後、APKは以下に出力される。

app/build/outputs/apk/debug/app-debug.apk

実機へのインストール

USBデバッグを有効にしたAndroid端末を接続する。

adb devices
adb install -r app/build/outputs/apk/debug/app-debug.apk

Android Studioを使わないメリット

この構成の利点は次の通り。

  • IDEが不要
  • メモリ消費が少ない
  • CLIで完全に自動化可能
  • CIでも同じ環境が使える

特に小規模なアプリや実験用途では、Android Studioよりも扱いやすい場合が多い。