Contents
Android Studio のインストールと Kotlin プラグインの確認
Android 開発を始めるにあたって、まずは 公式サイトから最新版の Android Studio を入手 し、開発環境を整えることが重要です。
本セクションではダウンロードからインストール、Kotlin プラグインのバージョン確認までの流れを解説します。実際に手順通りに進めれば、すぐに Compose や KMM の学習に取り掛かれる状態になります。
公式サイトから最新版を取得する手順
- ブラウザで Android Studio の公式ページ https://developer.android.com/studio にアクセスします。
- 「Download Android Studio」ボタンをクリックし、利用規約に同意してダウンロードを開始します。
- 表示された OS（Windows / macOS / Linux）に合わせたインストーラが取得できるので、ローカル環境に保存してください。
ポイント：サードパーティのミラーサイトは常に最新である保証がないため、必ず公式ページから入手しましょう。
インストーラ実行と初回セットアップ
| OS | 実行手順 |
|---|---|
| Windows | ダウンロードした .exe を実行し、デフォルト設定で「Next」→「Install」をクリック。 |
| macOS | .dmg を開き、Android Studio.app を Applications フォルダーへドラッグ＆ドロップ。 |
| Linux | android-studio.tar.gz を任意のディレクトリに解凍し、studio.sh を実行。 |
初回起動時に表示される Setup Wizard で SDK のインストール先やエミュレータイメージを選択します。この段階が完了すれば、Android Studio は使用可能です。
Kotlin プラグインのバージョン確認
多くの Android Studio バージョンでは Kotlin が標準搭載 されていますが、プラグイン自体は別途アップデートが必要な場合があります。以下の手順で現在使用中の Kotlin バージョンを確認し、最新版に更新しましょう。
- メニュー File → Settings (macOS は Preferences) を開きます。
- 左ペインの Plugins から「Kotlin」を検索します。アップデートが利用可能な場合は Update ボタンが表示されるので実行してください。
- 更新後、Help → About Android Studio を選択し、ダイアログに表示されている Kotlin バージョン（例:
1.9.x）を確認します。
注意：公式リリースノートやプラグインページで推奨バージョンを随時チェックすると、Compose のプレビューや KMM ビルド時のエラーを未然に防げます。
プロジェクト作成と Jetpack Compose テンプレートの選択
このセクションでは Compose 用のプロジェクト雛形 を生成し、ディレクトリ構造や重要ファイルについて概観します。テンプレートを活用すれば、手動で依存関係を書き込む手間が省け、すぐに UI 実装へ移行できます。
新規プロジェクトウィザードでのテンプレート選択
Android Studio のスタート画面から New Project をクリックし、以下の流れで設定します。
- 「Phone and Tablet」カテゴリを開き、Empty Compose Activity を選択。
- プロジェクト名・パッケージ名（例:
com.example.firstapp）を入力し、Language は必ず Kotlin を指定。 - Minimum SDK は API 21 以上が推奨されますが、最新の機能を利用したい場合は API 35 (Android 13) まで上げても構いません。
これだけで build.gradle.kts に Compose 用プラグインと必須ライブラリが自動的に追加されます。
生成されたディレクトリ構造と主要ファイルの概要
プロジェクト作成後に見られる典型的なフォルダ・ファイルは次の通りです。各ファイルの役割を把握しておくと、後続の実装がスムーズになります。
app/src/main/kotlin/com/example/firstapp/MainActivity.kt-
ComponentActivityを継承し、setContent { Greeting("Android") }がエントリーポイントとなります。 -
app/src/main/kotlin/com/example/firstapp/ui/theme/Theme.kt -
Material 3 のテーマ定義とカラーセットが格納されており、アプリ全体のデザインを一元管理できます。
-
app/src/main/res/layoutは空です（Compose が XML レイアウトに代わります）。 -
build.gradle.kts（Kotlin DSL）には以下のような設定が自動追加されます。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
plugins { id("com.android.application") kotlin("android") } android { compileSdk = 35 // 必要に応じて公式サイトで最新を確認 defaultConfig { applicationId = "com.example.firstapp" minSdk = 21 targetSdk = 35 versionCode = 1 versionName = "1.0" } buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.6.0" // 最新版は公式ドキュメントで確認 } } |
Kotlin 言語基礎と Android 固有 API の概要
Kotlin は 簡潔さ・安全性 が特徴で、Android 開発の第一言語として広く採用されています。ここでは基本構文に加えて、Compose と従来の Activity の違いを簡単にまとめます。
Kotlin の基本文法（val/var、関数、クラス）
|
1 2 3 4 5 6 7 8 9 10 |
// 定数は val、変更可能な変数は var val greeting = "Hello" var counter = 0 fun add(a: Int, b: Int): Int = a + b // シングルライン関数 class Person(val name: String) { fun sayHi() = println("Hi, I am $name") } |
valは再代入不可、varは可能です。- 型推論によりコード量が削減され、可読性が向上します。
Activity と Composable 関数の違いとライフサイクル
| 項目 | Activity | Composable |
|---|---|---|
| 主な役割 | 画面全体を管理し OS からのイベントを受け取る | UI 部品（ボタン・テキスト等）を宣言的に構築 |
| ライフサイクル | onCreate → onStart → onResume … |
再コンポジション時に自動呼び出し |
| 宣言方法 | XML または setContentView() でレイアウト指定 |
@Composable fun MyScreen(){ … } |
Compose を利用すると、UI とロジックが明確に分離 され、状態管理がシンプルになります。
Jetpack Compose で UI を実装・プレビューする手順
Compose の最大の利点は コードを書きながら即座に画面を確認できる 点です。以下では基本コンポーネントの組み立て方と、Android Studio のプレビュー機能の活用方法を具体的に示します。
Composable 関数の作成例
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
@Composable fun GreetingScreen() { Column( modifier = Modifier .fillMaxSize() .padding(16.dp), verticalArrangement = Arrangement.Center, horizontalAlignment = Alignment.CenterHorizontally ) { Text( text = "Hello, Android!", style = MaterialTheme.typography.headlineMedium ) Spacer(modifier = Modifier.height(24.dp)) Button(onClick = { /* TODO: handle click */ }) { Text("Tap me") } } } |
Columnで縦方向に要素を並べ、Modifierによってサイズ・余白を指定します。@Preview(showBackground = true)を付与すれば、エディタ右側に即座に UI が描画されます。
プレビュー機能の使い方
GreetingScreenの上に @Preview アノテーションを書き込みます。- エディタ右上の「Split」または「Design」ビューを選択すると、プレビューウィンドウが表示されます。
- プレビューウィンドウのドロップダウンから デバイスサイズ や テーマ（ライト／ダーク） を切り替えられるため、様々な環境で見た目を確認できます。
ヒント：コードを保存するたびにプレビューが自動更新されます。レイアウト調整の手間が格段に減ります。
ビルド・デプロイ、デバッグと公式 Codelab の活用
実装したアプリをエミュレータや実機で動かすまでの流れと、学習教材として有効な Codelab の利用方法を解説します。
エミュレータ／実機へのインストール手順
- Android Studio のツールバーから Run → Run 'app' を選択。
- Gradle がプロジェクト全体をビルドし、APK が生成されます。
- 接続されたエミュレータまたは USB デバッグが有効化された実機に自動でインストールされ、Logcat にデバッグ情報がリアルタイムで出力されます。
実機テストの注意点
- 開発者オプション → USB デバッグ を有効にする。
- Wi‑Fi 接続で ADB over network を使用したい場合は、
adb tcpip 5555コマンドでポートを開放し、端末の IP アドレスへ接続します。
Gradle Kotlin DSL における最新設定ポイント
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
plugins { id("com.android.application") kotlin("android") } android { compileSdk = 35 // 最新 SDK は公式サイトで確認 defaultConfig { applicationId = "com.example.firstapp" minSdk = 21 targetSdk = 35 versionCode = 1 versionName = "1.0" } buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.6.0" // 更新は公式リリースノートでチェック } } dependencies { implementation("androidx.core:core-ktx:1.13.0") implementation("androidx.compose.ui:ui:1.6.0") implementation("androidx.compose.material3:material3:1.2.0") } |
compileSdkとtargetSdkは 最新の API レベル（執筆時点では 35）に合わせます。- Compose のコンパイラ拡張バージョンは、Android Studio の更新と同期させることが重要です。
公式 Codelab のリンクと活用手順
※ URL は執筆時点で有効なものです。最新情報は公式ページをご確認ください
https://developer.android.com/codelabs/basic-android-kotlin-compose-first-app?hl=ja
Codelab を活用する流れは次の通りです。
- 環境構築：本記事で行った Android Studio のインストールと Kotlin プラグイン確認を完了させます。
- テンプレート作成：Codelab が推奨する「Empty Compose Activity」でプロジェクトを生成します。
- ステップ実施：章ごとの指示（
@Composableの追加、状態管理、ナビゲーション）を順にコーディングし、プレビューで結果を確認します。 - デバッグ & デプロイ：最後の「Run on device」セクションでエミュレータまたは実機へインストールし、動作を検証します。
このサイクルを繰り返すことで、Compose の基本から応用まで体系的に習得できます。
Kotlin Multiplatform Mobile（KMM）で共有コードを書く手順
KMM を利用すると Android と iOS 間でビジネスロジックを共通化 でき、長期的な開発コスト削減が期待できます。以下では初心者向けに最低限必要な設定と実装例を示します。
- メニュー File → New → New Module → Kotlin Multiplatform Mobile を選択し、モジュール名（例:
shared）を入力。 - 「Target」には Android と iOS をチェックし、テンプレートとして「Kotlin Multiplatform Library」を選びます。
2. 共通ロジックの実装
shared/src/commonMain/kotlin 配下に共通コードを書きます。たとえば簡易的な API クライアントは次のようになります。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
import kotlinx.coroutines.flow.Flow import kotlinx.coroutines.flow.flow interface GreetingRepository { fun getGreeting(): Flow<String> } class DefaultGreetingRepository : GreetingRepository { override fun getGreeting(): Flow<String> = flow { emit("Hello from KMM!") } } |
3. プラットフォーム固有実装（expect/actual）
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
// commonMain expect class PlatformLogger() { fun log(message: String) } // androidMain actual class PlatformLogger { fun log(message: String) = android.util.Log.d("KMM", message) } // iosMain actual class PlatformLogger { fun log(message: String) = NSLog("%@", message) } |
expect キーワードで共通インターフェースを定義し、各プラットフォーム側で actual 実装を提供します。
4. Android 側への組み込み
app/build.gradle.kts に以下の依存関係を追加します。
|
1 2 3 4 |
dependencies { implementation(project(":shared")) } |
Android のコードからは通常通り shared パッケージをインポートし、ロジックを呼び出せます。
5. iOS 側への組み込み
- Android Studio が自動生成した Xcode 用フレームワーク（例:
shared.framework) をビルドします。 - Xcode プロジェクトの Frameworks, Libraries, and Embedded Content に追加し、
import sharedで Swift から利用できるようにします。
|
1 2 3 4 5 6 7 |
import shared let repo = DefaultGreetingRepository() repo.getGreeting().collect { greeting in print(greeting) // "Hello from KMM!" } |
ポイント：KMM のビルドは Gradle 経由で行うため、Xcode 側の依存関係が正しく設定されているか常に確認してください。
まとめ
- Android Studio は公式サイトから最新版を取得し、インストール後に Kotlin プラグインのバージョンを必ず確認しましょう。
- Empty Compose Activity テンプレートでプロジェクトを作成すると、Compose 用の Gradle 設定が自動的に整います。
- Kotlin の基本構文と Activity と Composable の違いを理解すれば、宣言的 UI の利点を最大限に活かせます。
- プレビュー機能を使えば UI の見た目をリアルタイムで確認でき、開発サイクルが大幅に短縮されます。
- ビルド・デプロイは Gradle Kotlin DSL で最新 SDK 設定を行い、公式 Codelab と組み合わせてハンズオン形式で学習すると効果的です。
- KMM を導入すれば Android と iOS のビジネスロジックを一元管理でき、長期的な保守性が向上します。
これらの手順とポイントを押さえておけば、2024 年以降も安定した Android 開発環境を維持しながら、Compose と KMM の最新機能にスムーズに追従できるでしょう。