Unity 项目迁移鸿蒙（三）：SDK 接入
内容提要
本文介绍HarmonyOS应用中手动接入第三方SDK（.har包）的方法。通过创建独立模块tuanjieLib封装SDK逻辑，在oh-package.json5添加依赖，修改build-profile.json5配置，执行ohpm install同步，最后在entry模块的Ability生命周期中引用调用SDK，实现模块化集成。
延伸解读
模块化封装：避免 entry 模块臃肿
文章建议将 SDK 相关逻辑封装在独立的 tuanjieLib 模块中，而不是直接写在 entry 模块里。entry 模块主要负责 Ability 生命周期，若所有 SDK 逻辑都堆在其中，会导致代码臃肿、难以维护。通过 tuanjieLib 统一管理 SDK 的引入和封装，再暴露给 entry 调用，既保持了结构清晰，也便于后续 SDK 的更新或替换。这种模块化思路与 Android 工程中的多模块设计类似，有助于降低耦合度。
手动接入 .har 包的关键步骤
手动接入 .har 包需要完成几个关键配置：将 .har 文件放入 libs 目录，在 oh-package.json5 中声明依赖（使用 file: 路径），并在 build-profile.json5 的 runtimeOnly.packages 中注册包名。之后需执行 ohpm install 并同步项目。这些步骤缺一不可，否则可能导致依赖无法识别或编译错误。建议严格按照顺序操作，并注意包名与文件路径的一致性。
生命周期中调用 SDK 的注意事项
由于 SDK 需要在 Ability 生命周期中直接调用，文章选择在 TuanjiePlayerAbility 的 onCreate 中初始化 SDK。这种设计意味着 SDK 的初始化时机与 Ability 创建绑定，开发者需确保 SDK 的初始化方法（如 YourSDK.Init）在合适的生命周期阶段调用，避免在页面尚未准备好时执行耗时操作。同时，通过 tuanjieLib 导出的类，entry 模块可以方便地引用，但需注意导入路径的正确性。
Q&A
如何在HarmonyOS应用中手动接入第三方SDK的.har包？
在HarmonyOS应用中手动接入.har包，需要创建独立模块（如tuanjieLib）封装SDK逻辑，将.har包放入模块的libs目录，在oh-package.json5中添加依赖，在build-profile.json5中配置runtimeOnly.packages，执行ohpm install同步，然后在entry模块的Ability生命周期中引用调用。
为什么推荐在tuanjieLib模块中封装SDK逻辑而不是直接在entry中写？
因为entry模块不仅作为launcher，还承载Ability生命周期，如果所有SDK相关逻辑都写在entry中会显得臃肿。推荐在tuanjieLib中创建SDK代码文件夹，封装好逻辑后再暴露给entry的TuanjiePlayerAbility引用，实现模块化集成。
在oh-package.json5中如何添加.har包依赖？
在oh-package.json5的dependencies字段中添加依赖，格式为："your-sdk-name": "file:./libs/YourSDK-1.0.0.har"，其中your-sdk-name是自定义的依赖名称，路径指向libs目录下的.har文件。
在build-profile.json5中如何配置.har包？
在build-profile.json5的buildOption.arkOptions.runtimeOnly.packages数组中增加har包的名称，例如："packages": ["your-sdk-name"]。
如何同步依赖并让SDK生效？
在DevEco Studio中，右键tuanjieLib模块选择Open in Terminal，执行ohpm install命令，然后点击同步按钮，即可同步依赖。
如何在entry模块中调用封装好的SDK？
首先在tuanjieLib的exported.ets中导出自定义的类，例如：export { YourSDK } from './src/main/ets/GameSdk/YourSDK';然后在entry的TuanjiePlayerAbility.ets中导入并调用，例如：import { YourSDK } from 'tuanjieLib'; 在onCreate方法中调用YourSDK.Init(this.context)。
