Windows 上 OpenSSL v3 二进制文件与应用程序捆绑指南：常见问题解答

windows

2024-03-14 03:38:15

Windows 上将 OpenSSL v3 二进制文件与应用程序捆绑

问题概述

在 Windows 上使用 OpenSSL v3 二进制文件时，您可能会遇到一些问题，例如应用程序无法启动或出现错误消息。这些问题通常是由应用程序无法找到必要的 OpenSSL DLL 文件引起的。

解决方案

有几种方法可以解决此问题：

修改 DLL 搜索路径： 您可以使用 SetDllDirectory 函数或 PATH 环境变量将 OpenSSL 二进制文件所在的目录添加到 DLL 搜索路径中。
注册表： 您可以创建一个注册表项来指定应用程序所需的 DLL，包括 OpenSSL 二进制文件。
清单文件： 您可以创建一个应用程序清单文件（.manifest）并包含对 OpenSSL DLL 的依赖项。

具体步骤

方法 1：修改 DLL 搜索路径

使用 SetDllDirectory 函数：

int main() {
  SetDllDirectory("./lib");
  // 应用程序代码...
  return 0;
}

使用 PATH 环境变量：

右键单击“此电脑”，选择“属性”。
单击“高级系统设置”。
在“环境变量”下，找到并选择“Path”变量。
单击“编辑”。
在“变量值”中，添加 OpenSSL 二进制文件所在的目录，例如 C:\Program Files\OpenSSL-v3\bin。

方法 2：注册表

按下 Windows 键 + R，输入 regedit 并按回车键。
导航到以下注册表项：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\[应用程序名称]

右键单击“App Paths”项，选择“新建” > “项”。
将新项命名为您的应用程序名称。
在新项中，右键单击并选择“新建” > “字符串值”。
将新值命名为 Path，并将其值设置为应用程序的可执行文件路径。
再次右键单击并选择“新建” > “字符串值”。
将新值命名为 DllPath，并将其值设置为 OpenSSL 二进制文件所在的目录。

方法 3：清单文件

使用文本编辑器创建一个名为 [应用程序名称].manifest 的文件。
将以下内容添加到文件中：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type="win32" name="OpenSSL" version="3.0.0.0" processorArchitecture="x64" />
    </dependentAssembly>
  </dependency>
  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <dllSettings>
        <dllSetting>
          <dll name="libcrypto-3-x64.dll">
            <comClassFactory threadingModel="both" />
          </dll>
          <dll name="libssl-3-x64.dll">
            <comClassFactory threadingModel="both" />
          </dll>
        </dllSetting>
      </dllSettings>
    </windowsSettings>
  </application>
</assembly>