DiPlay Not Connecting? First-Connection Checks

Symptom

CarPlay never appears, or DiPlay returns to the home screen during setup.

Possible causes

Missing permissions, incorrect saved hotspot details, unsupported P2P APIs, and competing projection apps are different failure paths. Match the log to the stage.

Quick checks

1. Confirm Android 9+ for the APK and 10+ for Wi-Fi Direct. Close other projection apps.
2. Choose Built-in car hotspot, enable the real car hotspot, and save its exact name/password; keep iPhone Bluetooth/Wi-Fi enabled.
3. Pair through car Bluetooth settings, select the intended iPhone and accept CarPlay prompts. Review requested Wi-Fi/Location/Nearby permissions.
4. Try USB with a known data path. If one transport works, record it rather than calling the whole car incompatible.

Reported results & workarounds

For 0.2.0→0.2.6 loops, first re-check the migrated hotspot selection and saved details. #26 reports clearing app data as a workaround; it erases settings/pairing and should follow diagnostic export, not precede the basic checks.

Version status

For Android 10 getNetworkName failure, #79’s maintainer says 0.2.8 includes a fix. Only a custom-build retest is confirmed in the captured thread. A successful connection with the public APK still needs to be confirmed on the affected setup.

Reported setups

The following are source reports, not a universal affected-car list. Unknown fields remain unknown.

Related GitHub issues

Closed does not necessarily mean fixed. The source is authoritative for later updates.