첫 실행

설치 후 처음 프리모스튜디오 앱을 실행합니다. Windows 에서는 첫 실행에 보안 알림이 한 번 등장하고, macOS 는 아무 창 없이 바로 열립니다.

무엇을 하는 단계인가요?

• (Windows 만) 보안 알림 한 번 허용 — 처음 한 번만 필요
• 앱이 준비를 마칠 때까지 기다리기 — 저절로 진행되며 보통 5~10초 걸립니다
• 정상 시작되면 키트 선택 화면이 표시됩니다 (다음 페이지)

첫 실행에 한 번 나오는 안내입니다. [건너뛰기] 를 눌러도 되고, 나중에 [설정] 에서 다시 볼 수 있습니다.

다음 실행부터는 자동

아래 Windows 보안 알림 절차는 첫 실행 한 번만 필요합니다. 시스템이 신뢰 목록에 추가하면 다음부터는 일반 더블 클릭으로 바로 실행됩니다.

절차

macOS

1. 응용 프로그램 폴더에서 프리모스튜디오 더블 클릭
2. 앱 창이 표시되기까지 5~10초 대기
3. 키트 선택 화면이 나타나면 정상 — 키트 선택 으로 이동

보안 경고가 뜨지 않습니다

macOS 는 별도 허용 절차 없이 바로 열립니다. 아무 창도 뜨지 않는 게 정상입니다.

그래도 '확인되지 않은 개발자' 경고가 떴어요

예전에 받아둔 오래된 설치 파일일 가능성이 높습니다. 최신 파일로 다시 설치하면 해결됩니다.

1. 응용 프로그램 폴더에서 프리모스튜디오를 휴지통으로 이동
2. primolabs.kr 에서 파일을 새로 받아 설치

지금 당장 열어야 한다면 임시로 이렇게 열 수 있습니다 — 시스템 설정 → 개인정보 보호 및 보안 을 아래로 스크롤 → 보안 메시지 옆 [확인 없이 열기] → 비밀번호 입력.

다만 이 상태로는 자동 업데이트가 동작하지 않습니다. 수업 전에 최신 파일로 다시 설치해 두세요.

Windows

1. 시작 메뉴 또는 바탕화면 단축아이콘 으로 프리모스튜디오 실행
2. (첫 실행만) Windows Defender SmartScreen 처리
   • Defender 가 다음 메시지를 표시합니다:

     "Windows의 PC 보호 — Microsoft Defender SmartScreen에서 인식할 수 없는 앱의 시작을 차단했습니다."

   • [추가 정보] 클릭
   • 나타난 [실행] 버튼 클릭
3. 앱 창이 표시되기까지 5~10초 대기
4. 키트 선택 화면이 나타나면 정상 — 키트 선택 으로 이동

자동 업데이트

앱을 켤 때 새 버전이 있는지 한 번 확인합니다. 있으면 화면 맨 위에 알림 띠가 나타납니다.

새 버전 v2.8.5 사용 가능   [변경 내용] [나중에] [업데이트]

• [변경 내용] — 무엇이 바뀌었는지 미리 확인
• [나중에] — 알림 띠를 접습니다
• [업데이트] — 받기 시작 → 다 받으면 [지금 재시작] 버튼으로 바뀝니다

수업 중 자동 재시작 없음

수업 중 갑자기 재시작되는 일은 없습니다 — 사용자가 [업데이트] 와 [지금 재시작] 을 명시적으로 눌러야만 진행됩니다. 받아 두기만 하고 재시작을 미뤄도 됩니다.

지금 최신인지 직접 확인하기

알림 띠가 안 보인다고 최신이라는 뜻은 아닙니다 — 인터넷이 끊겨 확인에 실패했을 수도 있습니다. [설정] 탭 → 앱 정보에서 직접 확인할 수 있습니다.

[업데이트 확인] 버튼을 누르면 현재 상태가 한 줄로 표시됩니다.

표시	뜻
🟢 최신 버전이에요	더 받을 것이 없습니다
🟠 새 버전 vX.Y.Z 이 있어요	화면 맨 위에 알림 띠가 (다시) 나타납니다 → [업데이트]
🔵 vX.Y.Z 설치 준비됨 — 앱을 다시 켜면 적용돼요	이미 받아 뒀습니다. 다음 실행 때 적용됩니다
🔴 확인하지 못했어요	인터넷 연결을 확인해 주세요

[나중에] 를 눌렀어도 여기서 되살릴 수 있습니다

알림 띠를 접은 뒤 다시 받고 싶어지면 [설정] → [업데이트 확인] 을 누르면 됩니다. 알림 띠가 다시 나타나 [업데이트] 를 누를 수 있습니다.

받는 것과 적용하는 것은 따로입니다

[업데이트] 로 받아만 두고 수업이 끝난 뒤에 [지금 재시작] 하거나, 그냥 앱을 껐다 켜도 적용됩니다.

자주 발생하는 문제

'앱을 시작하지 못했어요' 안내창이 떴어요

가장 흔한 첫 실행 문제입니다. 다음 메시지가 표시됩니다:

앱을 시작하지 못했어요
프리모스튜디오가 준비를 마치지 못했습니다.

확인할 사항:
1. Windows Defender 또는 보안 프로그램 알림이 떴다면 "허용"을 눌러 주세요.
2. 알림이 없었다면 앱 아이콘을 우클릭 → "관리자 권한으로 실행"을 한 번만 시도해 주세요.
3. 한 번 정상 실행되면 이후로는 그냥 더블 클릭해도 됩니다.
4. 매번 관리자 권한이 필요하다면 설치 위치 문제입니다 — 메뉴얼의 "설치하기" 를 확인해 주세요.

해결 순서:

1. 화면 우하단 알림 영역에 Defender 알림이 있는지 확인 → 있으면 [허용]
2. 알림이 없으면 앱 아이콘 우클릭 → [관리자 권한으로 실행] 한 번 시도
3. 한 번 정상 실행 후 일반 더블 클릭으로 다시 실행

설치할 때의 안내와 헷갈리지 마세요

설치하기 에서 설치 프로그램은 관리자 권한으로 띄우지 말라고 안내했습니다. 여기서 말하는 건 이미 설치된 앱을 한 번 그렇게 실행해 보는 것으로, 서로 다른 이야기입니다.

관리자 권한으로 실행해야만 된다면 — 설치 위치를 의심하세요

3번처럼 한 번 실행 후 일반 실행으로 돌아가는 게 정상입니다. 매번 관리자 권한이 필요하다면 보안 프로그램 문제가 아니라 C:\Program Files\ 에 설치된 상태일 가능성이 높습니다.

그대로 두면 관리자 권한으로 계속 쓸 수는 있지만, 흐름 실행이 [WinError 5] 로 막히거나 자동 업데이트가 반쪽만 적용되는 문제가 남습니다. 설치하기 → Windows 의 절차대로 다시 설치하는 편이 낫습니다.

키트 선택 화면이 나타나지 않음 (30초 이상 검은 화면)

앱이 지난번에 제대로 닫히지 않으면, 함께 돌던 프로그램(primolabs-server)이 남아 새 실행을 막습니다. 직접 끝내 주면 됩니다.

Windows:

• Ctrl+Shift+Esc 로 작업 관리자 열기
• "세부 정보" 탭에서 primolabs-server.exe 항목을 모두 종료 (예전 이름인 python.exe 로 찾으면 나오지 않습니다)
• 프리모스튜디오 다시 실행

macOS:

• Cmd+Space → "활동 모니터" 검색하여 실행
• "CPU" 탭에서 primolabs-server 검색 (예전 이름인 python 으로 찾으면 나오지 않습니다)
• 항목 선택 후 좌상단 ✕ 버튼 → "종료"
• 프리모스튜디오 다시 실행

자동 정리 기능

프리모스튜디오는 켤 때마다 남아 있는 것을 스스로 정리합니다. 그래도 위 증상이 생기면 페이지 하단 📮 피드백 보내기 로 알려주세요.

강사 팁

첫 실행은 한 번만 까다로움

두 번째 실행부터는 바로 메인 화면이 뜹니다. 학생들이 첫 실행에 막히면 옆에서 한 번만 도와주면 됩니다.

Defender 알림은 정상 동작 (Windows)

프리모스튜디오 자체 문제가 아닙니다. Windows 가 처음 보는 프로그램에 띄우는 표준 안내로, 한 번 허용하면 다음부터는 뜨지 않습니다. macOS 에는 해당하지 않습니다.

수업 시작 5분 전 일괄 첫 실행

학생들 PC 모두 한 번 켜서 첫 실행을 마쳐두면 수업 시간 손실이 없습니다.

수업 중 업데이트 알림 처리

자동 업데이트 알림이 떠도 수업 중에는 [나중에] 를 권합니다. 업데이트 후엔 흐름 호환성 확인이 필요할 수 있습니다.

수업이 끝난 뒤 [설정] → [업데이트 확인] 을 누르면 알림 띠가 다시 나타나 그때 받으실 수 있습니다 (지금 최신인지 직접 확인하기).

소리·학습 단계·앱 업데이트는 오른쪽 [설정] 탭 에서 조절합니다.

다음 단계

키트 선택 화면이 표시되면 키트 선택 → 으로 이동합니다.

---

이 페이지에 빠진 내용이나 잘못된 부분을 발견하시면 페이지 하단 📮 피드백 보내기 를 활용해 주세요.