Android Studio インストールと最新Kotlinプロジェクト作成ガイド

1. システム要件と推奨環境

※ 注意
Android Studio は大量のキャッシュを作成するため、SSD の利用を強くおすすめします。

2. Android Studio のインストール & 最新版確認方法

2‑1. ダウンロード手順（公式サイトから取得）

1. ブラウザで Android Studio 公式ダウンロードページ にアクセス。
2. 「Download Android Studio」ボタンをクリックし、OS に合わせたインストーラを取得。
3. 利用規約に同意すると自動的にダウンロードが開始されます。

2‑2. インストール手順

2‑3. 最新版かどうかを確認する方法

1. Android Studio 起動 → メニューバー Help → About（macOS は Android Studio → About Android Studio）
2. 表示されるバージョン文字列が「Android Studio Electric Eel 2023.1.x」や「Android Studio Giraffe 2024.1.x」のように 公式サイトで案内されている最新安定版 かを確認。
3. 更新がある場合は同画面の Check for Updates... をクリックし、指示通りにアップデートを適用してください。

ポイント：バージョン番号は頻繁に変わるため「最新安定版」かどうかだけを目視で確認すれば、情報の乖離リスクは回避できます。

3. SDK・Compose などコンポーネントの更新手順

3‑1. SDK Manager から最新版に更新

3‑2. Jetpack Compose のバージョン更新

1. build.gradle.kts（または gradle/libs.versions.toml）に記載している以下の項目を最新版へ置き換える
   kotlin
// 例：Compose BOM を使用する場合
implementation(platform("androidx.compose:compose-bom:2024.09.00")) // バージョンは SDK Manager の「Compose UI」欄で確認
implementation("androidx.compose.ui:ui")
implementation("androidx.compose.material3:material3")
2. File → Sync Project with Gradle Files で同期し、コンパイルエラーが出なければ完了です。

ヒント：compose-bom を利用すると、個別ライブラリのバージョンを一括管理できるため更新作業が格段に楽になります。

4. 新規 Kotlin プロジェクト（Empty Activity）作成手順

作成後に確認すべきポイント

• app/src/main/kotlin/.../MainActivity.kt に class MainActivity : ComponentActivity() が自動生成されていること
• activity_main.xml（ViewBinding 使用時）または setContent { … } の Compose ブロックが存在すること
• Project ビューで build.gradle.kts が Kotlin DSL になっていること

5. アプリ名・パッケージ名・保存場所のベストプラクティス

5‑1. アプリ名（ユーザー向け表示）

5‑2. パッケージ名（逆ドメイン形式）

• 基本形：com.<組織・個人>. <プロジェクト>
• 例：com.example.mytodoapp、io.github.taro.weathernow
• 小文字・英数字のみ、アンダースコアは使用しない
• 将来的にサブモジュールが増える場合は feature.<機能名> のように階層化しても可

5‑3. 保存場所（Git 管理前提）

• パス長の上限：Windows は 260 文字、macOS/Linux は 4096 文字なので深い階層は避ける
• プロジェクト直下に .git を作成しやすくするため、ホームディレクトリ配下を推奨

6. Gradle ビルドファイル（build.gradle.kts）の基本構成とバージョン更新ポイント

バージョン更新のチェックリスト

ポイント：build.gradle.kts は手動編集が頻繁になる箇所です。変更前に必ず Git のブランチを切ってから 作業し、Sync Project with Gradle Files でビルドエラーが出ないことを確認しましょう。

7. エミュレータ／実機でのビルド・デプロイ手順

7‑1. AVD（Android Virtual Device）作成

1. Tools → Device Manager を開く
2. 「Create device」→ 推奨デバイスは Pixel 5（画面サイズが標準的）
3. OS イメージは API 34 (Android 14) – x86_64（Google Play 版推奨）を選択しダウンロード
4. 「Finish」後、リストに表示されたデバイスの Play アイコンで起動

Tip：エミュレータはハードウェアアクセラレーションが有効になっていると起動が数秒に短縮されます（Windows の場合は Hyper‑V / WSL2、macOS は Apple Silicon のネイティブサポート）。

7‑2. 実機デバッグ設定

7‑3. ビルド時間短縮テクニック

• gradle.properties に以下を追加してインクリメンタルビルドを有効化
  properties
org.gradle.caching=true
org.gradle.parallel=true
android.enableBuildCache=true
• Cold boot が遅い場合は AVD の Wipe Data を実行し、再起動後に Cold Boot → Quick Boot に切り替える

8. Compose Preview の活用方法

1. @Preview アノテーション付きの Composable 関数を作成
   kotlin
@Composable
fun Greeting(name: String) {
Text(text = "Hello $name!")
}

@Preview(showBackground = true)
@Composable
fun GreetingPreview() = Greeting("Android")

2. ファイル上部に **Design** タブが自動で表示されるので、**Refresh** ボタン（またはCtrl + R）で即座にプレビューを更新
3. プレビューモードの設定例
-showSystemUi = true→ ステータスバーやナビゲーションバーも同時表示
-fontScale = 1.2f → フォントサイズ変更をシミュレート

ポイント：Preview はエミュレータ不要で UI の見た目だけを高速に確認できるため、デザイン段階のフィードバックサイクルが大幅に短縮します。

9. GitHub への初期コミットと .gitignore 自動生成手順

9‑1. Android Studio 内で Git を有効化

1. VCS → Enable Version Control Integration... を選択
2. ダイアログで Git を指定 → プロジェクト直下に .git ディレクトリが作成される

9‑2. .gitignore の自動生成（Android 用テンプレート）

• Android Studio がプロジェクト作成時に標準的な除外パターンを持つ .gitignore を自動で配置します。代表的なエントリは以下の通りです

9‑3. 初回コミット & GitHub リモート設定

• ブランチ戦略（シンプル版）
• main：安定版リリースブランチ
• feature/*：機能追加用ブランチ → Pull Request 経由で main にマージ

10. まとめ & 今後のメンテナンスチェックリスト

10‑1. 本ガイドで実現できること

10‑2. 定期的に見直すべき項目（メンテナンスチェックリスト）

最終的なアドバイス
環境構築は「正しい手順」と「情報の鮮度」が鍵です。本稿で示した 公式ツール（SDK Manager、Android Studio の Update 機能） を利用すれば、バージョン番号を個別に追いかける必要がなくなります。疑問点やエラーは公式ドキュメントと Stack Overflow のタグ android-studio・kotlin で検索すると解決しやすくなるでしょう。

これで、Kotlin Android 入門プロジェクトの作成から Git 管理、日常的なアップデートまで一通りカバーできました。ぜひ実際に手を動かして、快適な開発環境を手に入れてください！