AKI跨语言调用库神助攻C/C++代码迁移至HarmonyOS NEXT

原创 已于 2025-01-03 15:37:10 修改 · 326 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#harmonyos #华为 #HarmonyOS

于 2025-01-02 17:01:26 首次发布

随着HarmonyOS NEXT的发布，越来越多的应用加速推进鸿蒙化。在这一过程中，如何高效迁移原有资产、简化跨语言调用，成为开发者和厂商面临的重要挑战。为解决这一痛点，一款名为AKI (Alpha Kernel Interacting)的开源三方库应运而生，它通过高效封装跨语言调用接口，帮助开发者将C/C++代码快速迁移至HarmonyOS NEXT。凭借卓越的兼容性，AKI已成为厂商与开发者打造鸿蒙原生应用过程中广泛使用的跨语言调用解决方案。

AKI是一款专为鸿蒙原生开发设计的FFI（外部函数接口）开发框架。它极大地简化了JS与C/C++之间的跨语言访问，为开发者提供了一种边界性编程体验友好的解决方案。通过AKI，开发者可以使用让代码更易读的语法糖，实现JS与C/C++之间的无障碍跨语言互调，真正做到所“键”即所得。

这一创新框架的出现，正是为了解决开发者在迁移C/C++项目到HarmonyOS NEXT时面临的核心痛点。传统的NAPI接口调用复杂，学习成本高，开发者需要耗费大量精力进行适配和迁移。AKI通过封装复杂的NAPI接口，让开发者无需直接接触繁琐的跨语言调用技术细节，这一设计不仅能有效减少跨语言调用接口90%的代码量，还能将跨语言调用接口和业务代码完全解耦，帮助开发者更加专注于产品创新与功能迭代，而非技术迁移的细节问题，大幅提升开发效率。

据悉，在涉及C/C++/ETS跨越语言调用的鸿蒙化应用中，有超过80%的项目都在使用AKI，如某知名购物应用，使用后减少了项目10%代码量；某知名社交电商平台使用后减少了50%以上跨语言调用接口代码量；某图像处理软件所有C++代码复用通过AKI来实现。使用AKI后这些项目不仅减少了项目代码量，还显著优化了代码复用与迁移流程。

目前，AKI已上线OpenHarmony开源社区，“OpenHarmony三方库中心仓网站”搜索“AKI”即可了解体验。期待更多厂商和开发者下载使用并参与共建，打造更高性能的鸿蒙应用，共同推进鸿蒙生态的繁荣发展。

OHPM仓AKI直达地址：https://ohpm.openharmony.cn/#/cn/detail/@ohos%2Faki

C/C++代码迁移至HarmonyOS NEXT
2401_82505179的博客
05-13 1045
随着HarmonyOSNEXT的发布，C/C++代码的跨语言调用成为开发者面临的主要挑战。传统NAPI接口复杂且学习成本高，导致迁移效率低下。为解决这一问题，AKI（AlphaKernelInteracting）应运而生，通过FFI框架和语法糖设计，简化了JS与C/C++的跨语言调用，显著减少了代码量和开发时间。AKI支持同步与异步接口绑定，优化了内存管理和线程安全，提升了应用性能。实际案例表明，AKI在购物应用、社交电商和图像处理软件中均表现出色，代码量减少90%以上，开发效率提升30%-50%。
鸿蒙HarmonyOS NEXT实战开发：使用AKI轻松实现跨语言调用实现案例
wanghuaQAQ的博客
08-09 1063
针对JS与C/C++跨语言访问场景，NAPI使用比较繁琐。
鸿蒙5.0开发常见问题【如何通过AKI三方库实现ArkTS与C/C++之间的跨语言调用？】
鸿蒙的技术博客
05-19 647
ArkTS与C/C++之间交互，涉及到跨语言调用中数据转换，以及跨线程交互等内容。
C/C++三方库移植到HarmonyOS平台详细教程
猫哥 的沉淀、积累、总结。天天学习，好好向上...c/c++,嵌入式 linux,Android,HarmonyOS，AIOT)
08-22 1473
本文介绍了C/C++三方库移植到HarmonyOS平台的两种主要方法：推荐的AKI方式和Node-API方式。AKI方式具有开发效率高、学习成本低的优势，通过极简语法糖实现ArkTS与C/C++的无障碍调用；Node-API方式则提供更精细的控制但复杂度较高。文章详细说明了AKI方式的移植步骤，包括环境准备、包装器创建、CMake配置和ArkTS调用示例，并对比了两种方式的适用场景。移植C/C++库可提升性能、复用功能并丰富HarmonyOS生态。
待到山花烂漫时：鸿蒙开发者 用代码灌溉鸿蒙花园
weixin_42378289的博客
06-29 55
开发语音识别功能的时候，我们团队没有足够的经验，华为技术人员提供了语音识别代码Demo以及UI代码，帮助我们快速实现语音识别功能。吉林银行作为吉林省经济发展的 “金融引擎”，在数字化转型浪潮中勇立潮头。23年年末吉林银行对应用鸿蒙化表示明确认可，认为鸿蒙生态适配不仅仅是吉林银行构建数字金融护城河的战略突破口，更是实现技术自主可控的关键战役，如春潮涌动时抢占滩头的先锋。“我们的手机银行集成第三方SDK有18个，HarmonyOS SDK替代了部分，不仅协同加速，提升了我们开发的效率，还为我们节省了大量成本。
从写代码到写Prompt，解锁鸿蒙原生应用高效开发秘籍
weixin_34487462的博客
07-18 88
同时，部署领域也实现了左移，百度与营销服务团队合作的部署插件，将线下环境的部署过程左移到了文心快码中，通过文心快码调用部署插件，可以实现快速部署，单次部署耗时可以节省 10 秒以上，线下环境的 API 更新效率也提升了3倍，成效显著。在这一背景下，中国开发者需要一个全新的平台，这个平台不仅仅是一个单一的技术或产品，而是一个全面的生态系统，涵盖应用程序、操作系统以及各种硬件设备，能够为用户提供全方位的服务。当前，大模型正在重新定义软件工程，不仅促进了软件开发的民主化，也推动了开发工具的智能化发展。
HarmonyOS NEXT开发实战：使用AKI轻松实现跨语言调用
m0_72493819的博客
07-04 1209
针对JS与C/C++跨语言访问场景，NAPI使用比较繁琐
【开源三方库】Aki：一行代码极简体验JS&C++跨语言交互
HarmonyOS_666的博客
07-30 1208
这份鸿蒙（HarmonyOS NEXT）文档包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。
HarmonyOS NEXT应用开发之使用AKI轻松实现跨语言调用
2401_83047642的博客
04-08 1605
针对JS与C/C++跨语言访问场景，NAPI使用比较繁琐。而AKI提供了极简语法糖使用方式，一行代码完成JS与C/C++的无障碍跨语言互调，使用方便。本示例将介绍使用AKI编写C++跨线程调用JS函数场景。通过调用C++全局函数，创建子线程来调用JS函数，实现对变量value的加10操作，为开发者使用AKI提供参考。随着鸿蒙开发越来越火热，我了解到现在有很多小伙伴想入行鸿蒙，但又不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。
开源鸿蒙 Cordova 设备信息插件开发详解
夏天的博客
11-22 1042
Apache Cordova 是一个开源的移动应用开发框架，允许开发者使用 HTML、CSS 和 JavaScript 构建跨平台移动应用。Cordova 通过插件机制提供了访问设备原生功能的能力，使 Web 应用能够调用系统 API。
鸿蒙Qt字体实战：消灭“豆腐块“乱码与自定义字体加载
小淼淼的博客
11-23 420
Qt应用移植到鸿蒙系统时常见中文字体显示为方框（"豆腐块"）问题，主要原因是系统字体回退失败或自定义字体加载路径错误。解决方案包括：显式指定系统字体、将字体文件拷贝到沙箱目录再加载、在QML中正确使用FontLoader引用字体名称。此外还需注意High DPI适配问题，通过设置环境变量或手动调整缩放因子来优化字体渲染效果。建议打包开源中文字体随App发布，确保字体在不同设备上都能正常显示。
鸿蒙Cordova开发踩坑记录：LocalStorage的“失忆症“
小淼淼的博客
11-24 536
摘要：本文揭示了鸿蒙混合开发中LocalStorage数据丢失问题，发现应用更新或重签名会导致沙箱重建，使WebView存储目录失效。为解决该问题，提出基于Native Preferences的持久化方案：1）封装NativeStorage插件通过JSBridge与前端交互；2）采用双写策略同步LocalStorage与Native存储；3）启动时实施数据迁移确保兼容性。同时强调避免存储大对象、保持签名一致及合理控制flush时机等注意事项。最终建议采用"LocalStorage+Preferen
【HarmonyOS 6】在UI控件上滑动也会触发onClick点击事件？
路漫漫亦无涯
11-24 33
HarmonyOS 6开发中遇到滑动触发onClick事件的问题，原因是滑动后抬起手指会触发默认点击事件。从API12开始，onClick新增distanceThreshold参数可设置移动阈值，当手指移动超过该阈值时点击识别失败。解决方案是在onClick中添加distanceThreshold参数并设置为1vp，这样轻微滑动就不会误触发点击事件。本文通过示例代码演示了问题复现和解决方法，提醒开发者注意API新特性的使用。
HarmonyOS跨设备同步
2509_93946182的博客
11-21 301
HarmonyOS通过异构组网技术将多设备融合为“超级终端”，其核心是三个关键技术：首先分布式软总线实现了设备间毫秒级延迟通信，我在测试中发现相同路由器环境下传输速率比传统蓝牙快15倍；我们曾在初期版本犯过严重错误——当用户在手机相册删除照片时，所有设备立即执行删除操作，导致用户平板上正在编辑的图片突然消失。通过分析用户操作习惯，我们最终采用“分段锁”方案：将文档按段落拆分同步单元，不同设备编辑不同段落时完全并行，编辑相同段落时触发协同编辑模式。在开发购物车同步功能时，我们采用“增量同步+冲突消解”方案。
HarmonyOS应用开发从入门到精通
2509_93942407的博客
11-21 245
项目结构里，这几个目录得熟悉：下放主要代码，管理布局、图片和多语言，负责编译配置。布局常用Column、Row、Stack，样式推荐用生命周期里动态计算，适配不同屏幕。比如做个简单的列表，用容器配合渲染，再给 item 加个事件，基本结构就出来了。记住，多查组件文档，官方给的属性方法很全。跨设备迁移是亮点，在里实现状态保存，系统会自动帮你在另一台设备上恢复。性能调优要用DevEco Profiler，卡顿多半是主线程跑了重任务，记得扔到Worker线程里。关键是多写多练，从简单应用开始，逐步叠加功能。
HarmonyOS + Cordova：原生与 Web 双向桥接常见问题总览与解决方案
小淼淼的博客
11-21 412
本文分析了HarmonyOS+Cordova双向桥接通信的常见问题与排查方法。主要内容包括：1）两条核心链路：JS调原生（cordova.exec→ArkTS插件）和原生调JS（onArkTsResult事件推送+JS Proxy注入）；2）常见问题点：service/action不匹配、回调缺失、JSON解析失败、Proxy注入时机不当等；3）排查流程：通过日志打点定位问题层级，检查发起方→桥接层→接收方的调用链；4）优化建议：统一消息结构、确保回调完整性、合理控制数据频率。文章提供了系统化的故障定位思路
深入解析HarmonyOS应用包管理Bundle：从原理到实践
不懂先生的博客
11-21 94
随着万物互联时代的到来，HarmonyOS作为华为推出的分布式操作系统，以其独特的架构和设计理念，为开发者提供了全新的应用开发体验。在HarmonyOS生态中，应用包管理（Bundle Management）是支撑应用分发、安装、运行和更新的核心模块。它不仅关系到应用的性能和安全，还直接影响用户体验和开发效率。
jq 在 HarmonyOS 上的构建与适配
最新发布
Pocker_Spades_A的博客
11-24 539
jq是一个轻量级、灵活的命令行 JSON 处理器，类似于sedawkgrep等工具，但专门用于处理 JSON 数据。它使用可移植的 C 语言编写，零运行时依赖，可以轻松地切片、过滤、映射和转换结构化数据。v1.71.7_ohos构建系统识别：Autotools 项目需要autoreconf和configure子模块处理：正确处理 git submodule 的初始化和配置目标平台选择：使用而不是C 预处理器配置：使用clang -E而不是clang++config.h 生成：处理的问题，提供回退方案。
32位C++代码转到64位C++代码需要做哪些调整
07-08
<think>我们正在处理一个关于将32位C++代码迁移到64位系统的问题。根据用户的问题，我们需要参考提供的引用内容，并给出详细的调整步骤。 引用[1]提到：要将程序做成64位的，底层的模块都要编译成64位的，32位模块与64位模块不能混在一起使用。否则会报错。同时，迁移过程中可能会遇到各种问题，短时间内完成迁移会产生很多bug。 引用[2]详细说明了数据类型的变化：在32位架构中通常使用ILP32模型（int, long, pointer都是32位），而在64位ARM架构中使用LP64模型（long和pointer是64位，int仍是32位）。这会导致以下问题： - long类型：32位系统中是32位，64位系统中是64位。如果代码中用long表示指针或数据长度，可能出现溢出或截断。 - size_t类型：32位是32位，64位是64位。用int存储size_t可能导致截断。 - pointer类型：32位是32位，64位是64位。用int或long存储指针地址在64位系统中可能无法工作。 另外，指针运算和数据对齐也有变化：64位系统要求更严格的对齐（8字节对齐），否则可能导致未定义行为。 引用[3]提到：C++不支持内嵌的64位汇编（_asm{}语法错误），需要写单独的汇编代码，编译为obj文件再链接。 引用[4]提到了一个迁移工具（AKI）可以优化迁移过程，减少代码量、优化内存管理和线程安全，但我们的问题可能不直接涉及HarmonyOS，所以重点参考前三个引用。 根据以上信息，我们需要回答用户：迁移32位C++代码到64位系统需要修改哪些内容？ 回答要点： 1. 重新编译所有模块为64位，确保一致性。 2. 数据类型调整：特别注意long、指针、size_t等类型的变化。 3. 指针存储和运算：避免用int或long存储指针，应使用intptr_t或uintptr_t。 4. 数据对齐：调整结构体等对齐方式以满足64位要求（8字节对齐）。 5. 内嵌汇编：如果代码中有内嵌汇编，需要改为外部汇编文件并单独编译。 6. 其他注意事项：如打印格式、函数参数类型等。 下面我们按照这些要点来组织回答。</think>将32位C++代码迁移到64位系统需要重点关注以下关键调整，这些修改源于数据类型变化、内存对齐和架构差异： ### 一、数据类型调整（核心修改） 1. **指针和`long`类型扩展** - 在LP64模型（Linux/macOS 64位）中： - 指针和`long`从32位→64位（`int`保持32位） - 使用`intptr_t`/`uintptr_t`存储指针值（替代`int`或`long`） ```cpp // 错误示例（32位） int ptrValue = (int)&object; // 正确迁移（64位） intptr_t ptrValue = reinterpret_cast<intptr_t>(&object); ``` 2. **长度相关类型** - `size_t`、`ptrdiff_t`从32位→64位 - 用`size_t`替代`unsigned int`表示对象大小/索引 ```cpp // 32位风险代码 for(int i=0; i<v.size(); ++i) // v.size()返回size_t（64位） // 迁移方案 for(size_t i=0; i<v.size(); ++i) ``` ### 二、内存对齐优化 1. **结构体对齐调整** - 64位系统要求**8字节对齐**（32位为4字节） - 显式指定对齐属性避免未定义行为： ```cpp struct __attribute__((aligned(8))) Data { int id; // 4字节 void* buf; // 8字节（需8字节对齐） }; ``` ### 三、汇编代码迁移（关键难点） 1. **内联汇编重构** - 移除`_asm{}`块（C++不支持64位内联汇编[^3]） - 改为独立汇编文件编译（`.asm`或`.s`）后链接： ```nasm ; 独立x64汇编文件（示例） section .text global AddFunc AddFunc: mov rax, rdi ; 64位寄存器 add rax, rsi ret ``` ### 四、编译与调试配置 1. **编译选项** ```bash g++ -m64 -Wall -Wpointer-arith # 强制64位模式，启用指针检查 ``` 2. **打印格式修正** ```cpp printf("指针地址: %p\n", ptr); // 替代%lx或%x printf("大小值: %zu\n", size_val); // zu用于size_t ``` ### 五、迁移验证工具 - 使用`-Wconversion`捕获隐式类型转换风险 - 静态分析工具：Clang-Tidy（检查64位不兼容模式） - AKI工具链（鸿蒙场景）可自动化90%数据类型转换[^4] > **迁移风险提示**：混合32/64位模块会导致崩溃[^1]，需**完整重新编译所有依赖库**。测试阶段重点关注： > 1. 超过4GB内存的数据处理 > 2. 指针与整型的相互转换 > 3. 第三方库的64位兼容性
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

HarmonyOS开发者

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值