ネイティブ、ハイブリッド、モバイルWeb、デスクトップアプリ向けのクロスプラットフォームテスト自動化。
ドキュメント|始めましょう|生態系| Changelog |寄稿ガイド|ディスカッションフォーラム
Appiumは、さまざまなモバイル、デスクトップ、IoTプラットフォームにWebドライバーベースの自動化の可能性を提供するオープンソースオートメーションフレームワークです。 Appiumはモジュラーで拡張可能であり、複数のプログラミング言語をサポートしています。つまり、関連するソフトウェアのエコシステム全体があります。
2022年1月1日の時点で、AppiumチームはAppium 1を維持またはサポートしなくなりました。公式にサポートされているプラットフォームドライバーはすべてAppium 2とのみ互換性があります。
Appium 1を使用している場合は、移行ガイドをお読みください。
警告
AppiumデスクトップまたはAppium Server GUIを使用する場合、これらのツールは両方とも非推奨されているため、Appium 2にアップグレードすることはできません。 Standalone Appium 2サーバーと組み合わせてAppium Inspectorを使用してください。
Appiumはnpmを使用してインストールできます(他のパッケージマネージャーは現在サポートされていません)。システムの要件と詳細については、インストールドキュメントを確認してください。
Appium 1からアップグレードする場合は、Appium 1が完全にアンインストールされていることを確認してください( npm uninstall -g appium )。これが行われていない場合、予期しないエラーが表示される場合があります。
npm i -g appiumこれにより、Core Appium Serverのみがインストールされることに注意してください。これは、それ自体で何も自動化できません。ドライバーを自動化するために、ターゲットプラットフォームのドライバーをインストールしてください。
Appiumは、iOS、Android、MacOS、Windowsなど、さまざまなプラットフォームでアプリの自動化をサポートしています。各プラットフォームは、その特定のプラットフォームを自動化する方法を知っている1人以上の「ドライバー」によってサポートされています。 Appium Ecosystemのドライバーページで、公式にサポートされたサードパーティのドライバーの完全なリストを見つけることができます。
ドライバー管理は、Appiumの拡張コマンドラインインターフェイスを使用して行われます。
# Install an official driver from npm (see documentation for a list of such drivers)
appium driver install < driver-name >
# Install any driver from npm
appium driver install --source=npm < driver-name >
# See documentation for installation from other sources
# List already installed drivers
appium driver list --installed
# Update a driver (it must be already installed)
# This will NOT update the major version, in order to prevent breaking changes
appium driver update < driver-name >
# Update a driver to the most recent version (may include breaking changes)
appium driver update < driver-name > --unsafe
# Uninstall a driver (it won't last forever, will it?)
appium driver uninstall < driver-name > クライアントライブラリは、さまざまなプログラミング言語でAppiumテストを書くことができます。 Java、Python、Ruby、および.Net C#には公式にサポートされているクライアント、および他の言語のサードパーティクライアントがいます。 Appium Ecosystemのクライアントページにクライアントの完全なリストを見つけることができます。
プラグインを使用すると、サーバーコードを変更せずにサーバー機能を拡張できます。ドライバーとプラグインの主な違いは、後者をAppium Serverスタートアップで明示的に有効にする必要があることです(デフォルトでインストールされているすべてのドライバーが有効になっています):
appium --use-plugins= < plugin-name >Appium Ecosystemのプラグインページに、公式にサポートされたサードパーティのプラグインの完全なリストを見つけることができます。
ドライバーと同様に、プラグイン管理は、Appiumの拡張コマンドラインインターフェイスを使用して行われます。
# Install an official plugin from npm (see documentation for a list of such plugins)
appium plugin install < plugin-name >
# Install any plugin from npm
appium plugin install --source=npm < plugin-name >
# See documentation for installation from other sources
# List already installed plugins
appium plugin list --installed
# Update a plugin (it must be already installed)
# This will NOT update the major version, in order to prevent breaking changes
appium plugin update < plugin-name >
# Update a plugin to the most recent version (may include breaking changes)
appium plugin update < plugin-name > --unsafe
# Uninstall a plugin
appium plugin uninstall < plugin-name > Appiumサーバーにコマンドの送信を開始するには、クライアントライブラリがリッスンを期待するURLとポートで実行している必要があります。 Appiumのコマンドラインインターフェイスは、サーバーの起動と構成に使用されます。
# Start the server on the default host (0.0.0.0) and port (4723)
appium server
# You can also omit the 'server' subcommand
appium
# Start the server on the given host, port and use a custom base path prefix (the default prefix is '/')
appium --address 127.0.0.1 --port 9000 --base-path /wd/hubAppiumは、並列サーバープロセスの実行と、単一のサーバープロセス内の並列ドライバーセッションをサポートしています。どのモードが特定のドライバーに最適であるか、または並列セッションをサポートするかどうかについて、対応するドライバーのドキュメントを参照してください。
xcuitestやuiautomator2などの一部のドライバーには、モバイルWebおよびハイブリッドアプリのサポートが組み込まれています。同じスクリプト内で、ネイティブアプリオートメーションとWebView Automationの間でシームレスに切り替えることができます。すべてがWeb自動化の標準であるWebDriverモデルを使用します。WebDriverプロトコルへの投資は、Web標準になったテスト用の単一、無料、およびオープンプロトコルに賭けていることを意味します。独自のスタックに閉じ込めないでください。
たとえば、AppleのAppiumなしでXcuitestライブラリを使用している場合、OBJ-C/Swiftを使用してテストのみを作成することができ、Xcodeを介してテストのみを実行できます。同様に、GoogleのUIAutomatorまたはEspressoを使用すると、Java/Kotlinでテストのみを作成できます。 Appiumは、モバイルなどのための真のクロスプラットフォームネイティブアプリオートメーションの可能性を開きます!
これが何であるかについてのより包括的な説明を探している場合は、Appiumがどのように機能するかについてのドキュメントを読んでください。
Appiumにはスポンサーシッププログラムがあります!あなたまたはあなたの会社がAppiumを使用し、プロジェクトに財政的に還元したい場合、これらの資金を使用して開発と貢献を奨励し、私たちが依存している他のオープンソースプロジェクトをサポートします。 OpenCollectiveページを介してスポンサーになります。
Appiumは、プロジェクト開発とリーダーシップの持続的な貢献について、私たちの開発と戦略的パートナーに非常に感謝しています!


スポンサーの完全なリストは、スポンサーページで入手できます。
Apache-2.0
@appium/loggerパッケージはISCライセンスの下にあります。