AMBA
English
日本語
✓한국어
Tiếng Việt

한국어

English
日本語
Tiếng Việt

화면 모드

🚀 데스크톱 앱 설치 가이드 ​

AMBA는 macOS, Windows 및 Linux 환경에서 최고 성능을 발휘하도록 최적화된 독립형 데스크톱 애플리케이션으로 제공됩니다.

🍏 macOS 설치 안내 ​

1. 디스크 이미지(.dmg) 다운로드 ​

공식 다운로드 포털에서 최신 패키지를 다운로드합니다:

  • Apple Silicon (M1/M2/M3/M4): 2020년 이후 출시된 모든 최신 Mac 모델(MacBook Air/Pro, Mac mini, iMac 등)에 권장됩니다.
  • Intel x64: 인텔 프로세서가 탑재된 기존 Mac 모델용입니다.

2. Applications 폴더로 복사 ​

  1. 다운로드한 .dmg 파일을 더블 클릭하여 엽니다.
  2. 설치 창에서 AMBA 아이콘을 Applications 폴더 바로가기로 드래그 앤 드롭합니다.
  3. 설치 완료 후 Finder에서 디스크 이미지를 추출(Eject)합니다.

3. 최초 실행 및 macOS Gatekeeper 보안 안내 ​

AMBA는 현재 기업 고객 대상 파일럿 배포(Pilot Distribution) 단계이므로, 최초 실행 시 macOS Gatekeeper에 의해 개발자 미확인 경고 창이 나타날 수 있습니다:

최초 실행 시 간단한 확인 방법

  1. Finder를 열고 응용 프로그램(Applications) 폴더로 이동합니다.
  2. AMBA 아이콘을 **우클릭(또는 Control 키를 누른 채 클릭)**한 다음 **'열기(Open)'**를 선택합니다.
  3. 나타나는 보안 대화상자에서 다시 한 번 **'열기(Open)'**를 클릭합니다.
  4. 이 작업은 최초 1회만 진행하면 되며, 이후에는 Launchpad, Spotlight 또는 Dock에서 정상 실행할 수 있습니다.

🪟 Windows 설치 안내 ​

1. 설치 파일 다운로드 ​

공식 다운로드 포털에서 최신 64비트 Windows 설치 프로그램(.exe 또는 .msi)을 다운로드합니다.

2. 설치 마법사 실행 ​

  1. 다운로드한 설치 파일을 더블 클릭하여 실행합니다.
  2. Windows SmartScreen 화면("PC 보호 알림")이 나타나는 경우:
    • **'추가 정보'**를 클릭합니다.
    • '실행' 버튼을 클릭합니다.
  3. 화면의 단계별 안내에 따라 설치를 완료하면 바탕화면에 바로가기 아이콘이 자동 생성됩니다.

🐧 Linux 설치 안내 ​

AMBA는 데비안 패키지(.deb) 및 독립 실행형 .AppImage 형식을 통해 주요 Linux 배포판을 완벽하게 지원합니다.

1. Debian / Ubuntu 환경 설치 (.deb) ​

  1. 공식 다운로드 포털에서 최신 .deb 패키지(AMBA_<version>_amd64.deb)를 다운로드합니다.
  2. 패키지를 설치합니다. 의존하는 런타임 라이브러리는 apt가 자동으로 설치합니다:
    bash
    sudo apt-get update
sudo apt install ./AMBA_*_amd64.deb
    패키지는 gnome-keyring(KDE에서는 KWallet)을 권장 패키지로 지정합니다. AMBA가 API 키를 저장하려면 필요합니다. --no-install-recommends로 설치했거나 최소 구성 데스크톱을 쓰는 경우 sudo apt install gnome-keyring으로 직접 설치하세요.

2. 독립 실행형 AppImage (Fedora / Arch / RHEL 등) ​

  1. 공식 다운로드 포털에서 .AppImage 파일(AMBA_<version>_amd64.AppImage)을 다운로드합니다.
  2. 필수 런타임 라이브러리 설치 여부를 확인합니다:
    • Debian / Ubuntu: sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1 gnome-keyring
    • Fedora / RHEL: sudo dnf install webkit2gtk4.1 gnome-keyring
    • Arch Linux: sudo pacman -S webkit2gtk-4.1 gnome-keyring
  3. 실행 권한을 부여하고 앱을 실행합니다:
    bash
    chmod +x AMBA_*_amd64.AppImage
./AMBA_*_amd64.AppImage

3. Linux에서 API 키 저장 (키링 필수) ​

AMBA는 API 키와 커넥터 자격 증명을 D-Bus를 통한 Secret Service 키링에만 저장합니다. 평문이나 데이터베이스로 대체 저장하지 않습니다.

  • GNOME, KDE Plasma, XFCE, Cinnamon: 보통 GNOME Keyring 또는 KWallet(5.97 이상)이 이미 실행 중입니다.
  • 경량 윈도우 매니저(i3, sway, bspwm, Hyprland) 또는 KeePassXC: 세션에서 Secret Service 제공자를 실행하세요. 예: gnome-keyring-daemon --start --components=secrets, 또는 KeePassXC에서 Secret Service 연동을 켭니다.
  • 키링이 실행 중이지 않은 경우: AMBA는 실행되지만 키 저장은 "시스템 키체인을 사용할 수 없습니다…" 메시지와 함께 실패하고, 설정 → 시스템 진단에 키체인 사용 불가로 표시됩니다. GNOME Keyring 또는 KWallet을 설치/활성화한 뒤 AMBA를 다시 시작하세요.
  • 0.5.8 이하에서 업데이트: 이전 버전이 저장한 키는 첫 실행 시 키링으로 옮겨집니다. 키링이 없는 동안에는 사용 가능해질 때까지 로컬 데이터베이스에 남아 있습니다.

🔄 안전한 무중단 자동 업데이트 ​

AMBA에는 원클릭 인앱 자동 업데이트 기능이 내장되어 있습니다. 새로운 업데이트가 배포되면:

  • 화면 하단 상태 표시줄에 알림 배지가 표시됩니다.
  • 변경 사항을 확인하고 단 한 번의 클릭으로 최신 버전으로 업데이트할 수 있습니다.
  • 모든 업데이트 패키지는 암호화 디지털 서명을 통해 위변조 여부를 엄격히 검증합니다.