chromedriver-helper 技术文档

1. 安装指南

1.1 使用 Bundler 安装

在项目的 Gemfile 中添加以下内容：

gem "selenium-webdriver"
gem "chromedriver-helper"

然后运行以下命令安装 gem：

bundle install

1.2 手动安装

如果你不使用 Bundler，可以直接通过以下命令安装：

gem install chromedriver-helper

2. 项目的使用说明

2.1 在 Rails 项目中使用

如果你在 Rails 项目中使用 Capybara 和 Selenium，可以在 Gemfile 中添加以下内容：

gem "selenium-webdriver"
gem "chromedriver-helper"

然后在你的测试配置中注册驱动：

Capybara.register_driver :selenium do |app|
  Capybara::Selenium::Driver.new(app, :browser => :chrome)
end

2.2 独立使用

如果你只是想管理 chromedriver 二进制文件，可以在 Gemfile 中添加：

gem "chromedriver-helper"

然后直接运行以下命令：

chromedriver-helper

该命令会自动下载并运行 chromedriver。

3. 项目 API 使用文档

3.1 配置选项

chromedriver-helper 支持通过 Capybara::Selenium::Driver.new 传递一些命令行选项。支持的选项包括：

• log_path
• url_base
• port_server
• whitelisted_ips
• verbose
• silent

示例：

Capybara::Selenium::Driver.new(app, browser: :chrome,
  driver_opts: {
    log_path: '/tmp/chrome.log',
    verbose: true
  })

3.2 更新到最新版本

你可以通过以下命令更新到最新版本的 chromedriver：

chromedriver-update

如果更新遇到问题，可以尝试删除 $HOME/.chromedriver-helper 目录并重新运行更新命令。

3.3 指定版本

如果你想在项目中指定特定版本的 chromedriver，可以在测试配置中设置版本：

Chromedriver.set_version "2.24"

或者通过命令行设置系统默认版本：

chromedriver-update 2.24

4. 项目安装方式

4.1 通过 Bundler 安装

在 Gemfile 中添加：

gem "chromedriver-helper"

然后运行：

bundle install

4.2 手动安装

直接运行以下命令：

gem install chromedriver-helper

4.3 更新安装

运行以下命令更新到最新版本：

chromedriver-update

4.4 指定版本安装

通过命令行指定版本：

chromedriver-update 2.24

5. 常见问题

5.1 chromedriver-helper 影响其他项目

在 v1.2.0 及更早版本中，chromedriver-helper 安装了一个名为 chromedriver 的可执行文件，可能会导致系统上其他未使用 chromedriver-helper 的项目出现问题。v2.0.0 及更高版本已修复此问题。

5.2 CentOS 6 和 7 上的问题

某些版本的 chromedriver 在 CentOS 6 和 7 上无法运行，可以通过运行 install_chrome.sh 脚本并设置 LD_LIBRARY_PATH 来解决。

LD_LIBRARY_PATH=/opt/google/chrome/lib chromedriver-helper