eric7 是 Python 语言的集成开发环境。
项目描述
0. eric7是什么？
eric7 是一个功能齐全的 Python 编辑器和 IDE，用 Python 编写。它基于跨平台 Qt UI 工具包，集成了高度灵活的 Scintilla 编辑器控件。它被设计为可用作日常快速而肮脏的编辑器，也可用作专业的项目管理工具，集成了 Python 为专业编码人员提供的许多高级功能。eric7 包含一个插件系统，它允许使用可从网上下载的插件轻松扩展 IDE 功能。有关更多详细信息，请参阅 < https://eric-ide.python-projects.org >。
1.安装
安装 eric7 是一个简单的过程。有多种方法可用。请选择最适合您的需求和技能的一种。eric7 可能是 Python 3、Qt5 和 PyQt5 所必需的。
1.1 为eric7创建Python虚拟环境
建议将 eric7 安装到 Python 虚拟环境中，以保持 Python 发行版的清洁。为此，请在终端窗口中输入以下命令来创建它。
Linux, macOS :
python3 -m venv eric7_venv
窗户：
python.exe -m venv eric7_venv
将eric7_venv替换为虚拟环境目录的所需路径。所有进一步的说明都将采用此环境名称。
1.2a 变体 1：通过“install.py”脚本安装
此方法可在所有受支持的平台上进行最完整的安装。提取 eric7 分发存档后，只需在终端窗口中执行以下命令。
Linux, macOS :
~/eric7_venv/bin/python3 install.py
窗户：
eric7_venv\Scripts\python.exe install.py
适当地更改 Python 可执行文件的路径。安装脚本将检查所有先决条件，并要求确认安装它们。如果安装过程需要调整，请键入 ~/eric7_venv/bin/python3 install.py --help以获得一些帮助。使用 --yes选项自动对所有问题回答“是”。
如果要卸载软件包，只需执行uninstall.py脚本。这摆脱了所有已安装的文件。在这种情况下，请发送电子邮件至以下地址并告诉我您的原因。这可能会给我一个关于如何改进 eric7 的提示。
在安装过程中，将创建一个包含有关安装的一些信息的文件。如果不需要，可以将--no-info 命令行选项添加到上面给出的安装命令中。
1.2b 变体 2：通过 Python 包索引 PyPI 安装
此方法是最简单的方法，但不会创建 macOS® 应用程序。在终端窗口中输入以下命令。
Linux, macOS :
~/eric7_venv/bin/python3 -m pip install --upgrade eric-ide
窗户：
eric7_venv\Scripts\python.exe -m pip install --upgrade eric-ide
安装完成后，导航到 Python 虚拟环境的可执行目录并执行eric7_post_install脚本。这将在 Linux 和桌面上创建应用程序菜单条目，并在 Windows® 平台上创建开始菜单条目。
Linux：
~/eric7_venv/bin/eric7_post_install
窗户：
eric7_venv\Scripts\eric7_post_install.exe
1.3 通过Qt在线安装程序安装Qt Tools
为了充分利用 eric7，建议安装 Qt 工具，如Qt Designer或Qt Linguist。如果执行上面显示的安装变体，这些工具将自动安装。否则，建议按照以下步骤从 Qt 网站获取它们。
从 Qt 下载站点下载 Qt 在线安装程序。
通过执行安装程序安装 Qt。
在 eric7 配置对话框的Qt配置页面上配置 Qt 工具的路径。
2. 安装翻译
eric7 的默认分发存档已经包含所有支持的翻译。如果上面的安装变体 1 是用这个执行的，你可以跳过这个部分。
如果使用了nolang存档，可以稍后通过下载所需的语言包来添加翻译，将其解压缩到临时目录并执行 install-i18n.py 脚本（键入 ~/eric7_venv/bin/python3 install-i18n.py） .
3. 跑步
只需调用 eric7，它将启动 IDE。使用“什么是”-帮助（带 ? 的箭头）获得一些帮助。eric 网站提供了一些描述 eric 某些方面的文档。要在独立变体中启动单元测试模块，只需调用 eric7_unittest。这将显示与从 eric7 中启动相同的对话框（尽管功能少一点）。通过执行 eric7_browser 脚本，可以将 Web 浏览器作为独立程序启动。
请注意，第一次启动 eric7 时，它会识别出它尚未配置，并会显示配置对话框。请花点时间完成所有配置项。但是，每个配置选项都有一个有意义的默认值。
4. 在小显示器的设备上使用 eric
eric 也可用于显示器小于全高清（即小于 1920 x 1080 像素）的设备。如果检测到这样的小屏幕，则会自动选择使用仅左侧边栏的侧边栏的界面。这是无法改变的。如果自动检测失败，可以通过使用“–small-screen”命令行选项启动 eric 来强制使用小屏幕布局。这会更改通过界面 ⇨ 界面配置页面可用的相应设置（选项“布局”和“合并左右侧边栏”。
5. 从源头运行
如果要从源代码树中运行 eric7，则必须在从源存储库重新签出后或添加新对话框后执行一次compileUiFiles.py脚本。此后只需执行eric7.py脚本。
6. 托盘启动器
eric7 带有一个名为“eric7_tray”的小实用程序。这会在系统托盘中嵌入一个图标，其中包含一个用于启动 eric7 及其所有实用程序的上下文菜单。双击此图标将启动 eric7 IDE。
7. 完成/调用提示
eric7 为 QScintilla 完成和调用提示功能提供了一个接口。QScintilla2 带有用于 Python 及其本身的 API 文件。PyQt6 和 PyQt5 也包含 API 文件。这些是默认安装的。如果选择了安装变体 1，则 eric7 的 API 文件将安装在同一位置。
为了在 eric7 中使用完成和调用提示，请在“编辑器 -> APIs”、“编辑器 -> 自动完成”和“编辑器 -> 调用提示”页面的“首选项对话框”中配置这些功能。
通过 eric7 插件系统可以使用其他补全和呼叫提示提供程序。详情见下文。
8. 远程调试器
为了启用远程调试器启动 eric7，打开首选项对话框并配置调试器页面上的设置。
远程登录必须可以在没有任何进一步交互的情况下进行（即没有密码提示）。如果远程设置与本地设置不同，您必须配置 Python 解释器和调试客户端以在“首选项”对话框中使用。使用install-debugclients.py脚本安装调试客户端文件并相应地设置 am 配置页面的条目。
为了简化调试客户端的安装过程，eric7 源包括脚本install-debugclients.py。
9. 被动调试
被动调试模式允许从 IDE 外部启动调试器。IDE 等待连接尝试。有关详细信息，请参阅文件 README-passive-debugging.rst。
10.插件系统
eric7 包含一个插件系统，用于扩展 eric7 的功能。一些插件是 eric7 的一部分。其他插件可通过 Internet 获得。请使用内置插件存储库对话框获取可用（官方）插件列表并下载它们。有关插件系统的更多详细信息，请参阅文档区域。
11. 附加软件包的接口
目前 eric7 提供了以下软件包的接口。
- Qt-设计器
这是 Qt 发行版的一部分，用于生成用户界面。
- Qt语言学家
这是 Qt 发行版的一部分，用于生成翻译。
- Qt 助手
这是 Qt 发行版的一部分，可用于显示帮助文件。
- 水银
这是一个分布式版本控制系统，可从 < https://www.mercurial-scm.org/ > 获得。它是 eric7 自己使用的。
- 吉特
这是另一个（可能更广为人知的）分布式版本控制系统。它可从 < https://www.git-scm.com > 获得。
- 颠覆
这是一个可从 < https://subversion.apache.org >获得的版本控制系统。eric7 支持两种不同的 Subversion 接口。一种是使用svn命令行工具，一种是使用PySvn Python接口< https://pysvn.sourceforge.io/ >。选择是根据安装的软件自动完成的。PySvn 接口是首选。可以使用“用户属性”对话框逐个项目覆盖这种自动化。
- 点子
这是一个从 Python 包索引 (PyPI) 安装其他 Python 包的工具。它可以从 < https://pypi.org/project/pip/ >
- 康达
这是另一个安装附加 Python 包和管理虚拟环境的工具。它可从 < https://github.com/conda/conda > 或 < https://pypi.org/project/conda/ >
- 虚拟环境
这是一个创建 Python 虚拟环境的工具。它可从 < https://pypi.org/project/virtualenv/ >
- 覆盖率.py
这是一个检查 Python 代码覆盖率的工具。稍微修改的版本是 eric7 发行版的一部分。原始版本可从 < http://www.nedbatchelder.com/code/modules/coverage.html >
- 轮廓
这是标准 Python 发行版的一部分，用于分析 Python 源代码。
12.国际化
eric7 及其工具已准备好以不同语言显示 UI，可以通过首选项对话框进行配置。在首选项对话框（Qt 页面）中给出的翻译目录中搜索 Qt 和 QScintilla 翻译。如果找不到翻译，即使您选择了其他内容，HMI 的某些部分也可能会显示英文文本。如果您缺少针对您的语言的 eric7 翻译并且愿意自愿参与这项工作，请给我发送一封电子邮件，注明国家代码，我将向您发送相应的 Qt-Linguist 文件。
13. 窗口布局
eric7 提供了可配置的窗口布局。可以配置各种工具窗格的可见性。外壳窗格的位置也可以配置。
14. 源代码文档
eric7 有一个内置的源代码文档生成器，它也可以通过命令行使用。有关详细信息，请参阅文件 README-eric7-doc.rst。
15. 包含的工具
eric7 附带一长串工具。这些可以通过 eric7 托盘启动器或直接通过命令行启动。它们可从 IDE 中获得。包含的工具是（按字母顺序排序）：
eric7_api.py
这是从 Python 源代码生成 API 文件的工具。
eric7_browser.py
这是 eric7 网络浏览器。它是一个基于 QtWebEngine 的成熟浏览器，它基于 Chromium 网络引擎。
eric7_compare.py
此工具可用于并排比较两个文件。通过对文本着色来突出显示文件之间的差异。
eric7_configure.py
这是配置对话框的独立变体。它提供了 eric7 中可用的大多数配置选项。
eric7_diff.py
此工具可用于查看两个文件之间的差异。这些显示为统一或上下文差异。
eric7_doc.py
这是从源文件中提取源代码文档并将其格式化为 HTML 文件的工具。
eric7_editor.py
这是 eric7 IDE 中嵌入的编辑器的精简、独立变体。
eric7_hexeditor.py
这是一个独立的十六进制编辑器，用于处理二进制文件。
eric7_iconeditor.py
这是一个创建基于像素的图标并将它们保存为像素图格式的小工具。
eric7_plugininstall.py
这是一个独立的实用程序，用于安装本地机器上可用的 eric7 插件。
eric7_pluginrepository.py
这是插件存储库窗口的独立变体。它用于查看可用的插件并将它们下载到本地机器。
eric7_pluginuninstall.py
这是一个用于卸载 eric7 插件的独立实用程序。
eric7_qregularexpression.py
此工具可用于创建基于 QRegularExpression 的正则表达式。
eric7_re.py
此工具可用于创建与 re 模块一起使用的 Python 正则表达式。
eric7_shell.py
这是一个独立的、图形化的 Python shell 应用程序。
eric7_snap.py
此工具可用于创建整个屏幕、单个窗口或可选区域的屏幕截图。
eric7_sqlbrowser.py
这是一个检查 SQL 数据库的简单工具。可以检查 Qt 支持的所有数据库产品。请注意，可以先安装 Qt 数据库驱动程序。
eric7_tray.py
这是托盘启动器应用程序。有关一些详细信息，请参见上文。
eric7_trpreviewer
此工具可用于预览 Qt 表单的翻译。表格和语言文件可以单独加载。可以加载多种语言，并且可以在加载的语言之间切换活动语言。
eric7_uipreviewer
此工具用于预览 Qt 表单。显示可以在可用的 Qt 窗口样式之间切换。
eric7_unittest
这是执行现有单元测试的独立工具。
eric7_virtualenv
这是一个管理 Python 虚拟环境的独立工具。它就像集成窗格并提供相同的功能。
16. 执照
eric7（和 eric7 工具）是在 GPLv3 的条件下发布的。有关详细信息，请参阅单独的许可文件LICENSE.GPL3 。eric7 中包含的第三方软件根据其各自的许可发布，并包含在 eric7 发行版中，以方便使用。
17. Bug 和其他报告
请将错误报告、功能请求或贡献发送到 eric 错误地址。安装 IDE 后，您可以使用帮助菜单的“报告错误...”条目，该条目将发送电子邮件至 < eric-bugs @ eric-ide 。蟒蛇项目。组织>。要请求新功能，请使用“帮助”菜单的“请求功能...”条目，该条目将向 < eric-featurerequest @ eric-ide发送电子邮件。蟒蛇项目。组织>。
或者，可以通过 < https://tracker.die-offenbachs.homelinux.org/ >的 eric7 问题跟踪器报告错误。
