diff --git a/INSTALL-macos-ko.md b/INSTALL-macos-ko.md new file mode 100644 index 0000000..709b257 --- /dev/null +++ b/INSTALL-macos-ko.md @@ -0,0 +1,130 @@ +Stem 설치 가이드 (macOS) +============================ + +승미님께. Stem을 처음 설치하실 때 단계별로 따라하시면 됩니다. +필요 시간 5분. 모르는 부분이나 막히는 단계 있으시면 화면 그대로 +캡쳐해서 보내주세요. + + +0. 준비 사항 +------------ +- 맥북 (애플 실리콘 M1/M2/M3/M4) +- 인터넷 연결 +- 본인 Google 계정 (회사 메일 또는 개인 메일) +- (인텔 맥은 이번 빌드 미지원. macOS 11 Big Sur 이상 권장) + + +1. 다운로드 +----------- +아래 주소를 사파리/크롬 주소창에 그대로 붙여넣고 엔터: + + https://gitea.muwol.io/eden/stem-app/releases/download/v0.1.0-test1/Stem_0.1.0_aarch64.dmg + +다운로드 폴더에 Stem_0.1.0_aarch64.dmg 파일이 생깁니다 (약 46MB). + + +2. DMG 열기 +----------- +다운로드 폴더에서 Stem_0.1.0_aarch64.dmg 파일을 더블클릭. + +작은 창이 뜨면서 두 개 아이콘이 보입니다. +- 왼쪽: Stem 앱 아이콘 +- 오른쪽: Applications 폴더 아이콘 (또는 "응용 프로그램") + + +3. 응용 프로그램으로 드래그 +--------------------------- +Stem 아이콘을 오른쪽 Applications 폴더 아이콘 위로 끌어다 놓으세요. + +복사가 끝나면 DMG 창은 닫아도 됩니다. + + +4. 첫 실행 — 그냥 더블클릭하면 안 됩니다 (중요) +----------------------------------------------- +이 앱은 아직 정식 인증서가 없어서 그냥 더블클릭하면 macOS가 막습니다. +아래 방법으로 우회하세요. + +4-1. Finder에서 응용 프로그램 폴더 열기 + - Finder 메뉴: 이동 -> 응용 프로그램 + - 또는 단축키 Shift + Cmd + A + +4-2. Stem 아이콘 우클릭 -> 열기 + (맥북 트랙패드는 두 손가락 탭, 또는 Control 누르고 클릭이 우클릭) + +4-3. 경고창에서 "열기" 버튼 클릭 + 메시지 예: "Stem은(는) 확인되지 않은 개발자가 배포한 앱입니다. + 정말로 여시겠습니까?" + -> "열기" (그냥 "확인" 아닌 "열기") + +4-4. macOS Sequoia(15)에서 위 방법이 안 될 때 + - Apple 메뉴 (좌상단 사과) -> 시스템 설정 + - 왼쪽 사이드바: 개인정보 보호 및 보안 + - 스크롤 내려서 "보안" 섹션 + - "Stem은(는) ... 사용이 차단됨" 옆 "그래도 열기" 버튼 클릭 + - 비밀번호 또는 Touch ID로 확인 + - 다시 응용 프로그램 폴더의 Stem 아이콘 더블클릭 + + +5. 처음 실행 시 로그인 +---------------------- +Stem이 켜지면 시작 화면(랜딩 페이지)이 나옵니다. + +1) "시작하기" 또는 "Sign in with Google" 버튼 클릭 +2) 기본 브라우저(사파리/크롬)가 열리며 Google 로그인 페이지로 이동 +3) 본인 Google 계정 선택 -> 권한 확인 -> "허용" +4) 브라우저: "Stem 앱으로 돌아가도 됩니다" 메시지 +5) Stem 앱 창으로 돌아가면 자동 로그인 완료, ELN 메인 화면 진입 + + +6. 잘 됐는지 확인 +----------------- +메인 화면에서 다음이 보이면 정상: +- 좌측 사이드바: Samples / Notes / Lineage / Drylab 메뉴 +- 본인 계정 아이콘이 우상단에 표시 +- 메뉴 아무거나 클릭해서 화면이 바뀜 + +이 단계까지 오시면 설치 완료입니다. + + +자주 막히는 부분 +================ + +Q. 더블클릭하니까 "손상되었습니다" 메시지가 떠요. +A. 우클릭(또는 Control + 클릭) 후 "열기"를 누르셔야 합니다. + 그냥 더블클릭은 첫 번째에서만 차단됩니다 (4-2 단계). + +Q. "그래도 열기" 버튼이 안 보여요. +A. macOS 12 이하면 위치가 다릅니다: Apple 메뉴 -> 시스템 환경설정 -> + 보안 및 개인정보 보호 -> 일반 탭 -> 하단에 "확인 없이 열기" 또는 + "그래도 열기" 버튼. + +Q. Google 로그인 후 브라우저는 닫혔는데 앱은 그대로예요. +A. Dock의 Stem 아이콘을 한 번 클릭해서 앱을 앞으로. 그래도 안 되면 + 앱 종료(Cmd+Q) 후 다시 실행. + +Q. 와이파이가 회사 보안망이라 로그인이 안 돼요. +A. 핸드폰 핫스팟으로 잠깐 바꿔서 한 번 로그인하면 그 이후는 회사망에서도 + 됩니다 (한 번 받은 토큰은 로컬에 저장). + +Q. 사용 중 앱이 꺼졌어요. +A. 다시 더블클릭하면 됩니다. 첫 실행 우회는 한 번만, 이후엔 일반 앱처럼 + 동작합니다. 작성하신 내용은 자동 저장되어 있습니다. + + +삭제하고 싶을 때 +================ +응용 프로그램 폴더에서 Stem.app을 휴지통으로 끌어다 놓으면 됩니다. +(로그인 정보는 Keychain에 저장되어 있어 완전 삭제는 추가 정리 필요 — + 그땐 따로 말씀해주세요) + + +안 풀리는 문제 +============== +화면 캡쳐(Cmd + Shift + 4 -> 영역 드래그)와 함께 메시지 주시면 됩니다. + +설치 파일 무결성 확인용 SHA-256 (선택): + f0bcfa26f82564459548931ab5406b2735b0cf30321b7fc4b7c0c56b09abbff7 Stem_0.1.0_aarch64.dmg + +터미널에서: + shasum -a 256 ~/Downloads/Stem_0.1.0_aarch64.dmg +실행해서 같은 값이 나오면 파일 손상 없습니다.