-
-
Notifications
You must be signed in to change notification settings - Fork 103
FAQ
For development: No. You can test using the CarPlay Simulator in Xcode.
For App Store: Yes. You must request a CarPlay entitlement from Apple. Apply at Apple's CarPlay page.
Yes! Android Auto support was added in v1.2.0. Not all features are available yet, but basic templates work. See Android Auto Setup.
Yes! Use the CarPlay Simulator:
- Xcode: I/O → External Displays → CarPlay
- Standalone: Xcode → Open Developer Tool → CarPlay Simulator
iOS 14.0 or later. CarPlay templates were introduced in iOS 12, but this package requires iOS 14+.
Use the image property on list items:
CPListItem(
text: 'Song',
image: 'assets/album.png', // Asset
// Or: image: 'https://...jpg', // URL
)For URLs, images are loaded in the background (v1.2.4+).
Use updateSections() instead of recreating the template:
listTemplate.updateSections([
CPListSection(items: [...newItems]),
]);Yes! Added in v1.2.4:
CPListTemplate(
sections: [...],
sectionIndexEnabled: false, // Hides the index
)Use push and pop:
// Navigate forward
FlutterCarplay.push(template: detailTemplate, animated: true);
// Go back
FlutterCarplay.pop(animated: true);
// Back to root
FlutterCarplay.popToRoot(animated: true);FlutterCarplay.showAlert(
template: CPAlertTemplate(
titleVariants: ['Alert Title'],
actions: [
CPAlertAction(
title: 'OK',
onPress: () => FlutterCarplay.popModal(animated: true),
),
],
),
);This isn't built into the package, but you can use URL schemes:
import 'package:url_launcher/url_launcher.dart';
void launchMaps(double lat, double lng) {
final url = 'maps://?daddr=$lat,$lng';
launchUrl(Uri.parse(url));
}- Map Template: Planned for future release
- Search Template: Planned (PR was open but needs update)
- Voice Control: Planned
No. CarPlay uses Apple's template system, not Flutter rendering. You can only use the provided templates (List, Grid, etc.).
This is an Apple restriction, not a package limitation.
No. Apple doesn't allow video playback on CarPlay for safety reasons.
Yes, if configured correctly with the shared Flutter engine. See iOS Setup.
The Tab Bar supports up to 4 custom tabs. If Now Playing is active, iOS adds it as a 5th tab automatically.
See Troubleshooting.
You forgot to call complete(). See Troubleshooting.
- Check Troubleshooting for common issues
- Search GitHub Issues
- Ask on Discord