기능별 권한
| 기능 | ADB 필요 여부 | 적용 범위 |
|---|---|---|
| 기본 USB/무선 CarPlay | 아니요 | 일반 앱 권한과 호환 하드웨어 |
| 검증된 앞유리 HUD 안내 | 실행 시 별도 시작 도구 불필요 | 특정 기본 펌웨어/수신기와 지도 메타데이터 |
| 기본 계기판 지도 | 항상 ADB가 필요한 것은 아님 | 앱에 노출된 프로젝션 디스플레이 및 지원 펌웨어 |
| DiLink 5.1 테마/카드 자동 연동 | 해당 펌웨어에서 최초 1회 Usage Access 허용 | 설치된 패키지에 표시된 명령 사용 |
| DiLink 5.0 지도 스트림 일시 정지/배터리 | 선택형 차량 ADB | 지원되는 제조사 속성, Check ADB access |
| 0.2.8 바퀴 속도/주차 중 영상 | 선택형 차량 ADB | 기본 꺼짐, 터널 미검증, 영상은 P에서만 |
| 계기판 곡/아티스트/재생 상태 | 네트워크 ADB | 지원 BYD 속성; Check ADB access에서 승인 |
| 센터 화면 플로팅 지도 | 다른 앱 위에 표시 | 설정 또는 ADB 허용; 계기판 지도 필요 |
| 홈에만 카드 표시 | Usage Access | 없으면 다른 앱도 덮을 수 있음 |
먼저 할 일
차량 연동을 켜기 전에 기본 CarPlay 연결부터 확인하세요. 펌웨어가 APK 설치에 ADB를 요구한다면 설치 제한이며 DiPlay 실행 요구 사항이 아닙니다.
앱의 자동 지도 설정 안내에는 설치된 패키지용 명령이 표시됩니다. HUD Test용 명령이 공개 릴리스 패키지에 그대로 맞는 것은 아닙니다.
공개 패키지 명령: adb shell appops set com.shihab.diplay SYSTEM_ALERT_WINDOW allow; adb shell appops set com.shihab.diplay GET_USAGE_STATS allow. 테스트 패키지는 com.shihab.diplay.hudtest입니다. 실행 전 설치된 패키지를 확인하세요.
0.2.22 — CarPlay와 홈에서 페어링, 핫스팟, Wi-Fi Direct, USB 실패 이유를 알려줍니다. Android 8/9 Wi-Fi 끊김 감지와 Bluetooth·이전 P2P 그룹 복구를 개선합니다. 동일 LAN 인터페이스 선택은 USB 네트워크를 쓰는 2022 Seal EV 한 대에서 시험했습니다.
고급 기능의 한계
선택형 차량 ADB는 localhost 5555 포트의 adbd와 Check ADB access의 명시적 키 승인을 사용합니다. TLS 무선 디버깅 페어링은 지원하지 않습니다. 주차 상태에서 필요한 기능만 켜세요.
배터리 기능은 식별 시점에 값을 읽어야 합니다. 연결 후 데이터가 준비되면 Check ADB access/Apply and reconnect를 사용하세요. 바퀴 속도 데이터가 있다고 터널 정확성이 검증된 것은 아닙니다. 주차 중 영상은 유효한 기어 값이 필요하며 P를 벗어나면 닫힙니다.
네트워크 ADB 배터리 읽기는 차량 프로토콜에 따라 CAN/CANFD를 선택합니다. 홈 화면 지도 미러의 표시/숨김 설정을 저장하며 계기판 지도는 유지합니다(PR #123/#133).
USB 시작 단계마다 반복되던 2초 대기를 줄이고 iOS 26에서는 CarPlay 모드를 먼저 요청합니다. 자동 확인이 시스템 USB 대화상자를 인식합니다. Android 7.1–9에 권한 화면이 없으면 이미 승인된 네트워크 ADB로 USB 접근을 허용할 수 있습니다. 실차 검증은 필요합니다.
이 가이드와 관련된 버전 정보
전체 업데이트 내용, 이전 버전의 세부 사항과 검증 범위는 버전 이력 페이지에 모았습니다. 아래 링크에서 각 버전의 전체 설명을 확인할 수 있습니다.