框架工程项目-混合开发的注意点

在进行框架工程项目的混合开发时，需要注意以下关键点：

1. MultiDex 使用限制：

   • 避免在 Portal 和 Bundle 工程中自行接入 MultiDex，除非是单 Portal 工程且必须设置 multiDexEnabled true。
   • 特别注意，不要在 Bundle 中尝试开启 multidex 支持，以避免潜在的编译或运行时问题。对于过大的 Bundle，应考虑拆分策略。

2. Material Design 配置与资源使用：

   • 由于 mPaaS 框架的特殊性，直接引入 AppCompat 相关库会导致编译错误。需采用 mPaaS 提供的自定义 AppCompat 库来解决此问题，该库基于 Android 23 版本并包含多种常用组件（如 appcompat, recyclerview 等）。
   • 配置 Portal 和 Bundle 工程时，需更新 Gradle 插件版本为特定版本，并根据需要添加相应子组件依赖，例如通过提供的示例语句添加 recyclerview 组件。
   • 使用 Material Design 资源时，需注意处理资源引用的特殊情况，比如检测 Package ID 是否重复、跨 Bundle 资源使用等，确保资源引用的正确性。

3. mPaaS 初始化与配置下载：

   • 在项目配置文件 .ohpmrc 中添加 mPaaS 仓库信息。
   • 通过 oh-package.json5 文件安装框架和相关依赖，如 @mpaas/framework 和 @mpaas/cpp-shared。
   • 下载并配置 HarmonyOS 相关配置文件到项目中，并在 EntryAbilityStage 的 onCreate 方法中初始化框架，同时确保在 module.json5 中注册该类。

4. 隐私权限弹框合规处理：

   • 根据监管要求，需在用户同意隐私协议后才能调用敏感 API。确保应用遵循 mPaaS 对应版本的支持策略。
   • 弹出隐私权限对话框的 Activity 不应继承 mPaaS 的 BaseActivity，以避免未授权前收集数据的问题。
   • 正确配置 meta-data 开关，并及时更新用户同意隐私权限的状态标记，以便于管理弹窗逻辑及权限状态记录。

5. Android SDK 集成注意事项：

   • 区分开发环境与生产环境的访问方式，前者可能无需 accessToken，后者则需生成并定期刷新 accessToken。
   • 运行 Demo 时确认兼容性问题，如遇 gradle 插件不兼容可尝试升级 Android Studio 或调整插件版本，确保使用 JDK 17 及以上版本。
   • 注意 Demo 中功能路由配置的适配性，以及对 gradle 插件版本和 Java 环境的具体要求。

综上所述，在进行框架工程项目混合开发时，务必关注 MultiDex 使用规则、正确配置 Material Design、完成必要的初始化与配置下载、遵守隐私权限处理规范，以及妥善处理 Android SDK 集成中的各种细节，以保障项目的顺利进行。