MPI · USER GUIDE

첫 연결부터 측정 완료까지

필요한 준비를 확인하고, 내 기기에 맞는 방법으로 연결하세요. 측정 중 지켜야 할 사항과 문제가 생겼을 때의 해결 순서도 함께 안내합니다.

데스크톱 앱 다운로드계정·이용 한도 확인

현재 배포 중인 Windows 10 / 11 (64-bit) 데스크톱 앱 기준입니다. AOS는 Android를 뜻합니다. 기기 제조사·OS·앱 버전에 따라 설정 이름과 제공 지표가 다를 수 있습니다.

시작 전 준비

PC와 데스크톱 앱

공식 다운로드 페이지에서 MPI를 설치하세요. 브라우저 사이트는 계정·결과 확인용이며, 기기 연결과 측정 시작은 데스크톱 앱에서 진행합니다.

계정과 인터넷

데스크톱 앱에서 MPI 계정에 로그인하고 측정 가능 시간을 확인하세요. 측정 시작 시 계정과 한도를 확인할 수 있는 인터넷 연결이 필요합니다. 클라우드 저장 한도도 별도로 확인하세요.

실기기와 데이터 케이블

측정할 앱이 설치된 Android 또는 iPhone과 데이터 전송이 가능한 USB 케이블을 준비하세요. 충전 전용 케이블은 사용할 수 없습니다. 최초 무선 연결 준비에도 USB가 필요합니다.

연결 도구와 권한

Android는 Android SDK Platform-Tools(adb)가 필요합니다. Windows에서 제조사 USB 드라이버가 추가로 필요할 수 있습니다. iOS는 Apple 기기 앱의 인식·신뢰 상태와 MPI의 iOS 준비 배지를 확인하세요.

연결 방법 선택

처음에는 USB로 기기 인식과 권한 승인을 완료하세요. 무선은 PC와 휴대폰이 서로 통신할 수 있는 같은 로컬 네트워크에서 준비합니다. 연결 방식을 바꿀 때는 진행 중인 측정을 먼저 종료하세요.

AOS · Android 유선 연결

USB 디버깅을 허용하고 기기를 선택합니다.

iOS · iPhone 유선 연결

컴퓨터 신뢰, 개발자 모드, iOS 준비 상태를 확인합니다.

AOS · Android 무선 연결

USB 연결을 먼저 완료한 뒤 Wireless로 전환합니다.

iOS · iPhone 무선 연결

USB로 Wi-Fi 연결을 켠 뒤 안내에 맞춰 케이블을 분리합니다.

유선 연결

USB

AOS · Android 유선 연결

USB 디버깅을 허용하고 기기를 선택합니다.

먼저 준비하세요

  • Android SDK Platform-Tools를 설치하고 adb를 Windows PATH에 추가한 뒤 MPI를 다시 실행하세요.
  • 휴대폰에서 개발자 옵션을 켜세요. 일반적으로 설정의 휴대전화 정보에서 빌드 번호를 7번 누릅니다. 제조사에 따라 위치가 다릅니다.

이 순서로 진행하세요

  1. 개발자 옵션에서 USB 디버깅을 켜고, 휴대폰 잠금을 해제한 상태로 PC에 USB 케이블을 연결하세요.
  2. 휴대폰에 표시되는 USB 디버깅 허용 요청을 확인하고, 본인이 사용하는 신뢰할 수 있는 PC에만 허용하세요.
  3. MPI의 실시간 측정 화면에서 USB를 선택하세요. 기기 목록을 새로고침하고 연결한 Android 기기를 선택하세요. OS는 자동으로 감지됩니다.
  4. 기기에서 측정할 앱을 실행하고 MPI에서 같은 앱을 선택하세요. 시작 전 앱이 화면에 보이는지 확인하세요.

연결 완료 확인

기기 이름과 앱 목록이 표시되고 권한 오류 없이 선택할 수 있으면 측정을 준비할 수 있습니다.

기억하세요

충전만 되고 기기가 보이지 않으면 데이터 케이블·USB 포트·디버깅 승인·제조사 드라이버 순서로 확인하세요. 필요하면 USB 연결 용도를 파일 전송으로 바꿔 다시 시도하세요.

USB

iOS · iPhone 유선 연결

컴퓨터 신뢰, 개발자 모드, iOS 준비 상태를 확인합니다.

먼저 준비하세요

  • Windows에 Apple 기기(Apple Devices) 앱을 설치하고 iPhone이 인식되는지 확인하세요.
  • iPhone의 잠금을 해제하고 데이터 전송용 케이블로 연결하세요. iOS 16 이상은 개발자 모드도 확인하세요.
첫 설치에서 iPhone이나 iOS 준비 배지가 보이지 않나요?

iOS 도구가 없는 상태에서는 기기를 찾지 못해 준비 배지도 보이지 않을 수 있습니다. Python 3.11 이상을 설치하며 PATH에 추가한 뒤 새 PowerShell 창에서 다음 명령으로 MPI가 지원하는 도구를 설치하세요.

python -m pip install --upgrade "pymobiledevice3>=9.13,<10" zeroconf

MPI를 완전히 종료했다가 다시 실행하고 USB 기기 목록을 새로고침하세요. iPhone을 선택하면 준비 배지를 확인할 수 있습니다. 기기가 계속 보이지 않으면 Apple 기기 앱의 인식·신뢰 상태부터 다시 확인하세요.

이 순서로 진행하세요

  1. PC와 iPhone에 표시되는 신뢰 요청을 확인하고 iPhone에서 “이 컴퓨터를 신뢰”를 승인하세요. 요청되면 기기 암호를 직접 입력하세요.
  2. iPhone의 설정 → 개인정보 보호 및 보안 → 개발자 모드를 켜고 재시동 후 활성화를 확인하세요. 메뉴가 없다면 아래 개발자 모드 FAQ를 확인하세요.
  3. MPI의 실시간 측정 화면에서 USB를 선택하고 iPhone을 선택하세요. OS는 자동으로 감지됩니다. 준비 배지에 설치 안내가 있으면 “자동 설치”를 사용하세요. 기기나 배지가 보이지 않으면 위의 첫 설치 안내를 따라 도구를 준비하세요.
  4. iOS 17 이상에서 터널이 필요하다고 나오면 “자동 설정”을 실행하고 Windows 관리자 권한(UAC) 요청을 승인하세요. 이 설정은 백그라운드 터널을 실행하는 로그인 예약 작업을 등록합니다.
  5. iOS 준비 상태를 다시 확인하고 측정할 앱을 선택하세요. iPhone에서 대상 앱을 실행한 상태로 측정을 시작하세요.

연결 완료 확인

기기와 앱이 표시되고, 필요한 iOS 도구와 터널이 준비된 상태인지 확인하세요. USB로 보여도 터널이 준비되지 않으면 최신 iOS의 측정이 실패할 수 있습니다.

기억하세요

관리되는 PC·기기에서 관리자 권한이나 개발자 모드가 제한되어 있으면 관리자에게 허용 여부를 확인하세요. 회사의 보안 설정을 임의로 해제하지 마세요.

무선 연결

Wi-Fi

AOS · Android 무선 연결

USB 연결을 먼저 완료한 뒤 Wireless로 전환합니다.

먼저 준비하세요

  • 위 Android 유선 연결을 먼저 완료하고 USB 케이블을 연결한 상태로 두세요.
  • 휴대폰 Wi-Fi를 켜고 PC와 같은 신뢰할 수 있는 로컬 네트워크에 연결하세요. 게스트 Wi-Fi·AP 격리 환경에서는 기기 간 통신이 막힐 수 있습니다.

이 순서로 진행하세요

  1. 진행 중인 측정을 종료하고 실시간 측정 화면에서 Wireless를 선택하세요.
  2. 연결된 Android USB 기기를 선택하면 MPI가 무선 연결 준비를 자동으로 시도합니다. 준비 중에는 USB를 분리하거나 연결 방식을 바꾸지 마세요.
  3. MPI에 “무선 연결됨”과 기기 이름이 표시되면 USB 케이블을 분리하세요.
  4. 선택된 무선 기기가 계속 표시되는지 확인하고, 대상 앱을 실행·선택한 뒤 새 측정을 시작하세요. 실패하면 USB 연결과 네트워크를 확인한 뒤 “무선 전환 다시 시도”를 사용하세요.

연결 완료 확인

케이블을 분리한 뒤에도 무선 기기를 선택할 수 있고 앱 목록을 불러올 수 있어야 합니다.

기억하세요

MPI의 이 절차는 USB에서 ADB TCP/IP 연결을 준비하는 방식입니다. Android의 “무선 디버깅” 페어링 코드·QR 코드를 MPI에 입력하는 방식은 제공하지 않습니다. 기기 재부팅이나 네트워크 변경 후에는 USB 준비가 다시 필요할 수 있습니다.

Wi-Fi

iOS · iPhone 무선 연결

USB로 Wi-Fi 연결을 켠 뒤 안내에 맞춰 케이블을 분리합니다.

먼저 준비하세요

  • 위 iOS 유선 연결과 신뢰 승인을 먼저 완료하세요. USB에서 iPhone을 선택한 상태로 준비 배지의 터널 실행 상태를 확인한 뒤 전환하세요.
  • PC와 iPhone을 같은 Wi-Fi 네트워크에 연결하고, 연결 준비 중에는 iPhone의 잠금을 해제한 상태로 유지하세요.

이 순서로 진행하세요

  1. USB가 연결된 상태에서 측정을 종료한 뒤 MPI에서 Wireless를 선택하세요. 연결된 iPhone USB 기기를 선택하면 무선 준비가 자동 시작됩니다.
  2. “iOS Wi-Fi 연결이 켜졌습니다… USB 케이블을 뽑으세요”라는 안내가 표시되면 USB를 분리하세요. 이 메시지는 무선 전환을 계속하기 위한 단계입니다.
  3. iPhone의 잠금을 해제한 상태로 두고 백그라운드 iOS 터널이 Wi-Fi로 다시 연결되도록 기다리세요. 전환 중에는 준비 배지가 보이지 않을 수 있습니다.
  4. “무선 기기 직접 선택”으로 기기를 찾고 선택하세요. 대상 앱을 실행·선택한 뒤 새 측정을 시작하세요. 다시 나타나지 않으면 USB로 돌아가 iPhone을 선택한 다음 신뢰·Wi-Fi·준비 배지의 터널 상태를 확인하세요.

연결 완료 확인

USB를 분리한 상태에서 무선 기기가 표시되고 앱 목록이 로드되며 필요한 터널이 준비되어야 합니다.

기억하세요

Apple 기기 앱의 Wi-Fi 동기화 설정만으로 MPI 측정 준비가 완료되는 것은 아닙니다. 최신 iOS는 무선에서도 측정용 터널이 필요하며 네트워크·OS 환경에 따라 연결이 제한될 수 있습니다.

측정과 결과 확인

  1. 대상과 조건 확인

    기기·앱 선택이 맞는지 확인하고 대상 앱을 화면에 띄우세요. 비교 측정은 그래픽 설정, 화면 밝기, 충전 여부, 시작 온도와 네트워크 조건을 가능한 한 동일하게 맞추세요.

  2. 측정 시작

    로그인과 잔여 시간을 확인한 뒤 측정을 시작하세요. “자동 측정 종료”를 설정하면 시간이 되었을 때 대상 앱도 종료됩니다. 앱의 중요한 작업을 먼저 저장하세요.

  3. 측정 중 상태 유지

    대상 앱을 전면에 유지하세요. 앱 종료·백그라운드 전환으로 측정이 끝날 수 있습니다. 기기가 지나치게 뜨거워지면 측정을 멈추고 식힌 뒤 다시 시작하세요.

  4. 종료 후 로컬 결과 확인

    측정을 종료하고 세션과 그래프를 확인하세요. “데이터(xlsx) 저장”으로 리포트를 내보낼 수 있습니다. 기본 저장 위치는 문서 폴더의 MPI/Raw이며, 앱 종료 시 생성되는 복구용 일부 데이터는 MPI/Recovery/Raw에 저장됩니다. 연결 끊김 뒤에는 저장된 구간부터 확인하세요.

  5. 클라우드·외부 전송 확인

    로컬 저장과 클라우드·외부 전송의 결과를 각각 확인하세요. 클라우드 동기화가 실패하면 로컬 원본을 보관하고, 원래 계정으로 로그인해 인터넷·저장 한도를 확인한 뒤 MPI 클라우드의 “대기 세션 다시 전송”을 사용하세요.

해야 할 일과 피해야 할 일

이렇게 이용하세요

  • 본인 소유이거나 측정 권한이 있는 기기와 앱을 사용하고, 신뢰하는 PC·네트워크에만 디버깅과 신뢰 권한을 허용하세요.
  • 측정 종료와 결과 저장을 확인한 뒤 케이블을 분리하거나 연결 방식을 바꾸세요.
  • 무선 디버깅을 사용한 뒤에는 필요에 따라 USB 디버깅을 끄고 기기를 재부팅해 네트워크 디버깅 세션을 종료하세요.
  • 외부 엔드포인트는 본인이 관리하거나 신뢰하는 주소인지 확인하고, 결과를 공유하기 전에 기기 식별자와 앱 정보 등을 검토하세요.

이 행동은 피하세요

  • 측정 도중 화면을 잠그거나 다른 앱으로 전환하지 마세요. Android Companion 대시보드를 여는 것도 대상 앱을 백그라운드로 보낼 수 있습니다.
  • Android는 무선 연결 성공 전, iOS는 케이블 분리 안내 전에 USB를 임의로 뽑지 마세요. USB와 Wireless를 반복해서 전환하거나 여러 도구에서 동시에 같은 기기의 디버깅 연결을 바꾸지 마세요.
  • 공용 Wi-Fi에서 ADB TCP/IP 연결을 사용하거나 인터넷에 디버깅 포트를 공개하지 마세요.
  • 연결 오류를 해결하려고 백신·방화벽 전체를 끄거나 기기를 초기화하지 마세요. 저장 실패 상태에서 원본 세션을 삭제하거나 앱을 제거하지 마세요.

자주 묻는 질문·문제 해결

USB로 충전은 되는데 Android 기기가 보이지 않아요.

데이터 전송 지원 케이블로 PC의 다른 USB 포트에 직접 연결해 보세요. 휴대폰 잠금을 해제하고 개발자 옵션의 USB 디버깅과 승인 창을 확인하세요.

Windows에서 필요한 제조사 USB 드라이버와 Android Platform-Tools 설치를 확인하세요. adb를 PATH에 추가했다면 MPI를 완전히 종료했다가 다시 실행하고 목록을 새로고침하세요.

unauthorized 또는 USB 디버깅 권한 오류가 나요.

휴대폰 화면에서 해당 PC의 USB 디버깅 요청을 허용하세요. 팝업이 없다면 케이블을 다시 연결하세요.

계속 실패하면 개발자 옵션의 “USB 디버깅 승인 취소” 후 재승인을 시도할 수 있습니다. 이 작업은 기존 PC의 디버깅 승인도 취소하므로 다른 연결에 미칠 영향을 먼저 확인하세요.

무선 연결이 안 되거나 자주 끊겨요.

휴대폰 Wi-Fi가 실제로 켜져 있는지, PC와 같은 로컬 네트워크인지 먼저 확인하세요. 모바일 데이터만 켜진 상태로는 이 절차를 사용할 수 없습니다.

게스트 Wi-Fi, 공유기의 기기 격리, VPN 또는 방화벽 정책이 기기 간 통신을 막는지 확인하세요. 신뢰하는 사설 네트워크에서 다시 시도하고, 임의로 보안 정책을 해제하지 마세요.

기기를 재부팅했거나 IP·네트워크가 바뀌었다면 USB부터 다시 준비하세요. 측정 중 끊겼다면 저장된 결과를 확인한 뒤 새 측정을 시작하세요.

iPhone의 신뢰 요청이 없거나 페어링 오류가 나요.

iPhone을 잠금 해제하고 USB로 다시 연결하세요. 먼저 Apple 기기 앱에서 기기가 보이는지 확인한 뒤 PC·iPhone의 신뢰 요청을 승인하세요.

다른 케이블·포트, Apple 기기 앱 업데이트, PC·iPhone 재시동 순서로 확인하세요. 계속 실패하면 아래 Apple 신뢰 안내를 참고하세요. 위치 및 개인정보 보호 재설정은 기존 신뢰와 권한에 영향을 주므로 마지막 수단으로 검토하세요.

iPhone에 개발자 모드 메뉴가 보이지 않아요.

컴퓨터와의 페어링을 먼저 진행하고 설정 → 개인정보 보호 및 보안을 다시 확인하세요. OS·기기 관리 정책에 따라 메뉴가 없거나 제한될 수 있습니다.

Apple 공식 개발자 모드 안내를 확인하세요. 관리 기기는 관리자에게 문의하고, 메뉴가 없다는 이유로 기기 초기화나 탈옥을 시도하지 마세요.

iOS 도구나 터널 준비에 실패해요.

USB로 연결한 iPhone을 선택하고 iOS 준비 배지에서 필요한 항목을 확인하세요. 설치 안내는 “자동 설치”, 터널 미실행은 “자동 설정”으로 진행합니다. 기기·배지가 전혀 보이지 않으면 위 iOS 유선 연결의 첫 설치 안내로 Python과 도구를 준비하세요.

iOS 17 이상은 USB 연결에서도 터널이 필요합니다. Windows 관리자 권한 요청을 취소했다면 다시 설정하세요. 신뢰 승인·개발자 모드·잠금 해제 상태를 확인하고 준비 상태를 새로 확인하세요.

iOS 무선 준비에서 “USB를 뽑으세요”가 표시돼요.

Wi-Fi 연결 설정이 완료되어 다음 단계로 진행하라는 안내입니다. 이 메시지가 나타난 뒤 케이블을 분리하고, 같은 Wi-Fi에서 iPhone의 잠금을 해제한 상태로 기다리세요.

터널이 Wi-Fi로 다시 연결되면 “무선 기기 직접 선택”을 사용하세요. 기기가 보이지 않으면 터널 실행 상태와 네트워크를 확인하고 USB로 재연결해 다시 준비하세요.

앱이 목록에 없거나 측정이 바로 종료돼요.

기기에서 대상 앱을 직접 실행한 뒤 앱 목록을 새로고침하고 다시 선택하세요. 선택한 기기·앱이 실제 실행 중인 것과 같은지 확인하세요.

앱 종료, 화면 잠금, 다른 앱 전환으로 대상 앱이 전면에서 사라지면 측정이 종료될 수 있습니다. 대상 앱을 화면에 유지하고 새 측정을 시작하세요.

FPS·GPU·온도 등이 비어 있거나 기기마다 달라요.

기기·OS·권한에 따라 제공되는 지표가 다릅니다. 빈 값은 0이나 고장이라는 뜻이 아니며, 모든 기기에서 모든 지표를 제공하지는 않습니다.

연결·권한·iOS 준비 상태를 확인한 뒤에도 특정 지표만 없다면 지원 범위를 고려해 제공되는 지표로 비교하세요. 충전 상태·온도·그래픽 설정 등 측정 조건도 맞추세요.

로그인했는데 측정 시작이나 클라우드 저장이 안 돼요.

데스크톱 앱과 사이트가 같은 계정인지 확인하고, 세션이 만료되었다면 다시 로그인하세요. 인터넷과 계정의 잔여 측정 시간·클라우드 저장 한도를 확인하세요.

한도 확인에 실패하면 측정이 시작되지 않을 수 있습니다. 이미 수집한 데이터는 로컬 저장 여부를 확인하고 보관하세요. 플랜 변경 전에는 계정 페이지에서 실제 사용량을 확인하세요.

저장·업로드·외부 엔드포인트 전송이 실패했어요.

먼저 로컬 세션과 원본 CSV를 보관하세요. 클라우드 업로드 실패와 로컬 저장 실패를 구분하고, 인터넷·로그인·저장 한도를 확인한 뒤 다시 시도하세요.

외부 전송의 4xx 오류는 주소·권한·수신 서버 설정을, 5xx 오류는 수신 서버 상태를 확인하세요. 재시도 전 수신 서버에 이미 데이터가 저장되었는지도 확인하면 중복 전송을 줄일 수 있습니다.

측정 엔진이 시작되지 않거나 앱이 멈춰요.

MPI를 종료하고 다시 실행하세요. 연결 도구 준비 상태를 확인하고, Windows 보안의 보호 기록에서 data-engine 실행이 차단되었는지 확인하세요.

공식 다운로드 파일인지 확인한 뒤 필요한 항목만 검토하세요. 문제가 계속되면 오류 문구와 로그를 보관하고, 재설치 전에 로컬 결과를 백업하세요.

문제가 계속될 때

재현 가능한 정보가 있으면 원인을 더 빨리 찾을 수 있습니다. 문의할 때 아래 내용을 정리하고 오류가 난 화면을 함께 전달하세요.

  • MPI 버전, Windows 버전, 기기 모델과 Android·iOS 버전
  • USB / Wireless 구분, 실패한 단계, 발생 시각과 정확한 오류 문구
  • 특정 앱에서만 발생하는지, 시도한 해결 방법과 재현 순서
  • iOS 터널 문제는 %LOCALAPPDATA%\MPI\ios-tunnel.log 중 오류가 발생한 구간

로그·화면·CSV를 공유하기 전에 이메일, 기기 식별자, 토큰, 개인 경로와 민감한 앱 정보를 가리세요. 암호·인증 코드·전체 계정 토큰은 전달하지 마세요.

공식 설정·문제 해결 문서