HCCDA 鸿蒙应用实验常见问题解答

开发环境配置问题
确保已安装DevEco Studio 3.1及以上版本，并正确配置SDK。若遇到工具链报错，检查Java环境是否为JDK 8或11，Node.js版本需≥14.19.1。网络问题可能导致依赖下载失败，建议配置国内镜像源。

项目创建与编译错误
创建项目时若提示模板缺失，需同步更新SDK至最新版本。编译阶段常见Gradle报错，可通过清理缓存（./gradlew clean）或修改build.gradle中的依赖版本解决。鸿蒙API版本需与设备系统版本匹配。

UI布局与预览问题
ArkUI中的组件需严格遵循声明式语法，避免混用传统XML布局。预览器无法显示时，检查ets文件是否使用了@Entry装饰器。动态样式推荐使用@Styles或@Extend优化代码。

模拟器运行故障
本地模拟器启动失败可能因Hyper-V或硬件加速未开启（Windows需BIOS中启用VT-x）。远程模拟器需登录华为云账号，并确保配额充足。日志过滤命令：hdc shell hilog -TAG *:E。

真机调试步骤

1. 设备需开启开发者模式并绑定华为账号。
2. 在AppGallery Connect中创建项目并申请调试证书。
3. 使用hdc_std命令手动安装HAP包时，注意签名配置必须与证书一致。

常见API调用异常
权限未声明会导致功能失效，需在module.json5中显式声明（如网络权限：ohos.permission.INTERNET）。异步回调中更新UI必须使用@State或@Link装饰的变量。

资源与多设备适配
资源文件需按屏幕密度分类存放（如base/medium/）。媒体查询示例：

.width($r('app.float.window_width'))
.height($r('app.float.window_height'))

数据持久化方案
轻量级存储推荐Preferences，关系型数据库使用RDB。分布式数据同步需调用distributedData模块，注意设备需登录相同华为账号并组网。

第三方服务集成
地图服务需申请API Key并配置agconnect-services.json。推送功能依赖华为Push Kit，注意消息格式需符合HarmonyOS通知规范。

性能优化建议
避免主线程耗时操作，复杂计算建议使用Worker线程。列表渲染优先使用LazyForEach，图片加载采用Image组件的缓存策略。内存泄漏检测工具可通过DevEco Profiler获取。