Eclipse(2022年6月版)のインストール,日本語化,基本操作(Ubuntu 上)
この記事では,Linux (Ubuntu) 上で Eclipse (2022年6月版) を利用するための手順を示す.Linux (Ubuntu) の基本的なコマンド操作と,Java JDK の概要を理解していることを前提とする.
Linux マシンでの Eclipse のダウンロードとインストール,日本語化の手順を説明する. さらに,プロジェクトの作成,クラスの定義と実行という基本操作の手順も,スクリーンショットを交えて説明する.
【この Web ページの目次】
【サイト内の関連ページ】
Eclipse インストール手順 (Ubuntu 上)
前準備として JDK のインストール
OpenJDK 18 のインストールと設定(Ubuntu 上): 別ページ »で説明
古いバージョンの Eclipse のアンインストール
過去に Eclipse をインストールした場合,古いバージョンのディレクトリ(例: /home/<ユーザ名>/eclipse)が残っていることがある.インストール場所は環境により異なる.不要であれば,該当ディレクトリを削除する.
ダウンロード
- Eclipse の Web ページを開く
- ダウンロードページへジャンプ
ページの上の方にある「Download」をクリックする.
- 「DOWNLOAD Packages」をクリックする.
- 種類の選択
「Linux」の右横の「x86_64」をクリックする.
- ダウンロードサイトの選択
「DOWNLOAD」をクリックするか, 「Select Another Mirror」を展開し「Japan ...」を選ぶ. その後,「Japan ...」のところをクリックする.
-
.tar.gz形式のアーカイブファイル(例:eclipse-inst-jre-linux64.tar.gz)のダウンロードが始まる.
ダウンロードが終わるまで待つ.
インストール
- 先ほどダウンロードしたファイルを展開(解凍)
* ここでは例として /tmp にダウンロードしたものとして説明する. 実際にダウンロードしたディレクトリに移動し,次のコマンドでファイルを展開(解凍)する.コマンド内のファイルパスは,自身の環境に合わせて読み替える.
tar -xvzf /tmp/eclipse-inst-jre-linux64.tar.gz
- eclipse-inst の実行
展開してできたディレクトリに移動し,次のコマンドを実行する.cd eclipse-installer ./eclipse-inst
- 種類を選ぶ.
* ここでは,「Eclipse IDE for Enterprise Java Developers」を選んだとして説明を続ける.用途に応じて他のパッケージを選択することもできる.
- インストールディレクトリ(Installation Folder)を確認してから,
「INSTALL」をクリックする.
- ライセンス条項の確認
内容を確認し,同意する場合のみ続行する.
- メッセージの確認
インストール中に,証明書の信頼などに関する確認メッセージが表示される場合がある.内容を確認の上,続行する.
- インストールが終わったら「LAUNCH」をクリックし,起動を確認する.
初回起動時設定
初めて Eclipse を起動する際に,設定と確認を行う.これらの設定は後から変更できる.
* 先に,日本語化 を行ってもよい.
- Eclipse の起動
Eclipse の起動コマンドは,インストールディレクトリ内の
eclipseファイルである.インストール時の選択によってパスは異なるが,例えば次のようなパスになる.~/eclipse/java-2022-06/eclipse/eclipse
- 起動時に,Eclipse のワークスペースを置くディレクトリを設定する.
ワークスペースは,プロジェクトファイル,ソースコード,設定が保存される場所である.
* ディレクトリの場所は任意であるが,パスに半角スペースや全角文字(日本語など)を含むディレクトリは避ける.場所は後で変更できる.
- Eclipse の画面が開くので確認する.最初は「ようこそ」画面が表示される.
- Eclipse で,インストール済みの JRE を確認する
Eclipse がプロジェクトのコンパイルや実行に使用する Java Runtime Environment (JRE) を確認する.
Eclipse のメニューから 「ウィンドウ (Window)」→「設定 (Preferences)」を選択し, 設定用ウインドウを開く. 左側のペインで「Java」→「インストール済みの JRE (Installed JREs)」を選択し,使用する JRE が認識されているかを確認する.Eclipse に付属する JRE や,システムにインストール済みの JDK が自動で検出される.
- 文字コード設定の確認
ソースコードなどのテキストファイルを扱う際の文字コードと改行コードを確認・設定する.
「ウィンドウ (Window)」→「設定 (Preferences)」を開き, 左側のペインで「一般 (General)」→「ワークスペース (Workspace)」を選択する.
「テキスト・ファイル・エンコード (Text file encoding)」と,「新規テキスト・ファイルの行区切り文字 (New text file delimiter)」を確認する.文字化けを防ぐため,エンコーディングは UTF-8,Linux 環境での開発では行区切り文字は LF (Unix) を選ぶ.
- Emacs風キーバインドを使う場合には,そのように設定する.
Eclipse は標準で独自のキーバインドを持つが,他のエディター(例: Emacs)のキーバインドに変更できる.
「ウィンドウ (Window)」→「設定 (Preferences)」を開き, 左側のペインで「一般 (General)」 → 「キー (Keys)」 を選択する. 「スキーム (Scheme)」のプルダウンメニューから キーバインド(例:「Emacs」)を選ぶ.
- ビルド・パスの確認
Java プロジェクトがソースコードをどこから読み込み,コンパイル結果をどこに出力するかの設定(ビルド・パス)を確認する.
「ウィンドウ (Window)」→「設定 (Preferences)」を開き, 左側のペインで「Java」→「ビルド・パス (Build Path)」を選択する.
「ソースおよび出力フォルダー (Source and output folder)」 で,「フォルダー (Folders)」にチェックが入っていることを確認する.これは,ソース (
src) と出力 (bin) を別々のフォルダーにする設定である.
- Java コンパイラー準拠レベルの確認
プロジェクトで使用する Java の言語バージョン(準拠レベル)を設定する.
「ウィンドウ (Window)」→「設定 (Preferences)」を開き, 左側のペインで「Java」→「コンパイラー (Compiler)」を選択する.
「Compiler compliance level (コンパイラー準拠レベル)」 が表示される(例: 18).使用する Java のバージョンに合わせて設定する.プロジェクトごとに変更することもできる.
日本語化
Eclipse のメニューなどを日本語で表示するために,Pleiades(プレアデス)プラグインをインストールする.
- Pleiades の Web ページを開く
Pleiades の公式サイト https://willbrains.jp/を開く.
- 「Pleiades の概要」に目を通す
- 「Linux」を選択
「Pleiades プラグイン・ダウンロード」のセクションで 「Linux」を選んでクリックする.
- ダウンロードが始まる
zip 形式のファイルがダウンロードされる.
- Eclipse のインストールディレクトリに,ダウンロードした zip ファイルを展開(解凍)する.
* ここでは例として /tmp にダウンロードしたものとして説明する. zip ファイルのパスと,Eclipse のインストールディレクトリは,自身の環境に合わせて読み替える.
# Eclipseのインストールディレクトリへ移動 cd <eclipse のインストールディレクトリ> # ダウンロードしたPleiadesのzipファイルを展開 unzip /tmp/pleiades.zip展開先を明示する場合は,
unzip /tmp/pleiades.zip -d <eclipse のインストールディレクトリ>のように-dオプションを付ける.
-
Eclipse の設定ファイルである
eclipse.iniを編集する.このファイルは Eclipse のインストールディレクトリ直下にある.編集前に,
eclipse.iniのバックアップを作成する.テキストエディタで
eclipse.iniファイルを開き,ファイルの一番最後に,次の1行を追記する.「
-javaagent:<eclipse のインストールディレクトリ>/plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar」<eclipse のインストールディレクトリ>の部分は,自身の Eclipse のインストールディレクトリの絶対パス(例:/home/user/eclipse/java-2022-06/eclipse)に置き換える.------変更後の eclipse.ini の例-------------------------------------- -startup plugins/org.eclipse.equinox.launcher_1.6.400.v20210924-0641.jar --launcher.library /home/user/.p2/pool/plugins/org.eclipse.equinox.launcher.gtk.linux.x86_64_1.2.500.v20220509-0833 -product org.eclipse.epp.package.jee.product -showsplash /home/user/.p2/pool/plugins/org.eclipse.epp.package.common_4.24.0.20220609-1200 --launcher.defaultAction openFile --launcher.appendVmargs -vm /usr/lib/jvm/java-18-openjdk-amd64/bin -vmargs -Dosgi.requiredJavaVersion=17 -Dosgi.instance.area.default=@user.home/eclipse-workspace -XX:+UseG1GC -XX:+UseStringDeduplication --add-modules=ALL-SYSTEM -Dosgi.dataAreaRequiresExplicitInit=true -Xms256m -Xmx2048m -Declipse.p2.max.threads=10 -javaagent:/home/user/eclipse/java-2022-06/eclipse/plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar
- Eclipse の起動
再度 Eclipse を起動する.
~/eclipse/java-2022-06/eclipse/eclipse変更が反映されない場合は,
-cleanオプションを付けて起動する.~/eclipse/java-2022-06/eclipse/eclipse -clean
起動時にワークスペース選択ダイアログが表示される場合がある.
- Eclipse の画面が開くので確認する.
メニューバーやビューのタイトルが日本語化されていることを確認する.日本語化されていない場合は,eclipse.iniに追記したパスが正しいか,Pleiades が Eclipse のインストールディレクトリに展開されているかを確認する.
Eclipse の基本操作
ここでは Eclipse を使った Java プログラミングの基本的な流れとして,新規プロジェクトの作成,クラス(HelloWorld)の作成,保存,実行を行う.
あらかじめ決めておく事項
- プロジェクト名: HelloWorld
- パッケージ名: hoge.hoge.com (例)
- メインとなるクラス名: HelloWorld
プロジェクトの新規作成
Java のコードを管理する単位として,まず「プロジェクト」を作成する.
プロジェクトを作成すると,設定したワークスペースのディレクトリ(例: /home/ユーザー名/workspace)の下に,プロジェクト名のディレクトリが作成される.そのディレクトリの下には,ソースコードを格納する src ディレクトリと,コンパイル後のクラスファイルを格納する bin ディレクトリができる.
- プロジェクトの新規作成の開始
メニューから「ファイル (File)」→「新規 (New)」→「プロジェクト (Project)」を選択する.
または,左側の「パッケージ・エクスプローラー (Package Explorer)」ビュー内で右クリックし,「新規 (New)」→「プロジェクト (Project)」を選択する.
- 「Java」の展開
「新規プロジェクト (New Project)」ウィザードが開くので, 「Java」フォルダーを展開する.
- 「Java プロジェクト」の選択
展開した「Java」の下にある 「Java プロジェクト (Java Project)」を選び,「次へ (Next)」をクリックする.
- プロジェクト名の指定
「新規Javaプロジェクト (New Java Project)」ウィザードで,プロジェクト名を入力する(例: HelloWorld).プロジェクト名には半角英数字,ハイフン,アンダースコアを用い,全角文字やスペースは避ける.
- Java 設定
JRE やプロジェクト・レイアウトなどの設定は,デフォルトのままでよい.「モジュール」に関する設定が表示される場合,「
module-info.javaファイルを作成しない」を選択してよい.確認後,「完了 (Finish)」をクリックする.
- (オプション)
関連付けられたパースペクティブを開きますか
「この種のプロジェクトは Java パースペクティブに関連付けられています。パースペクティブを開きますか?」というダイアログが表示された場合,「パースペクティブを開く (Open Perspective)」をクリックする.これにより,Java 開発用のウィンドウレイアウト(パースペクティブ)に切り替わる.
- (オプション)
手動で新しいパースペクティブを開く操作
異なるパースペクティブ(作業に適した画面レイアウト)を開きたい場合,手動で切り替える.
-
メニューから「ウィンドウ (Window)」→
「パースペクティブを開く (Open Perspective)」→
「その他 (Other)...」と操作する.
- Java パースペクティブの選択
「パースペクティブを開く (Open Perspective)」ダイアログで, 「Java (デフォルト)」を選び, 「開く (Open)」をクリックする.
-
メニューから「ウィンドウ (Window)」→
「パースペクティブを開く (Open Perspective)」→
「その他 (Other)...」と操作する.
- Java パースペクティブが開いたことの確認
Eclipse の画面レイアウトが Java 開発用に切り替わったことを確認する.左にパッケージ・エクスプローラー,中央にエディター,下にコンソールや問題ビューが配置される.
パッケージとクラスの作成
Java では,関連するクラスをまとめるために「パッケージ」を使う.
パッケージ名は,クラス名の衝突を避け,ソースコードを体系的に管理するために用いる.一意になるよう,組織や個人のインターネットドメイン名を逆順にした形式(例: com.example.myproject, org.apache.commons)が慣習である.すべて小文字で記述する.
この例では,パッケージ名を hoge.hoge.com,作成するクラス名を HelloWorld とする.
- (もし表示されていなければ)パッケージ・エクスプローラーを開く
メニューから「ウィンドウ (Window)」→「ビューの表示 (Show View)」→「パッケージ・エクスプローラー (Package Explorer)」 と操作する.
パッケージの作成やクラスの作成は,「パッケージ・エクスプローラー」ビューで行う.
- パッケージを新規作成するプロジェクトを選択
パッケージ・エクスプローラー(左側のビュー)に,先ほど作成したプロジェクト(HelloWorld)が表示されている. プロジェクト内の
srcフォルダーを右クリックする.(プロジェクト名を右クリックしてもよい)
- クラスの新規作成の開始
右クリックメニューから「新規 (New)」→「クラス (Class)」と選択する.
* 右クリックメニューの「新規 (New)」を選んだときに,「クラス (Class)」が表示されないことがある.その場合は,「新規 (New)」→「その他 (Other)...」を選択し,開いたウィザードで「Java」→「クラス (Class)」を選択して「次へ (Next)」をクリックする.
- Java パッケージ名とクラス名の指定
「新規 Java クラス (New Java Class)」ウィザードが開くので,必要な情報を入力する.
- 「パッケージ (Package)」フィールドに,作成するパッケージ名を入力する(例: hoge.hoge.com).
- 「名前 (Name)」フィールドに,作成するクラス名を入力する(例: HelloWorld).クラス名は,アッパーキャメルケース(UpperCamelCase),つまり各単語の先頭を大文字にして繋げて記述するのが Java の標準的な命名規則である(例:
HelloWorld,MyUsefulClass). - 「どのメソッド・スタブを作成しますか? (Which method stubs would you like to create?)」の項目にある「public static void main(String[] args)」にチェックを入れる.これにより,プログラムの実行開始点となる
mainメソッドが自動で生成される. - 「完了 (Finish)」をクリックする.
クラス定義
パッケージ・エクスプローラーで src の下の hoge.hoge.com パッケージの下に HelloWorld.java が作成されている.これに処理コードを記述する.
- クラスファイル一覧の表示
パッケージ・エクスプローラーで, プロジェクト名 (HelloWorld) の下の 「src」フォルダーを展開すると,作成したパッケージ名 (hoge.hoge.com) が表示される.さらにその下を展開すると,クラスファイル (
HelloWorld.java) が表示される. - 定義したいクラスのファイルを開く
パッケージ・エクスプローラーで,先ほど作成したクラスファイル 「HelloWorld.java」をダブルクリックする. 中央のエリアにエディターが開き,ファイルの内容が表示される.
mainメソッドの枠組みが記述されている.Eclipse では,パッケージ・エクスプローラーで編集したい「クラス名.java」ファイルをダブルクリックすることで,エディターが開く.
同じパッケージ内に別のクラスを追加したい場合は, パッケージ名 (hoge.hoge.com) を右クリックして「新規 (New)」→「クラス (Class)」を選択する.
- エディタでクラス定義を行う
エディターに表示された
HelloWorld.javaの内容を編集する.mainメソッドの{}の中に,実行したい処理を記述する. 次のコード例をコピー&ペーストする. (パッケージ名を「hoge.hoge.com」以外にした場合は,1行目のpackage宣言を実際のパッケージ名に合わせる).----------------------ここから--------------------- package hoge.hoge.com; public class HelloWorld { /** * プログラム実行開始点 * @param args コマンドライン引数 */ public static void main(String args[]) { // コンソールにメッセージを出力する System.out.println("Hello Java World !"); } } ----------------------ここまで----------------------補足: コード例の
mainメソッドの上部にある/** ... */で囲まれたコメントは JavaDoc コメントと呼ばれる形式である.この形式で記述すると,専用のツールで API ドキュメントを生成できる.
- ソースを保存
メニューから「ファイル (File)」→「保管 (Save)」を選択するか,ショートカットキー CTRL+S を押してファイルを保存する. Eclipse では,ファイルの保存時に自動的にコンパイルが実行される.コードに文法エラーや警告があれば,画面下部の「問題 (Problems)」ビューに表示されるので確認し,修正する.エラーがある状態ではプログラムを実行できない.
実行
作成した Java プログラムを実行する.
- 実行したいクラスを選び,右クリック
パッケージ・エクスプローラーで,実行したい
mainメソッドを持つクラスファイル「HelloWorld.java」 を右クリックする. - 「実行 (Run As)」 → 「1 Javaアプリケーション (1 Java Application)」と操作する.
* もしくは,
HelloWorld.javaをエディタで開いている状態で,ツールバーの実行ボタン(緑色の再生マーク)をクリックするか,ショートカットキー Alt+Shift+X を押し,次に J を押すという操作でも実行できる.
- Eclipse 画面下部の「コンソール (Console)」ビューに,プログラムの出力結果「Hello Java World !」と表示されることを確認する.