Airtest

エアテスト・

ゲームやアプリ向けのクロスプラットフォームUIオートメーションフレームワーク

跨平台的ui自动化框架、适用于游戏和アプリ（中文版点这里）

特徴

• 一度書いて、どこでも実行： Airtestは、アプリのインストール、シミュレートされた入力、アサーションなどを含むクロスプラットフォームAPIを提供します。 Airtestは、画像認識テクノロジーを使用してUI要素を見つけて、コードを注入せずにゲームやアプリを自動化できるようにします。

• 完全にスケーラブル： Airtestケースは、コマンドラインまたはPython APIを使用して、大規模なデバイスファームで簡単に実行できます。 HTMLレポートで詳細な情報と画面記録を使用すると、故障ポイントをすばやく見つけることができます。 NetEaseは、Airtestプロジェクトの上にAirlabを構築します。

• AirTestide： AirTestideは、ユーザーフレンドリーな方法でケースを作成および実行するのに役立つボックス外のGUIツールです。 AirTestideは、完全な自動化ワークフローをサポートしています： create -> run -> report 。

• Poco： Pocoは、主要なプラットフォームとゲームエンジン全体でオブジェクト（UIウィジェット）階層に直接アクセスする機能を追加します。これにより、Pythonで指示を書くことができ、より高度な自動化を実現できます。

Airtest Homepageから始めましょう

サポートされているプラ​​ットフォーム

インストール

pipを使用して、Airtest Pythonライブラリをインストールします。

pip install -U airtest

MacOS/Linuxプラットフォームでは、ADBの実行許可を付与する必要があります。

 # for mac
cd {your_python_path}/site-packages/airtest/core/android/static/adb/mac
# for linux
# cd {your_python_path}/site-packages/airtest/core/android/static/adb/linux
chmod +x adb

GUIツールを使用する必要がある場合は、ホームページからAirTestideをダウンロードしてください。

ドキュメント

Readthedocsで完全なAirtestドキュメントを見つけることができます。

例

AirTestは、プラットフォームに依存しないAPIを提供することを目的としているため、自動ケースを1回記述して複数のデバイスとプラットフォームで実行できます。

1. Connect_Device APIを使用すると、Android/iOSデバイスまたはWindowsアプリケーションに接続できます。
2. 次に、シミュレートされた入力を実行して、ゲームまたはアプリを自動化します。
3. 期待される結果を主張することを忘れないでください。

 from airtest . core . api import *

# connect an android phone with adb
init_device ( "Android" )
# or use connect_device api
# connect_device("Android:///")

install ( "path/to/your/apk" )
start_app ( "package_name_of_your_apk" )
touch ( Template ( "image_of_a_button.png" ))
swipe ( Template ( "slide_start.png" ), Template ( "slide_end.png" ))
assert_exists ( Template ( "success.png" ))
keyevent ( "BACK" )
home ()
uninstall ( "package_name_of_your_apk" )

詳細については、AirTest Python APIリファレンスを参照するか、APIコードをご覧ください

cliからの.airケース

AirTestideを使用して、自動化されたケースを.air Directoriesとして簡単に作成できます。 Airtest CLIは、エアテスチド自体を使用せずに、さまざまなホストマシンとターゲットデバイスプラットフォームでケースを実行する可能性を提供します。

 # run cases targeting on Android phone connected to your host machine via ADB
airtest run " path to your .air dir " --device Android:///

# run cases targeting on Windows application whose title matches Unity.*
airtest run " path to your .air dir " --device " Windows:///?title_re=Unity.* "

# generate HTML report after running cases
airtest report " path to your .air dir "

# or use as a python module
python -m airtest run " path to your .air dir " --device Android:///

提供されairtest/playground/test_blackjack.air例を実行してみてください。これがマルチデバイスランナーサンプルです。

貢献

プルリクエストは大歓迎です。

ありがとう

このプロジェクトを改善するこれらすべての素晴らしい作品に感謝します。

• STF
• ATX
• ピウィナウート