开发者您好！

一、整体架构（一句话看懂）

• 团结引擎侧：C# → P/Invoke 调用 C++ 插件（.so）
• 鸿蒙侧（DevEco C++）：通过 N-API / 动态链接 加载同一个 C++ 共享库（.so）
• 双向通信：C++ 作为中间层，两边都能调用它；C++ 再通过 函数指针 / 回调 反向调用两边

你要的是：团结引擎 C# ↔ C++ ↔ DevEco C++（纯原生通道）

二、环境准备

1. 安装 团结引擎（Tuanjie），并勾选 OpenHarmony Build Support 模块
2. 安装 DevEco Studio（带 Native C++ SDK、NDK）
3. 系统：Windows /macOS 均可；架构：arm64-v8a（鸿蒙手机 / 平板）

三、第一步：编写共用的 C++ 库（两边都调用它）

1. 新建 C++ 库项目（或直接写 .h/.cpp）

新建文件夹 SharedCpp，创建 2 个文件：

(1) shared_api.h（对外接口）

#ifndef SHARED_API_H
#define SHARED_API_H

#include <stdint.h>

// 必须加 extern "C"，防止C++名称粉碎（关键！）
#ifdef __cplusplus
extern "C" {
#endif

// 1. 简单函数：C++ 加法（两边都能调用）
int32_t Shared_Add(int32_t a, int32_t b);

// 2. 回调类型：用于 C++ → 调用 C# / DevEco C++
typedef void (*SharedMessageCallback)(const char* msg);

// 3. 注册回调（C#/DevEco C++ 把自己的函数传给C++）
void Shared_RegisterCallback(SharedMessageCallback cb);

// 4. C++ 主动发消息（触发回调）
void Shared_SendMessage(const char* msg);

#ifdef __cplusplus
}
#endif

#endif // SHARED_API_H

(2) shared_api.cpp（实现）

#include "shared_api.h"

// 全局保存回调指针
static SharedMessageCallback g_Callback = nullptr;

int32_t Shared_Add(int32_t a, int32_t b) {
    return a + b;
}

void Shared_RegisterCallback(SharedMessageCallback cb) {
    g_Callback = cb;
}

void Shared_SendMessage(const char* msg) {
    if (g_Callback) {
        g_Callback(msg); // 回调：C++ → C# / DevEco C++
    }
}

四、第二步：编译 C++ 为 .so（给鸿蒙 / 团结引擎用）

方案 A：用 DevEco 编译（推荐，一次编译两边用）

1. DevEco 新建 Native C++ 空项目
2. 把 shared_api.h / shared_api.cpp 放入 entry/src/main/cpp/
3. 修改 CMakeLists.txt（编译成动态库）

cmake_minimum_required(VERSION 3.13)
project(sharedcpp)

# 编译为动态库
add_library(sharedcpp SHARED
    shared_api.cpp
)

# 头文件路径
include_directories(${CMAKE_CURRENT_SOURCE_DIR})

1. 点击 Build → Make Project
2. 生成路径：

entry/build/intermediates/cmake/release/obj/arm64-v8a/libsharedcpp.so

方案 B：用团结引擎编译（略）

• 放入 Assets/Plugins/OHOS/arm64-v8a/
• 团结引擎会自动参与 NDK 编译

五、第三步：团结引擎侧（C# → C++）

1. 放入 .so 和头文件

• 在团结引擎中创建目录：

Assets/Plugins/OHOS/arm64-v8a/libsharedcpp.so
Assets/Plugins/OHOS/include/shared_api.h

• 选中 .so → Inspector：
  • Select Platforms: OHOS
  • CPU: ARM64
  • 勾选 Load On Startup

2. C# 调用 C++（P/Invoke）

新建脚本 NativeComm.cs：

using System;
using System.Runtime.InteropServices;
using UnityEngine;

public class NativeComm : MonoBehaviour
{
    // 1. 引入共用C++库
    #if UNITY_OPENHARMONY
    const string LIB_NAME = "sharedcpp";
    #else
    const string LIB_NAME = "__Internal";
    #endif

    [DllImport(LIB_NAME, CallingConvention = CallingConvention.Cdecl)]
    private static extern int Shared_Add(int a, int b);

    [DllImport(LIB_NAME, CallingConvention = CallingConvention.Cdecl)]
    private static extern void Shared_RegisterCallback(SharedMessageCallback cb);

    [DllImport(LIB_NAME, CallingConvention = CallingConvention.Cdecl)]
    private static extern void Shared_SendMessage(string msg);

    // 2. 回调委托（匹配C++的typedef）
    [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
    public delegate void SharedMessageCallback(string msg);

    // 3. 保存委托（防止GC回收，关键！）
    private static SharedMessageCallback s_Callback;

    void Start()
    {
        // (1) C# → C++：调用加法
        int sum = Shared_Add(10, 20);
        Debug.Log($"C# 调用 C++ Add: 10+20 = {sum}");

        // (2) 注册C#回调（C++将来能调用）
        s_Callback = OnCppMessage;
        Shared_RegisterCallback(s_Callback);

        // (3) C# → C++：发消息
        Shared_SendMessage("Hello from Unity C#");
    }

    // (4) C++ → C#：回调函数
    [AOT.MonoPInvokeCallback(typeof(SharedMessageCallback))]
    static void OnCppMessage(string msg)
    {
        Debug.Log($"C# 收到 C++ 回调: {msg}");
    }
}

3. 挂载与导出

• 把 NativeComm 挂到场景中一个 GameObject
• File → Build Settings → OHOS → Build
• 导出 DevEco 工程（后面要导入 DevEco）

六、第四步：DevEco C++ 侧（鸿蒙 C++ → C++ 库）

1. 导入共用库

1. 打开刚才团结引擎导出的 DevEco 工程
2. 把 libsharedcpp.so 放入：

entry/src/main/cpp/libs/arm64-v8a/

1. 把 shared_api.h 放入：

entry/src/main/cpp/include/

2. 修改 CMakeLists.txt（链接 .so）

cmake_minimum_required(VERSION 3.13)
project(entry)

# 1. 头文件
include_directories(include)

# 2. 库路径
link_directories(${CMAKE_CURRENT_SOURCE_DIR}/libs/arm64-v8a)

# 3. 你的模块
add_library(entry SHARED
    native.cpp
)

# 4. 链接共用C++库
target_link_libraries(entry
    sharedcpp  # 核心！
    log
)

3. DevEco C++ 调用（native.cpp）

#include <stdio.h>
#include <string>
#include "napi/native_api.h"
#include "include/shared_api.h"

// 1. 回调：C++ → DevEco C++
void CppMessageFromShared(const char* msg) {
    printf("DevEco C++ 收到 C++ 回调: %s\n", msg);
}

// 2. 导出给ArkTS的方法（演示用，你可以纯C++调用）
static napi_value DevEcoCallCpp(napi_env env, napi_callback_info info) {
    napi_value result;

    // (1) DevEco C++ → C++：调用加法
    int sum = Shared_Add(100, 200);
    printf("DevEco C++ 调用 C++ Add: 100+200 = %d\n", sum);

    // (2) 注册DevEco回调
    Shared_RegisterCallback(CppMessageFromShared);

    // (3) DevEco C++ → C++：发消息
    Shared_SendMessage("Hello from DevEco C++");

    // 返回结果给ArkTS（可选）
    napi_create_int32(env, sum, &result);
    return result;
}

// 3. N-API注册
extern "C" __attribute__((visibility("default")))
napi_value Init(napi_env env, napi_value exports) {
    napi_property_descriptor desc[] = {
        {"callCpp", nullptr, DevEcoCallCpp, nullptr, nullptr, nullptr, napi_default, nullptr}
    };
    napi_define_properties(env, exports, sizeof(desc)/sizeof(desc[0]), desc);
    return exports;
}

七、双向通信完整流程（最终效果）

1. 启动 App
2. Unity C# → 调用 Shared_Add(10,20) → C++ → 返回 30
3. Unity C# → 注册 OnCppMessage 回调到 C++
4. Unity C# → Shared_SendMessage("Hello Unity") → C++
5. C++ → 回调 → Unity C# 打印：Hello Unity
6. DevEco C++ → 调用 Shared_Add(100,200) → C++ → 返回 300
7. DevEco C++ → 注册 CppMessageFromShared 回调
8. DevEco C++ → Shared_SendMessage("Hello DevEco") → C++
9. C++ → 回调 → DevEco C++ 打印：Hello DevEco

真正双向：任何一边调用 Shared_SendMessage，两边都会收到回调（共用同一个 C++ 库）

八、小白常见坑（必看）

1. 必须加 extern "C"

   • 不加：C#/DevEco 找不到函数（名称粉碎）

2. 回调必须防 GC

   • C# 用静态委托 + [MonoPInvokeCallback]

3. .so 架构必须匹配

   • 鸿蒙真机：arm64-v8a

4. 团结引擎导出后必须在 DevEco 重新编译

   • 直接运行会报 “库找不到”