Repolode
投稿する
alipay

alipay/SoloPi

実機でのAndroid UIフローの記録・再生・アサーション・プロファイリングに対応するオープンソースのモバイルテスト自動化ツール。Agentハーネスも利用できます。

GitHub で見る
スター
6,364
フォーク
1,272
未解決の Issue
140
最終コミット
3 日前

これは何？

SoloPiは、モバイルアプリのテスト向けオープンソース自動化ツールです。Android端末でタップ、入力、スクロール、アサーションを記録し、同じ端末や別の端末で再生できます。また、CPU、メモリ、FPS、バッテリー、温度、ネットワークトラフィックなどのパフォーマンスデータを収集でき、アプリのコールドスタート時間とウォームスタート時間も計測できます。

ADB経由で端末に接続でき、ワイヤレスデバッグにも対応しています。また、1台のコントローラー端末から複数のスマートフォンを操作できます。記録したフローは、別のコンバータープロジェクトを使ってAppiumまたはMacacaのスクリプトに変換できます。

リポジトリには、AIエージェント向けコマンドラインハーネスのsolopi-skillも含まれています。実行前に現在のページと照合する型付きの動的アクション、passed、failed、not_testedの結果を返す独立した判定機能、単一ホストでの無人管理実行に対応しています。HarmonyOS版は別ブランチで公開されています。

主な機能

  • 01PC側で記録環境を用意せずに、Android端末上のUI操作を記録・再生できます。
  • 02再生中にUIノードや画像に対するアサーションを実行できます。
  • 03CPU、メモリ、FPS、バッテリー、温度、ネットワークをリアルタイムまたは記録データで監視できます。
  • 04コールドスタートとウォームスタートの所要時間を計測できます。
  • 051台のマスター端末から複数のスレーブ端末を操作できます。
  • 06ページ状態のチェックと独立した結果判定を備えた、型付きのAgentアクションを実行できます。

ユースケース

  • 複数の実機でAndroidアプリのフローを回帰テストする。
  • 1台のコントローラーから多数の端末を対象に互換性テストを行う。
  • CPU、メモリ、ネットワークが制限された条件下で、アプリの起動時間やパフォーマンスを計測する。
  • CIワークフローで、監査可能な証跡を残しながらAIエージェントに端末テストを実行させる。

クイックスタート

  1. 1

    ソースからローカルCLIを実行して、利用可能なアクションを一覧表示する（デバイスは不要）

    ./solopi-skill/scripts/solopi-ai --pretty actions
  2. 2

    CLIを仮想環境にインストールする

    python -m pip install -e ./solopi-skill/scripts/harness
  3. 3

    solopi-appのテスト用およびデバッグ用APKをビルドする

    ./solopi-app/gradlew -p solopi-app :app:testDebugUnitTest :agentmodel:testDebugUnitTest :portal:assembleDebug

使う前に知っておきたいこと

  • オープンソースのデバイス側実装はAndroidのみをサポートしています。
  • 実行には、USBまたはワイヤレスADBデバッグが許可された実機のAndroidデバイスが必要です。
  • ビルドのドキュメントでは、Android Studio 4.0、Gradle 6.1.1、NDK 16など、古いツールチェーンを対象としています。
  • 複数デバイスの制御機能は、まだオープンソース化されていません。

収録されている特集

Android の ADB・不要アプリ削除ツールAndroid アプリとスマホツールテストフレームワークと自動テストツール

トピック

#android#mobile-testing#ui-testing#test-automation#adb#performance-testing#harmony#arkts#automated-testing#automation

よくある質問

SoloPi とは？
実機でのAndroid UIフローの記録・再生・アサーション・プロファイリングに対応するオープンソースのモバイルテスト自動化ツール。Agentハーネスも利用できます。 SoloPiは、モバイルアプリのテスト向けオープンソース自動化ツールです。Android端末でタップ、入力、スクロール、アサーションを記録し、同じ端末や別の端末で再生できます。また、CPU、メモリ、FPS、バッテリー、温度、ネットワークトラフィックなどのパフォーマンスデータを収集でき、アプリのコールドスタート時間とウォームスタート時間も計測できます。
SoloPi は無料で使えますか？ライセンスは？
SoloPi は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
SoloPi は今もメンテナンスされていますか？
活発にメンテナンス中。SoloPi の最終コミットは 2026年11月5日 です。
SoloPi は何に使えますか？
複数の実機でAndroidアプリのフローを回帰テストする。 1台のコントローラーから多数の端末を対象に互換性テストを行う。 CPU、メモリ、ネットワークが制限された条件下で、アプリの起動時間やパフォーマンスを計測する。 CIワークフローで、監査可能な証跡を残しながらAIエージェントに端末テストを実行させる。
SoloPi のインストール方法は？
ソースからローカルCLIを実行して、利用可能なアクションを一覧表示する（デバイスは不要）: ./solopi-skill/scripts/solopi-ai --pretty actions CLIを仮想環境にインストールする: python -m pip install -e ./solopi-skill/scripts/harness solopi-appのテスト用およびデバッグ用APKをビルドする: ./solopi-app/gradlew -p solopi-app :app:testDebugUnitTest :agentmodel:testDebugUnitTest :portal:assembleDebug
SoloPi はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/alipay/SoloPi

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト