local.propertiesとは？初心者向けガイドと使い方の要点共起語・同意語・対義語も併せて解説！

この記事を書いた人

高岡智則

年齢：33歳性別：男性職業：Webディレクター（兼ライティング・SNS運用担当）居住地：東京都杉並区・永福町の1LDKマンション出身地：神奈川県川崎市身長：176cm 体系：細身〜普通（最近ちょっとお腹が気になる）血液型：A型誕生日：1992年11月20日最終学歴：明治大学・情報コミュニケーション学部卒通勤：京王井の頭線で渋谷まで（通勤20分）家族構成：一人暮らし、実家には両親と2歳下の妹恋愛事情：独身。彼女は2年いない（本人は「忙しいだけ」と言い張る）

local.propertiesとは？初心者向けガイドと使い方の要点

local.properties という名前のファイルは Android Studio や Gradle で使われる「環境情報を保存するための設定ファイル」です。ここにはローカル環境に依存する情報が書かれ、チームで共有するコードには含めないことが基本です。

このファイルがあるとないとでビルドに影響が出る場合がありますが実際には開発者の端末ごとに異なる情報を保持するために用意されています。中学生にもわかるように、まずは役割から整理します。

local.properties の主な役割

主な役割は Gradle が正しい場所にある Android SDK を探す手助けです。sdk.dir という項目に SDK のパスを記述するのが一般的です。場合によっては ndk.dir も含まれることがあります。

どこにあるのかと作り方

通常はプロジェクトのルートディレクトリに置かれます。新しいプロジェクトを Android Studio で作成すると自動的に作られることが多いですが手作業で作ることも可能です。ファイル名は local.properties で内容はキーとパスの組み合わせで成り立ちます。

安全に扱うポイント

このファイルには機密情報そのものは入っていませんがローカルの環境依存情報なのでバージョン管理には含めないのが基本です。公開リポジトリにはアップロードせず代わりに .gitignore に記述して除外します。

表でわかる要点

<th>項目

説明
local.properties	プロジェクトのルートに置く設定ファイルで Gradle が参照する
sdk.dir	Android SDK のパスを表す重要な項目
ndk.dir	NDK のパスを指す場合がある
注意点	機密情報を含めずバージョン管理には含めない

よくある誤解

local.properties はすべての設定を含むファイルだと思われがちですが実際には端末ごとの環境情報を保存するためのものです。SDK の場所を変えた後はプロジェクトを再同期する必要があります。設定をいじるときは慎重に行い何を変更したのか覚えておくと後で役立ちます。

簡単な確認ポイント

新しいプロジェクトを開いたとき local.properties が自動生成されているかを確認します。表示されるパスが自分の SDK の場所と一致しているかを一度チェックしましょう。もし一致していなければ sdk.dir の値を自分の環境に合わせて変更しプロジェクトを再同期します。

local.propertiesの同意語

local.properties: Android/Gradleのローカル設定ファイル。sdk.dir など、ローカル開発環境に依存する設定を格納します。通常はプロジェクトルートに置かれ、バージョン管理には含めず個人の環境でのみ利用されることが多いです。
ローカル設定ファイル: ローカル環境に特化した設定を格納するファイルの総称。主に開発者のマシン固有の設定を保存します。
ローカルプロパティファイル: key=value 形式で設定を保存するファイルのこと。ローカル環境に依存する設定を格納します。
ローカル環境設定ファイル: 開発者のマシン固有の設定を保存するファイル。ローカル環境の再現性には注意が必要です。
ローカル環境プロパティファイル: 環境依存の設定を含む、ローカル用の .properties ファイルのことです。
ローカルSDKディレクトリ設定ファイル: sdk.dir のように Android SDK の場所を指定する設定を格納するファイルです。
ローカル用プロパティファイル: ローカル環境で使う設定を格納するプロパティファイルです。
開発者ローカル設定ファイル: 開発者個人のローカル環境に特化した設定を格納します。
ローカルの設定ファイル: ローカル環境に依存する設定を指す日常的な表現です。
ローカル環境依存設定ファイル: 環境依存の設定を含むファイル。特定のマシンでのみ適用されます。
ローカル環境専用設定ファイル: 特定のローカル環境にのみ適用される設定を格納します。
ローカル設定プロパティ: 設定項目を表すプロパティの集合としての意味を持ちます。
ローカルプロパティ: 設定項目を表す「プロパティ」の総称。ローカル用の設定を指すことが多いです。
プロパティファイル（ローカル用）: ローカル環境で使う .properties 形式の設定ファイルです。

local.propertiesの対義語・反対語

remote.properties: ローカルの対義語として、遠隔地の環境用の設定を格納するファイル。ローカルではなくサーバーや他端末に関係する設定を指す。
global.properties: 全体で共有・適用される設定を格納するファイル。ローカル限定ではなく、環境全体に影響する設定。
cloud.properties: クラウド上に保存・適用される設定を格納するファイル。ローカルファイルではなくオンラインの設定。
server.properties: サーバー側の設定を格納するファイル。クライアント（ローカル）側の設定とは対になる概念。
shared.properties: 複数の環境で共有される設定を格納するファイル。ローカルだけに閉じない共通設定。
central.properties: 中央管理的な設定を格納するファイル。各端末が独立して持つローカル設定の対として、中央の設定を指す。
universal.properties: 普遍的に適用される設定を格納するファイル。特定のローカル環境に依存しない設定。
network.properties: ネットワーク関連の設定を格納するファイル。ローカルマシンのみに閉じない、ネットワーク全体の設定を指す。
public.properties: 公開・共有対象の設定を格納するファイル。ローカルの非公開設定とは異なる性質を示す。
distributed.properties: 分散配置・配布向けの設定を格納するファイル。ローカルの単独環境ではなく、分散された環境で使われる設定。

local.propertiesの共起語

sdk.dir: Android SDK のパスを指定する設定。例: sdk.dir=/Users/username/Library/Android/sdk
ndk.dir: Android NDK のパスを指定する設定。例: ndk.dir=/Users/username/Library/Android/ndk
Android Studio: local.properties を生成・編集することが多い統合開発環境
Android SDK: Android の開発用ソフトウェア開発キットの総称
Android NDK: C/C++ のコードをビルドするためのネイティブ開発キット
Gradle: Android のビルドツール。local.properties はビルド設定と連携して利用される
build.gradle: Gradle によるビルド設定ファイル
gradle.properties: Gradle の設定ファイル。local.properties と併用されることがある
JAVA_HOME: Java のインストール先を指す環境変数。Gradle 実行時に参照されることが多い
NDK: Native Development Kit の略称
Windows: Windows 環境ではパスの書き方が異なるため例が OS ごとに分かれる
macOS: macOS 環境ではパスの表記が異なる
Linux: Linux 環境ではパスの表記が異なる
.gitignore: local.properties は機密情報を含む可能性があるため、ソース管理から除外するのが一般的

local.propertiesの関連用語

local.properties: Androidプロジェクトのルートディレクトリに置かれる、マシン依存の設定ファイル。SDKの場所などを記述し、Gradleがそれを参照してビルド環境を特定する。通常はリポジトリに含めず、各開発者が自分の環境を設定する。
Android SDK: Androidアプリ開発用のソフトウェア開発キット。SDKにはプラットフォームツール、ビルドツール、APIレベルごとのプラットフォームが含まれ、アプリのビルドとデバッグに必要。
sdk.dir: local.properties 内のキー。Android SDKのインストールパスを示す。例: sdk.dir=/path/to/android/sdk
ndk.dir: NDKのパスを指定する設定。NDKはネイティブコードのビルドに必要。古いGradleプラグインで使われることがある。
Gradle: Android アプリのビルドを自動化するオープンソースツール。
Gradle wrapper: プロジェクトに含まれる Gradle 実行スクリプト（gradlew/gradlew.bat）。このバージョンを使ってビルドを再現可能にする。
Android Studio: 公式 IDE。local.properties の生成やSDK管理を行い、Gradle と連携してビルドを実行。
Android Gradle Plugin: AGP。Gradle 上で Android 用のビルドタスクを提供するプラグイン。
build.gradle: モジュール/プロジェクトのビルド設定ファイル。依存関係、SDKバージョン、ビルドタイプなどを定義。
settings.gradle: 複数モジュール構成の設定を管理するGradleファイル。
Platform-tools: Android SDK の一部。adb などのツールを含む。
Build-tools: ビルド時に使う各種ツール群。API レベルごとに分かれている。
Platforms: 各 API レベルのプラットフォーム実装を含むディレクトリ。
SDK Manager: SDK のインストール・更新を行うツール。Android Studio から GUI、またはコマンドラインで利用。
API level: Android API のバージョン番号。例: API レベル31 は Android 12。
.gitignore: Git で追跡したくないファイルを指定する設定ファイル。local.properties はリポジトリに含めない方針が基本。
Git: 分散型バージョン管理システム。コードの履歴管理や共同開発に使用。
ANDROID_HOME: 旧来のSDKパスを指す環境変数。現在は ANDROID_SDK_ROOT の使用が推奨。
ANDROID_SDK_ROOT: SDKのルートディレクトリを指す環境変数。Gradle・ツールが参照することがある。
PATH: 実行可能ファイルを検索する環境変数。SDK のツールをコマンドから呼ぶ際に影響する。
CI/CD: 継続的インテグレーション/デリバリー。CI 環境では local.properties が不要なことが多く、環境変数や別ファイルで対処するのが一般的。
Local vs global configuration: local.properties は各開発者の端末固有の設定ファイル。共有するべき設定ではなく、個別に管理する。
Security/Privacy: local.properties には絶対パスやユーザー名などの機密情報が含まれる可能性があるため、公開リポジトリには含めない。