OCX 打包 CAB 与 JS 调用详细教程

    最近在做一个 WEB 项目，需要调用 OCX 进行连接读卡器读卡。本来并不想用 OCX 技术，因为 ActiveX 技术是微软出品，这样就导致整个系统只能使用 IE 浏览器(其他浏览器可以通过插件的形式支持 OCX 的调用)。但尝试了很多方法调用客户端 DLL 发现都走不通。最后无奈之下，才打算研究 OCX 技术。

    网上都说 ActiveX 技术很麻烦，会出现各种错误，不做的时候不知道，真正需要研究时候，才发现确实如此。主要问题是，报错和问题的真正原因没有关系或者说关系不大，甚至很多时候没有报错，只有不断尝试。

    言归正传，下面来讲一下如何搞定 OCX。

    首先先声明，本教程只关于 OCX 打包 CAB 和 JS 调用 OCX，这里不探讨如何通过 C++ 写 OCX。因为本人只做 Java 开发，对于C++ 并没有研究。

    开发系统：win8.1 64位

    测试通过系统：win7 64 位、win8.1 64位、xp 32位

  OCX 和 CAB 的关系。

    大家知道，得到 OCX 之后，如果想要调用，首先要注册。在不注册的情况下，没办法调用 OCX 。

    最简单的注册办法是手动注册。手动注册需要在命令行操作。对于开发人员来说，多多少少要和命令行打交道，可能没有问题，不过对于使用我们系统的客户来说，让他进行命令行操作的确不合适。不管我们文档写得多么详细，对客户来说这都是不友好的，而且手动注册也设计到安全性问题。所以就需要在客户不知情的情况下自动对 OCX 注册。这也就是 CAB 的作用。

    手动注册 OCX

    我们假设，OCX 所在的目录是：D:/ocx/xpbutton/xpbutton.ocx

 

   

     通过 regsvr32 xpbutton.ocx ，这样我们就手动注册了 OCX。

     如果想卸载 OCX，我们可以反注册：regsvr32 /u xpbutton.ocx 。

       注册和卸载，我们都需要以管理员身份运行 cmd 控制台。-- 这里特别需要注意！

     如果在注册时候出现下面的错误：

 

   

     1.首先查看是否以管理员身份运行 CMD。

     2.如果还是不行，可以考虑将相应的 OCX 放到系统目录下     

          a). 32 位系统放到 C:\Windows\System32

          b). 64 位系统放到 C:\Windows\SysWOW64

     3.如果还是报错，那可以确定是缺少 DLL 导致的。各位可以下载一个工具： Dependency Walker。

     看 这里的教程，看少了哪些 DLL，去网上下载这些 DLL， 这些 DLL 就是你必须要和 OCX 一起打包到 CAB 压缩包里面去的。因为你自己电脑少了，说明客户电脑也同样可能会少这些 DLL。

     这里需要注意的是：首选的是和你系统相同位数的 DLL，肯定不会错，实在找不到 64 位的，才考虑 32 位的版本。

     下载了 DLL 后，将 DLL 存放到上面第二步提到的系统文件夹下面，然后再注册。

     OCX 打包 CAB

     首先下载 OCX 打包签名工具：ocx 打包签名工具，  访问密码 ddb4。

     将需要签名和打包的 OCX 和命令放到相同文件夹。

     制作签名证书：

          在命令行运行下面命令：

         1. 执行命令：

makecert.exe -ss xpbutton -n "CN=这里随便" -sv .\xpbutton.pvk -r .\xpbutton.cer

 

        输入三次，密码，查看控制台出现 Succeeded 表示成功。

 

        此时生成文件：xpbutton.cert 和 xpbutton.pvk

 

         2. 运行命令：

Cert2Spc.exe .\xpbutton.cer .\xpbutton.spc

          查看控制台，出现 Succeeded 表示成功。

 

         此时会生成文件：xpbutton.spc

         两条命令结束，我们一共得到三个文件：xpbutton.cer、xpbutton.pvk、xpbutton.spc

 

     对 OCX 进行签名

          打包 CAB 之前，首先需要对 OCX 本身进行签名操作，这一步很重要，如果没做，你可能就犯错了。

          3. 运行命令：signtool signwizard

        如果想要填写时间戳，可以填写以下地址：http://timestamp.verisign.com/scripts/timstamp.dll

        等待片刻，出现下面提示，则表示对 ocx 签名完成。

        控制台出现：Successfully completed signing wizard:<> 表示成功。

      编写 INF 文件

          INF 文件也是一个重点，如果编写错误，则不能正确打包。（各位可以下载本人编写的 INF 文件，在此基础上进行修改，保证 INF 文件的正确性）

          INF 参考文件下载地址：OCX inf 文件,  访问密码 49de。

       如果打包 CAB 没有问题 ocx 、dll 都会下载到 c:/windows/ocx/ 目录下，方便各位卸载 ocx ，删除 dll 文件。

[version]
signature="$CHICAGO$"
AdvancedINF=2.0

[DefaultInstall]
CopyFiles=files
RegisterOCXs=RegisterFiles

[DefaultUninstall]
cleanup=1
Delfiles=files
UnRegisterOCXs=RegisterFiles

[SourceDisksNames]
1 = %DiskName%, "xpbutton.cab", 1

[SourceDisksFiles]
xpbutton.ocx=1
msvcrtd.dll=1
mfc42d.dll=1
mfco42d.dll=1

[RegisterFiles]
%30%\Windows\ocx\xpbutton.ocx

[DestinationDirs]
files=30, Windows\ocx

[files]
xpbutton.ocx=xpbutton.ocx
msvcrtd.dll=msvcrtd.dll
mfc42d.dll=mfc42d.dll
mfco42d.dll=mfco42d.dll

[xpbutton.ocx]
file=thiscab
clsid={134EE1CC-4B8A-4E74-8C41-F4990065E2E1}
FileVersion=1,0,0,1
RegisterServer=yes

[msvcrtd.dll]
file=thiscab
FileVersion=6.0.8337.0

[mfc42d.dll]
file=thiscab
FileVersion=6.0.8168.0

[mcfo42d.dll]
file=thiscab
FileVersion=6.0.8267.0

[Strings]
DiskName="Windows\ocx"

        以上是本人的 inf 文件。解释几个部分。

           1.这里面添加了 3 个dll，如果各位不需要将 dll 打包到 cab ，则可以参照上面蓝色的部分。如果没有 mcfo42d.dll 则将蓝色的部分全部删除，其余的不动。以此类推。
           2.

[xpbutton.ocx]
file=thiscab
clsid={134EE1CC-4B8A-4E74-8C41-F4990065E2E1}
FileVersion=1,0,0,1
RegisterServer=yes 

          进行简单解释：

              file=thiscab 照搬照抄，不解释。由于是 64 位系统，本人测试这么写没问题。

              32 位系统也可以这样写： file-win32-x86=thiscab 

              clsid 这里，最简单的办法是找到 ocx 的来源，询问制作 ocx 作者，他们知道这里应该填写什么。

              如果找不到制作人，也有办法，参照前文手动注册 ocx ，然后查看搜索注册表：xpbutton

           找到左边类似的注册表结构，然后 134EE1CC-4B8A-4E74-8C41-F4990065E2E1 将是我们需要的 clsid 了。

           注意：本人在 C:\Windows\ocx\ 目录下注册的 xpbutton.ocx 文件。所以上面右图地址才会是 C:\Windows\ocx\xpbutton.ocx 

           FileVersion 也是一样，最好的办法，找到 ocx 的来源(开发者)，确定版本号，编写 ocx 时，代码中会有 ocx 对应的版本号。当初和 C 沟通时，看过 ocx 的 C++ 代码，里面有对应的版本信息。这里的版本信息必须和 OCX 的版本信息一致。

RegisterServer=yes 表示下载下来后自动注册此 ocx 。

           大家可以看到我下面的 dll 文件的代码中都没有这一句，意思是 dll 下载下来后不需要注册，如果各位的 dll 也需要注册，对应 dll 区域也需要添加此语句。

          3.对 INF 文件中绿色的部分进行解释

          绿色的部分，表示 dll 的版本号，如何确定 dll 版本号。其实很简单。

          找到对应的 dll 右击，查看属性，这里的文件版本，就是我们需要的版本号， 请注意，不是产品版本。 

     OCX 打包 CAB 文件

           4.运行命令：

CABARC.EXE -s 6144 n xpbutton.cab xpbutton.ocx xpbutton.inf

          需要解释一下这条命令：是将 xpbutton.ocx xpbutton.inf 文件打包成 xpbutton.cab 文件，如果我们需要将额外的 dll 也打包到 cab 里面，那这样写：CABARC.EXE -s 6144 n xpbutton.cab xpbutton.ocx msvcrtd.dll xpbutton.inf 以此类推。

      对 CAB 文件签名

         对 CAB 文件签名的过程，可以查看上文对 OCX 文件签名的过程，除了第一步此处选择的是 CAB 文件之外。其余步骤完全相同。

    到目前为止，我们已经将 OCX 打包成 CAB ，但是到现在还不行。很多教程都到此为止，其实 OCX 的繁琐远还没有结束。

    JS 调用 OCX（CAB）

     引入 OCX 控件

          新建一个 HTML 文件，我们通过如下方式引入 OCX：

         一项一项解释：

         id="xpButton" 表示此 object 对象的 id 为 xpButton，命名随便都可以，后续会用到。

         classid="clsid:134EE1CC-4B8A-4E74-8C41-F4990065E2E1" 看到这个，应该很熟悉。classid="clsid:这部分照抄，不要改动。只改动冒号 : 后面部分就行了。（本人不小心把 clsid: 这一部分漏掉了，写成了 classid="134EE1CC-4B8A-4E74-8C41-F4990065E2E1"，结果 CAB 文件下载不下来）。 注意：千万别漏了 clsid。

         codebase="./xpbutton.cab#version=1,0,0,1" 这一部分代码是告诉浏览器，如果找不到 clsid 为 134EE1CC-4B8A-4E74-8C41-F4990065E2E1 注册表，也就是系统中没有注册过此 xpbutton.ocx ，则去找对应的 xpbutton.cab 文件。这里 "./xpbutton.cab" 意思是和当前 html 存放在同一目录下的 xpbutton.cab 文件。“./”表示当前路径，也就是 html 所在的路径。后面的 "#version=1,0,0,1" 表示当前 OCX 的版本号，也就是 CAB 压缩包中 INF 文件里面写的 OCX 的版本号（FileVersion）。 注意版本号：1,0,0,1 是用逗号 "," 分隔，不是点号 "." ，如果你用了点号 "."，那么恭喜你，你又错了。 

         补充说明：我们遇到过三个版本号

                              1. OCX 编写时，C++ 代码中规定了 OCX 的版本号。

                              2. OCX 打包 CAB 文件时，INF 文件中规定了当前 OCX 的版本号。

                              3. HTML 调用 OCX 时，CODEBASE 表明了需要调用的 OCX 版本号。

           这三个版本号需要一致。

          很有意思的是，如果想要升级 OCX，其实很简单，让 OCX 编写人员升级 OCX，然后我们升级 INF 文件中的版本号，再把相应 HTML 中的版本号也升级。浏览器调用此 HTML 时候，如果发现 CODEBASE 中的版本号升级了，则会自动重新下载 CAB 文件，并重新注册。

          之前，为了测试 OCX 升级后是否本身有问题，手动注册此 OCX ，没有重新打包 CAB，结果每次访问都发现注册的是 CAB 中上一个版本的 OCX。说明只要发现注册过的 OCX 版本和 CAB 版本不一致的情况下，浏览器都会重新下载 CAB，并重新注册。

             这里还要说明一点就是，OCX 被编写出来后。clsid 就固定了。此 OCX 不管注册到哪台电脑上，查看注册表，clsid 都是一样的，不会改变。这也就是为什么我们在 HTML 里面，直接可以写上 clsid 的原因。因为客户下载 CAB ，自动注册后，OCX 的 clsid 就是我们编写 C++ 时候规定的 clsid。

         JS 调用 OCX 方法

          解释以上代码

          1.   xpButton.AboutBox() ;

                    xpButton 其实不是凭空出现的，这里的 xpButton 是