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)が残っていることがある.インストール場所は環境により異なる.不要であれば,該当ディレクトリを削除する.

ダウンロード

  1. Eclipse の Web ページを開く

    https://www.eclipse.org/を開く.

  2. ダウンロードページへジャンプ

    ページの上の方にある「Download」をクリックする.

  3. DOWNLOAD Packages」をクリックする.
  4. 種類の選択

    「Linux」の右横の「x86_64」をクリックする.

  5. ダウンロードサイトの選択

    DOWNLOAD」をクリックするか, 「Select Another Mirror」を展開し「Japan ...」を選ぶ. その後,「Japan ...」のところをクリックする.

  6. .tar.gz 形式のアーカイブファイル(例: eclipse-inst-jre-linux64.tar.gz)のダウンロードが始まる.
    ダウンロードが終わるまで待つ.

インストール

  1. 先ほどダウンロードしたファイルを展開(解凍)

    * ここでは例として /tmpダウンロードしたものとして説明する. 実際にダウンロードしたディレクトリに移動し,次のコマンドでファイルを展開(解凍)する.コマンド内のファイルパスは,自身の環境に合わせて読み替える.

    tar -xvzf /tmp/eclipse-inst-jre-linux64.tar.gz
    
  2. eclipse-inst の実行
    展開してできたディレクトリに移動し,次のコマンドを実行する.
    cd eclipse-installer
    ./eclipse-inst
    
  3. 種類を選ぶ.

    * ここでは,「Eclipse IDE for Enterprise Java Developers」を選んだとして説明を続ける.用途に応じて他のパッケージを選択することもできる.

  4. インストールディレクトリ(Installation Folder)を確認してから, 「INSTALL」をクリックする.
  5. ライセンス条項の確認
    内容を確認し,同意する場合のみ続行する.
  6. メッセージの確認

    インストール中に,証明書の信頼などに関する確認メッセージが表示される場合がある.内容を確認の上,続行する.

  7. インストールが終わったら「LAUNCH」をクリックし,起動を確認する.

初回起動時設定

初めて Eclipse を起動する際に,設定と確認を行う.これらの設定は後から変更できる.

* 先に,日本語化 を行ってもよい.

  1. Eclipse の起動

    Eclipse の起動コマンドは,インストールディレクトリ内の eclipse ファイルである.インストール時の選択によってパスは異なるが,例えば次のようなパスになる.

    ~/eclipse/java-2022-06/eclipse/eclipse
    
  2. 起動時に,Eclipse のワークスペースを置くディレクトリを設定する.

    ワークスペースは,プロジェクトファイル,ソースコード,設定が保存される場所である.

    * ディレクトリの場所は任意であるが,パスに半角スペースや全角文字(日本語など)を含むディレクトリは避ける.場所は後で変更できる.

  3. Eclipse の画面が開くので確認する.最初は「ようこそ」画面が表示される.
  4. Eclipse で,インストール済みの JRE を確認する

    Eclipse がプロジェクトのコンパイルや実行に使用する Java Runtime Environment (JRE) を確認する.

    Eclipse のメニューから 「ウィンドウ (Window)」→「設定 (Preferences)」を選択し, 設定用ウインドウを開く. 左側のペインで「Java」→「インストール済みの JRE (Installed JREs)」を選択し,使用する JRE が認識されているかを確認する.Eclipse に付属する JRE や,システムにインストール済みの JDK が自動で検出される.

  5. 文字コード設定の確認

    ソースコードなどのテキストファイルを扱う際の文字コード改行コードを確認・設定する.

    ウィンドウ (Window)」→「設定 (Preferences)」を開き, 左側のペインで「一般 (General)」→「ワークスペース (Workspace)」を選択する.

    テキスト・ファイル・エンコード (Text file encoding)」と,「新規テキスト・ファイルの行区切り文字 (New text file delimiter)」を確認する.文字化けを防ぐため,エンコーディングは UTF-8,Linux 環境での開発では行区切り文字は LF (Unix) を選ぶ.

  6. Emacs風キーバインドを使う場合には,そのように設定する.

    Eclipse は標準で独自のキーバインドを持つが,他のエディター(例: Emacs)のキーバインドに変更できる.

    ウィンドウ (Window)」→「設定 (Preferences)」を開き, 左側のペインで「一般 (General)」 → 「キー (Keys)」 を選択する. 「スキーム (Scheme)」のプルダウンメニューから キーバインド(例:「Emacs」)を選ぶ.

  7. ビルド・パスの確認

    Java プロジェクトがソースコードをどこから読み込み,コンパイル結果をどこに出力するかの設定(ビルド・パス)を確認する.

    ウィンドウ (Window)」→「設定 (Preferences)」を開き, 左側のペインで「Java」→「ビルド・パス (Build Path)」を選択する.

    ソースおよび出力フォルダー (Source and output folder)」 で,「フォルダー (Folders)」にチェックが入っていることを確認する.これは,ソース (src) と出力 (bin) を別々のフォルダーにする設定である.

  8. Java コンパイラー準拠レベルの確認

    プロジェクトで使用する Java の言語バージョン(準拠レベル)を設定する.

    ウィンドウ (Window)」→「設定 (Preferences)」を開き, 左側のペインで「Java」→「コンパイラー (Compiler)」を選択する.

    Compiler compliance level (コンパイラー準拠レベル)」 が表示される(例: 18).使用する Java のバージョンに合わせて設定する.プロジェクトごとに変更することもできる.

日本語化

Eclipse のメニューなどを日本語で表示するために,Pleiades(プレアデス)プラグインをインストールする.

  1. Pleiades の Web ページを開く

    Pleiades の公式サイト https://willbrains.jp/を開く.

  2. 「Pleiades の概要」に目を通す
  3. 「Linux」を選択

    Pleiades プラグイン・ダウンロード」のセクションで 「Linux」を選んでクリックする.

  4. ダウンロードが始まる

    zip 形式のファイルがダウンロードされる.

  5. Eclipse のインストールディレクトリに,ダウンロードした zip ファイルを展開(解凍)する.

    * ここでは例として /tmpダウンロードしたものとして説明する. zip ファイルのパスと,Eclipse のインストールディレクトリは,自身の環境に合わせて読み替える.

    # Eclipseのインストールディレクトリへ移動
    cd <eclipse のインストールディレクトリ>
    
    # ダウンロードしたPleiadesのzipファイルを展開
    unzip /tmp/pleiades.zip
    

    展開先を明示する場合は,unzip /tmp/pleiades.zip -d <eclipse のインストールディレクトリ> のように -d オプションを付ける.

  6. 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
    
  7. Eclipse の起動

    再度 Eclipse を起動する.

    ~/eclipse/java-2022-06/eclipse/eclipse
    

    変更が反映されない場合は,-clean オプションを付けて起動する.

    ~/eclipse/java-2022-06/eclipse/eclipse -clean
    

    起動時にワークスペース選択ダイアログが表示される場合がある.

  8. Eclipse の画面が開くので確認する.
    メニューバーやビューのタイトルが日本語化されていることを確認する.日本語化されていない場合は,eclipse.ini に追記したパスが正しいか,Pleiades が Eclipse のインストールディレクトリに展開されているかを確認する.

Eclipse の基本操作

ここでは Eclipse を使った Java プログラミングの基本的な流れとして,新規プロジェクトの作成,クラス(HelloWorld)の作成,保存,実行を行う.

あらかじめ決めておく事項

プロジェクトの新規作成

Java のコードを管理する単位として,まず「プロジェクト」を作成する.

プロジェクトを作成すると,設定したワークスペースのディレクトリ(例: /home/ユーザー名/workspace)の下に,プロジェクト名のディレクトリが作成される.そのディレクトリの下には,ソースコードを格納する src ディレクトリと,コンパイル後のクラスファイルを格納する bin ディレクトリができる.

  1. プロジェクトの新規作成の開始

    メニューから「ファイル (File)」→「新規 (New)」→「プロジェクト (Project)」を選択する.
    または,左側の「パッケージ・エクスプローラー (Package Explorer)」ビュー内で右クリックし,「新規 (New)」→「プロジェクト (Project)」を選択する.

  2. Java」の展開

    「新規プロジェクト (New Project)」ウィザードが開くので, 「Java」フォルダーを展開する.

  3. Java プロジェクト」の選択

    展開した「Java」の下にある 「Java プロジェクト (Java Project)」を選び,「次へ (Next)」をクリックする.

  4. プロジェクト名の指定

    「新規Javaプロジェクト (New Java Project)」ウィザードで,プロジェクト名を入力する(例: HelloWorld).プロジェクト名には半角英数字,ハイフン,アンダースコアを用い,全角文字やスペースは避ける.

  5. Java 設定

    JRE やプロジェクト・レイアウトなどの設定は,デフォルトのままでよい.「モジュール」に関する設定が表示される場合,「module-info.java ファイルを作成しない」を選択してよい.確認後,「完了 (Finish)」をクリックする.

  6. (オプション) 関連付けられたパースペクティブを開きますか

    「この種のプロジェクトは Java パースペクティブに関連付けられています。パースペクティブを開きますか?」というダイアログが表示された場合,「パースペクティブを開く (Open Perspective)」をクリックする.これにより,Java 開発用のウィンドウレイアウト(パースペクティブ)に切り替わる.

  7. (オプション) 手動で新しいパースペクティブを開く操作

    異なるパースペクティブ(作業に適した画面レイアウト)を開きたい場合,手動で切り替える.

    1. メニューから「ウィンドウ (Window)」→ 「パースペクティブを開く (Open Perspective)」→ 「その他 (Other)...」と操作する.
    2. Java パースペクティブの選択

      「パースペクティブを開く (Open Perspective)」ダイアログで, 「Java (デフォルト)」を選び, 「開く (Open)」をクリックする.

  8. Java パースペクティブが開いたことの確認

    Eclipse の画面レイアウトが Java 開発用に切り替わったことを確認する.左にパッケージ・エクスプローラー,中央にエディター,下にコンソールや問題ビューが配置される.

パッケージとクラスの作成

Java では,関連するクラスをまとめるために「パッケージ」を使う.

パッケージ名は,クラス名の衝突を避け,ソースコードを体系的に管理するために用いる.一意になるよう,組織や個人のインターネットドメイン名を逆順にした形式(例: com.example.myproject, org.apache.commons)が慣習である.すべて小文字で記述する.

この例では,パッケージ名を hoge.hoge.com,作成するクラス名を HelloWorld とする.

  1. (もし表示されていなければ)パッケージ・エクスプローラーを開く

    メニューから「ウィンドウ (Window)」→「ビューの表示 (Show View)」→「パッケージ・エクスプローラー (Package Explorer)」 と操作する.

    パッケージの作成やクラスの作成は,「パッケージ・エクスプローラー」ビューで行う.

  2. パッケージを新規作成するプロジェクトを選択

    パッケージ・エクスプローラー(左側のビュー)に,先ほど作成したプロジェクト(HelloWorld)が表示されている. プロジェクト内の src フォルダーを右クリックする.(プロジェクト名を右クリックしてもよい)

  3. クラスの新規作成の開始

    右クリックメニューから「新規 (New)」→「クラス (Class)」と選択する.

    * 右クリックメニューの「新規 (New)」を選んだときに,「クラス (Class)」が表示されないことがある.その場合は,「新規 (New)」→「その他 (Other)...」を選択し,開いたウィザードで「Java」→「クラス (Class)」を選択して「次へ (Next)」をクリックする.

  4. Java パッケージ名とクラス名の指定

    「新規 Java クラス (New Java Class)」ウィザードが開くので,必要な情報を入力する.

    1. 「パッケージ (Package)」フィールドに,作成するパッケージ名を入力する(例: hoge.hoge.com).
    2. 「名前 (Name)」フィールドに,作成するクラス名を入力する(例: HelloWorld).クラス名は,アッパーキャメルケース(UpperCamelCase),つまり各単語の先頭を大文字にして繋げて記述するのが Java の標準的な命名規則である(例: HelloWorld, MyUsefulClass).
    3. どのメソッド・スタブを作成しますか? (Which method stubs would you like to create?)」の項目にある「public static void main(String[] args)」にチェックを入れる.これにより,プログラムの実行開始点となる main メソッドが自動で生成される.
    4. 完了 (Finish)」をクリックする.

クラス定義

パッケージ・エクスプローラーで src の下の hoge.hoge.com パッケージの下に HelloWorld.java が作成されている.これに処理コードを記述する.

  1. クラスファイル一覧の表示

    パッケージ・エクスプローラーで, プロジェクト名 (HelloWorld) の下の 「src」フォルダーを展開すると,作成したパッケージ名 (hoge.hoge.com) が表示される.さらにその下を展開すると,クラスファイル (HelloWorld.java) が表示される.

  2. 定義したいクラスのファイルを開く

    パッケージ・エクスプローラーで,先ほど作成したクラスファイル 「HelloWorld.java」をダブルクリックする. 中央のエリアにエディターが開き,ファイルの内容が表示される.main メソッドの枠組みが記述されている.

    Eclipse では,パッケージ・エクスプローラーで編集したい「クラス名.java」ファイルをダブルクリックすることで,エディターが開く.

    同じパッケージ内に別のクラスを追加したい場合は, パッケージ名 (hoge.hoge.com) を右クリックして「新規 (New)」→「クラス (Class)」を選択する.

  3. エディタでクラス定義を行う

    エディターに表示された 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 ドキュメントを生成できる.

  4. ソースを保存

    メニューから「ファイル (File)」→「保管 (Save)」を選択するか,ショートカットキー CTRL+S を押してファイルを保存する. Eclipse では,ファイルの保存時に自動的にコンパイルが実行される.コードに文法エラーや警告があれば,画面下部の「問題 (Problems)」ビューに表示されるので確認し,修正する.エラーがある状態ではプログラムを実行できない.

実行

作成した Java プログラムを実行する.

  1. 実行したいクラスを選び,右クリック

    パッケージ・エクスプローラーで,実行したい main メソッドを持つクラスファイル「HelloWorld.java」右クリックする.

  2. 実行 (Run As)」 → 「1 Javaアプリケーション (1 Java Application)」と操作する.

    * もしくは,HelloWorld.java をエディタで開いている状態で,ツールバーの実行ボタン(緑色の再生マーク)をクリックするか,ショートカットキー Alt+Shift+X を押し,次に J を押すという操作でも実行できる.

  3. Eclipse 画面下部の「コンソール (Console)」ビューに,プログラムの出力結果「Hello Java World !」と表示されることを確認する.