(一):介绍
出于某些原因,你可能会发现你想要和使用Windows DLL一样使用你的Linux库.对于这有一些原因例如以下:
你正在支持一个使用多个第三方库的大应用.该项目在Linux中是可用的,可是你还没有准备直接链接到他作为一个Linux共享库.
有一个定义好的可用的接口,而且有许多用于接口的解决的方法.
你仅仅有一个二进制Windows应用,他能够通过插件扩展,比如文本编辑器或IDE.
处理这些问题的过程是很easy的.你须要编写一个spec文件,该文件以同样的格式描写叙述库接口作为一个DLL.当然,你可能希望为库编写一个小的封装.你组合他们形成一个Wine内置的链接到Linux库的DLL.然后你在wine配置中改动theDllOverrides来确保这个新内置的DLL被调用,而不是不论什么的Windows版本号.
在这个小节中,我们将会看到两个样例程序.第一个样例是很easy的,而且在”baby steps”中引入主题.都二个样例是在Wine中ODBC的接口代理.我们将要位ODBC样例引用的文件位于Wine源代码的dlls/odbc32文件夹中.
第一个样例是基于一个情况(比如,函数的名称已经被改变了来保护无辜的函数).大量的Windows应用包括链接到第三方DLL的DLL.出于一些原因,第三方DLL在Wine中执行不是很好.然后,第三方库在Linux环境中也是可用的.方便的是,DLL和Linux共享库仅仅有一小部分功能,而且应用仅仅用使用当中的一个.
特别的,应用调用一个函数:
signed short WINAPI MyWinFunc (unsigned short a, void *b, void *c,unsigned long *d, void *e, int f, char g, unsigned char *h);linux库包括一个相应的函数:
signed short MyLinuxFunc (unsigned short a, void *b, void *c,unsigned short *d, void *e, char g, unsigned char *h);(二):编写spec文件
通过编写spec文件開始.这个文件描写叙述接口,好像他是DLL一样.
在这个简单的样例中,我们想要一个Wine内置的DLL和MyWin DLL相相应.spec文件是MyWin.dll.spec,而且看上去像这:
#
# File: MyWin.dll.spec
#
# some sort of copyright
#
# Wine spec file for the MyWin.dll built-in library (a minimal wrapper around the
# linux library libMyLinux)
#
# For further details of wine spec files see the Winelib documentation at
# www.winehq.org
2 stdcall MyWinFunc (long ptr ptr ptr ptr long long ptr) MyProxyWinFunc
# End of file注意,參数被标记成了long,即使他们比那个要小.通过这个样例,我们将直接链接到Linux共享库,而通过ODBC这个样例,我们将动态载入Linux共享库.
在ODBC样例中,你能够在文件odbc32.spec中看到这些.
(三):编写一个封装
首先,我们将要看一个简单的样例.这个样例基本的问题就是长处不同的參数列表.f參数不必传递给Linux函数,而且d參数理论上须要从unsigned long *和unsigned short *之间转换.这么做是为了确保高位的返回值被正确设置.也不像ODBC样例一样,我们将要直接链接到Linux的共享库上.
/*
* File: MyWin.c
*
* Copyright (c) The copyright holder.
*
* Basic Wine wrapper for the Linux 3rd party library so that it can be
* used by the application
*
* Currently this file makes no attempt to be a full wrapper for the 3rd
* party library; it only exports enough for our own use.
*
* Note that this is a Unix file; please don't go converting it to DOS format
* (e.g. converting line feeds to Carriage return/Line feed).
*
* This file should be built in a Wine environment as a Winelib library,
* linked to the Linux 3rd party libraries (currently libxxxx.so and
* libyyyy.so)
*/
#include <3rd party linux header>
#include <windef.h> /* Part of the Wine header files */
/* This declaration is as defined in the spec file. It is deliberately not
* specified in terms of 3rd party types since we are messing about here
* between two operating systems (making it look like a Windows thing when
* actually it is a Linux thing). In this way the compiler will point out any
* inconsistencies.
* For example the fourth argument needs care
*/
signed short WINAPI MyProxyWinFunc (unsigned short a, void *b, void *c,unsigned long *d, void *e, int f, char g, unsigned char *h)
{
unsigned short d1;
signed short ret;
d1 = (unsigned short) *d;
ret = 3rd party linux function (a, b, c, &d1, e, g, h);
*d = d1;
return ret;
}
/* End of file */对于一个更广泛的情况,我们能够使用ODBC样例.这个被实现位一个头文件(proxyodbc.h)和一个C源代码文件(proxyodbc.c).尽管文件很长,可是在结构上很easy.
DllMain函数用于初始化DLL.在过程附加事件中,函数动态链接到期望的Linux ODBC库中(由于有若干个可用的),而且构建一系列的函数指针.在过程解附加事件中,他解除链接.
然后每个函数通过在初始化过程中设置的函数指针调用适当的Linux函数.
(四):构建
那么我们怎样构建一个Wine内置的DLL呢?
最简单的方法就是使winemaker来为我们做这些复杂的工作.举个简单样例,我们有两个源代码文件(封装和spec文件).我们也有第三方头文件和库文件.
将这两个源文件放到一个合适的文件夹中,然后使用winemaker来创建构建框架,包括配置脚本,makefile等等.你可能希望使用以下的选项:
--nosource-fix(须要winemaker的版本号为0.5或更新)来确保两个文件未被改动(假设使用了一个较低版本号,使这两个文件仅仅读,而且忽略不能改动他们的投诉).--dll --single-target MyWin --nomfc来指定目标--DMightNeedSomething -I3rd_party_include -L3rd_party_lib -lxxxx -lyyyy这些头文件的位置等
在执行winemaker之后,我能够仅仅在定义之前编辑Makefile,向当中加入一行CEXTRA = -Wall.
然后就是简单的执行confugure和make就可以.
(五):安装
那么我们怎样安装代理,而且确保每个事物都连接正确呢?
在这个事情上有很大的灵活性,所以须要遵循的不是唯一可行的选项.
确保Linux共享对象放到了Linux系统能够找到的地方.这就意味着他应该被放在在/etc/ld.so.conf文件里提及的文件夹中的一个中或者是在LD_LIBRARY_PATH指定的路径以下.假设你能从Linux程序中链接到他,应该也是能够的.
讲代理共享对象(MyWin.dll.so)放到同样的位置作为内置DLL的其它部分.确保WINEDLLPATH包括有代理共享对象的文件夹.
假设你既有Windows DLL也有一个Linux DLL/代理对,那么你必须确保有正确的一个得到调用.最简单的方法就是重命名Windows版本号,使他不被检測到.你能够使用winecfg设置一个DLL重写,这样内置版本号就会被使用.
一旦你这样做了,你就应该成功的使用Linux共享对象了.假设你有问题,然后在执行wine之前设置 WINEDEBUG=+module环境变量来查看真正发生了什么.
(六):转换文件名称
假设你想要转换传入的DOS格式的文件名称称到他们等效的Unix格式.当然,在微软的Windows API中没有合适的函数,可是wine提供了一个用于这个工作的函数,而且从kernel32 DLL的拷贝中导出的.这个函数就是wine_get_unix_file_name(定义在winbase.h)中.