로컬 단말기 실행 중 오류 문제 해결

  • 업데이트 날짜 Feb 10, 2026
  • 에 게시됨 Nov 26, 2025
  • 4 읽은 시간(초)
  • Autify Customer success team
  • Rie Kuromiya
  • Technical Support
 Prev Next

로컬 단말기 실행은 이 문서에 안내된 설치 과정(셋업) 이 필요하며, 개발 계정이 필요할 수 있는 등 개발 담당자의 협조가 필요한 경우가 있습니다.

로컬 단말기 실행을 이용하려면 커맨드 라인 인터페이스(CLI) 를 사용하여 설치를 진행해야 합니다. 이 과정에서 소프트웨어 개발에 대한 기본적인 지식이 필요할 수 있으며, 더불어 개발 계정이 필요하여 개발 담당자의 협조가 필요한 경우도 있습니다. 개발자의 협력 하에 이용을 고려해 주십시오.

설치 방법은 이 문서를 참고하시기 바라며, 설치 과정에서 오류가 발생했을 때의 대처 방법을 안내해 드립니다.

1. 설치 (셋업)

Q1-1. iOS 로컬 단말기 이용 시 “No devices are currently connected.” 메시지가 나타납니다

새로운터미널(Windows의 경우 Command Prompt 또는 PowerShell 사용)에서 autify mobile link doctor 명령어를 실행하여 연결된 단말기 이름이 표시되는지 확인하십시오.

  • 단말기 이름이 표시되지 않는 경우, autify mobile link start를 중지하고, 기기를 컴퓨터에서 분리했다가 다시 연결하십시오.
  • 단말기 이름이 표시되는 경우
    • autify mobile link start 명령어가 실행 중인지 확인한 후, NoCode Mobile페이지를 새로고침하십시오.
    • autify mobile auth login 으로 설정된 액세스 토큰을 생성한 것과 동일한 사용자 계정을 NoCode Mobile 애플리케이션에서 사용하고 있는지 확인하십시오.

Q1-2. iOS 로컬 단말기 이용 시 ‘프로파일을 찾을 수 없습니다’가 표시될 때

사용 중인 Apple Developer Account에 Cloud Managed Distribution Certificates 권한이 있는지 확인하세요. 이 권한은 Admin 역할에는 기본으로 활성화되어 있지만, App Manager나 Developer 역할에는 수동으로 활성화해야 합니다.

Q1-3. Autify CLI 및 Autify Mobile link의 최신 버전을 이용하고 싶습니다. 업데이트 방법을 알려주세요.

명령줄(Command Line)에 Warning: @autifyhq/autify-cli update available from 0.61.0 to 0.62.0. 와 같은 경고가 표시되는 경우, 다음에 따라 업데이트해 주십시오.

터미널에서 다음을 실행합니다.

autify update
autify mobile link install

Q1-4. autify mobile link doctor 실행 시 "API connectivity check failed: Failed to access the server" 메시지가 표시되는 경우

autify mobile link doctor 명령어를 실행했을 때 커맨드 라인 인터페이스(CLI)에 「API connectivity check failed: Failed to access the server」라고 표시된다면, Autify API에 대한 액세스 자체가 차단되었을 가능성이 있습니다.

로컬 실기기 실행에 필요한 Mobile link 기능을 거치지 않고 Autify API에 직접 액세스할 수 있는지 확인하기 위해, 다음 절차에 따라 명령어를 실행해 보시기 바랍니다.

  1. Autify 설정 화면에서 새 퍼스널 액세스 토큰(API 인증 토큰)을 생성 합니다.
  2. 아래 코드의 <ACCESS_TOKEN> 부분을 1번에서 생성한 본인의 토큰으로 바꿉니다.
  3. 아래 코드의 <PROJECT_ID> 부분을 해당 워크스페이스의 ID로 바꿉니다.
  4. 수정한 코드를 CLI 화면에 붙여넣어 실행합니다.
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
"https://mobile-app.autify.com/api/v1/projects/<PROJECT_ID>/results"

위 명령어를 실행했을 때 정상적인 응답이 오지 않는(액세스할 수 없는) 경우, 사내 IT 팀 담당자에게 '외부 API(Autify) 접속 허용'("https://mobile-app.autify.com/api/v1/projects/<PROJECT_ID>/results" 에 접속 가능하도록 설정)에 대해 확인 및 요청을 진행해 주시기 바랍니다.

외부 API(Autify)에 접속할 수 있는 상태임에도 계속해서 「API connectivity check failed: Failed to access the server」 메시지가 표시된다면, 이용 중인 네트워크의 SSL 통신 환경이 원인일 수 있습니다.

만약 SSL 인증서 검증을 비활성화했을 때 Autify 서버에 접속이 가능하다면 SSL 설정의 영향일 가능성이 큽니다. CLI에서 다음 명령어를 실행하여 정상적으로 접속되는지 확인해 보십시오. 문제가 해결된다면 사내 네트워크 팀을 통해 Autify에 접속할 수 있도록 네트워크 조치를 요청해 주시기 바랍니다. 주의: 아래 명령어는 문제의 원인을 파악하기 위한 용도로만 사용해 주시고, 상시 사용은 권장하지 않습니다.

NODE_TLS_REJECT_UNAUTHORIZED=0 autify mobile link doctor
NODE_TLS_REJECT_UNAUTHORIZED=0 autify mobile link start

2. 레코딩

Q2-1.iOS 로컬 단말기 이용 시 NoCode Mobile 화면에 'No devices are currently connected'라고 표시되어 autify mobile link start를 명령어로 입력하니 'Application is already running. Multiple instances cannot be started'라는 메시지가 표시되어 테스트 실행 및 시나리오 작성이 불가능합니다.

Screenshot 2025-08-21 at 18.19.45.png

아래를 시도해 보십시오.

  1. 터미널에서 Ctrl + C를 입력하여 CLI를 중지시킵니다.
  2. 터미널에서 다음 명령어를 실행하여 실행 중인 프로세스를 찾습니다.
ps aux | grep 'mobile link start

*실행 후, 어떤 ID가 표시될 것입니다. 이 ID를 3단계에서 사용합니다.
*만약 ID가 표시되지 않으면, autify mobile link start 를 실행합니다.

  1. 실행 중인 프로세스가 발견되면, 다음 명령어를 실행하여 PID를 kill합니다.
kill <PID>

<PID> 를 2단계에서 확인한 ID로 바꾸어 실행해 보십시오.

위의 내용을 실행한 후, 다시 autify mobile link start 를 실행해 보십시오.


Q2-2. iOS 로컬 단말기 이용 시 레코딩 중에 "프로파일을 찾을 수 없습니다"라는 메시지가 표시되어 레코딩을 시작할 수 없습니다.

레코딩을 시작한 후, "프로필을 찾을 수 없습니다. WebDriverAgent를 설치하려면 적절한 프로비저닝 프로파일이 설정되어 있어야 합니다. 프로파일을 설정해 주십시오."라는 메시지가 표시되며 레코딩이 되지 않는 경우, 아래 그림과 같이 유료 Apple Developer Program에 등록된 계정을 가진 분의 App Store Connect 화면에서 Certificates, Identifiers & Profile (클라우드 관리 배포 인증서) 설정이 유효한지 확인해 주십시오. 필요한 경우, 고객 조직의 개발 담당자의 협조를 받아 설정을 확인해 주십시오.
함께, 준비할 것 중 "Apple Developer 계정" 항목 도 확인해 주십시오.

appleaccount.png

모든 상황에 대해, 위의 내용을 확인해도 해결되지 않는 경우, 이 글을 참고하여 해당 테스트 결과 URL과 함께 로그 파일을 첨부하여 문의해 주세요.

Q2-3. Android 단말기 이용 시, 단계 1의 애플리케이션을 시작하기 전에 오류가 발생하여 레코딩 자체가 불가능합니다.

테스트 결과 로그(예: recording-1234XXX-appium.log)에 "info: java.lang.SecurityException: Permission denial: writing to settings requires:android.permission.WRITE_SECURE_SETTINGS" 와 같은 오류가 있는 경우, Android 단말기의 권한 설정 문제일 가능성이 제기되었습니다. Android 단말기의 설정을 변경하면 문제가 해결될 수 있으므로, 단말기에서 다음 설정을 실시한 후 레코딩을 다시 시도해 주시겠습니까?

여기를 참고 (외부 사이트) 하여 개발자 옵션을 표시하고 이동합니다.

"개발자 옵션" 또는 "보안" 설정에서 "Disable Permission Monitoring" 을 ON으로 설정하거나, "App Permission Monitor" 를 OFF로 설정합니다.

※ 다른 단말기에서 레코딩한 시나리오를 테스트 실행했을 때 “내부 오류 또는 테스트 최대 실행 시간 초과로 인해 테스트 실행이 중단되었습니다.” 라고 표시된 경우에도 위 설정으로 해결될 수 있습니다.

3. 테스트 실행

Q3-1.iOS 로컬 단말기 이용 시 테스트 실행 시 스텝 0에서 "내부 오류 또는 테스트 최대 실행 시간 초과로 인해 테스트 실행이 중단되었습니다."라는 오류 메시지가 표시됩니다.

원인은 한 가지가 아닐 수 있지만, 먼저 아래 내용을 확인해 주세요.

  1. XCode 계정이 올바르게 설정되어 있는지 확인해 주세요. 권한이 없는 경우 오류가 발생합니다.
  2. 로컬 단말기의 화면 잠금을 해제하는 것을 잊으셨을 경우, 오류가 발생합니다. 연결된 로컬 단말기의 화면 잠금을 해제하고 다시 실행해 보세요.

Q3-2. Android 단말기를 이용할 때, 테스트 실행 중 단계 0에서 "내부 오류 또는 테스트 최대 실행 시간 초과로 인해 중단되었습니다."라는 오류 메시지가 표시됩니다.

테스트 결과 로그(예: recording-1234XXX-appium.log)에 "info: java.lang.SecurityException: Permission denial: writing to settings requires:android.permission.WRITE_SECURE_SETTINGS" 와 같은 오류가 포함되어 있다면, 이는 Android 단말기의 권한 설정 문제로 인해 발생했을 수 있습니다.

문제를 해결하고 테스트를 재실행하기 위해 단말기의 설정을 다음과 같이 변경해 보시기 바랍니다.

이 가이드 (외부 사이트) 를 참고하여 개발자 옵션을 활성화하십시오.

"개발자 옵션" 또는 "보안" 설정에서 "Disable Permission Monitoring" 을 ON으로 전환하고, "App Permission Monitor" 를 OFF로 전환합니다.


어떤 현상에 대해서도, 위 내용을 확인했음에도 불구하고 해결되지 않는 경우, 이 문서 를 참고하여 해당 테스트 결과 URL과 함께 로그 파일을 첨부하여 문의해 주시기 바랍니다.

Autify는 누구나 자동화 테스트를 수행할 수 있는 노코드 테스트 자동화 플랫폼입니다. 인공 지능(AI)을 사용하여 테스트 시나리오를 유지 관리합니다.
로그인
제품
리소스
© Autify,Inc.