설치 및 초기 설정

시스템 요구 사항

• macOS 13.0 이상
• Intel 또는 Apple Silicon 아키텍처 모두 지원
• 3 MB 디스크 공간
• 인터넷 연결 (AI 조회 및 업데이트에 사용, 일부 기능은 오프라인에서도 사용 가능)

설치 방법

방법 1: 웹사이트에서 DMG 다운로드 (권장)

1. DevGlish 공식 웹사이트 방문
2. Download 버튼을 클릭하여 최신 DevGlish.dmg 다운로드
3. .dmg 파일을 더블 클릭하여 설치 프로그램 열기
4. DevGlish 앱을 Applications 폴더로 드래그
5. 완료! Applications 폴더에서 DevGlish를 찾아 실행할 수 있습니다

방법 2: TestFlight 베타 버전

최신 기능을 먼저 체험하고 싶으신가요? TestFlight 테스트 프로그램에 참여하세요:

1. Apple Mail에서 초대 링크를 수신하거나 DevGlish 공식 웹사이트에서 신청
2. 링크를 클릭하고 TestFlight 앱에서 Accept 클릭
3. TestFlight가 자동으로 DevGlish 베타 버전을 다운로드합니다
4. 설치 완료 후 TestFlight 앱에서 DevGlish를 실행할 수 있습니다

팁

TestFlight 버전을 사용하면 새로운 기능을 미리 체험할 수 있습니다. 여러분의 피드백을 환영합니다!

핵심 설정: 손쉬운 사용 권한 부여

DevGlish는 macOS 손쉬운 사용 API(AXUIElement)를 사용하여 선택한 텍스트를 읽습니다. 이것은 앱이 정상적으로 작동하기 위한 필수 조건입니다.

이 권한이 왜 필요한가요?

DevGlish는 모든 앱에서 선택한 텍스트에 접근해야 합니다. Xcode에서 코드 조각을 선택하든, Slack에서 채팅 메시지를 선택하든, 브라우저에서 웹 콘텐츠를 선택하든, DevGlish는 이 권한을 통해 선택한 내용을 가져온 후 AI 조회를 수행합니다.

단계 1: 시스템 설정 열기

1. 메뉴 바 왼쪽 상단의 Apple 로고 클릭
2. System Settings (시스템 설정) 선택

단계 2: 개인정보 보호 및 보안으로 이동

1. 왼쪽 사이드바에서 Privacy & Security (개인정보 보호 및 보안) 찾기
2. 클릭하여 진입

단계 3: 손쉬운 사용 찾기 및 활성화

1. 아래로 스크롤하여 Accessibility (손쉬운 사용) 옵션 찾기
2. Accessibility 클릭
3. 오른쪽 창에서 DevGlish 앱 찾기
4. DevGlish가 목록에 없으면 + 버튼을 클릭한 후 Applications 폴더에서 DevGlish 선택
5. DevGlish 옆의 토글 스위치가 켜져 있는지(초록색) 확인

주의

DevGlish에 손쉬운 사용 권한이 없으면 전역 단축키 ⌘⇧D가 작동하지 않습니다.

단계 4: DevGlish 실행

1. 시스템 설정 닫기
2. Applications 폴더에서 DevGlish를 실행하거나, Spotlight 검색 사용 (⌘Space, “DevGlish” 입력)
3. DevGlish가 메뉴 바 우측 상단에 나타납니다 (톱니바퀴 아이콘)

로그인

DevGlish를 실행한 후, 학습 진도와 저장된 단어를 동기화하려면 로그인이 필요합니다.

옵션 1: Apple Sign In 사용 (권장)

1. 메뉴 바에서 DevGlish 아이콘 클릭
2. Sign in with Apple 선택
3. Apple ID로 로그인 완료
4. DevGlish에 Apple 계정 접근 권한 부여 (인증용으로만 사용하며, DevGlish는 비밀번호를 저장하지 않습니다)

옵션 2: 매직 링크 사용 (이메일 로그인)

1. 메뉴 바에서 DevGlish 아이콘 클릭
2. Sign in with Email 선택
3. 이메일 주소 입력
4. 이메일을 확인하고 수신된 매직 링크 클릭
5. 링크가 자동으로 DevGlish에 로그인합니다

문제 해결

문제: ⌘⇧D를 눌러도 반응이 없음

해결 방법:

1. DevGlish가 실행 중인지 확인 (메뉴 바 우측 상단에 아이콘이 있어야 합니다)
2. DevGlish가 System Settings > Privacy & Security > Accessibility에서 활성화되어 있는지 확인
3. DevGlish 재시작 시도: 메뉴 바 아이콘 클릭 → Quit DevGlish 후 다시 실행
4. Accessibility 설정에서 DevGlish의 권한 스위치를 다시 전환 (끄고 다시 켜기)

문제: 로그인할 수 없거나 이메일을 받지 못함

해결 방법:

1. 네트워크 연결 확인
2. 이메일 로그인 사용 시, 스팸 메일 폴더 확인 (Magic Link 이메일이 필터링될 수 있음)
3. Apple Sign In으로 대체 시도
4. 문제가 지속되면 [email protected]로 문의

문제: DevGlish가 선택한 텍스트에 접근할 수 없음

해결 방법:

1. Accessibility에서 권한을 부여했는지 확인 (위의 단계 3 참조)
2. 일부 앱(특정 보안 앱 등)이 손쉬운 사용 접근을 차단할 수 있습니다. 다른 앱에서 테스트해 보세요 (Notes, TextEdit 등)
3. DevGlish 재시작 (메뉴 바 아이콘 → Quit 후 다시 실행)

참고

문제가 해결되지 않으면 지원 페이지를 통해 문의해 주세요.

다음 단계

이제 DevGlish를 설치하고 설정했습니다! 3분 빠른 시작으로 이동하여 첫 번째 조회 방법을 알아보세요.