# Eclipse (简体中文)

翻译状态： 本文是英文页面 Eclipse 的翻译，最后翻译时间：2015-03-12，点击这里可以查看翻译后英文页面的改动。

Eclipse 是一个开源的社区项目，它致力于提供一个通用的开发平台。Eclipse 项目最广为人知的是它的跨平台集成开发环境(IDE). Arch Linux 软件包 (以及本文) 只针对于此 IDE。

Eclipse IDE 主要是用 Java 写成，但是可以用来用数种语言开发应用程序，包括 Java, C/C++, PHP 和 Perl. 此 IDE 也可以提供 subversion 支持(见下文) 以及任务管理。

## 安装

安装位于官方软件仓库的软件包eclipse[broken link: replaced by eclipse-java]。

这个基础包内建了 Java 开发支持。

### Eclipse for Java

针对 Java 开发者的 Eclipse IDE 可以安装 AUR 的 eclipse-java 软件包。

## 插件

大部分插件只需 pacman 就可安装 (更多信息见 Eclipse 插件包参考). 这样同时能保证它们是最新的。另外，你也可以使用 #Eclipse Marketplace 或内建的#插件管理器。

### 添加默认更新站点

确保您已配置好针对当前版本的 Eclipse 的更新站点，这样它就能自动安装插件依赖。Eclipse 最新版本是 Luna ，它的更新站点是: http://download.eclipse.org/releases/luna. 转到 帮助 > 安装新软件 > 添加，填写名称后可以轻松地找到更新站点 - 比如，Luna 软件源 - 并填上网址。

### Eclipse Marketplace

注意: 确保您遵循了#添加默认更新站点部分。

要使用 Eclipse Marketplace, 首先要安装: 转到 帮助 > 安装新软件 > 切换到默认更新站点 > 通用工具 > Marketplace 客户端。重启 Eclipse, 之后在 帮助 > Eclipse Marketplace 可以找到。

### 插件管理器

注意: 确保您遵循了#添加默认更新站点部分。

使用 Eclipse 的插件管理器以从官方源下载并安装插件: 这种情况下你需要在插件网站上找到需要的源，然后转到 帮助 > 安装新软件..., 在 Work with 栏目里输入源地址，从下面的列表里选择要安装的插件并遵循教程。

注意:

- 如果你使用 Eclipse 的插件管理器，建议您以 root 身份运行 Eclipse: 这种方法插件会安装到 `/usr/share/eclipse/plugins/`; 如果你以普通用户安装，它们会被存储在 `~/.eclipse/` 下的一个和版本号相关的文件夹里，并且升级 Eclipse 之后插件再也无法被识别。
- 日常工作时不要以 root 身份运行 Eclipse.

#### 通过插件管理器升级

运行 Eclipse 并执行 帮助 > 检查更新。如果你如上以 root 身份安装，那么需要以 root 身份来升级。

对于准备更新的插件，你应该确保已经启用它们的更新源 窗口 > 首选项 > 安装/升级 > 可用软件站点: 你可在各自的网站上找到插件的更新源。要添加/编辑/移除... 源只需使用可用软件站点面板右部的按钮。对于 Eclipse 4.4 (Luna), 检查你是否启用了:

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

要接受更新提示转到 窗口 > 首选项 > 安装/升级 > 自动更新. 如果你想接受以 root 身份安装插件的更新提示，你需要以 root 身份运行 Eclipse. 转到 窗口 > 首选项 > 安装/升级 > 可用软件站点, 选择插件相关的源并导出它们，然后以普通用户运行 Eclipse 并在同样的面板里导入它们。

### 插件列表

- AVR — AVR 微控制器插件。

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

- Aptana — HTML5/CSS3/JavaScript/Ruby/Rails/PHP/Pydev/Django 支持，也可作为独立程序下载。

  http://www.aptana.com/ || eclipse-aptanaAUR[broken link: archived in aur-mirror] aptana-studioAUR

- Eclipse CDT — C/C++ 支持。

  http://www.eclipse.org/cdt/ || eclipse-cdt[broken link: replaced by eclipse-cpp]

- Eclipse PDT — PHP 支持。

  http://www.eclipse.org/pdt/ || eclipse-pdtAUR

- EclipseFP — Haskell 支持。

  http://eclipsefp.github.io/ || eclipse-eclipsefpAUR[broken link: archived in aur-mirror]

- EGit — Git 支持。

  http://www.eclipse.org/egit || eclipse-egitAUR

- EPIC — Perl 支持。

  http://www.epic-ide.org/ || eclipse-epicAUR[broken link: archived in aur-mirror]

- IvyDE — IvyDE 依赖管理器

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

- Markdown — Eclipse 的 Markdown 编辑插件。

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

- MercurialEclipse — Mercurial 支持。

  https://bitbucket.org/mercurialeclipse/main/wiki/Home || eclipse-mercurialAUR

- Mylyn — 任务列表支持。

  http://www.eclipse.org/mylyn/ || eclipse-mylynAUR

- PHPEclipse — 另一 PHP 支持。

  http://www.phpeclipse.com/ || eclipse-phpeclipseAUR

- PyDev — Python 支持。

  http://pydev.org/ || eclipse-pydevAUR

- Subclipse — Subversion 支持。

  http://subclipse.tigris.org/ || eclipse-subclipseAUR

- Subversive — 另一 Subversion 支持。

  http://www.eclipse.org/subversive/ || eclipse-subversiveAUR

- TestNG — TestNG 支持。

  http://testng.org/doc/eclipse.html || eclipse-testngAUR

- TeXlipse — LaTeX 支持。

  http://texlipse.sourceforge.net/ || texlipseAUR[broken link: archived in aur-mirror]

- Eclipse PTP — 并行编程 C/C++ 支持。

  http://www.eclipse.org/ptp/ || eclipse-ptpAUR

## 启用 javadoc 集成

将鼠标指针放在标准 Java 方法的时候想看API条目？

### 在线版本

如果你的机器有不间断的互联网连接，您可以使用在线文档:

1. 转到 窗口 > 首选项, 然后转到 Java > 已安装的 JRE.
2. 应该会有一个类型为 "Standard VM" 的 "java". 选择它并点击 Edit.
3. 选择 "JRE system libraries:" 下的 `/opt/java/jre/lib/rt.jar` 条目然后点击 Javadoc Location....
4. 在 "Javadoc location path:" 文本栏里键入 "http://docs.oracle.com/javase/7/docs/api/".

### 离线版本

你可安装 openjdk8-doc 软件包把文档存储到本地。Eclipse 能够自动找到 javadocs. 如果不起效，针对 rt.jar 把 Javadoc 设置到 `file:/usr/share/doc/java8-openjdk/api`.

## 疑难问题

### 第一次启动或帮助 > 欢迎时崩溃

添加如下内容到 `/usr/share/eclipse/eclipse.ini`:

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

如果安装了 FireFox 也可试试:

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

### Ctrl+X 关闭了 Eclipse

是这个 bug 的一部分。只要看看 `~/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/

解决方案: http://www.eclipse.org/forums/index.php/m/872214/

从 /usr/share/eclipse/plugins/org.eclipse.platform_4.3.xxx/css/ 备份 css 文件夹对版本 4.3.x (Kepler) 也有用。

#### 4.4.0 (Luna)

Luna 提供了暗色主题，可在 首选项 > 外观 再选择 'Dark' 主题启用。

暗色主题使用它自己的颜色而不是 GTK 主题的，如果你想完全使用 GTK 颜色设定的话，从此处删除或移动所有 .css 文件到备份子文件夹: /usr/share/eclipse/plugins/org.eclipse.ui.themes_1.0.0.xxxx/css/

### 使用 Gnome 3.6 Adwaita 主题时"提示"显示为深色背景色

如下取消 `/usr/share/themes/Adwaita/gtk-2.0/gtkrc` 倒数第二行的注释

    #widget "gtk-tooltip*"  style "tooltips"

相关 bug:

- https://bugzilla.gnome.org/show_bug.cgi?id=688285
- https://bugs.eclipse.org/bugs/show_bug.cgi?id=381010 (WONTFIX)

### 切换按钮的选择/未选择状态是一样的

如下取消 `/usr/share/themes/Adwaita/gtk-2.0/gtkrc` 最后一行的注释

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

要应用修改后的主题，使用 `gnome-tweak-tool` 来选择另一主题之后切回 Adwaita.

相关 bug:

- 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

Open the appropriate file with your text editor, ie e4_default_gtk.css if you are using the "GTK theme". 寻找 .MPartStack, 并把字号改成你想要的大小

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

## 另见

- How to use Subversion with Eclipse

Category:

- Development (简体中文)

Hidden category:

- Pages with broken package links