PhoneGap 1.5版本 cordova.js 简析 3(转)
原文:http://peng-jiesi.iteye.com/blog/1494079
在基本升级了phonegap1.5后,发现原有的phonegap插件基本还是能够工作的,而因为项目原因我需要重写phonegap的定位能力,却发现无法找到类似phonegap 1.4的定义代码
- PhoneGap.addConstructor(function() {
- navigator._geo = new Geolocation();
- // No native geolocation object for Android 1.x, so use PhoneGap
- // geolocation
- if (typeof navigator.geolocation === 'undefined') {
- navigator.geolocation = navigator._geo;
- Geolocation.usingPhoneGap = true;
- }
- //Geolocation.usePhoneGap();
- });
进过分析发现phonegap通过一个'cordova/common'模块保证我们继续可以使用navigator.geolocation来访问函数.在phonegap1.5 js代码的最后实现了一个self.boot的方法,当onNativeReady时触发,下面就是其中的主要功能 -- 扩展window对象
- // Drop the common globals into the window object, but be nice
- // and don't overwrite anything.
- builder.build(base.objects).intoButDontClobber(window);
- // Drop the platform-specific globals into the window object and
- // do it like a honey badger does it.
- builder.build(platform.objects).intoAndClobberTheFOutOf(window);
- // Call the platform-specific initialization
- platform.initialize();
整个过程分成了三部分, 构建共用对象,构建平台(IOS, android等)对象,初始化平台参数. 而前两者都是通过'cordova/builder'组建实现.通过分析该组建可以发现其中最重要的函数为include,代码如下
- function include(parent, objects, clobber) {
- each(objects, function(obj, key) {
- try {
- var result = obj.path ? require(obj.path) : {};
- if (clobber) {
- // Clobber if it doesn't exist or if an
- // override is specified.
- if (typeof parent[key] === 'undefined'
- || typeof obj.path !== 'undefined') {
- parent[key] = result;
- }
- result = parent[key];
- } else {
- // Don't clobber if something already exists
- // there
- if (typeof parent[key] == 'undefined') {
- parent[key] = result;
- } else {
- // Set result to what already exists, so
- // we can build children into it if they
- // exist.
- result = parent[key];
- }
- }
- if (obj.children) {
- include(result, obj.children, clobber);
- }
- } catch (e) {
- alert('Exception building cordova JS globals: '
- + e + ' for key "' + key + '"');
- }
- });
- }
通过include函数,程序会把在common中定义的object下的所有对象通过path初始化后以属性的方式添加进windows里面,但是如果window对象中存在了该属性则不会被覆盖.同时一个功能如果需要存在子结点,则必须放在obj.children里(同path同级)否则无效.
接着程序会将platform的object下对象,以覆盖的方式添加进window中,主要包括以下几个属性
- window.cordova.JSCallback : "cordova/plugin/android/callback"
- window.cordova.JSCallbackPolling : "cordova/plugin/android/polling"
- window.navigator.app : "cordova/plugin/android/app"
- window.device : "cordova/plugin/android/device"
- window.File : "cordova/plugin/File"
- window.FileReader : "cordova/plugin/FileReader"
- window.FileError : "cordova/plugin/FileError"
而如我开始的需求,则需要将 navigator.geolocation 从common 移到 platform中保证在android平台强制使用扩展的定位能力,而非浏览器自带的.