跳到內容

擴充功能 PR 的本地驗證

有時在合併或發布之前，可能有必要驗證遠端驅動程式或外掛程式公關是否適用於特定本機環境。本教學課程說明如何達成此目標。

需求

  • NodeJS 的最新 LTS 版本。查看 Node.js 主頁 以取得下載連結。
  • Appium 伺服器的最新版本。使用下列指令，以確保您已安裝最新版本：npm uninstall appium 和 npm install -g appium。
  • Git 應在本地可用。

安裝

  • 查看 本機公關。還有一個選項（雖然較不靈活，因為您稍後將無法輕鬆擷取此公關的任何變更）只需 下載 並解壓縮本機來源。如果您選擇後面的選項，則不需要 git 工具。
  • 導覽至本機驅動程式或外掛程式資料夾，並從該資料夾執行 npm i。
  • 請確定您尚未安裝指定的驅動程式或外掛程式。請使用 appium driver uninstall <driver_name> 或 appium plugin uninstall <plugin_name> CLI 刪除任何殘留檔案。<driver_name>/<plugin_name> 的值取決於 PR 已準備好的實際驅動程式或外掛程式名稱。如果您不確定需要使用哪個名稱，請檢查 package.json 清單的內容，該內容必須始終位於擷取來源的根資料夾下。您應該在那裡尋找 "appium" -> "driverName" 項目值。
  • 將目前資料夾變更為非驅動程式/外掛程式資料夾根目錄或其子資料夾的資料夾。此外，請確定您的目前工作資料夾不包含任何額外的 package.json 檔案。如果包含，請直接移至不包含任何額外檔案的任何其他資料夾。
  • 執行下列指令，將驅動程式/外掛程式來源連結至 Appium 伺服器：appium driver install --source=local <full_path_to_driver_folder_with_fetched_sources> 或 appium plugin install --source=local <full_path_to_plugin_folder_with_fetched_sources>。
  • 如果 Appium 伺服器正在執行，請停止伺服器，並重新啟動伺服器 (appium server --use-drivers=<driver_name>) 以查看已載入驅動程式的清單。如果連結成功，您必須在伺服器記錄中看到驅動程式名稱及其父資料夾的路徑。對於外掛程式，必須在伺服器啟動時明確要求載入此外掛程式：appium server --use-plugins=<plugin_name>。

更新

在您測試 PR 後，如果發現問題，可能需要使用 Git 中的最新變更更新本機分支。請遵循下列步驟進行操作

  • 移至本機驅動程式/外掛程式的父資料夾，並執行 git pull。
  • 如果 Appium 伺服器正在執行，請停止伺服器。
  • 在本機驅動程式/外掛程式的父資料夾中執行 npm i，以重新建置驅動程式/外掛程式，並在必要時更新任何依賴項。
  • 重新啟動 Appium 伺服器，類似於在上述對應的 安裝 步驟中執行的操作。

切換回穩定版本

合併公關後，不再需要使用本機外掛程式/驅動程式部署，因此切換回由 NPM 管理的套件是有意義的。請遵循下列步驟進行切換

  • 透過執行 appium driver uninstall <driver_name> 或 appium plugin uninstall <driver_name>，取消連結伺服器上已安裝的驅動程式/外掛程式。
  • 刪除本機來源資料夾 (rm -rf <full_path_to_plugin_or_driver_folder_with_fetched_sources>)。
  • 從 NPM 安裝驅動程式或外掛程式。查看元件 README 以找出適當的指令。