[Map 3D开发实战系列] Map Resource Explorer 之二 运行和调试

前面的文章中我们介绍了这个项目的背景和目的，着手在Visual Studio中建立了一个简单的项目并写了一个简单的自定义命令，下面我们来说说如何运行和调试。

由于我们是创建了一个Class Library，通过编译会生成一个dll程序集，这个程序集不能直接运行，我们需要把它加载到AutoCAD Map 3D环境中才能调试。我们要在Visual Studio的项目属性中做如下的配置，在Debug选项卡Start Action选择Start external program，并指向Map 3D的启动文件。

再运行之前，我们再回顾一下我们写的简单命令

public class Commands
{ 

    [CommandMethod("CmdList")]
    public void CmdListCommand()
    {
        Util.PrintLn("PROMPT: MapResourceExplore commands:");
        Util.PrintLn("\nResourceExplorer");
        Util.PrintLn("\nRegisterEvents");
    } 

}

我们定义了一个公有方法CmdListCommand，这个方法我们给了CommandMethod属性，从而把这个方法标示为AutoCAD命令。当我们的程序集加载后，在AutoCAD Map 3D的命令行中输入CmdList命令后，就会调用CmdListCommand方法。注意我们定义的方法名不一定和命令名移植。还有需要注意的是Commands这个类要标示为public。

这里我们使用了一个工具类Util，这个类定义在Autodesk.Gis.Map.Platform.Utils名称空间中，它在作用就是在命令中中打印出字符串，具体的实现方法是这样的：

        /// <summary>
        /// Prints message in the AutoCAD command line. Will automatically 
        /// add a newline symbol at the beginning.
        /// </summary>
        /// <param name="msg">The message to be printed.</param>
        public static void PrintLn(string msg)
        {
            Application.DocumentManager.MdiActiveDocument.Editor.WriteMessage(msg);
.WriteMessage("\n" + msg);
        }

关于Util工具类的更多实现，可以参考Map SDK中的Platform.Samples.Util例子。

运行调试

下面我们就可以按F5启动调试了，Visual Studio会启动一个Map 3D。待Map 3D启动后，在命令行中输入netload，加载我们编译生成的MapResourceExplorer.dll, 然后在命令行中输入我们的自定义命令CmdList后回车，在Map 3D的命令行中应该就能打印出我们的字符串。如果需要调试，我们可以在需要调试的地方添加断点。

运行的结果如下：

好了，今天先说这么多，从下篇文章开始，我们将使用AutoCAD.net API来创建我们程序的基本界面，添加一个AutoCAD WPF风格的Palette。

Cheers，

峻祁连