跳转到正文

iOS 配置

GitHub

iOS 车载支持使用 CarPlay 模板。在应用发布 CarPlay 支持功能之前,Apple 必须先批准您应用类别的 CarPlay entitlement。

向以下内容添加 CarPlay scene 配置: ios/App/App/Info.plist 并将其指向插件的 scene delegate。

对于 Swift Package Manager,请使用:

<key>UIApplicationSceneManifest</key>
<dict>
<key>UIApplicationSupportsMultipleScenes</key>
<true/>
<key>UISceneConfigurations</key>
<dict>
<key>CPTemplateApplicationSceneSessionRoleApplication</key>
<array>
<dict>
<key>UISceneClassName</key>
<string>CPTemplateApplicationScene</string>
<key>UISceneDelegateClassName</key>
<string>AutoPlugin.AutoCarPlaySceneDelegate</string>
</dict>
</array>
</dict>
</dict>

对于 CocoaPods,delegate 模块通常为:

<string>CapgoCapacitorAuto.AutoCarPlaySceneDelegate</string>

根据您的使用场景,申请对应 App 类别的 CarPlay entitlement。该插件会渲染一个简单的 CPListTemplate,但 Apple 仍会决定哪些模板和类别允许用于正式发布。

终端窗口
npx cap sync ios
  • setRootTemplate 当车载显示器连接时,更新 CarPlay 列表模板。
  • CarPlay 行选择事件将发送 carAction 至 JavaScript。
  • 如果 CarPlay 在 WebView 监听器就绪前已连接,插件挂载时会补发保留的事件。

CarPlay 不会渲染你的 Capacitor WebView。请保持车载列表行内容简短,并将其作为触发手机端 App 逻辑的原生意图触发器。

如果你正在使用 iOS 配置 要规划原生插件工作,请将其与 使用 @capgo/capacitor-auto 用于“使用 @capgo/capacitor-auto”中的原生能力, Capgo 插件目录 查看 Capgo 插件目录中的产品工作流, Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节, 添加或更新插件 关于“添加或更新插件”中的实现细节,以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。