MacにAndroid端末をつないでOSのバージョンを確認したいけれど手順が分からず戸惑っている方は多いです。
この記事を読むとUSB接続で端末を認識させてADB（Androidデバイスを操作する公式ツール）で確実にOSバージョンを取得する実践的な手順が段階的に学べます。さらに接続トラブルへの対処法や複数端末の扱い方まで役立つ情報がそろっています。
| 項目 | 内容 |
|---|---|
| 独自コンテンツ1 | 実機で検証した手順を初心者にも分かりやすく順を追って提示します。 |
| 独自コンテンツ2 | ADBコマンドの使いどころとよくあるつまずきの回避方法を実体験ベースで解説します。 |
| 独自コンテンツ3 | 複数端末を同時に扱う場合やMac特有の接続トラブルへの具体的な対処法を紹介します。 |
まずは簡単な接続確認から順に進めれば短時間でOSバージョンが確認できるようになりますので気軽に読み進めてください。
Android博士最初は戸惑うかもしれませんが一つずつ確かめながら進めれば必ずできるようになります、困ったら慌てず手順に戻ってゆっくり確認してください。
Macで接続したAndroid端末のOSバージョンを確認する方法
MacでAndroid端末のOSバージョンを確認する手順を、やさしくお伝えします。USB接続やWi‑Fi接続でadbコマンドを実行するだけで各端末のAndroidバージョンとAPIレベルがわかります。
実際には端末でUSBデバッグを有効にしてからMacのターミナルでadbを使います。シリアルを確認してからgetpropで必要なプロパティを抜き出すだけなので作業はシンプルです。
複数端末やWi‑Fi接続でも一括で収集できるので自動化が効きます。ここでは初心者でも迷わないように実際に使えるコマンド例と注意点を紹介します。
Android博士まずは落ち着いて一つずつ進めてみましょう。小さなコマンド一つで端末情報が見られるので楽しいですよ。
USB接続した端末でバージョンとAPIレベルを取得する手順
USB接続で端末のバージョンを取得する流れはかんたんです。端末側でデベロッパーオプションのUSBデバッグをオンにしてからMacと接続してください。
ターミナルで接続を確認してシリアルを控えたら、そのシリアルを指定してgetpropでバージョンとAPIレベルを取ります。実行するコマンドは次のようになります。
adb devices;adb -s shell getprop ro.build.version.release ro.build.version.sdk Macのターミナルでadb devicesでシリアルを確認しadb -s shell getprop ro.build.version.release ro.build.version.sdkで取得する
Macのターミナルでadb devicesを実行して接続中の端末一覧を確認します。出力の1列目がシリアルなので必要なものを控えてください。
adb -s
Wi‑Fiや複数端末で一括してバージョンを一覧化する手順
同じネットワーク上であればWi‑Fi経由で端末に接続できます。端末でadb tcpip 5555を実行してからMacでadb connect <端末IP>:5555を使うとワイヤレスで操作できます。
複数端末がある場合は各端末のIPを集めて順番に接続するかローカルで一括処理するスクリプトを使うと楽です。最後にgetpropで抜き取ってCSVにまとめるのがおすすめです。
adb devicesの出力をforループで回して各端末にadb -s shell getpropを実行しCSVに保存するワンライナー例
for d in $(adb devices|awk ’NR>1{print $1}’);do adb -s $d shell getprop ro.build.version.release ro.build.version.sdk|tr ’\n’ ’,’;echo ”,$d”;done>android_versions.csv
MacでエミュレータやSDKのインストール済みAndroidバージョンを一覧で確認する方法
エミュレータやSDKにどのAndroidバージョンが入っているか迷ったときは安心してください。GUIでもターミナルでもさくっと一覧を確認できる方法があるので順番に見ていきましょう。
- AndroidStudioのSDKManagerでインストール済みプラットフォームを確認する。
- ターミナルのsdkmanagerやavdmanagerで利用可能イメージや作成済みAVDを確認する。
- 実機をADBで接続して端末側のOSバージョンを確認する。
Android博士最初は情報が散らばって見えるかもしれませんが順に見ればすぐ慣れます。迷ったらこの順で確認すると手早く終わります。
Android StudioのSDK Managerでインストール済みプラットフォームを見る手順
AndroidStudioにはSDKManagerが組み込まれていてインストール済みのプラットフォーム一覧を視覚的に確認できます。GUIなので一覧の見落としが起きにくく初心者にもやさしい方法です。
メニューからPreferencesを開いてください。環境によってはSettingsという表記の場合があります。
AndroidSDKの項目を選びSDKManagerを表示します。ここでSDKPlatformsのタブを見てインストール済みのAPIレベルと付随パッケージを確認できます。
Android StudioのPreferencesからAndroid SDK→SDK Platformsタブを開きインストール済みAPIとパッケージを確認する
AndroidStudioのメニューからPreferencesを選んでください。
左のリストでAndroidSDKを選択してからSDKPlatformsタブをクリックしてください。
各APIレベルのチェックやInstalled列でインストール状況と関連パッケージの有無を確認できます。
ターミナルでsdkmanagerやavdmanagerから利用可能なイメージを確認する手順
ターミナルからだとsdkmanagerやavdmanagerで一気に一覧を取得できます。パスが通っていれば短いコマンドでインストール済みパッケージや作成済みAVDを確認できるのでスクリプト化にも向いています。
sdkmanager --list
avdmanager list avdターミナルで sdkmanager –list と avdmanager list avd を実行して利用可能／作成済みのシステムイメージやAVD名を確認する
| 項目 | 内容 |
|---|---|
| sdkmanager –list | インストール済みと利用可能なパッケージ全体が表示されシステムイメージを含めて確認できる。 |
| avdmanager list avd | 作成済みAVDの名前と構成が一覧で表示され起動候補を把握できる。 |
| 実行場所 | AndroidSDKのcmdline-toolsかtoolsがインストールされている環境のターミナルで実行する。 |
MacでAndroidバージョンの数字・API・コードネーム対応表を手早く作る方法
Macで手早くAndroidのバージョン対応表を作るなら、シンプルなCSVにまとめるのがいちばん扱いやすいです。実機からはadbで取得できる情報を組み合わせて、バージョン番号(API)とコードネームを横並びにしておくと見つけやすくなります。
エンジニア視点のコツとしては、列を統一してファイル名に更新日を入れておくことです。自動化したければadbでro.build.version.releaseとro.build.version.sdkを取ってCSVに追記する小さなシェルを用意すると日々の管理が楽になります。
- テキストで手作業のCSVを作る方法。
- adbで端末情報を取得してスクリプトでCSVに追加する方法。
- スプレッドシートで共同編集しつつCSVでエクスポートする方法。
代表的なバージョンをCSVで作る手順
代表的なバージョンをCSVで作るときは、まずヘッダを決めます。たとえばversion,api,codenameのようにしておくと後で見返したときに分かりやすいです。
次に代表行を入れます。例として13,33,Tiramisuや12,31,SnowConeを1行ずつ並べて、UTF-8で保存すれば汎用性が高く使えます。
テキストエディタでヘッダにバージョン,API,コードネームを作り代表行を追加して保存する（例 13,33,Tiramisu 12,31,SnowCone）
任意のテキストエディタで新規ファイルを作成します。ファイル名はandroid_versions.csvなどにすると分かりやすいです。
一行目にversion,api,codenameと書き、続けて13,33,Tiramisuと12,31,SnowConeを各行にカンマ区切りで追加します。
UTF-8で保存してスプレッドシートやCLIツールで中身を確認します。必要ならadbで端末のro.build.version.sdkを取得して照合してください。
Macで特定のAndroidバージョン向けに端末とエミュレータをフィルタして動作確認する応用
Macで特定のAndroidバージョンを狙って動作を確かめたいときは、接続済みの実機とエミュレータをバージョン別に絞り込むと効率がぐっと上がります。ここでは手元の端末と起動中のエミュレータをまとめて確認し、テスト対象だけを抽出する考え方をやさしく紹介します。
ちょっとした自動化スクリプトを用意しておくと、日々の手順が楽になります。SDKツール(adbやavdmanager)を使いこなせば、手作業で探すより早くリストが作れるようになります。
- 実機はadbで接続してro.build.version.releaseを取得する方法。簡単で確実です。
- エミュレータはavdmanagerやAndroid StudioのDevice Managerでイメージ情報を確認する方法。起動状態も合わせてチェックできます。
- 一覧をCSV化して並び替えやフィルタをかける方法。一覧化すると抜け漏れが減ります。
- よく使うバージョンをタグ付けしてスプレッドシートに落とし込む方法。チーム共有が楽になります。
バージョン別にテスト対象を抽出して手順書を作る方法
バージョン別にテスト対象を抽出するときは、まず端末一覧の取得とバージョン情報の紐付けを行います。実機とエミュレータの両方を同じフォーマットで出力しておくと後工程で楽になります。
抽出後は古い順や特定バージョンだけをフィルタしてテスト項目を割り当てます。優先度はサポート方針と利用率を参考にして、代表的な機種を優先的に含めると実戦的なテストリストが作れます。
adbで各端末のバージョンを取得してCSV化し古い順や指定バージョンでフィルタしてテストリストを作る具体的なコマンド例
adb devicesで接続端末一覧を得てから、各シリアルに対してadb -s SERIAL shell getprop ro.build.version.releaseを実行してシリアル,バージョンの行を作ります。
作ったシリアル,バージョンのファイルをsort -t, -k2Vでバージョン順にしておくと古い順や新しい順で簡単に並べ替えできます。
grep ‘,9$’やawkで特定のバージョンだけ抽出して別ファイルに保存します。抽出結果をスプレッドシートに貼れば共有用のテストリスト完成です。
よくある質問
- Macで接続したAndroid端末のOSバージョンはどうやって確認する。
端末の画面で設定→端末情報を見るのがいちばん手早い方法です。ターミナルを使うならAndroidプラットフォームツールを入れてadbを使い端末のshellでgetpropのro.build.version.releaseやro.build.version.sdkを確認します。両方覚えておくとトラブル対応が楽になります。
- adbで端末が認識されません。どうすればよいですか。
まず端末でUSBデバッグを有効化し画面のロックを解除した状態で接続してみてください。接続モードが充電のみになっている場合はファイル転送に切り替えるのが効果的です。それでもダメなときはケーブルやUSBポートを変えたりadbのサーバーを再起動してみてください。
- Macにadbが入っていません。簡単な導入方法はありますか。
Homebrewが入っている環境ならHomebrewでAndroidプラットフォームツールを導入すると手間が少ないです。もう一つの方法はAndroid公式サイトからplatform-toolsをダウンロードして展開する方法です。PATHの設定を忘れると使えないので注意してください。
- USB接続できない環境でもOSバージョンを調べられますか。
はい端末自体の設定画面で確認できますしスクリーンショットや設定画面を写真で送ってもらえば確認できます。端末にネット接続があればリモート管理サービスや端末メーカーのクラウド機能でバージョン情報を得られる場合もあります。
- getpropのro.build.version.releaseとro.build.version.sdkは何が違うの。
ro.build.version.releaseはユーザーに表示されるバージョン名や数字を示します。ro.build.version.sdkは内部で使うAPIレベルの数字なのでアプリ互換性を判断するときに役立ちます。セキュリティパッチはro.build.version.security_patchで確認できます。
まとめ
ここまで紹介した方法は端末内の設定画面で直接見る方法と、Mac上でadbを使って取得する方法の2つが中心です。設定画面は手軽に確認できるので初めに見ると安心で、複数台や自動で集めたいときはadbの方が便利です。
Macで正確に知りたいときはAndroidPlatformToolsを入れてUSBデバッグを有効にしてからターミナルで操作すると良いです。端末側で承認を求められたら許可して、adbではro.build.version.releaseが表示するリリース番号とro.build.version.sdkがSDK番号を教えてくれます。
接続されないときはケーブルや端末のUSBモード、AndroidFileTransferの干渉をまず疑ってください。最後にPlatformToolsは定期的に更新しておくと新しい端末でも問題が少なく、USBデバッグは使い終わったらオフにすると安全です。