Appium针对基于chromium浏览器的驱动appium-c

appium-chromium-driver是Appium的驱动，用于基于Chromium浏览器（例如Chrome）的自动化测试。对基于Chromium浏览器的测试已经有ChromeDrvier，那为何还需要appium-chromium-driver，事实上，本驱动就是基于``ChromeDrvier做了一些对ChromeDriver的封装实现，基础框架和技术与ChromeDriver`完全一致，但是，它有如下几个优势：

• 当Appium环境部署好后，只需要安装该驱动即可自动化测试基于Chromium的浏览器；

• 不需要下载特定的ChromeDrvier版本，本驱动会负责自动下载与浏览器匹配的ChromeDrvier版本；

• 可以利用Appium插件和特性的生态系统优势，ChromeDrvier是不支持的。

备注：appium-chromium-driver是Appium基于ChromeDriver的实现，而ChromeDriver则是遵循W3C的WebDriver规范的实现，WebDriver规范衍生于Selenium WebDriver。可以参考ChromeDriver、Selenium WebDriver、WebDriver参考的简介。

安装

假设已经安装Appium服务端（版本2.0及以上），如果还未安装，可以参考Appium环境搭建。此外假设你已经安装了Chrome浏览器（或其他基于Chromium的浏览器）。

利用如下命令可以查看已经安装的驱动列表信息：

appium driver list

可以看到chromium驱动还未安装，在命令行执行如下命令安装appium-chromium-driver驱动：

appium driver install chromium

使用

要启动一个连接到该驱动的会话，客户端需要提供至少如下三个能力参数：

下面的例子展示了，如何使用上面三个参数就能进行简单的Chrome浏览器自动化测试，与Selenium不同，它无需指定ChromeDriver，Appium会自动根据本设备的Chrome浏览器版本选择（下载）对应的ChromeDriver。也可以指定Chrome和ChromeDriver，具体见更多使用的示例。

from appium.webdriver.appium_service import AppiumService
from appium.options.common.base import AppiumOptions

# 开启服务端
APPIUM_HOST = '127.0.0.1'
APPIUM_PORT = 4723
@pytest.fixture(scope="session")
def start_appium_service():
 server = AppiumService()
 server.start(args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)], timeout_ms=60000)
 yield server
 server.stop()

def create_appium_session_by_chromedriver(custom_opts = None):
 options = AppiumOptions()
 options.set_capability("appium:automationName", "Chromium")
 if custom_opts is not None:
 options.load_capabilities(custom_opts)
 return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)

def test_chrome_on_pc(start_appium_service):
 custom_opts = {
 "platformName": "Linux",
 "browserName": "chrome",
 }
 driver = create_appium_session_by_chromedriver(custom_opts)

 url = "https://gitee.com/"
 driver.get(url=url)
 assert "Gitee" in driver.title
 driver.quit()

能力集

除了所有ChromeDrvier支持的能力集外，本驱动还支持如下能力，主要是用于对WebDriver（ChromeDriver或MsedgeDriver）的管理：

备注：对于Chrome或Chromium，ChromeDriver本身支持的能力集可以通过以goog:chromeOptions为键的字典加入到能力集中；对于MSEdge浏览器，可以通过以ms:edgeOptions为键的字典加入到能力集中。见更多使用的示例。

更多使用的示例

• 指定使用具体版本的ChromeDriver和Chrome

  通过"appium:executable": path指定ChromeDriver的位置，通过"goog:chromeOptions": {"binary": path}指定Chrome位置。

    from appium.webdriver.appium_service import AppiumService
    from appium.options.common.base import AppiumOptions
    
    # 开启服务端
    APPIUM_HOST = '127.0.0.1'
    APPIUM_PORT = 4723
    @pytest.fixture(scope="session")
    def start_appium_service():
     server = AppiumService()
     server.start(args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)], timeout_ms=60000)
     yield server
     server.stop()

    def create_appium_session_by_chromedriver(custom_opts = None):
     options = AppiumOptions()
     options.set_capability("appium:automationName", "Chromium")
     if custom_opts is not None:
     options.load_capabilities(custom_opts)
     return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)
    
    def test_chrome_on_pc_specify_chrome_and_driver(start_appium_service):
     chromedriver_path = "/home/chrometest/chromedriver/chromedriver" # 指定ChromeDriver的路径
     chrome_path = "/home/chrometest/chrome/chrome" # 指定Chrome浏览器的路径
     chromeOptions = {"binary": chrome_path, }
     custom_opts = {
     "platformName": "Linux",
     "browserName": "chrome",
     "appium:executable": chromedriver_path,
     "goog:chromeOptions": chromeOptions
     }
     driver = create_appium_session_by_chromedriver(custom_opts)

     url = "https://gitee.com/"
     driver.get(url=url)
     assert "Gitee" in driver.title
     driver.quit()

• 测试Android设备侧的Chrome浏览器（使用appium-chromium-driver）

  要求：

  1）Android设备已经连接或模拟器(AVD)已经打开

  2）Appium服务端机器上的ChromeDriver与Android设备（或模拟器）上的Chrome浏览器版本匹配，请参考version-selection

  说明：

  通过"goog:chromeOptions": {"androidPackage": "com.android.chrome"}指定打开Android设备上Chrome。

  platformName仍然是Appium服务端机器使用的操作系统。

  from appium.webdriver.appium_service import AppiumService
  from appium.options.common.base import AppiumOptions
  
  # 开启服务端
  APPIUM_HOST = '127.0.0.1'
  APPIUM_PORT = 4723
  @pytest.fixture(scope="session")
  def start_appium_service():
   server = AppiumService()
   server.start(args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)], timeout_ms=60000)
   yield server
   server.stop()
  
  def create_appium_session_by_chromedriver(custom_opts = None):
   options = AppiumOptions()
   options.set_capability("appium:automationName", "Chromium")
   if custom_opts is not None:
   options.load_capabilities(custom_opts)
   return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)
  
  def test_chrome_on_android(start_appium_service):
   chromedriver_path = "/home/chrometest/chromedriver/chromedriver" # 指定ChromeDriver的路径
   chromeOptions = {"androidPackage": "com.android.chrome"}
   custom_opts = {
   "platformName": "Linux",
   "browserName": "chrome",
   "appium:executable": chromedriver_path,
   "goog:chromeOptions": chromeOptions
   }
   driver = create_appium_session_by_chromedriver(custom_opts)
  
   url = "https://gitee.com/"
   driver.get(url=url)
   assert "Gitee" in driver.title
   driver.quit()```