검색

시작하기

Macro Automation Studio 다운로드 및 설치 방법

64비트 Windows 또는 Apple Silicon Mac에 Macro Automation Studio를 다운로드해 설치하고, 이메일이나 Google로 로그인하며, 업데이트와 프로젝트 위치를 확인합니다.

  • Windows
  • Mac
  • 에뮬레이터
  • 클라우드 기기
  • 휴대폰
  • 스튜디오
초급 업데이트 8분 소요
이 페이지의 내용
  1. 시작하기 전에
  2. Macro Automation Studio 다운로드
  3. Windows 또는 Apple Silicon Mac에 설치
  4. 로그인
  5. 구독 확인
  6. 업데이트
  7. MAS가 파일을 보관하는 위치
  8. 문제 해결
  9. MacroAutomationStudio is currently running
  10. Python 환경이 끝까지 만들어지지 않음
  11. ADB executable not found
  12. 업데이트 실패
  13. 다음 단계: Windows 또는 Apple Silicon Mac에 안드로이드 에뮬레이터 추가

Macro Automation Studio(MAS)는 Windows와 Apple Silicon Mac용 데스크톱 앱입니다. 이 페이지에서는 Macro Automation Studio 다운로드, 각 시스템의 설치 프로그램, 로그인, 내장 업데이트 기능, 그리고 MAS가 파일을 보관하는 위치를 다룹니다.

시작하기 전에

  • Windows: 64비트 Windows 10 또는 11 PC와 관리자 권한 요청을 승인할 수 있는 계정.
  • Mac: macOS 12 Monterey 이상의 Apple Silicon Mac(M1부터 M5까지). Intel 빌드와 Linux 빌드는 없습니다.
  • 다운로드 페이지 기준 권장 메모리는 Windows 8 GB(16 GB 권장), Mac 4 GB(8 GB 권장)입니다. 에뮬레이터는 그 위에 별도 메모리가 필요합니다.
  • 로그인용 이메일 주소 또는 Google 계정.

Macro Automation Studio 다운로드

다운로드 페이지에서 설치 프로그램을 받습니다. Windows는 MacroAutomationStudio-<version>.exe, Mac은 Apple Silicon용으로 빌드된 DMG를 받습니다.

Windows 또는 Apple Silicon Mac에 설치

  1. 설치 프로그램을 실행하고 관리자 권한 요청을 승인합니다.
  2. 이전 버전의 MAS가 설치되어 있으면 먼저 제거할지 묻습니다. Yes를 클릭합니다.
  3. MAS가 실행 중이면 닫을지 묻습니다. 허용하거나 직접 MAS를 닫습니다.
  4. 라이선스에 동의하고 바탕화면 아이콘을 만들지 선택합니다.
  5. 파일이 C:\MacroAutomationStudio에 복사될 때까지 기다립니다. 그다음 설치 프로그램이 Python 환경을 만드는데, 몇 분 걸릴 수 있습니다.
  6. 실행 옵션을 켜 둔 채 Finish를 클릭합니다.

설치 프로그램은 adb, Tesseract OCR, uv 패키지 관리자도 C:\ProgramData\MacroAutomationStudio\3rdparty에 넣습니다. 설치 중에 그 밖의 것을 내려받지는 않습니다.

  1. DMG를 열고 MacroAutomationStudio를 Applications로 옮깁니다.
  2. Applications에서 실행합니다. 앱은 서명과 공증을 거쳤습니다. macOS가 인터넷에서 받은 앱을 열지 확인하면 Open을 클릭합니다.
  3. 첫 실행 시 MAS가 ~/Library/Application Support/MacroAutomationStudio/python_venv에 Python 환경을 만듭니다. 몇 분 걸릴 수 있습니다.
  4. adb, Tesseract OCR, uv는 앱 번들 안에 들어 있습니다. MAS가 “ADB executable not found”를 표시하면 Homebrew로 adb를 설치하고 MAS를 다시 시작합니다:
bash
brew install android-platform-tools

MAS는 앱 번들 안에서 adb를 먼저 찾고, 그다음 PATH, 마지막으로 Homebrew 폴더를 찾습니다.

로그인

MAS는 두 가지 로그인 방식을 지원합니다. 둘 다 같은 계정으로 연결됩니다.

  1. Sign in with Google을 클릭합니다. 브라우저에 Google 로그인 페이지가 열립니다. “Login Successful”이 표시되면 앱으로 돌아옵니다.
  2. 또는 Email address와 Password를 입력하고 Sign In을 클릭합니다.

MAS가 처음이신가요? Sign up을 클릭하고 이메일과 비밀번호를 입력한 뒤, MAS가 이메일로 보낸 일회용 비밀번호를 입력합니다. 계정이 활성화되면 로그인합니다.

구독 확인

로그인 후 MAS가 이용 권한을 확인합니다. 무료 체험 또는 유료 요금제가 있으면 모든 페이지가 열립니다. 없으면 MAS가 Subscription을 열고 요금제를 고를 때까지 그 페이지에 머무릅니다. 요금제는 가격 페이지에, 동작 방식은 결제 페이지에 있습니다.

업데이트

MAS는 스스로 업데이트합니다. 릴리스마다 새 설치 프로그램을 내려받을 필요가 없습니다.

  1. 로그인 후 MAS가 버전 서버에 최신 릴리스를 확인합니다.
  2. 새 버전이 있으면 두 버전 번호와 릴리스 노트가 담긴 “New Update Available” 대화 상자가 열립니다.
  3. Update Now를 클릭해 시작하거나 Not Now로 계속 작업합니다. 다운로드 중에는 Minimize를 클릭할 수 있습니다.
  4. MAS가 업데이트 도우미를 받은 뒤 업데이트 패키지를 받고, SHA-256 해시로 패키지를 검증합니다. Mac에서는 도우미가 앱을 교체하기 전에 MAS Apple 팀의 코드 서명도 확인합니다.
  5. 대화 상자에 “Update Complete”가 표시됩니다. Restart Now를 클릭하거나 자동 재시작을 기다립니다.

MAS가 파일을 보관하는 위치

항목WindowsMac
앱C:\MacroAutomationStudio/Applications/MacroAutomationStudio.app
프로젝트C:\ProgramData\MacroAutomationStudio\projects~/Library/Application Support/MacroAutomationStudio/projects
로그C:\ProgramData\MacroAutomationStudio\logs~/Library/Application Support/MacroAutomationStudio/logs
Python 환경C:\ProgramData\MacroAutomationStudio\python_venv~/Library/Application Support/MacroAutomationStudio/python_venv

각 프로젝트 폴더 이름은 <id>_<name> 형식이며, 이름은 소문자로 바뀌고 공백은 밑줄이 됩니다. 폴더 안에는 src/app.py, 프로젝트에 인수 폼이 있을 때 생성되는 src/script_args.py, 그리고 직접 추가한 에셋이 있습니다. 프로젝트는 git 저장소입니다. Git 프로젝트와 코드 동기화를 참고하세요.

C:\ProgramData는 기본적으로 숨겨져 있습니다. 탐색기 주소창에 경로를 입력하면 열립니다.

문제 해결

MacroAutomationStudio is currently running

설치 프로그램이 실행 중인 MAS를 발견했습니다. Yes를 클릭해 앱을 닫게 하거나, MAS 창에서 직접 종료한 뒤 설치 프로그램을 다시 실행하세요.

Python 환경이 끝까지 만들어지지 않음

설치 프로그램은 경고를 기록하고 그대로 끝냅니다. MAS가 다음 실행 때 설정을 다시 시도합니다. 앱이 “uv package manager not found”를 표시하면 다운로드 페이지에서 MAS를 다시 설치하세요.

ADB executable not found

Mac에서만 발생합니다. MAS가 앱 번들, PATH, /opt/homebrew 어디에서도 adb를 찾지 못했습니다. brew install android-platform-tools를 실행하고 MAS를 다시 시작하세요.

업데이트 실패

대화 상자에 원인이 표시됩니다. 네트워크 오류면 Try Again을 클릭합니다. “Not enough disk space”면 공간을 확보하고 다시 시도합니다. Download Manually가 제시되면 다운로드 페이지에서 새 버전을 설치하세요.

다음 단계: Windows 또는 Apple Silicon Mac에 안드로이드 에뮬레이터 추가

기기 페이지에서 Android 에뮬레이터, 클라우드 기기 또는 휴대폰을 추가한 뒤, 시작하기로 첫 매크로를 실행하세요.

다음 단계

관련 페이지

시작하기파이썬 안드로이드 자동화 시작하기: 첫 매크로 실행Macro Automation Studio에서 파이썬 안드로이드 자동화를 시작합니다: 기기를 연결한 뒤 마켓플레이스 봇 실행, MAS Agent 요청, 첫 매크로 작성까지 안내합니다.기기안드로이드 에뮬레이터 매크로: 기기 추가와 adb 포트Macro Automation Studio의 안드로이드 에뮬레이터 매크로 기기 설정: 자동 검색되는 에뮬레이터, adb 포트 규칙, 포트로 기기 추가, 클라우드 기기와 휴대폰 연결을 다룹니다.계정EnglishMacro Automation Studio Not Working? Errors and FixesFixes for when Macro Automation Studio is not working: sign-in, missing devices, image not found, OCR misreads, script errors, stuck cloud devices and credits.
이 페이지가 도움이 되었나요?
페이지를 Markdown으로 복사

궁금한 점이 있으신가요? Discord에서 질문하기