diff --git a/INSTALL-macos-ko.md b/INSTALL-macos-ko.md index 709b257..f3c1ec5 100644 --- a/INSTALL-macos-ko.md +++ b/INSTALL-macos-ko.md @@ -1,130 +1,27 @@ -Stem 설치 가이드 (macOS) -============================ +Stem 설치 (macOS, Apple Silicon) +================================ -승미님께. Stem을 처음 설치하실 때 단계별로 따라하시면 됩니다. -필요 시간 5분. 모르는 부분이나 막히는 단계 있으시면 화면 그대로 -캡쳐해서 보내주세요. +1. DMG 다운로드 + https://gitea.muwol.io/eden/stem-app/releases/download/v0.1.0-test1/Stem_0.1.0_aarch64.dmg + +2. DMG 열어서 Stem.app을 Applications로 드래그. + +3. 첫 실행은 우클릭 > 열기 필수. + - Apple Developer 인증서 없이 ad-hoc 서명만 된 빌드라 + 그냥 더블클릭하면 Gatekeeper가 차단함. + - Sequoia(15)는 우클릭으로도 안 막아주는 경우가 있음 → + 시스템 설정 > 개인정보 보호 및 보안 > 보안 섹션 하단 "그래도 열기". + +4. Google OAuth 로그인. + 브라우저로 튀어나갔다가 돌아오면 메인 화면. + 안 돌아오면 Dock에서 Stem 한 번 클릭. + +5. 회사 보안망에서 OAuth 막히면 핫스팟으로 한 번만 로그인. + 토큰은 Keychain에 저장돼서 이후엔 회사망 OK. -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 -실행해서 같은 값이 나오면 파일 손상 없습니다. + → f0bcfa26f82564459548931ab5406b2735b0cf30321b7fc4b7c0c56b09abbff7 + +문제 있으면 화면 캡쳐 보내주세요.