Pokedex-AR部署与排错完全手册ARCore支持检测、常见构建坑与Release打包清单【免费下载链接】Pokedex-AR Pokedex-AR demonstrates ARCore, Sceneform, and modern Android tech stacks — such as Hilt, Coroutines, Flow, Jetpack (Room, ViewModel, LiveData) based on MVVM architecture.项目地址: https://gitcode.com/gh_mirrors/po/Pokedex-ARPokedex-AR 是一个基于ARCore Sceneform的 Android 增强现实示例应用采用 MVVM 架构集成 Hilt 依赖注入、Coroutines/Flow 协程、Room 数据库与 Jetpack 组件可在真实场景中渲染宝可梦 3D 模型并捕捉它们。本手册面向新手带你完成ARCore 支持检测、本地部署构建、常见构建坑排错与 Release 打包全流程。一、项目概览部署前先认识它模块说明路径:app主应用UI、网络、数据库、Hilt 注入app/:pokedexar-coreAR 核心封装ARCore、Sceneform、3D 模型渲染pokedexar-core/assets/*.sfb预转换好的 3D 场景文件宝可梦、球、花园app/src/main/assets/sampledata/3D 模型源文件与纹理app/sampledata/二、部署前环境检查清单1分钟检查项要求依据JDKJDK 11app 模块指定 Java 11app/build.gradleGradle7.2wrapper 已内置gradle/wrapper/gradle-wrapper.propertiesAGP7.0.2build.gradleSDKcompileSdk 31minSdk 24dependencies.gradleAndroid StudioFlamingo2021.2及以上与 AGP 7 配套第一个坑app 模块jvmTarget 11而pokedexar-core是1.8。若本机只装了 JDK 8构建会直接报Source option 11 is no longer supported。请在 Android Studio 的Settings → Build Tools → Gradle → Gradle JDK中切换为 JDK 11。三、快速部署步骤1. 克隆仓库git clone https://gitcode.com/gh_mirrors/po/Pokedex-AR2. 打开项目并同步用 Android Studio 打开项目目录等待 Gradle Sync。首次同步会下载 ARCore 1.29.0 与 Sceneform 1.17.1 等依赖定义见pokedexar-core/build.gradle。3. 真机运行连接一台支持 ARCore 的 Android 设备Android 7.0见 ARCore 设备兼容列表USB 调试开启后直接 Run。模拟器无法运行 AR 场景。四、ARCore 支持检测如何判断设备可用Pokedex-AR 的 ARCore 声明集中在 app/src/main/AndroidManifest.xml包含三处关键配置meta-data android:namecom.google.ar.core android:valuerequired /声明应用必须运行在 ARCore 环境uses-feature android:nameandroid.hardware.camera.ar android:requiredtrue /要求设备具备 AR 相机这是 Play Store 上架时的过滤条件也是安装时设备不支持提示的来源android:glEsVersion0x00030000OpenGL ES 3.0ARCore 渲染的硬性门槛。运行时状态判断进入 AR 场景后SceneActivity.kt路径app/src/main/java/com/skydoves/pokedexar/ui/scene/SceneActivity.kt中通过arFrame.camera.trackingState检查是否进入TrackingState.TRACKING未跟踪时会等待环境识别完成。排错建议打开应用提示设备不支持 ARCore → 先确认设备在 ARCore 兼容列表运行时黑屏或卡住不动 → 多为光线不足/纹理单一TrackingState一直非 TRACKING换明亮环境重试想改为可选支持不支持时降级 UI可将 meta-data 的required改为optional。五、常见构建坑 Top 5坑1jcenter() 已停用同步 401/超时build.gradle的 repositories 中仍含jcenter()JFrog 已关闭服务。若遇到依赖拉取失败或 401删除该仓库或确保所有依赖能从google()/mavenCentral()命中。坑2Sceneform SDK 已停止维护Sceneform 插件com.google.ar.sceneform.plugin曾用于把.obj转成.sfb官方已宣布弃用且转换器不再可用。本项目已提前把转换产物提交在仓库app/src/main/assets/*.sfb所以无需重新转换即可构建但如果你要新增 3D 模型需自行用旧版插件或 [Blender 导出管线] 生成.sfb/.sfa这是最大的隐性成本。坑3Hilt kapt 注解处理失败app 模块使用 Hilt 2.40.5kapt编译常见报错dagger.hilt相关类找不到确认app/build.gradle中id kotlin-kapt与dagger.hilt.android.plugin两个插件都在且 JDK 版本一致。坑4META-INF 文件冲突多依赖携带 LICENSE/NOTICE 文件时可能报 duplicate 错误项目已在app/build.gradle的packagingOptions中统一排除勿删该段配置。坑5Room 数据库 Schema 导出app/build.gradle配置了room.schemaLocation导出到app/schemas/。修改实体后若忘记提交 schema 文件测试含 Robolectric会因版本不匹配失败。六、Release 打包清单 ✅#事项说明1创建签名 keystorekeytool -genkey -v -keystore pokedexar.jks -keyalg RSA -keysize 2048 -validity 100002补充 signingConfigsapp/build.gradle当前没有 buildTypes/signingConfigs 块默认 release 未签名需自行添加 release 签名配置并绑定到buildTypes3确认版本号versionCode 3、versionName 1.0.2在dependencies.gradle中统一管理发版前先递增4网络域名白名单AR 列表页依赖 PokeAPI 网络数据network/PokedexClient.kt确认设备可正常联网5混淆开关项目未开启 R8 混淆如需减包可加minifyEnabled true并补充 keep 规则Moshi/Hilt 类需保留6执行打包菜单Build → Generate Signed App Bundle / APK选择 release 签名配置7产物验证安装后验证列表加载、详情跳转、AR 场景三个入口均正常七、FAQ 速查QSync 一直失败优先检查 JDK 11 与 Gradle 7.2 是否匹配再看网络代理能否访问google()/mavenCentral()仓库。Q构建报错kapt内存溢出在gradle.properties中调大-Xmx如 4g。Q能跑在平板/模拟器上吗不能AR 场景强依赖真机 ARCorecamera.arfeature required。Q代码格式报错项目使用 Spotlessspotless.gradle执行spotlessApply任务统一格式化即可。按此清单走完你应当能顺利把 Pokedex-AR 跑在一台支持 ARCore 的真机上并产出可分发的 Release APK。【免费下载链接】Pokedex-AR Pokedex-AR demonstrates ARCore, Sceneform, and modern Android tech stacks — such as Hilt, Coroutines, Flow, Jetpack (Room, ViewModel, LiveData) based on MVVM architecture.项目地址: https://gitcode.com/gh_mirrors/po/Pokedex-AR创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考