反应原生车Play
CarPlay和Android Auto支持回放原生应用程序.
特征
- 📱 CarPlay 支持: 完整的 iOS CarPlay 集成
- 🚗 Android 自动支持: 完整Android 自动兼容
- 🎯 曝光 SDK 53 兼容性: 最新世博会SDK更新
- 🏗️ 新建筑准备: 支持反应原住民的新建筑
- 📍 导航模板: 地图、列表、网格和更多
- 🎵 媒体支助: 现在播放模板和音频控制
- 📞 通讯: 联系人和通讯模板
安装
npm install @g4rb4g3/react-native-carplay
# or
yarn add @g4rb4g3/react-native-carplay
曝光 SDK 53 兼容性
此版本已更新,以便与Expo SDK 53完全兼容,包括:
- ✅ Android API 34 (英语): 已更新至目标稳定Android版本
- ✅ 科特林岛 1.9.10: 已证实兼容性的稳定克特林版本
- ✅ 带子 8.4: 更新了构建工具以提高兼容性
- ✅ 反应原生 0.76+: 支持与 Expo SDK 53相兼容的回放原生版本
- ✅ 新建筑: 全力支持Fabric和TurboModules
所需资源
iOS系统
- iOS 14.0+ (英语)
- X码 16+
- 应用程序中的 CarPlay 能力
机器人
- Android API 23+ (Android 6.0) (英语)
- Android 自动支持
- 汽车App库 1.7.0
设置
iOS 设置
-
在您的应用程序中添加 CarPlay 能力 :
<!-- ios/YourApp/Info.plist --> <key>UIRequiredDeviceCapabilities</key> <array> <string>carplay</string> </array> -
在您的应用程序代表中配置 CarPlay 场景 .
Android 设置
-
将 Android 自动权限添加到您的列表 :
<!-- android/app/src/main/AndroidManifest.xml --> <uses-permission android:name="androidx.car.app.NAVIGATION_TEMPLATES" /> <uses-permission android:name="androidx.car.app.MAP_TEMPLATES" /> <uses-permission android:name="androidx.car.app.ACCESS_SURFACE" /> -
在清单中配置您的 CarPlay 服务 .
基本用途
import { CarPlay } from '@g4rb4g3/react-native-carplay';
// Initialize CarPlay
CarPlay.connect();
// Create a simple list template
const listTemplate = {
id: 'main-list',
title: 'My App',
sections: [{
items: [
{ id: '1', text: 'Item 1', detailText: 'Detail 1' },
{ id: '2', text: 'Item 2', detailText: 'Detail 2' },
]
}],
onItemSelect: (item) => {
console.log('Selected:', item);
}
};
// Present the template
CarPlay.presentTemplate(listTemplate);
模板
列表模板
适合显示音乐、联系人或导航目的地等物品的清单.
地图模板
理想的导航应用 有转弯方向 和感兴趣的点.
网格模板
用于显示相册封面或分类图标等视觉内容的功能很好.
现在播放模板
音乐和音频应用程序必须显示当前播放状态.
解决问题
Android 构建问题
如果您在升级到 Expo SDK 53 后遇到建筑问题:
-
清理您的缓存数字 :
cd android && ./gradlew clean -
更新您的工程的 Gradle 版本 内
android/gradle/wrapper/gradle-wrapper.properties数字 :distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.1-bin.zip -
确保正确的 SDK 版本 在你身边
android/build.gradle数字 :compileSdkVersion 34 targetSdkVersion 34 minSdkVersion 23 -
更新 Kotlin 版本 在您的项目中
android/build.gradle数字 :ext.kotlinVersion = '1.9.25'
共同问题
- "没有找到模块":确保你已经运行
pod install(iOS)或重建您的项目(Android) - 不连接卡Play:确保您的应用程序具有卡普莱能力和适当的权益
- Android 自动自动失效: 请检查是否将所有所需的权限添加到您的清单中
从以前的版本迁移
如果从旧版本升级 :
- 更新您的依赖关系以匹配 Expo SDK 53
- 重建您的开发建筑
- 测试所有 CarPlay/ Android 自动功能
- 更新任何已贬值的 API 用途
捐款
我们欢迎捐款! 请阅读我们提供的准则,并向主要存放处提交拉动请求.
许可证
麻省理工学院许可证 - 详情见LICENSE文件.
支助
为原住民社区制作