精灵点点基础教程5 -- 编写扩展程序
摘要：虽然点点的内核功能仍然在不断的增加中，但毕竟不能一下就完善起来，所以在遇到无法实现的功能时，还是需要你自己编写扩展来实现想要的功能。
虽然如此，不过也不要怕，因为编写一个扩展真的是一件非常简单的事情，只需根据下面的步骤一步一步操作即可，不过需要一些C和C++的功底
目录
编写扩展程序
虽然点点的内核功能仍然在不断的增加中，但毕竟不能一下就完善起来，所以在遇到无法实现的功能时，还是需要你自己编写扩展来实现想要的功能。
虽然如此，不过也不要怕，因为编写一个扩展真的是一件非常简单的事情，只需根据下面的步骤一步一步操作即可，不过需要一些C和C++的功底。
1. 首先我们打开精灵点点的安装根目录。
2. 进入ExtensionSources目录，会在里面有一个名为ACExtendDemo的目录，点进去双击ACExtendDemo.sln，这是一个VS2010的示例解决方案。
3. 打开解决方案后，打开dllmain.cpp,扩展程序的源文件都在这里面了
下面我们将dllmain.cpp的主要内容粘帖在下面，仔细看里面的注释。
// 因为从V8引擎传过来的字符都是UTF8，而我们的工程选择的是UNICODE字符集，所以需要相互的转化函数
char* UnicodeToUTF8(const wchar_t* wp){
// 具体内容看源代码
};
// UnicodeToUTF8的逆向
WCHAR* UTF8ToUnicode(const char* c){
// 具体内容看源代码
};
// 将字符串解析成JSON对象
Json::Value ParseJson(WCHAR* json){
// 具体内容看源代码
};
/**************************************************************************
方法描述:真正的导出函数，在我们的脚本里被调用的函数
参数: params 点点扩展函数的参数只有一个就是字符型的params,可以是任意的字符串
如果需要传递的参数是复杂的数据结构，可以使用JSON字符串的方式传入，在这个扩展函数
里的params就类似是这样的结构 "{a:3,b:6}"
返回值:点点扩展函数的返回值均为字符串，如果需要返回复杂的结构，可以将结构体转化
为JSON字符串返回
**************************************************************************/
extern "C" __declspec(dllexport) WCHAR* Sum(WCHAR *params){
// 假如 params为字符串 "{a:3,b:6}"
// 解析JSON字符串
Json::Value p = ParseJson(params);
// 获取a的值，此时为3
int a = p["a"].asInt();
// 获取b的值，此时为6
int b = p["b"].asInt();
// 两数相加,c=9
int c = a + b;
// 将计算结果转化为字符串返回
WCHAR *r = new WCHAR[12];
wsprintf(r, L"%d", c);
return r;
};
// 返回JSON字符串的情况
extern "C" __declspec(dllexport) WCHAR* GetPoint(WCHAR *params){
return L"{\"x\":12,\"y\":8}";
};
// 直接执行操作的情况
extern "C" __declspec(dllexport) WCHAR* OpenUrl(WCHAR *params){
WCHAR * url = params;
::ShellExecute(NULL, L"open", L"explorer", url, NULL, SW_SHOW);
return L"";
};
然后我们将此工程编译，此时会生成一个名为ACExtensionDemo.dll的文件 ，将此文件拷贝到安装目录下的Extensions里。
这样我们就可以在脚本中调用刚才写的扩展方法了，我们这里以调用extern "C" __declspec(dllexport) WCHAR* Sum(WCHAR *params)这个方法为例来说明一下。
脚本应该象这样写
// 构造扩展方法的对象，其中函数为DLL的名字
var aed = ex("ACExtensionDemo");
// 调用Sum方法，其中第一个参数为方法名，第二个为参数，此参数会被作为params传递给DLL里的Sum方法，回想一下刚才扩展里面的SUM方法的注释。
// 此方法执行完成后ret的值为9.
var ret = aed.call('sum','{a:3,b:6}');
// 虽然讲在DLL里方法的参数PARAMS必须为字符串，但在脚本里我们仍然可以如下面的调用方式,这种情况JSON对象会被自动转化为字符串传递给DLL的扩展方法
var ret1 = aed.call('sum',{a:3,b:6});
写一个扩展并调用，是不是非常简单。：）
