문제 해결: 설치 & 빌드

1DevTool 설치 또는 첫 실행 시 문제를 해결합니다.

macOS: "개발자를 확인할 수 없어 열 수 없음"

macOS는 기본적으로 App Store 외부에서 다운로드한 앱을 차단합니다. 이것은 Gatekeeper 경고이며 1DevTool에 문제가 있다는 신호가 아닙니다.

시스템 설정을 사용한 해결:

  1. System Settings → Privacy & Security를 엽니다
  2. Security 섹션까지 스크롤합니다
  3. "1DevTool was blocked from use because it is not from an identified developer"라는 메시지가 표시됩니다
  4. Open Anyway를 클릭합니다
  5. 나타나는 다이얼로그에서 확인합니다

Terminal을 사용한 대체 해결:

bash
xattr -d com.apple.quarantine /Applications/1DevTool.app

Terminal에서 이 명령을 한 번 실행한 후 1DevTool을 정상적으로 실행합니다. 다시 프롬프트되지 않습니다.

Windows: 안티바이러스가 설치 차단

일부 안티바이러스 프로그램은 새롭거나 서명되지 않은 설치 프로그램을 의심스럽다고 플래그하고 설치 중에 차단합니다.

해결:

  1. 안티바이러스 소프트웨어에서 실시간 보호를 일시적으로 비활성화합니다.
  2. 1DevTool 설치 프로그램을 실행합니다.
  3. 설치가 완료된 후 실시간 보호를 다시 활성화합니다.

보호를 완전히 비활성화하는 대신 1DevTool 설치 프로그램 파일(일반적으로 1DevTool-Setup.exe) 또는 설치 디렉터리(C:\Users\<you>\AppData\Local\1DevTool)에 예외를 추가할 수 있습니다. 정확한 단계는 안티바이러스에 따라 다릅니다 — 안티바이러스 설정에서 "Exclusions" 또는 "Exceptions"를 찾습니다.

Linux: AppImage가 실행되지 않음

AppImage를 더블클릭해도 아무 일도 없거나 즉시 닫히면 다음 해결을 순서대로 시도하세요:

파일을 실행 가능하게 만듭니다. AppImage는 실행 전에 실행 권한이 필요합니다:

bash
chmod +x 1DevTool-*.AppImage

FUSE를 설치합니다. AppImage는 자신을 마운트하기 위해 FUSE(Filesystem in Userspace)를 사용합니다. 많은 최소 Linux 설치에는 포함되어 있지 않습니다:

bash
sudo apt install libfuse2

Fedora/RHEL에서: sudo dnf install fuse.

Terminal에서 실행하여 오류 출력을 확인합니다. 여전히 실패하면 오류 메시지를 읽을 수 있도록 터미널에서 실행합니다:

bash
./1DevTool-*.AppImage --no-sandbox

--no-sandbox 플래그는 일부 기업 Linux 설정이나 컨테이너 같은 제한된 환경에서 때때로 필요합니다.

앱이 열리지만 빈 화면 유지

증상: 1DevTool이 실행되고 창이 나타나지만 인터페이스가 로드되지 않습니다 — 흰색 또는 회색 빈 화면.

원인: 이전 설치 또는 실패한 업데이트에서 손상된 앱 캐시 파일.

해결 — 캐시 삭제:

  • macOS:
    bash
    rm -rf ~/Library/Application\ Support/1DevTool/Cache
  • Windows: 파일 탐색기에서 %APPDATA%\1DevTool\Cache로 이동하고 Cache 폴더를 삭제합니다.
  • Linux: rm -rf ~/.config/1DevTool/Cache

캐시를 삭제한 후 1DevTool을 재시작합니다. 캐시가 자동으로 다시 빌드됩니다.

시작 시 tmux를 찾을 수 없음

1DevTool은 패널을 전환하거나 앱을 최소화할 때 터미널 세션을 유지하기 위해 tmux를 사용합니다. tmux가 설치되어 있지 않으면 시작 시 경고가 표시되고 터미널이 지속되지 않습니다.

tmux 설치:

  • macOS: brew install tmux
  • Linux (Debian/Ubuntu): sudo apt install tmux
  • Linux (Fedora/RHEL): sudo yum install tmux 또는 sudo dnf install tmux

설치 후 1DevTool을 완전히 종료하고 다시 실행합니다. 커스텀 셸 또는 비표준 PATH를 사용하는 경우 tmux가 있는 디렉터리(일반적으로 /usr/local/bin 또는 /usr/bin)가 셸의 PATH 변수에 포함되어 있는지 확인합니다.