Ubports Installer

기기 지원 및 자동 감지

지원되는 UBports 기기를 자동으로 감지하고, 기기에 맞는 최신 설치 구성 파일을 다운로드하여 사용합니다. 구성 파일은 기본적으로 최신 버전의 installer-configs 저장소에서 가져옵니다.

커스텀 구성 파일 지원

-f 또는 –file 옵션을 사용하여 로컬 YAML 구성 파일을 지정할 수 있습니다. 이는 구성 파일 테스트나 새로운 기기 추가 시 유용합니다.

상세 로그 및 버그 보고

설치 중 오류가 발생하면 버그 보고 생성을 제안하며, 로그 파일은 다음과 같은 위치에 저장됩니다:

• Windows: %APPDATA%ubportsubports-installer.log
• macOS: $HOME/Library/Caches/ubports/ubports-installer.log
• Linux: ~/.cache/ubports/ubports-installer.log

다운로드·설치 방법

Windows 사용자는 공식 배포 페이지에서 exe 형식의 설치 프로그램을 다운로드할 수 있습니다. 다운로드 후 실행 파일을 더블클릭하여 설치를 시작할 수 있습니다. 또한 Scoop을 통해 scoop install ubports-installer 명령어로 설치할 수 있습니다.

기본 사용법/명령어

설치 프로그램을 실행하면 지원되는 기기를 연결하라는 안내가 표시됩니다. 기기를 연결하고 화면 지시 사항에 따라 진행하면 설치가 자동으로 진행됩니다. 고급 사용자는 명령줄 인터페이스를 통해 다음과 같은 옵션을 사용할 수 있습니다:

• -V, –version: 버전 정보 출력
• -f, –file : 로컬 YAML 구성 파일로 오버라이드
• -v, –verbose: 디버깅 정보 출력 (여러 번 사용 시 상세도 증가)
• -d, –debug: Electron 웹 디버거 활성화
• –systemimage : 커스텀 시스템 이미지 서버 URL 설정
• -h, –help: 도움말 표시

이런 경우에 유용합니다

Ubuntu Touch를 지원하는 스마트폰이나 태블릿에 대체 운영체제를 설치하려는 일반 사용자에게 유용합니다. 특히 복잡한 플래싱 명령어나 수동 파일 관리를 피하고 싶은 사용자에게 적합합니다. 개발자나 테스터는 -f 옵션을 사용하여 맞춤 구성 파일로 새로운 기기 지원을 시험할 수 있습니다.

제한 사항·확인 사항

이 도구는 UBports 기기 목록에 포함된 기기만을 지원합니다. 지원되지 않는 기기에서는 작동하지 않을 수 있으며, 기기별로 특정 부트로더나 파티션 구성이 필요할 수 있습니다. 설치를 위해서는 기기의 개발자 모드가 활성화되어 있고, USB 디버깅이 허용되어 있어야 합니다.