本文的内容主要参考网上收集的资料，不过在Android 4.0 webkit上做扩展时，碰到一些问题，觉得有必要记录下来。
所谓扩展JavaScript对象，就是增加一个JS对象，但它并没有定义在标准的JS对象集合中。如果网页中包含了扩展的JS对象，使用普通的浏览器就会报JS错误。
下面以添加HelloObject对象为例说明具体步骤，该对象具有description属性：
添加HelloObject.h, HelloObject.cpp, HelloObject.idl文件，简单起见，将这三个文件放到Source/WebCore/page目录下。 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
#ifndef HelloObject_h
#define HelloObject_h
#include <wtf/PassRefPtr.h>
#include <wtf/RefCounted.h>
#include "PlatformString.h"
namespace WebCore {
class HelloObject : public RefCounted < HelloObject > {
public :
static PassRefPtr < HelloObject > create () { return adoptRef ( new HelloObject ()); }
String description () const ;
private :
HelloObject ();
};
} // namespace WebCore
#endif // HelloObject_h
HelloObject.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
#include "config.h"
#include "HelloObject.h"
namespace WebCore {
HelloObject :: HelloObject ()
{
}
String HelloObject :: description () const
{
return "Hello Object" ;
}
} // namespace WebCore
HelloObject.cpp
1
2
3
4
5
6
module window {
interface [OmitConstructor] HelloObject {
readonly attribute DOMString description;
};
}
HelloObject.idl
修改Source/WebCore/page/下的DOMWindow.h文件，添加如下声明： 1
2
3
4
5
6
7
class HelloObject ;
public :
HelloObject * helloObject () const ;
HelloObject * optionalHelloObject () const { return m_helloObject . get (); }
private :
mutable RefPtr < HelloObject > m_helloObject ;
修改Source/WebCore/page/下的DOMWindow.cpp文件，添加接口实现: 1
2
3
4
5
6
HelloObject * DOMWindow :: helloObject () const
{
if ( ! m_helloObject )
m_helloObject = HelloObject :: create ();
return m_helloObject . get ();
}
在DOMWindow::clear()函数中添加一行语句：
1
attribute [Replaceable] HelloObject helloObject;
接下来需要修改编译系统，让android编译系统编译新增的文件： 首先修改Source/WebCore/Android.mk，增加page/HelloObject.cpp到LOCAL_SRC_FILES 变量，其次需要修改Source/WebCore/Android.derived.v8bindings.mk，增加
$(intermediates)/bindings/V8HelloObject.h到GEN 变量。（注：这个是必须的，否则就不会根据HelloObject.idl生成V8HelloObject.h文件，在编译时会出错，这也
是折腾了半天得出的成果）
至此，工作基本上完成，待webkit重新编译后，可以用如下的网页进行验证：
1
2
3
4
5
6
7
8
<html>
<body>
<script type= "text/javascript" >
document . write ( "<pThis is from HelloObject: " );
document . write ( helloObject . description + "</p>" );
</script>
</body>
</html>
[参考资料]
webkit的js对象扩展（一）——binding方式创建自定义对象（单实例）
android 上 webkit js 本地扩展之全局本地对象实现步骤