Eclipse

Eclipse はユニバーサルな開発プラットフォームを目指している、オープンソースコミュニティプロジェクトです。Eclipse プロジェクトはクロスプラットフォームの統合開発環境 (IDE) として広く知られています。Arch Linux パッケージ (とこのガイド) は IDE を扱っています。

Eclipse IDE は主として Java で書かれていますが Java, C/C++, PHP, Perl, Python など様々な言語によるアプリケーション開発に使うことができます。また、IDE は subversion をサポートしており、タスク管理もできます。

インストール

以下のパッケージのどれかをインストールしてください:

• eclipse-cpp^AUR
• eclipse-java^AUR
• eclipse-php^AUR
• eclipse-jee^AUR
• eclipse-javascript^AUR
• eclipse-rust^AUR

上記のパッケージを複数同時にインストールすることはできません。FS#45577 を参照。上記の中で一番必要なパッケージをインストールした後、別の言語を追加する必要があるときはプラグインを使用してください。

ノート: eclipse-common パッケージは 2020年9月の 4.17-3 より廃止されました。https://aur.archlinux.org/packages/eclipse-java/#pinned-767030

プラグイン

pacman を使うことで多くのプラグインは簡単にインストールできます (詳しくは Eclipse プラグインパッケージガイドラインを見て下さい)。また、pacman を使うことでプラグインは最新状態に保たれます。他に、Eclipse Marketplace や Eclipse 内蔵のプラグインマネージャを使う方法もあります。

デフォルトのアップデートサイトを追加

あなたの使用している Eclipse のバージョンにあった、デフォルトのアップデートサイトが設定されていることを確認してください。プラグインが依存するパッケージは自動的にインストールされます。Eclipse の最新バージョンは Oxygen で、デフォルトのアップデートサイトは次になります: http://download.eclipse.org/releases/oxygen 。Help > Install new Software > Add を選択して、後でアップデートサイトがわかるように名前を付けて下さい。例えば: Oxygen Software Repository。そして url を入力します。

Eclipse Marketplace

ノート: あらかじめデフォルトのアップデートサイトの追加セクションに従ってアップデートサイトを追加しておいて下さい。

Eclipse Marketplace を使用するには、まずインストールを行ってください: Help > Install new software > Switch to the default update site > General Purpose Tools > Marketplace Client を開きます。Eclipse を再起動すれば Help > Eclipse Marketplace から使用することができるようになります。

プラグインマネージャ

ノート: あらかじめデフォルトのアップデートサイトの追加セクションに従ってアップデートサイトを追加しておいて下さい。

Eclipse のプラグインマネージャを使用することで Eclipse のリポジトリからプラグインをダウンロード・インストールすることができます。その場合、プラグインのウェブサイトで必要なリポジトリを確認してから、Help > Install New Software... を開き、Work with フィールドにリポジトリを入力、そして下のリストからインストールするプラグインを選択して指示に従ってください。

ノート:

• Eclipse のプラグインマネージャを使用してプラグインをインストールする場合、root で Eclipse を起動することを推奨します: その場合プラグインは /usr/lib/eclipse/plugins/ にインストールされます。通常ユーザーでインストールした場合、~/.eclipse/ 内のバージョン別のフォルダに保存されるため、Eclipse のアップグレードを行うと認識されなくなります。
• 日常的に Eclipse を root で使用してはいけません。

プラグインマネージャでアップデート

Eclipse を起動して Help > Check for Updates を選択してください。上のセクションで推奨しているように root でプラグインをインストールした場合、root で Eclipse を起動する必要があります。

プラグインをアップデートするために、プラグインのアップデートリポジトリが Window > Preferences > Install/Update > Available Software Sites で有効になっていることを確認してください: プラグインのリポジトリは各プラグインのプロジェクトウェブサイトで確認できます。リポジトリを追加・編集・削除する際は Available Software Sites パネルの右にあるボタンを使ってください。Eclipse 4.5 (Mars) の場合、以下のリポジトリが有効になっていることを確認してください:

http://download.eclipse.org/releases/mars

アップデート通知を受信するには、Window > Preferences > Install/Update > Automatic Updates を開きます。root でインストールしたプラグインの通知を受信したい場合、root で Eclipse を起動して Window > Preferences > Install/Update > Available Software Sites を開き、インストールしたプラグインのリポジトリを選択して Export してください。その後、通常ユーザーで Eclipse を起動してから同じパネルでリポジトリを Import します。

プラグイン一覧

• AVR — AVR マイクロコントローラプラグイン。

http://avr-eclipse.sourceforge.net/wiki/index.php/The_AVR_Eclipse_Plugin || eclipse-avr^AUR

• Aptana — HTML5/CSS3/JavaScript/Ruby/Rails/PHP/Pydev/Django のサポート。スタンドアロンのアプリケーションとしても使えます。

http://www.aptana.com/ || aptana-studio^AUR

• IvyDE — IvyDE 依存関係マネージャ。

https://ant.apache.org/ivy/ivyde/ || eclipse-ivyde^AUR

• Markdown — Eclipse 用の Markdown エディタプラグイン。

http://www.winterwell.com/software/markdown-editor.php || eclipse-markdown^AUR

• PyDev — Python のサポート。

http://pydev.org/ || eclipse-pydev^AUR

• Subclipse — Subversion のサポート。

https://github.com/subclipse/subclipse || eclipse-subclipse^AUR

• Subversive — Subversion のサポート。

https://www.eclipse.org/subversive/ || eclipse-subversive^AUR

• TestNG — TestNG のサポート。

http://testng.org/doc/eclipse.html || eclipse-testng^AUR

• TeXlipse — LaTeX のサポート。

http://texlipse.sourceforge.net/ || eclipse-texlipse^AUR

• Checkstyle — Eclipse Checkstyle のサポート。

http://eclipse-cs.sourceforge.net/ || eclipse-checkstyle^AUR

javadoc との統合を有効にする

Java の標準メソッドにマウスポインタを乗せたときに API エントリを表示する方法。

オンライン版

マシンから常時インターネットに接続している場合、オンラインドキュメントを使うことができます:

1. Window > Preferences から、Java > Installed JREs を開いて下さい。
2. "Standard VM" タイプの "java" が存在するので、それを選択して Edit をクリック。
3. "JRE system libraries:" の下の /opt/java/jre/lib/rt.jar アイテムを選択して、Javadoc Location... をクリック。
4. "Javadoc location path:" テキストフィールドに "https://docs.oracle.com/javase/8/docs/api/" と入力します。

オフライン版

openjdk8-doc パッケージをインストールすることでドキュメントをローカルに保存することが可能です。Eclipse は javadocs を自動的に検出します。自動検出が行われない場合、rt.jar の Javadoc の位置を file:/usr/share/doc/java8-openjdk/api に設定してください。

トラブルシューティング

最初の起動時や Help > Welcome を選択するとクラッシュする

以下の行を /usr/share/eclipse/eclipse.ini に追加してください:

-Dorg.eclipse.swt.browser.UseWebKitGTK=true

Firefox をインストールしている場合は、以下も試して下さい:

-Dorg.eclipse.swt.browser.DefaultType=mozilla

Ctrl+X で Eclipse が終了する

この バグが原因です。~/workspace/.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi を開いて Ctrl+X のコンビネーションを削除してください。一番最初にあります。

Eclipse 4 に暗い/カスタムした gtk テーマが反映されず背景が白くなる

4.2.0 と 4.3.0

次のディレクトリから全ての .css ファイルを削除あるいはバックアップフォルダに移動してください: /usr/share/eclipse/plugins/org.eclipse.platform_4.2.0.v201206081400/css/。

ソース: https://www.eclipse.org/forums/index.php/m/872214/

バージョン 4.3.x (Kepler) の場合、/usr/share/eclipse/plugins/org.eclipse.platform_4.3.xxx/css/ から css フォルダをバックアップしてください。

4.4.0 (Luna)

Luna には Dark テーマが存在し、Preferences > Appearance から 'Dark' テーマを選択することで有効にできます。

ダークテーマは GTK のテーマカラーではなく独自の色を使用します。GTK の色設定を完全に反映させたい場合、次のフォルダから全ての .css ファイルを削除してください: /usr/share/eclipse/plugins/org.eclipse.ui.themes_1.0.0.xxxx/css/。

Adwaita テーマを使っている場合にツールチップの背景色が暗くなる

GTK+ 3 の無効化セクションの手順で SWT_GTK3 を無効化してから公式リポジトリの webkitgtk2^AUR パッケージをインストールすることで旧テーマが使えます。

トグルボタンの状態が選択している時も選択していない時も変わらない

/usr/share/themes/Adwaita/gtk-2.0/gtkrc の最後の行を以下のようにコメントアウトしてください:

#widget "*swt*toolbar*" style "null"

修正済みのテーマを適用するには、gnome-tweak-tool で一度違うテーマを選択してから Adwaita に戻します。

関連するバグ:

• https://bugzilla.gnome.org/show_bug.cgi?id=687519

デフォルトのウィンドウタイトルのフォントサイズを変更

Eclipse の設定からウィンドウタイトルのフォントサイズを変更することはできません。テーマの .css ファイルを編集する必要があります。Eclipse のアップデートで、変更した設定は戻ってしまうので注意してください。編集するファイルは以下のディレクトリにあります:

/usr/share/eclipse/plugins/org.eclipse.platform_4.3.<your version number>/css

テキストエディタで適切なファイルを開いて下さい。例えば "GTK theme" を使用している場合、e4_default_gtk.css を編集します。ファイルの中にある .MPartStack を探して、font-size を適当なサイズに変更してください:

.MPartStack {
       font-size: 9;
       swt-simple: false;
       swt-mru-visible: false;
}

GTK+ 3 の無効化

SWT GTK+ 3 UI が使い物にならない場合、Eclipse を起動するときに SWT_GTK3=0 環境変数を使うことで GTK+ 3 の使用を無効にすることができます:

SWT_GTK3=0 eclipse

また、/usr/lib/eclipse/eclipse.ini に以下を追加することでも同じ効果が適用されます:

--launcher.GTK_version
2

上記の2行は以下の文字列よりも前に追加してください:

--launcher.appendVmargs

webkitgtk2^AUR パッケージがインストールされていない場合、上記の設定を行うと、Javadoc のポップアップが正しく表示されなくなるので注意してください。

クイックアウトラインや型階層の文字が読めない

GTK2 バックエンドを使用している場合、テーマを編集することで解決できます。以下を e4_default_gtk.css に追加してください:

Tree {
  color: black;
}

GTK3 バックエンドでは、この問題は既に解決済みです。詳しくは https://bugs.eclipse.org/bugs/show_bug.cgi?id=492376 を参照。

Freshplayerplugin

Eclipse は freshplayerplugin^AUR と互換性がありません。https://github.com/i-rinat/freshplayerplugin/issues/298 を見てください。

Eclipse 4.6 で Marketplace が開けない

こちらのバグ を見てください。以下のコマンドで解決できます:

# eclipse -consoleLog -application org.eclipse.equinox.p2.director -uninstallIU org.apache.httpcomponents.httpclient/4.3.6.v201411290715
# rm /usr/lib/eclipse/plugins/org.apache.httpcomponents.httpclient_4.3.6.v201411290715.jar

Show in System Explorer が機能しない

こちらのガイド を見てください。Window > Preferences > General > Workspace からシステムエクスプローラを起動するコマンドを変更してください。Xfce ユーザーであれば thunar ${selected_resource_uri} に変更することでフォルダを Thunar で開けます。

Wayland で表示がおかしい

Wayland で Eclipse を実行した場合、マウスの動きに対して反応が遅かったり、ダイアログウィンドウが切れてしまうことがあります (バグレポート: [1])。XWayland で Eclipse を実行することで一時的に問題を回避することができます。

root で /usr/bin/eclipse ファイルを開いて exec 行の前に以下の行を追加してください:

export GDK_BACKEND=x11

これで XWayland で Eclipse が実行されるようになります。

参照

• How to use Subversion with Eclipse