C#制作、打包、簽名、發布Activex全過程

一、前言

      最近有這樣一個需求，需要在網頁上面啟動客戶端的軟件，軟件之間的通信、調用，單單依靠HTML是無法實現了，因此必須借用Activex來實現。由於本人主要擅長C#，自然本文給出了用C#實現的范例，本文的預期效果是有一定Winform基礎的人可都輕松讀懂本文。

文章主要介紹了以下幾個部分：

 

1、用C#制作Activex控件，並發布為msi安裝文件

 

2、將msi打包為cab，達到瀏覽器自動安裝的效果

 

3、給cab數字簽名（可選）

 

4、將Activex應用到網頁上

 

二、用C#制作Activex控件，並發布為msi安裝文件

 

1）新建window用戶控件項目EasyActivex。其實VS2010並沒有提供專門的Activex項目模板，所謂的Activex，只要符合com標准即可。

 

 

 

 

2）在EasyActivex項目添加IObjectSafety接口

 

 

在IObjectSafety接口代碼如下，值得注意的是Guid不能隨便改，必須為一下代碼給出的Guid：

 

 

using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.InteropServices;

namespace EasyActivex
{

    [ComImport, GuidAttribute("CB5BDC81-93C1-11CF-8F20-00805F2CD064")]
    [InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IObjectSafety
    {
        [PreserveSig]
        int GetInterfaceSafetyOptions(ref Guid riid, [MarshalAs(UnmanagedType.U4)] ref int pdwSupportedOptions, [MarshalAs(UnmanagedType.U4)] ref int pdwEnabledOptions);

        [PreserveSig()]
        int SetInterfaceSafetyOptions(ref Guid riid, [MarshalAs(UnmanagedType.U4)] int dwOptionSetMask, [MarshalAs(UnmanagedType.U4)] int dwEnabledOptions);
    }
}

 

3）在EasyActivex項目添加EUserControl控件，在控件中實現IObjectSafety接口。

 

 

在控件上面添加按鈕，命名為btnOpenNote

 

 

控件的后台代碼必須實現IObjectSafety接口

 

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Text;
using System.Windows.Forms;
using System.Runtime.InteropServices;
namespace EasyActivex
{
    //這個Guid，網頁調用的時候用到，Mark
    [Guid("685F0A47-944D-4145-BF4E-76A02A422B02")]
    //這里要實現IObjectSafety接口
    public partial class EUserControl : UserControl, IObjectSafety  
    {
        public EUserControl()
        {
            InitializeComponent();
        }
        #region IObjectSafety  接口成員實現（直接拷貝即可）

        private const string _IID_IDispatch = "{00020400-0000-0000-C000-000000000046}";
        private const string _IID_IDispatchEx = "{a6ef9860-c720-11d0-9337-00a0c90dcaa9}";
        private const string _IID_IPersistStorage = "{0000010A-0000-0000-C000-000000000046}";
        private const string _IID_IPersistStream = "{00000109-0000-0000-C000-000000000046}";
        private const string _IID_IPersistPropertyBag = "{37D84F60-42CB-11CE-8135-00AA004BB851}";

        private const int INTERFACESAFE_FOR_UNTRUSTED_CALLER = 0x00000001;
        private const int INTERFACESAFE_FOR_UNTRUSTED_DATA = 0x00000002;
        private const int S_OK = 0;
        private const int E_FAIL = unchecked((int)0x80004005);
        private const int E_NOINTERFACE = unchecked((int)0x80004002);

        private bool _fSafeForScripting = true;
        private bool _fSafeForInitializing = true;

        public int GetInterfaceSafetyOptions(ref Guid riid, ref int pdwSupportedOptions, ref int pdwEnabledOptions)
        {
            int Rslt = E_FAIL;

            string strGUID = riid.ToString("B");
            pdwSupportedOptions = INTERFACESAFE_FOR_UNTRUSTED_CALLER | INTERFACESAFE_FOR_UNTRUSTED_DATA;
            switch (strGUID)
            {
                case _IID_IDispatch:
                case _IID_IDispatchEx:
                    Rslt = S_OK;
                    pdwEnabledOptions = 0;
                    if (_fSafeForScripting == true)
                        pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_CALLER;
                    break;
                case _IID_IPersistStorage:
                case _IID_IPersistStream:
                case _IID_IPersistPropertyBag:
                    Rslt = S_OK;
                    pdwEnabledOptions = 0;
                    if (_fSafeForInitializing == true)
                        pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_DATA;
                    break;
                default:
                    Rslt = E_NOINTERFACE;
                    break;
            }

            return Rslt;
        }

        public int SetInterfaceSafetyOptions(ref Guid riid, int dwOptionSetMask, int dwEnabledOptions)
        {
            int Rslt = E_FAIL;
            string strGUID = riid.ToString("B");
            switch (strGUID)
            {
                case _IID_IDispatch:
                case _IID_IDispatchEx:
                    if (((dwEnabledOptions & dwOptionSetMask) == INTERFACESAFE_FOR_UNTRUSTED_CALLER) && (_fSafeForScripting == true))
                        Rslt = S_OK;
                    break;
                case _IID_IPersistStorage:
                case _IID_IPersistStream:
                case _IID_IPersistPropertyBag:
                    if (((dwEnabledOptions & dwOptionSetMask) == INTERFACESAFE_FOR_UNTRUSTED_DATA) && (_fSafeForInitializing == true))
                        Rslt = S_OK;
                    break;
                default:
                    Rslt = E_NOINTERFACE;
                    break;
            }

            return Rslt;
        }

        #endregion

        /// <summary>
        /// 打開記事本
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void btnOpenNote_Click(object sender, EventArgs e)
        {
            System.Diagnostics.Process.Start("notepad.exe"); 
        }
    }
}

小提示：EUserControl代碼的Guid可以用VS附帶的Guid生成工具生成：

 

4）在EasyActivex項目AssemblyInfo.cs文件中添加代碼

 

 

 

//用戶添加
[assembly: AllowPartiallyTrustedCallers()]

 

5）設置EasyActivex項目項目屬性為com互操作

 

 

6）新建windows程序安裝項目EasySetup

 

 

7）將EasyActivex項目生產的dll添加到EasySetup項目中。下圖的EasyActivex.dll為已經添加進去了的文件。

 

 

8）在EasySetup項目中，設置EasyActivex.dll文件屬性為vsdraCOM。

 

 

完成以上步驟，生成下即可得到msi安裝文件

 

三、將msi安裝文件打包為cab，達到在瀏覽器中自動安裝的效果

 

如果只是生成了msi文件，用戶安裝的時候比較麻煩，像安裝一般軟件一樣，需要用戶慢慢點擊下一步，慢慢安裝，在本項目中采用打包成cab文件的方式，做到用戶點擊運行后，即可自動安裝。

在這里需要准備文件有：

    cabarc.exe：微軟提供的cab打包工具

    EasySetup.msi：  本案例中EasySetup項目生成的windows部署安裝文件

    install.inf ： 需要跟EasySetup.msi打包在一起的文件，制作方法請見下文

    build.bat：  打包的批處理命令，制作方法請見下文

 

1）  install.inf制作。新建txt文件，加入以下內容，將文件名重新命名為install.inf即可。其中EasyZSetup.msi即是要打包的安裝程序的名稱。

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

[Setup Hooks]  
hook1=hook1  

[hook1]  
run=msiexec.exe /i "%EXTRACT_DIR%\EasySetup.msi" /qn 

 

2）   build.bat制作。新建txt文件，加入以下內容，將文件名重新命名build.bat即可。其中EasyActivex.cab是生成目標cab的名稱；install.inf是第一步生成的文件名，而EasySetup.msi是需要打包的安裝程序名；第二條ping命令僅僅是讓批處理不要那么快退出，起到更利於觀察生成結果的作用。

"cabarc.exe" -s 6144 n EasyActivex.cab install.inf EasySetup.msi
ping -n 20 127.0.0.1 >nul 

 

 把以上四個文件復制到同一個文件夾中，雙擊build.bat批處理命令即可生成cab文件

 

 

雙擊bat后的運行結果如下，其中EasyActivex.cab即是生成的目標cab文件。

 

 

 

三、給cab數字簽名（可選）

 

     由於處於安全問題考慮，IE瀏覽器設置默認是禁用未簽名的Activex控件的，不過想想也知道，假如打開個未知網頁，“網頁”就能隨便調用計算機本地的東西是多么恐怖的事情，因此，瀏覽器運行的Activex必須是簽名了的，也符合常理。

     如果不怕用戶麻煩，不采用cab簽名的方式的話，也可以通過設置瀏覽器安全性來運行Activex。設置方法：打開瀏覽器--瀏覽器Internet選項--安全選項卡--自定義級別按鈕-下載未簽名的Activex控件設置為提示，保存即可。等安裝完畢后，可以將“下載未簽名的Activex控件”設置回禁用。

   以下為給cab簽名的方法，具體方法，數字認證網上面已經介紹得很詳細：

 

   1）申請、安裝證書。上中國數字認證網（ http://www.ca365.com/）申請一個免費數字證書（試用期為1年，如果企業用的話需要購買）。 

        操作方法： http://www.ca365.com/forward.do?pageurl=/ca/yhsc/4.jsp ，值得注意的是證書用途必須選擇代碼簽名證書。

        申請成功后的證書，由於是不帶密鑰的，因此下載完畢后只能夠在申請證書的機器上安裝、使用（簽名文件），如果需要在其他機器上使用的話需要將密鑰導出，操作方法為：   http://www.ca365.com/forward.do?pageurl=/ca/yhsc/5.jsp 。

 

  2）用證書給cab包簽名： http://www.ca365.com/forward.do?pageurl=/ca/thsc/7.jsp 

 

四、在解決方案中添加EasyWeb項目

 

    終於到了最后一步，發布鳥。在解決方案中添加EasyWeb項目

 

 

 

在網頁目錄中新建Activex文件夾，並將EasyActivex.cab文件拷貝進去

 

 

在網頁中添加以下代碼，即可調用Activex控件了。值得注意的是codebase是cab包的相對路徑；clsid是EUserControl控件的Guid。

 

 <object id="csharpActiveX" codebase="Activex/EasyActivex.cab" classid="clsid:685F0A47-944D-4145-BF4E-76A02A422B02"></object>

運行效果如下：

點擊即可在網頁中打開記事本了。

 

五、本案例源碼+cab打包工具+數字簽名工具下載

 

六、參考資料：

1、使用C#開發ActiveX控件  http://www.cnblogs.com/yilin/archive/2009/09/15/1567332.html 

2、Activex簽名方法和工具技巧  http://www.360doc.com/content/10/0901/15/203871_50402416.shtml

3、中國數字認證網用戶手冊 http://www.ca365.com/forward.do?pageurl=/ca/yhsc.jsp