주차한 뒤 준비하기
아래 메뉴와 버튼 이름은 앱의 영어 화면을 기준으로 표시했습니다.
- 차량 시스템 정보에서 차종·연식, DiLink, Android, 펌웨어 버전을 확인하고 기록하세요.
- 개발 프로젝트의 GitHub 릴리스에서 공식 APK를 받고 차량이 지원하는 방법으로 설치하세요. APK 설치 허용 여부는 차량 시스템과 펌웨어에 따라 다릅니다.
- DiPlay를 열고 사용하는 기능에 필요한 권한을 허용하세요. Bluetooth/근처 기기와 Wi-Fi/위치는 연결에, 마이크는 Siri와 통화에 쓰입니다. 알림은 연결 조작을 표시합니다.
- 다른 스마트폰 화면 연동 앱을 종료하세요. iPhone의 Bluetooth와 Wi-Fi를 켜고 차량 Bluetooth 설정에서 페어링하세요.
처음 연결하기
기본 연결 방식은 차량 내장 핫스팟입니다. 가능하면 5 GHz로 켜고 Settings → Connection → Connection setup에 정확한 이름과 비밀번호를 저장하세요. iPhone의 Bluetooth와 Wi-Fi를 켠 상태로 차량과 페어링한 뒤 Connect phone을 누르고 CarPlay 안내를 승인하세요. 자동으로 핫스팟에 접속하지 않으면 iPhone에서 직접 연결해 보세요.
레거시 Wi-Fi Direct는 펌웨어에 의존하며 요청 주파수를 확인할 수 없습니다. 대상은 0.2.21 이상에서 Android 7.0–9, 0.2.15–0.2.20에서 7.1–9, 0.2.13–0.2.14에서 Android 9입니다. 구형 Android의 실차 검증은 아직 필요합니다.
Existing Wi-Fi / Same LAN: 먼저 시스템 설정에서 차량과 iPhone을 같은 공유기나 휴대용 Wi-Fi에 연결한 다음 DiPlay에 네트워크 이름과 비밀번호를 저장하세요. Bluetooth는 켜 두세요. WPA2 또는 WPA2/WPA3 혼합 모드를 사용하고 공유기의 클라이언트 격리를 꺼서 두 기기가 통신할 수 있게 하세요. DiPlay가 대신 Wi-Fi에 접속해 주지는 않습니다.
USB: 데이터 전송이 가능한 케이블과 USB 데이터 포트를 사용하고 Connect with USB를 선택하세요. 차량의 USB 권한과 iPhone의 신뢰/CarPlay 요청을 승인하세요. 로컬 VPN 권한을 요청하면 허용하세요. USB 연결에 쓰이며 인터넷 VPN 서비스가 아닙니다. 기본 CarPlay에는 ADB가 필요 없지만 차량에서 앱을 설치할 때는 필요할 수 있습니다.
0.2.22 — USB 음성 메시지, 음성 메모와 받아쓰기는 더 작은 마이크 패킷을 사용하며 실차 확인은 남아 있습니다. USB 네트워크가 열리면 시작을 다시 요청하고 늦은 시작은 최대 45초 기다립니다. 복구 기한이며 연결 보장 시간이 아닙니다.
각 기능 확인하기
30 fps, HEVC 끄기, 아이콘/글자 크기 Default로 시작하세요. 화면이 끊기면 해상도를 80% 또는 60%로 낮춰 보세요. 연결 중 화면 설정을 바꿀 때는 Apply and reconnect로 적용하세요. 연결하지 않은 상태에서 저장하면 다음 연결에 적용됩니다.
화면, 터치, 음악, 내비게이션 음성, Siri, 통화를 각각 확인하세요. CarPlay 홈 화면이 보인다고 모든 기능이 정상인 것은 아닙니다.
Android에서 "패키지를 구문 분석하는 데 문제가 발생했습니다"라고 표시되면 설치 중에 오류가 발생한 것입니다. Android 7.0 이상, 공식 APK 파일 이름, 전체 다운로드 및 차량에서 APK 설치를 허용하는지 여부를 확인하세요. 문제 #113에는 이 오류가 포함되어 있지만 확인된 원인이나 수정 사항은 없습니다.
자동으로 시작되지 않으면 먼저 DiPlay를 직접 열어 연결하세요. 차량 시작 후 앱 열기와 앱을 열 때 연결하기 설정, 백그라운드 실행 권한을 따로 확인하세요. #118의 Qin 소유자는 이후 새 버전에서 해결됐다고 답했습니다. 정확한 버전과 전체 구성이 없으므로 모든 Qin에서 해결됐다고 볼 수는 없습니다.
업데이트와 문제 제보
서명이 0.2.21와 일치합니다. 설정과 페어링을 유지하려면 com.shihab.diplay를 업데이트하세요. 0.2.22에서 재현한 다음 설정 → 진단 → 진단 보고서 저장 또는 전화로 보고서 가져오기를 수행합니다. Android 7.0–9는 스토리지 액세스를 요청합니다. Android 10+는 일반적으로 다운로드/DiPlay에 저장됩니다. 공유하기 전에 검토하세요. 자동 업로드가 되지 않습니다. 저장에 실패해도 보고서 보기 및 공유는 계속 사용할 수 있습니다.
시작 문제는 차량 시스템을 재시작한 뒤 DiPlay를 직접 열어 보고서를 내보내세요. 차종, 펌웨어, Android, iPhone/iOS, 연결 방식, 실행 단계, 발생 시간을 적어 주세요. 보내기 전에 내용을 확인하고 핫스팟 비밀번호는 넣지 마세요. 자동으로 업로드되지 않습니다.
APK 분석에 실패하면 무엇을 확인하나요?
실제 Android/API와 CPU ABI를 APK 요구 사항과 비교하세요. 32비트 ARM 시스템은 arm64 전용 패키지를 설치할 수 없습니다. 조건이 맞으면 실제 APK, 전체 오류와 설치 경로를 확인하세요. 무작위 패키지 교체를 멈추고 초보자에게 서명 검증을 필수로 요구하지 않습니다.
간단한 테스트 기록 남기기
설정 → 진단 → 휴대폰에서 보고서 받기는 QR 또는 주소와 6자리 코드로 다운로드합니다. 5회 오입력 후 수동 입력이 잠기며 페이지를 다시 열면 해제; QR은 유지됩니다. 공유 전 검토하며 자동 업로드하지 않습니다.
- 먼저 한 가지 연결 방식과 기본 설정으로 시작하세요. 설정을 바꾸기 전에 APK 파일명, 차량 펌웨어, iPhone 모델과 iOS 버전을 기록하세요.
- 주차한 상태에서 음악, 내비게이션 안내, Siri, 통화를 각각 시험하고 결과를 적으세요. 화면이 정상이라고 소리나 마이크도 정상인 것은 아닙니다.
- 차량 홈 화면으로 돌아갔다가 DiPlay를 다시 열어 재연결을 확인하세요. 선택 기능은 하나씩 켜고 어떤 변경부터 문제가 생기는지 기록하세요.
이 가이드와 관련된 버전 정보
전체 업데이트 내용, 이전 버전의 세부 사항과 검증 범위는 버전 이력 페이지에 모았습니다. 아래 링크에서 각 버전의 전체 설명을 확인할 수 있습니다.
관련 GitHub 이슈
이슈가 닫혔다고 해서 수정되었다는 뜻은 아닙니다. 이후 업데이트는 원문을 확인하세요.