跳转到正文

iOS 配置

GitHub

iOS 汽车支持使用 CarPlay 模板。在应用可以发布 CarPlay 支持之前,Apple 必须批准您应用类别的 CarPlay 权限。

将 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 category 申请 CarPlay entitlement。该插件会渲染一个简单的 CPListTemplate,但 Apple 仍决定正式分发时允许使用哪些模板和类别。

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

CarPlay 不会渲染您的 Capacitor WebView。请保持车载行简短,并将其用作手机应用逻辑的原生意图触发器。

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