如何将海康机器人C++ DEMO封装为适配.Net 7跨平台的SDK？

核心思路 #

利用海康提供的跨平台C++ DEMO，通过P/Invoke跨平台通用方案（优先推荐）或C++/CLI Windows专属方案，将C++读码逻辑封装为.NET 7可直接调用的接口，同时适配Windows和Linux ARM64架构。

一、准备工作 #

• 提取C核心代码：从海康DEMO中抽离读器初始化、读码、资源释放等核心业务函数，剔除UI、平台冗余代码，整理成独立的C模块（如hk_reader_core.cpp和hk_reader_core.h）。
• 验证跨平台兼容性：检查代码中是否存在Windows专属API（如Win32相关调用），替换为标准C++库实现，确保可在Linux ARM64下编译。
• 安装编译工具：Windows端安装带C++开发组件的Visual Studio；Linux ARM64端安装g++、make工具链，或准备交叉编译环境。

二、具体封装实现 #

方案1：跨平台P/Invoke封装（推荐） #

将C++代码编译为动态链接库，通过.NET的P/Invoke机制直接调用，适配双平台。

步骤1：编译C++为动态库

• Windows端：

  1. 在Visual Studio创建「动态链接库(DLL)」项目，添加整理后的C++核心代码。
  2. 配置项目属性：目标平台选对应架构（如x64），C++标准设为C++17（与海康DEMO一致），指定输出目录。
  3. 编译生成HkReader.dll，保留头文件用于函数声明。

• Linux ARM64端：

  1. 将C++代码传到Linux ARM64设备或交叉编译环境。
  2. 编写Makefile：

     CC = aarch64-linux-gnu-g++
     CFLAGS = -fPIC -shared -std=c++17
     TARGET = libHkReader.so
     SOURCES = hk_reader_core.cpp
     
     all:
         $(CC) $(CFLAGS) $(SOURCES) -o $(TARGET)
     

  3. 执行make生成libHkReader.so。

步骤2：.NET 7中通过P/Invoke调用

在Avalonia项目中创建封装类，声明C++函数并调用：

using System.Runtime.InteropServices;

public class HkReaderService
{
    private const string _libraryName = RuntimeInformation.IsOSPlatform(OSPlatform.Windows) 
        ? "HkReader.dll" 
        : "libHkReader.so";

    // 初始化读码器，参数类型需与C++函数严格匹配
    [DllImport(_libraryName, CallingConvention = CallingConvention.Cdecl)]
    public static extern int InitReader(string deviceIp, int port);

    // 读取条码，返回C风格字符串指针
    [DllImport(_libraryName, CallingConvention = CallingConvention.Cdecl)]
    public static extern IntPtr ReadCode();

    // 释放读码器资源
    [DllImport(_libraryName, CallingConvention = CallingConvention.Cdecl)]
    public static extern void ReleaseReader();

    // 封装字符串转换与内存释放逻辑
    public static string GetReadResult()
    {
        IntPtr codePtr = ReadCode();
        string result = Marshal.PtrToStringAnsi(codePtr);
        // 调用C++提供的内存释放函数，避免泄漏
        FreeCodeBuffer(codePtr);
        return result;
    }

    // 声明C++的内存释放函数
    [DllImport(_libraryName, CallingConvention = CallingConvention.Cdecl)]
    private static extern void FreeCodeBuffer(IntPtr buffer);
}

方案2：Windows专属C++/CLI封装 #

若Windows端需要更优雅的面向对象封装，可通过C++/CLI创建中间层，将C++逻辑包装为.NET类。

步骤1：创建C++/CLI类库

1. 在Visual Studio创建「CLR类库(.NET)」项目，目标框架选.NET 7。
2. 添加C++核心代码与头文件，编写封装类：

#include "hk_reader_core.h"
using namespace System;

namespace HkReaderCli
{
    public ref class ReaderService
    {
    private:
        HkReaderCore* _coreInstance;
    public:
        ReaderService()
        {
            _coreInstance = new HkReaderCore();
        }

        int Init(String^ deviceIp, int port)
        {
            const char* ipPtr = (const char*)Marshal::StringToHGlobalAnsi(deviceIp).ToPointer();
            int result = _coreInstance->InitReader(ipPtr, port);
            Marshal::FreeHGlobal(IntPtr((void*)ipPtr));
            return result;
        }

        String^ ReadCode()
        {
            const char* codePtr = _coreInstance->ReadCode();
            String^ result = gcnew String(codePtr);
            _coreInstance->FreeCodeBuffer(codePtr);
            return result;
        }

        ~ReaderService()
        {
            delete _coreInstance;
        }
    };
}

3. 编译生成.dll，直接在.NET 7项目中引用。

三、Avalonia跨平台部署配置 #

1. 在项目中创建平台专属目录：runtimes/win-x64/native 和 runtimes/linux-arm64/native，分别放入对应平台的动态库。
2. 设置动态库的「复制到输出目录」属性为「始终复制」，或在项目文件中配置：

<ItemGroup>
  <None Include="runtimes/win-x64/native/HkReader.dll" CopyToOutputDirectory="PreserveNewest" />
  <None Include="runtimes/linux-arm64/native/libHkReader.so" CopyToOutputDirectory="PreserveNewest" />
</ItemGroup>

3. 发布时指定目标平台：

   # Windows x64
   dotnet publish -r win-x64 -c Release
   # Linux ARM64
   dotnet publish -r linux-arm64 -c Release
   

四、关键注意事项 #

• 调用约定：C++默认使用cdecl调用约定，P/Invoke中必须显式指定，否则会导致栈溢出。
• 内存管理：C分配的内存必须由C代码释放，禁止在.NET中直接释放，避免内存泄漏或崩溃。
• 交叉编译：若没有Linux ARM64本地环境，可使用aarch64-linux-gnu-g++交叉编译工具链在x64机器上编译。
• 调试：通过输出C++函数返回值排查问题，重点检查初始化、设备连接等环节的错误码。

内容的提问来源于stack exchange，提问作者Melon NG