New TlbImp Release on CodePlex - Full Customization of Interop Assemblies

New TlbImp Release on CodePlex - Full Customization of Interop Assemblies

  • Comments 7

It has been a few months since our last release of TlbImp on CodePlex. We recently released a new version of TlbImp – please visit the Codeplex page for this tool to find out more.

In this release, we’ve introduced two major features:

1. Ruled-based customization of interop assemblies

2. TlbImp regression test tool

Ruled-based customization of interop assemblies

The new TlbImp utility allows users to customize the interop assembly conversion process within TlbImp, by specifying a set of rules to customize specified types/functions/signature. We’ve received a lot of feedback from TlbImp users that they want the ability to make their own changes to the interop assembly in their build process, and they end up using ILDASM to disassemble the interop assembly into IL code, modify it using a PERL script, and then use ILASM to re-generate the interop assembly. This is obviously a painful process and requires a lot of additional work. This feature is designed to solve this problem.

Let’s start with a simple example: suppose we’d like to change the name of a certain type from an interop assembly. Let’s first double click to open TlbImpConfigFileEditor.exe to start the config file editor, and open the type library which contains the type we want to customize – let’s just use Samples\ChangeManaged\Name\ChangeManagedNameSimple.tlb to illustrate this:

clip_image002

The left pane shows every type/function/signature/field in that particular type library, while in the right pane, all the rules in the config file are displayed. All these rules tell TlbImp how to customize the interop assembly.

In order to change the name of IComparable interface, we need to create a rule. First, let’s drag the IComparable interface from the left pane to the right pane, and you will see the following dialog:

clip_image004

The dialog above is used to create a new rule, which tells TlbImp

1) What types/functions/signatures/fields are affected, and

2) What kind of customization will be done

In this dialog, we need to specify the corresponding Action to be ChangeManagedName by selecting ChangeManagedName in the drop down box, so that the name of types will be customized. After clicking OK, you’ll see a rule gets created in the right pane as follows (you’ll need to expand the rule node on your own):

clip_image006

The rule named “Change interface name” has a category of type, which means this rule applies to types only, not functions, not signatures. The condition node has a sub tree defining a set of conditions which specifies what types are affected by this rule. By selecting the Condition node (or its sub nodes), you’ll be able to see the corresponding expression in the bottom (read-only), which is NativeName Equal 'IComparable. It means that any type that is named “IComparable” in the type library will be affected by this rule. Because we were dragging the IComparable interface node to the right side, the right set of conditions that match the interface is automatically generated for you. You can also modify the condition by yourself if you wish. Say we would like to add one restriction that the rule only applies to interfaces. Let’s click the <Empty> node under the And node, select TypeKind in the first dropdown box, Equal in the second dropdown box, interface in the third dropdown box.

The result is as follows:

clip_image008

Please note that the condition nodes are organized like an abstract syntax tree. Therefore, all the condition nodes under the ‘And’ node are basically ‘And’-ed together. You’ll see the corresponding expression in the bottom pane, as follows:

( NativeName Equal 'IComparable' ) And ( TypeKind Equal 'Interface')

When the condition part is done, we’ll need to specify how the customization will be done. In this case, we need to specify the new name of the type. Clicking on the New Name node under Action node, you’ll get the dialog below:

clip_image010

Enter the new name and click OK. The rule is now completed:

clip_image012

Let’s save it as ChangeInterfaceName.xml, and call TlbImp2.exe under command line. You’ll need to use the new /config switch to refer to the .xml file you’ve just saved (as highlighted in yellow).

clip_image014

After running tlbimp2, you can start ILDASM on the result interop assembly and see what it is like after it is customized:

clip_image016

You’ll see IComparable has been renamed to IMyInterface (as highlighted in yellow).

Besides the ChangeManagedName action, TlbImp also supports a few other actions. A full list of supported actions is as follows:

1. ChangeManagedName: Change the name of specified entity

2. ResolveTo: Resolve a type library type to another managed type. We already have people requesting this feature (http://clrinterop.codeplex.com/WorkItem/View.aspx?WorkItemId=2565)

3. AddAttribute: Add attribute on any type

4. PreserveSig: Apply preserveSig transformation to functions and add PreserveSig attribute

5. ConvertTo: Change function signature. You can use ConvertTo to change int * to an int array.

Every action has a corresponding example under the Samples directory. Please feel free to try out those examples if you are interested.

Regression Test Tool

In order to help developers to make sure his change doesn’t cause any regression, we’ve developed a simple regression test tool, which is available at the same project page:

http://clrinterop.codeplex.com/Release/ProjectReleases.aspx?ReleaseId=17579

This is the same tool we’ve been using internally for developing this new TlbImp release.

Download and unzip the .zip file, double click to launch TlbImpRegressionTestTool.exe under bin directory, and then navigate to the file menu and open the testcase.xml under testcase directory:

clip_image018

You can see there is a list of all the test cases in the main window. Before running these testcases, you need to tweak some settings: Select settings under the Run menu, and enter the exact location of TlbImp2.exe and WinDiff.exe, which is required during test execution.

Please note that you can use a different diff tool as long as the diff tool accepts two arguments and compare the diff between the two.

clip_image020

After you are done with the configuration, select Run All Testcases or Run Selected Testcases under the run menu to run the testcases:

clip_image022

This tool will execute the selected testcases one by one and change the status accordingly once the test finished execution. A green background means success, while a red background suggests failure. In the case of failure, you can double click on that row to open windiff (or your preferred diff tool) which compares the expected result (generated from a stable version of TlbImp) and the actual result (generated from the specified TlbImp in the configuration step).

And that’s it. Do try out these new features, and let us know what you think about this new TlbImp release. Feel free to leave comments either at this blog or directly at http://clrinterop.codeplex.com/.

 

 

- Yi Zhang,

Developer, CLR

Leave a Comment
  • Please add 7 and 4 and type the answer here:
  • Post
  • PingBack from http://www.anith.com/?p=20747

  • 当サイト、救援部では無料でオ○ニー動画を見ることができます。ご近所検索機能でリアルタイムオ○ニーを見るチャンスも高く、興奮間違いなしです。また、一人Hのお手伝いを希望されるセレブ女性もあり、お手伝いいただけた方には高額謝礼をお支払いしております。

  • セクース好きな女性が集まる★男性との性なる夜を求めた女性達が多数登録しております!セフレ出会いサイト☆セクフレ☆で夏休み中でヒマを持て余している女子○生から、刺激を求めるOLまでみんなまとめてオイシイ関係になっちゃおう

  • 今最もアツイバイトは人妻とのセフレ契約です。当サイトではお金を払ってでもセフレがほしい人妻が集まり、男性会員様との逆援生活を待っています。当サイトで欲求不満の女性との出会いをしてみませんか

  • 大好評の逆ナンイベントが毎週��催決定!素敵な出会いのきっかけ探し・アイナビにきませんか?積極的な出会いを求める人達なら無料参加OK!あなたもほんの少しの勇気で素敵な彼氏・彼女をGETしちゃおう!

  • 夏休みで家出する女の子が急増しています。最初はマンガ喫茶やネットカフェで過ごすことが多いようですが、すぐにお小遣いが無くなり家出掲示板で泊めてくれたり遊んでくれる男性を探す子が多いようです。当サイトはそんな女の子達をサポートしたいという人たちと困っている女性たちの為のサイトです

  • 毎月10万円を最低ラインとする謝礼を得て、セレブ女性に癒しを与える仕事があります。無料登録した後はメールアプローチを待つだけでもOK、あなたもセレブラブで欲求を満たしあう関係を作ってみませんか

Page 1 of 1 (7 items)