alipay/SoloPi

어떤 프로젝트인가요?

핵심 기능

• 01PC에서 별도로 녹화 환경을 설정하지 않고 Android 기기에서 UI 동작을 기록하고 재생합니다.
• 02재생 중 UI 노드와 이미지를 검증합니다.
• 03CPU, 메모리, FPS, 배터리, 온도, 네트워크를 실시간으로 모니터링하거나 기록합니다.
• 04콜드·웜 스타트 시간을 측정합니다.
• 05마스터 기기 하나로 여러 슬레이브 기기를 제어합니다.
• 06페이지 상태 확인과 독립적인 결과 판정을 지원하는 타입 지정 Agent 액션을 실행합니다.

활용 사례

• 실제 휴대폰 여러 대에서 Android 앱 흐름을 회귀 테스트합니다.
• 컨트롤러 하나로 여러 기기에서 호환성을 테스트합니다.
• 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과 같은 구형 도구 체인을 기준으로 합니다.
• !다중 기기 제어 기능은 아직 오픈 소스로 공개되지 않았습니다.

포함된 컬렉션

토픽

자주 묻는 질문

SoloPi은(는) 무엇인가요?

실제 기기에서 Android UI 흐름을 기록·재생하고 검증·프로파일링하는 오픈소스 모바일 테스트 자동화 도구로, Agent harness도 제공합니다. SoloPi는 모바일 앱 테스트를 위한 오픈소스 자동화 도구입니다. Android 기기에서 탭, 입력, 스크롤, 검증 동작을 기록한 뒤 같은 기기나 다른 기기에서 재생합니다. CPU, 메모리, FPS, 배터리, 온도, 네트워크 트래픽 등의 성능 데이터도 수집하며, 앱의 콜드·웜 스타트 시간을 측정할 수 있습니다.

SoloPi은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

SoloPi은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

SoloPi은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. SoloPi의 마지막 커밋은 2026년 11월 5일입니다.

SoloPi은(는) 어디에 사용할 수 있나요?

실제 휴대폰 여러 대에서 Android 앱 흐름을 회귀 테스트합니다. 컨트롤러 하나로 여러 기기에서 호환성을 테스트합니다. 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