Macでターミナルを開いてAndroidのバージョンやAPIレベルをさっと確認したくて迷っている人が多いはずです。
この記事を読むと、実際に使えるコマンドとその使い方が手に入り、バージョン名とAPIレベルの対応をすぐに参照できるようになりますので作業時間が短くなります。
| 項目 | 内容 |
|---|---|
| すぐ使えるコマンド一覧 | sdkmanagerやadbを使った実例を示しながらコマンドだけで一覧を取得する方法を解説する。 |
| バージョンとAPIの対応表 | Androidのリリース名とAPIレベルを実務で役立つ形で整理して提示する。 |
| トラブル対処のワザ | SDKパスや権限の問題など現場でよく遭遇する悩みへの具体的な対処法を紹介する。 |
コマンドを一つ覚えるだけで日常の確認作業が短くなりますので、気軽に手元のMacで試しながら読み進めてみてください。
Android博士最初は戸惑うかもしれませんが大丈夫です。ゆっくり試しながら進めれば自然に身につきますので気軽にやってみてくださいね。
MacでコマンドからAndroidのバージョンとAPIレベル一覧を確認する方法
MacのTerminalだけで、手元にあるAndroidのバージョンとAPIレベルをすばやく確認できます。sdkmanagerを使えばインストール済みのplatformsが一覧で出るので、どのAPIが揃っているかを短時間で把握できます。
ここではまず簡単にインストール済みSDKを見る方法を紹介し、そのあと利用可能な全プラットフォームを詳しく出力してCSVやMarkdownにまとめるやり方までお伝えします。初めてでも迷わないように手順とコツを添えて説明します。
- インストール済みSDKを確認する方法（sdkmanager –listを実行）
- 利用可能な全プラットフォームを取得する方法（–verboseで詳細出力）
- grepやawkでplatforms;android-XXを抽出してCSVやMarkdownに整形する方法
Android博士最初はコマンドや出力がにぎやかに見えるかもしれませんが、一つずつ試せば慣れます。落ち着いて出力を追いながら操作すると安心です。
インストール済みSDKの簡易一覧をTerminalで確認するやり方
インストール済みのSDKをざっと確認したいときは、sdkmanager –listが手軽で確実です。Android SDKのbinフォルダに移動して実行すると、installedセクションにあるplatformsだけが表示されます。
表示を見れば手元にあるAPIレベルが一目でわかるので、ビルド設定やエミュレータ選びがすばやく決められます。ネットワークは不要なのでオフライン環境でも使えます。
Terminalを開いてAndroid SDKのbinフォルダに移動してsdkmanager –listを実行する
MacのTerminalアプリを起動してください。
一般的なパスは~/Library/Android/sdk/cmdline-tools/latest/binまたは~/Library/Android/sdk/tools/binです。環境変数ANDROID_SDK_ROOTが設定されている場合はその下のbinに移動してください。
移動先でsdkmanager –listを実行するとinstalledにあるplatformsが表示されます。出力をスクロールしてplatforms行を探してください。
出力のplatforms行からplatforms;android-XXを読み取りAPIレベルとバージョン名を対応させる方法
| 項目 | 内容 |
|---|---|
| platforms;android-34の例 | API level 34, Android 14 |
| platforms;android-33の例 | API level 33, Android 13 |
| platforms;android-31の例 | API level 31, Android 12 |
利用可能な全プラットフォームとAPI番号を詳細に取得するやり方
利用可能な全プラットフォームを確認したいときは、sdkmanager –list –verboseで遠隔のパッケージ情報も合わせて取得できます。これによりインストール可能なplatformsがすべて出るので、どのAPIを追加すべきか判断しやすくなります。
出力はかなり長くなることがあるのでファイルにリダイレクトしてから確認すると見やすくなります。ネットワークが必要な点だけ注意してください。
sdkmanager –list –verboseで利用可能パッケージを出力する
sdkmanager –list –verboseを実行すると、installedとavailableの両方が詳細に表示されます。
出力が長い場合はリダイレクトしてファイルに保存すると後で検索や加工がしやすくなります。
利用可能パッケージの情報取得はネットワークを使うため、通信が不安定だと途中で切れることがあります。
grepやawkでplatforms;android-XXを抽出してAPI番号一覧のCSVやMarkdownを作る手順
出力からplatforms;android-を含む行をgrepで抜き出します。まずはファイルに保存してから作業すると安全です。
awkやsedでandroid-の後ろの番号を抽出してCSV形式に整形します。ヘッダーにapi,android_versionなどを付けると管理しやすくなります。
得られたCSVをテキストエディタやスプレッドシートで開き、Markdownテーブルに変換すると共有が簡単になります。
MacでAndroidStudioのSDKマネージャーからAPIレベルとバージョンを確認する方法
MacのAndroidStudioでSDKマネージャーからAndroidのバージョンとAPIレベルをさっと確認する方法を紹介します。AndroidStudioを開きメニューバーからPreferencesを選ぶかショートカット⌘,で設定を開きます。設定内の外観と動作→システム設定→AndroidSDKを選んでください。
表示されるSDKマネージャーでSDKPlatformsタブを選ぶと各行にAndroidバージョン名とAPIレベルの列が並びます。虫眼鏡で絞り込んだりパッケージ詳細を表示にチェックすると細かいパッケージが確認できます。プロジェクトのcompileSdkVersionと合わせておくと安心です。
SDK Platformsで特定APIの対応バージョンとAPI番号を見るやり方
SDKPlatformsタブでは左側にAndroidバージョン名が表示され隣のAPIレベル列にAPI番号が並びます。表記は「Android14(API34)」のようだったりAPIレベルが独立して表示されたり環境で違いがあります。
見つけにくいときは上部の検索でAPI番号やバージョン名を入力すると早く絞り込めます。インストール済みはチェックで確認できそのままSDKプラットフォームを追加できます。
AndroidStudioを開いてPreferencesからAndroid SDK設定画面を表示する場所を開く
DockやFinderからAndroidStudioを起動します。
メニューバーのAndroidStudio→Preferencesを選ぶかショートカット⌘,で設定を開きます。
外観と動作→システム設定→AndroidSDKを選ぶとSDK設定画面が表示されます。
SDK Platformsタブで各行のAndroidバージョン名とAPIレベルの列を直接確認する
| 項目 | 内容 |
|---|---|
| Version列 | Androidのリリース名や表記が入る列。例:Android14 |
| APILevel列 | API番号が数値で表示される列。例:34 |
| 確認のヒント | 検索で絞り込みやパッケージ詳細表示でさらに中身を確認できます |
MacでアプリのminSdkVersionとtargetSdkVersionに合うAPIレベルを決める方法
Mac上でminSdkVersionとtargetSdkVersionを決めるときは、ふたつの観点で考えるとわかりやすいです。ひとつは既存ユーザーへの広がりを優先するかどうか、もうひとつは最新APIの恩恵を受けて機能や安全性を高めるかどうかです。
実際には機能ごとの必要APIを洗い出して最小値を決める方法と、狙うAndroidバージョンの挙動変化を確認してtargetSdkVersionを合わせる方法の両方を組み合わせるのが現実的です。MacではエミュレータやLintを使って動作確認するのがおすすめです。
- 互換性重視で低いminSdkVersionを選ぶ方法。
- 新機能重視で高いtargetSdkVersionを選ぶ方法。
- 機能ごとにAPIを洗い出して両者をバランスさせる方法。
Android博士焦らなくて大丈夫です。まずは使っているAPIをリスト化してから絞ると迷いが減りますし、エミュレータで軽く動かして感覚をつかむと決めやすくなります。
互換性重視で最低APIを決めるやり方
互換性重視で最低APIを決めるときは実際のユーザー環境を参考にするのがいちばん手堅いです。アナリティクスで使われているAndroidバージョンの分布を見て、サポートしたい割合を決めてください。
次にアプリで使っているAPIを洗い出して、それぞれの最小必要APIを確認します。互換ライブラリでカバーできるかどうか、エミュレータや古い端末で動かして問題ないかを確認してからminSdkVersionを決めると安心です。
アプリが使う機能ごとに必要なAPIレベルを洗い出して最小のminSdkVersionを決める
画面やバックグラウンド処理などアプリの機能をすべて書き出して、どのAPIを使うかを整理します。
Android DevelopersのドキュメントやLintの出力から、各APIがいつ追加されたかを確認します。
機能で必要なAPIレベルの最大値をminSdkVersionに設定して、エミュレータで低APIを中心に動作確認します。
新機能重視でtargetSdkを決めるやり方
新機能重視でtargetSdkVersionを上げるときは、そのAPIの挙動変化がもたらす利点を優先して考えてください。パーミッションやプライバシー周りの強化はアップデートで恩恵を受けやすいです。
一方で挙動変更による影響を受ける箇所は事前にリストアップして対応コードを用意します。MacのエミュレータでターゲットAPIを設定して動かし、問題が出たら段階的に修正していくのが現実的な進め方です。
対象にしたいAndroidバージョンのAPI差分（挙動変更や制限）を確認してtargetSdkVersionを設定する
| 項目 | 内容 |
|---|---|
| 確認先 | Android DevelopersのBehavior changesとAPI diffを参照します。リリースノートに実例が載っています。 |
| 注意すべき変更例 | バックグラウンド制限やストレージ挙動の変更、権限付与の細かいルールがよく問題になります。 |
| テスト方法 | Mac上のAVDで該当APIレベルを実機と同様に起動し、ログや動作をチェックして挙動差を確認します。 |
よくある質問
- AndroidのバージョンとAPIレベルの対応表はどこで見られますか
公式の対応表はAndroid Developersの「APIレベル」ページで確認できます。手元でさっと見たいときはAndroid StudioのSDK ManagerでもプラットフォームごとのAPIレベルが一覧で出ますし、開発環境ごとに参照先を持っておくと安心です。
- Macのターミナルでインストール済みのSDKや利用可能なプラットフォーム一覧を手早く出すコマンドはありますか
SDKが正しくインストールされていればtools/binにあるsdkmanagerを使ってsdkmanager –listで確認できます。接続中の実機のAPIレベルを知りたいときはadb shell getprop ro.build.version.sdkで数字をすぐ確認できます。
- SDKの場所やPATHまわりでよくあるつまずきとその直し方は何ですか
Macでは標準で/Users/ユーザー名/Library/Android/sdkに入ることが多いので、ANDROID_HOMEやPATHにtools/binとplatform-toolsを追加すると安定します。sdkmanagerが見つからないときはパスを確認してからsdkmanager –licensesでライセンスを受け入えるとコマンドが使えるようになります。
- compileSdkVersionやtargetSdkVersionはどの値にすればいいですか
原則としてcompileSdkVersionは最新の安定版に合わせると新APIが使えて便利です。targetSdkVersionは実機テストが終わってから最新に上げるのが安全で、minSdkVersionはサポートしたい最低端末に合わせて決めると良いです。
まとめ
MacのコマンドからAndroidのバージョンやAPIレベルを手早く確認する方法をまとめました。代表的な手順はAndroidSDKのsdkmanagerでパッケージ一覧を確認する方法と、adbで接続中の端末からAndroidバージョンを直接取得する方法です。環境変数PATHが正しく通っているか最初にチェックすると安心です。
日常的な流れとしては、まずsdkmanagerで利用可能なAPIを把握し、実機やエミュレータはadbで確認すると効率が良いです。ツールは定期的にアップデートしておくと予期せぬ表示の違いを減らせます。よく使うコマンドはシェルスクリプトにまとめておくと作業が速くなります。
Android博士慌てなくて大丈夫です。最初はコマンドの出力が多くて戸惑うかもしれませんが、何度か使えば自然に見分けられるようになります。
注意点として、AndroidSDKのパスが通っていないとコマンドが見つからないエラーになります。古いSDKや端末では表示形式が異なることがあるので、バージョンをよく確認してください。